Show Menu
TEMAS×

Working with AEM Forms Repository

Acerca del servicio de repositorio
El servicio Repositorio proporciona servicios de gestión y almacenamiento de recursos a AEM Forms. Cuando los desarrolladores crean una aplicación de AEM Forms , pueden implementar los recursos en el repositorio en lugar del sistema de archivos. Los recursos pueden incluir cualquier tipo de material colateral, incluidos formularios XML, formularios PDF (incluidos formularios de Acrobat), fragmentos de formulario, imágenes, perfiles, políticas, archivos SWF, archivos DDX, esquemas XML, archivos WSDL y datos de prueba.
Por ejemplo, piense en la siguiente aplicación Forms denominada Aplicaciones/FormsApplication :
Observe que hay un archivo llamado Loan.xdp ubicado en FormsFolder. Para acceder a este diseño de formulario, debe especificar la ruta completa (incluida la versión): Applications/FormsApplication/1.0/FormsFolder/Loan.xdp .
Para obtener información sobre la creación de una aplicación de Forms mediante Workbench, consulte la Ayuda de Workbench .
La ruta a un recurso ubicado en el repositorio de AEM Forms es:
Applications/Application-name/Application-version/Folder.../Filename
Los siguientes valores muestran algunos ejemplos de valores URI:
  • Applications/AppraisalReport/1.0/Forms/FullForm.xdp
  • Applications/AnotherApp/1.1/Assets/picture.jpg
  • Applications/SomeApp/2.0/Resources/Data/XSDs/MyData.xsd
Puede examinar el repositorio de AEM Forms mediante un navegador web. Para examinar el repositorio, introduzca la siguiente URL en un explorador Web https://[server name]:[server port]/repository . Puede comprobar los resultados de inicio rápido asociados a la sección Uso del repositorio de AEM Forms mediante un navegador web. Por ejemplo, si agrega contenido al repositorio de AEM Forms, puede ver el contenido en un navegador web. (Consulte Inicio rápido (modo SOAP): Escritura de un recurso mediante la API de Java).
La API de repositorio proporciona una serie de operaciones que puede utilizar para almacenar y recuperar información del repositorio. Por ejemplo, puede obtener una lista de recursos o recuperar recursos específicos almacenados en el repositorio cuando se necesita un recurso como parte del procesamiento de una aplicación.
La API de repositorio no se puede utilizar para interactuar con los servicios de contenido (obsoleto). Para interactuar con Content Services (obsoleto), utilice la API de Document Management.
Mediante la API de servicio Repositorio, puede realizar las siguientes tareas:
Con la API de repositorio, no puede administrar el control de acceso a los recursos, buscar recursos ni especificar relaciones con los recursos mediante un repositorio de ECM.
Cuando se escribe un PDF cifrado en el repositorio, no se puede utilizar la función de extracción de relaciones automatizada. De lo contrario, un archivo PDF cifrado se puede almacenar en el repositorio y recuperarse posteriormente. El recuperador puede elegir descifrar el PDF después de recuperarlo del repositorio.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Creación de carpetas

Las carpetas (colecciones de recursos) se utilizan para almacenar objetos (archivos o recursos) en grupos organizados. Las carpetas pueden contener recursos y otras carpetas, también conocidas como subcarpetas. Los recursos solo se pueden almacenar en una carpeta a la vez.
Los archivos heredan listas de control de acceso (ACL) de las carpetas y las subcarpetas heredan las ACL de sus carpetas principales. Por lo tanto, las carpetas principales deben existir para poder crear carpetas secundarias. El IDE le permite interactuar sólo carpeta por carpeta, no archivo por archivo. No puede crear versiones de carpetas y no es necesario; una carpeta no contiene datos en sí misma. En su lugar, es sólo un contenedor de recursos que contienen datos. La ACL predeterminada es un permiso de nivel de sistema, lo que significa que los usuarios deben tener permisos de nivel de sistema (leer, escribir, recorrer, administrar ACL) hasta que alguien les conceda permisos para una carpeta en particular. Las ACL solo funcionan en el IDE.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para crear una carpeta, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree el cliente de servicio.
  3. Cree la carpeta.
  4. Escriba la carpeta en el repositorio.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder crear una colección de recursos mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Crear la carpeta
Invoque el método de servicio Repositorio para crear la colección de recursos y rellenar la colección de recursos con información de identificación, incluyendo su UUID, nombre de carpeta y descripción.
Escribir la carpeta en el repositorio
Invoque el método del servicio Repositorio para escribir la colección de recursos, especificando el URI de la carpeta de destino.
Consulte también

Creación de carpetas mediante la API de Java

Cree una carpeta mediante la API del servicio Repositorio (Java):
  1. Incluir archivos de proyecto
    Incluya archivos de proyecto en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Crear la carpeta
    Para crear una colección de recursos, primero debe crear un com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean objeto.
    Invoque el repositoryInfomodelFactoryBean método newResourceCollection del objeto y pase los parámetros siguientes:
    • Identificador com.adobe.repository.infomodel.Id UUID que se asignará al recurso.
    • Identificador com.adobe.repository.infomodel.Lid UUID que se asignará al recurso.
    • Un java.lang.String nombre que contiene el nombre de la colección de recursos. Por ejemplo, FormsFolder . El método devuelve un com.adobe.repository.infomodel.bean.ResourceCollection objeto que representa la nueva carpeta.
    Defina la descripción de la carpeta utilizando el setDescription método y pase el siguiente parámetro:
    • Un String objeto que describe la colección de recursos. En este ejemplo "test Folder" se utiliza .
  4. Escribir la carpeta en el repositorio
    Invoque el ResourceRepositoryClient método del writeResource objeto y pase el URI de la carpeta y del ResourceCollection objeto. Por ejemplo, el URI de la carpeta puede ser el siguiente valor /Applications/FormsApplication/1.0/ .
    El método devuelve una instancia del com.adobe.repository.infomodel.bean.Resource objeto recién creado. Por ejemplo, puede recuperar el valor de identificador del nuevo recurso invocando el com.adobe.repository.infomodel.bean.Resource método getId del objeto.
Consulte también

Creación de carpetas mediante la API de servicio Web

Cree una carpeta mediante la API del servicio Repositorio (servicio Web):
  1. Incluir archivos de proyecto
    • Cree un ensamblado de cliente de Microsoft .NET que utilice el WSDL de repositorio mediante base64.
    • Haga referencia al ensamblado de cliente de Microsoft .NET.
  2. Crear el cliente de servicios
    Mediante el ensamblado de cliente de Microsoft .NET, cree un RepositoryServiceService objeto invocando su constructor predeterminado. Establezca su Credentials propiedad con un System.Net.NetworkCredential objeto que contenga el nombre de usuario y la contraseña.
  3. Crear la carpeta
    Cree la carpeta utilizando el constructor predeterminado para la ResourceCollection clase y pase los parámetros siguientes:
    • Un Id objeto, que se crea invocando el constructor predeterminado para la Id clase y se asigna al Resource campo id del objeto.
    • Un Lid objeto, que se crea invocando el constructor predeterminado para la Lid clase y se asigna al Resource campo lid del objeto.
    • Una cadena que contiene el nombre de la colección de recursos, que se asigna al Resource campo del name objeto. El nombre utilizado en este ejemplo es "testfolder" .
    • Una cadena que contiene la descripción de la colección de recursos, que se asigna al Resource campo del description objeto. La descripción utilizada en este ejemplo es "test folder" .
  4. Escribir la carpeta en el repositorio
    Invoque el RepositoryServiceService método del writeResource objeto y pase los parámetros siguientes:
    • Ruta de acceso donde se creará la carpeta.
    • El ResourceCollection objeto que representa la carpeta.
    • Pase null los otros dos parámetros.
Consulte también

Escritura de recursos

Puede crear recursos en una ubicación determinada del repositorio. El tamaño natural del archivo está sujeto a las limitaciones de la base de datos y al tiempo de espera de sesión. Para la configuración predeterminada, los archivos están limitados a 25 MB. Para aumentar o reducir el tamaño máximo del archivo, debe cambiar la configuración de la base de datos.
Escribir recursos equivale a almacenar datos en el repositorio. Una vez que se escribe un recurso en el repositorio, se hace accesible para todos los clientes del ecosistema del repositorio. Al escribir recursos en el repositorio, como esquemas XML, archivos XDP y archivos XSD, el contenido se analiza en función del tipo MIME. Si se admite el tipo MIME, el analizador determina si existe una relación implícita con otro contenido. Por ejemplo, si una hoja de estilo en cascada (CSS) tiene una URL relativa que hace referencia a una CSS común, se espera que también envíe la CSS común al repositorio. La relación entre los dos recursos se almacena como una relación pendiente durante un período no ajustable de 30 días. Cuando envía la CSS común al repositorio dentro del período de 30 días, se forma la relación.
Al crear un recurso, la lista de control de acceso (ACL) se hereda de la carpeta principal. La carpeta raíz tiene permisos de nivel de sistema hasta que se crea un recurso o una carpeta inicial, momento en el cual se otorgan permisos de ACL predeterminados al recurso o la carpeta.
Puede escribir recursos mediante programación mediante la API de Java del servicio Repositorio o la API de servicio Web.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para escribir un recurso, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Repositorio.
  3. Especifique el URI del recurso que se va a leer.
  4. Lea el recurso.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder leer un recurso mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Especifique el URI de la carpeta de destino del recurso
Cree una cadena que contenga el URI del recurso que se va a leer. La sintaxis incluye barras diagonales, como en este ejemplo: "/ path / folder ".
Crear el recurso
Invoque el método de servicio Repositorio para crear el recurso y rellene el recurso con información de identificación, incluido su UUID, nombre del recurso y descripción.
Especificar el contenido del recurso
Invoque el método de servicio Repositorio para crear contenido de recursos y almacenarlo en el recurso.
Escribir el recurso en la carpeta de destino
Invoque el método del servicio Repositorio para escribir el recurso, especificando el URI de la carpeta de destino.
Consulte también

Escribir recursos mediante la API de Java

Escriba un recurso mediante la API de servicio de repositorio (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Especifique el URI de la carpeta de destino del recurso
    Especifique el URI de la carpeta de destino del recurso. En este caso, como el recurso denominado testResource se almacenará en la carpeta denominada testFolder , el URI de la carpeta es "/testFolder" . El URI se almacena como un java.lang.String objeto.
  4. Crear el recurso
    Para crear un recurso, primero debe crear un com.adobe.repository.infomodel.bean.RepositoryInfomodelFactoryBean objeto.
    Invocar el RepositoryInfomodelFactoryBean método del newResource objeto, que crea un com.adobe.repository.infomodel.bean.Resource objeto. En este ejemplo, se proporcionan los siguientes parámetros:
    • Un com.adobe.repository.infomodel.Id objeto, que se crea invocando el constructor predeterminado de la Id clase.
    • Un com.adobe.repository.infomodel.Lid objeto, que se crea invocando el constructor predeterminado de la Lid clase.
    • Un java.lang.String archivo que contiene el nombre del recurso. Para especificar la descripción del recurso, invoque el Resource método del setDescription objeto y pase una cadena que contenga la descripción. En este ejemplo, la descripción es "test resource" .
  5. Especificar el contenido del recurso
    Para crear contenido para el recurso, invoque el RepositoryInfomodelFactoryBean método del newResourceContent objeto, que devuelve un com.adobe.repository.infomodel.bean.ResourceContent objeto. Agregue contenido al ResourceContent objeto. En este ejemplo, esto se logra realizando las siguientes tareas:
    • Invocación del ResourceContent método del setDataDocument objeto y transferencia de un com.adobe.idp.Document objeto
    • Invocación del ResourceContent método del setSize objeto y transferencia del tamaño en bytes del Document objeto Agregue el contenido al recurso invocando el Resource método del setContent objeto y pasando el ResourceContent objeto. Para obtener más información, consulte AEM Forms API Reference .
  6. Escribir el recurso en la carpeta de destino
    Invoque el ResourceRepositoryClient método del writeResource objeto y pase el URI de la carpeta, así como el Resource objeto.
Consulte también

Escribir recursos mediante la API de servicio web

Escriba un recurso mediante la API de servicio de repositorio (servicio Web):
  1. Incluir archivos de proyecto
    • Cree un ensamblado de cliente de Microsoft .NET que utilice el WSDL de repositorio mediante base64.
    • Haga referencia al ensamblado de cliente de Microsoft .NET.
  2. Crear el cliente de servicios
    Mediante el ensamblado de cliente de Microsoft .NET, cree un RepositoryServiceService objeto invocando su constructor predeterminado. Establezca su Credentials propiedad utilizando un System.Net.NetworkCredential objeto que contenga el nombre de usuario y la contraseña.
  3. Especifique el URI de la carpeta de destino del recurso
    Especifique el URI de la carpeta de destino del recurso. En este caso, como el recurso denominado testResource se almacenará en la carpeta denominada testFolder , el URI de la carpeta es "/testFolder" . Cuando utilice un idioma compatible con Microsoft .NET Framework (por ejemplo, C#), almacene el URI en un System.String objeto.
  4. Crear el recurso
    Para crear un recurso, invoque el constructor predeterminado de la Resource clase. En este ejemplo, la siguiente información se almacena en el Resource objeto:
    • Un com.adobe.repository.infomodel.Id objeto, que se crea invocando el constructor predeterminado para la Id clase y se asigna al Resource campo id del objeto.
    • Un com.adobe.repository.infomodel.Lid objeto, que se crea invocando el constructor predeterminado para la Lid clase y se asigna al Resource campo lid del objeto.
    • Una cadena que contiene el nombre de archivo del recurso, que se asigna al Resource campo del name objeto. El nombre utilizado en este ejemplo es "testResource" .
    • Una cadena que contiene la descripción del recurso, que se asigna al Resource campo del description objeto. La descripción utilizada en este ejemplo es "test resource" .
  5. Especificar el contenido del recurso
    Para crear contenido para el recurso, invoque el constructor predeterminado de la ResourceContent clase. A continuación, agregue contenido al ResourceContent objeto. En este ejemplo, esto se logra realizando las siguientes tareas:
    • Asignación de un BLOB objeto que contenga un documento al ResourceContent campo del dataDocument objeto.
    • Asignación del tamaño en bytes del BLOB objeto al ResourceContent campo del size objeto. Agregue el contenido al recurso asignando el ResourceContent objeto al Resource campo del content objeto.
  6. Escribir el recurso en la carpeta de destino
    Invoque el RepositoryServiceService método del writeResource objeto y pase el URI de la carpeta, así como el Resource objeto. Pase null los otros dos parámetros.
Consulte también

Recursos de listado

Puede descubrir recursos enumerando los recursos. Se realiza una consulta en el repositorio para encontrar todos los recursos relacionados con una colección de recursos determinada.
Una vez que haya organizado los recursos, podrá inspeccionar la estructura que ha creado al ver una rama concreta de la estructura, como lo haría en un sistema operativo.
Los recursos de listado funcionan según la relación: los recursos son miembros de carpetas. La afiliación está representada por una relación de tipo "miembro de". Cuando enumera los recursos en una carpeta determinada, realiza una consulta de los recursos relacionados con una carpeta determinada por el "miembro de" de la relación. Las relaciones son direccionales: un miembro de una relación tiene un origen que es miembro del objetivo. La fuente es el recurso; el destino es la carpeta principal.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para enumerar los recursos, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree el cliente de servicio.
  3. Especifique la ruta de la carpeta.
  4. Recupere la lista de recursos.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder crear una colección de recursos mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Especificar la ruta de la carpeta
Cree una cadena que contenga la ruta de la carpeta que contenga los recursos. La sintaxis incluye barras diagonales, como en este ejemplo: "/ path / folder ".
Recuperar la lista de recursos
Invocar el método de servicio Repositorio para recuperar la lista de recursos, especificando la ruta de la carpeta de destino.
Consulte también

Enumerar recursos mediante la API de Java

Enumere recursos mediante la API de servicio de Repositorio (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Especificar la ruta de la carpeta
    Especifique el URI de la colección de recursos que se va a consultar. En este caso, su URI es "/testFolder" . El URI se almacena como un java.lang.String objeto.
  4. Recuperar la lista de recursos
    Invoque el ResourceRepositoryClient método del listMembers objeto y pase el URI de la carpeta.
    El método devuelve un java.util.List conjunto de com.adobe.repository.infomodel.bean.Resource objetos que son el origen de un com.adobe.repository.infomodel.bean.Relation tipo Relation.TYPE_MEMBER_OF y que tienen el URI de colección de recursos como destino. Puede iterar a través de esto List para recuperar cada uno de los recursos. En este ejemplo, se muestra el nombre y la descripción de cada recurso.
Consulte también
Recursos de listado.

Enumerar recursos mediante la API de servicio Web

Enumere los recursos mediante la API de servicio Repositorio (servicio Web):
  1. Incluir archivos de proyecto
    • Cree un ensamblado de cliente de Microsoft .NET que utilice el WSDL de repositorio.
    • Haga referencia al ensamblado de cliente de Microsoft .NET.
  2. Crear el cliente de servicios
    Mediante el ensamblado de cliente de Microsoft .NET, cree un RepositoryServiceService objeto invocando su constructor predeterminado. Establezca su Credentials propiedad utilizando un System.Net.NetworkCredential objeto que contenga el nombre de usuario y la contraseña.
  3. Especificar la ruta de la carpeta
    Especifique una cadena que contenga el URI de la carpeta que se va a consultar. En este caso, su URI es "/testFolder" . Cuando utilice un idioma compatible con Microsoft .NET Framework (por ejemplo, C#), almacene el URI en un System.String objeto.
  4. Recuperar la lista de recursos
    Invoque el RepositoryServiceService método del listMembers objeto y pase el URI de la carpeta como el primer parámetro. Pase null los otros dos parámetros.
    El método devuelve una matriz de objetos que se pueden convertir en Resource objetos. Puede iterar por la matriz de objetos para recuperar cada uno de los recursos relacionados. En este ejemplo, se muestra el nombre y la descripción de cada recurso.
Consulte también
Recursos de listado.

Lectura de recursos

Puede recuperar recursos de una ubicación determinada del repositorio para leer su contenido y metadatos. El flujo de trabajo es un formulario de inicialización. El proceso tiene todos los permisos necesarios para leer el formulario. El sistema recupera el formulario de datos y lee el contenido del repositorio. El repositorio otorga acceso al contenido y a los metadatos (la capacidad de saber si el recurso existe).
El repositorio tiene los cuatro tipos de permisos siguientes:
  • traverse : le permite enumerar recursos; es decir, para leer metadatos de recursos, pero no contenido de recursos
  • lea : le permite leer contenido de recursos
  • escribir : le permite escribir contenido de recursos
  • administración de listas de control de acceso (ACL) : le permite manipular las ACL en los recursos
Los usuarios solo pueden ejecutar procesos cuando tienen permiso para ejecutar el proceso. Los usuarios de IDE necesitan permisos de lectura y travesía para sincronizar con el repositorio. Las ACL solo se aplican en tiempo de diseño porque el tiempo de ejecución se produce en el contexto del sistema.
Puede leer recursos mediante programación mediante la API de Java del servicio Repositorio o la API de servicio Web.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para leer un recurso, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Repositorio.
  3. Especifique el URI del recurso que se va a leer.
  4. Lea el recurso.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder leer un recurso mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Especifique el URI del recurso que se va a leer
Cree una cadena que contenga el URI del recurso que se va a leer. La sintaxis incluye barras diagonales, como en este ejemplo: "/ path / resource ".
Leer el recurso
Invoque el método del servicio Repositorio para leer el recurso, especificando el URI.
Consulte también

Leer recursos mediante la API de Java

Lea un recurso mediante la API de servicio de repositorio (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Especifique el URI del recurso que se va a leer
    Especifique un valor de cadena que represente el URI del recurso que se va a recuperar. Por ejemplo, suponiendo que el recurso se llame testResource , que se encuentra en una carpeta denominada testFolder , especifique /testFolder/testResource .
  4. Leer el recurso
    Invoque el ResourceRepositoryClient método del readResource objeto y pase el URI del recurso como parámetro. Este método devuelve una Resource instancia que representa el recurso.
Consulte también

Lectura de recursos mediante la API de servicio web

Lea un recurso mediante la API de servicio Repositorio (servicio Web):
  1. Incluir archivos de proyecto
  2. Crear el cliente de servicios
    Mediante el ensamblado de cliente de Microsoft .NET, cree un RepositoryServiceService objeto invocando su constructor predeterminado. Establezca su Credentials propiedad utilizando un System.Net.NetworkCredential objeto que contenga el nombre de usuario y la contraseña.
  3. Especifique el URI del recurso que se va a leer
    Especifique una cadena que contenga el URI del recurso que se va a recuperar. En este caso, como el recurso denominado testResource está en la carpeta denominada testFolder , su URI es "/testFolder/testResource" . Cuando utilice un idioma compatible con Microsoft .NET Framework (por ejemplo, C#), almacene el URI en un System.String objeto.
  4. Leer el recurso
    Invoque el RepositoryServiceService método del readResource objeto y pase el URI del recurso como el primer parámetro. Pase null los otros dos parámetros.
Consulte también

Actualización de recursos

Puede recuperar y actualizar el contenido de los recursos en el repositorio. Al actualizar los recursos, el control de acceso a esos recursos permanece sin cambios entre las versiones. Al realizar una actualización, tiene la opción de incrementar la versión principal. Si no decide incrementar la versión principal, la versión secundaria se actualiza automáticamente.
Al actualizar un recurso, la nueva versión se crea en función de los atributos de recurso especificados. Al actualizar un recurso, se especifican dos parámetros importantes: el URI de destino y una instancia de recurso que contiene todos los metadatos actualizados. Es importante tener en cuenta que si no cambia un atributo determinado (por ejemplo, el nombre), el atributo seguirá siendo necesario en la instancia que pase. Las relaciones que se crean al analizar el contenido se agregan a la versión específica y no se presentan a menos que se especifique.
Por ejemplo, si actualiza un archivo XDP y contiene referencias a otros recursos, también se registrarán esas referencias adicionales. Supongamos que form.xdp versión 1.0 tiene dos referencias externas: un logotipo y una hoja de estilo, y posteriormente se actualiza form.xdp para que ahora tenga tres referencias: un logotipo, una hoja de estilo y un archivo de esquema. Durante la actualización, el repositorio agregará la tercera relación (al archivo de esquema) a su tabla de relación pendiente. Una vez que el archivo de esquema esté presente en el repositorio, la relación se formará automáticamente. Sin embargo, si form.xdp versión 2.0 ya no utiliza el logotipo, la versión 2.0 de form.xdp no tendrá relación con el logotipo.
Todas las operaciones de actualización son atómicas y transaccionales. Por ejemplo, si dos usuarios leen el mismo recurso y ambos deciden actualizar la versión 1.0 a la versión 2.0, uno de ellos se realizará correctamente y uno de ellos fallará, se mantendrá la integridad del repositorio y ambos obtendrán un mensaje que confirme el éxito o el error. Si la transacción no se confirma, se reenviará en caso de error en la base de datos y se agotará el tiempo de espera o se revirtirá en función del servidor de aplicaciones.
Puede actualizar los recursos mediante programación mediante la API de Java del servicio Repositorio o la API de servicio Web.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para actualizar un recurso, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Repositorio.
  3. Recupere el recurso que se va a actualizar.
  4. Actualice el recurso.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder leer un recurso mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Recuperar el recurso que se va a actualizar
Lea el recurso. Para obtener más información, consulte Leer recursos .
Actualizar el recurso
Configure la nueva información en el recurso e invoque el método de servicio Repositorio para actualizar el recurso, especificando el URI, el recurso actualizado y cómo se debe actualizar la información de la versión.
Consulte también

Actualización de recursos mediante la API de Java

Actualice un recurso mediante la API del servicio Repositorio (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Recuperar el recurso que se va a actualizar
    Especifique el URI del recurso para recuperarlo y leerlo. En este ejemplo, el URI del recurso es "/testFolder/testResource" .
  4. Actualizar el recurso
    Actualice la información del Resource objeto. En este ejemplo, para actualizar la descripción, invoque el Resource método del setDescription objeto y pase la nueva cadena de descripción como parámetro.
    A continuación, invoque el ServiceClientFactory método updateResource del objeto y pase los parámetros siguientes:
    • Un java.lang.String objeto que contiene el URI del recurso.
    • El Resource objeto que contiene la información de recurso actualizada.
    • Un boolean valor que indica si se debe actualizar la versión principal o la secundaria. En este ejemplo, se pasa un valor de true para indicar que se va a incrementar la versión principal.
Consulte también

Actualización de recursos mediante la API de servicio web

Actualice un recurso mediante la API de repositorio (servicio Web):
  1. Incluir archivos de proyecto
    • Cree un ensamblado de cliente de Microsoft .NET que utilice el WSDL de repositorio.
    • Haga referencia al ensamblado de cliente de Microsoft .NET.
  2. Crear el cliente de servicios
    Mediante el ensamblado de cliente de Microsoft .NET, cree un RepositoryServiceService objeto invocando su constructor predeterminado. Establezca su Credentials propiedad utilizando un System.Net.NetworkCredential objeto que contenga el nombre de usuario y la contraseña.
  3. Recuperar el recurso que se va a actualizar
    Especifique el URI del recurso que se va a recuperar y lea el recurso. En este ejemplo, el URI del recurso es "/testFolder/testResource" . Para obtener más información, consulte Leer recursos .
  4. Actualizar el recurso
    Actualice la información del Resource objeto. En este ejemplo, para actualizar la descripción, asigne un nuevo valor al Resource campo del description objeto.
  5. Invoque el RepositoryServiceService método updateResource del objeto y pase los parámetros siguientes:
    • Un System.String objeto que contiene el URI del recurso.
    • El Resource objeto que contiene la información de recurso actualizada.
    • Un boolean valor que indica si se debe actualizar la versión principal o la secundaria. En este ejemplo, se pasa un valor de true para indicar que se va a incrementar la versión principal.
    • Pase null los dos parámetros restantes.
Consulte también

Búsqueda de recursos

Puede crear consultas utilizadas para buscar recursos en el repositorio, incluido el historial, los recursos relacionados y las propiedades.
Puede recuperar recursos relacionados para determinar las dependencias entre un formulario y sus fragmentos. Por ejemplo, si tiene un formulario, puede determinar qué fragmentos o recursos externos utiliza. Si tiene una imagen, también puede averiguar qué formularios utilizan la imagen. También puede buscar recursos relacionados mediante el filtrado basado en propiedades. Por ejemplo, puede buscar todos los formularios que utilicen una imagen con un nombre especificado o buscar cualquier imagen utilizada por un formulario con un nombre especificado. También puede realizar búsquedas con propiedades de recurso. Por ejemplo, puede realizar una consulta para buscar todos los formularios o recursos cuyo nombre comience con una cadena determinada que pueda incluir caracteres comodín de ’%’ y ’_. Recuerde que las búsquedas basadas en propiedades no se basan en relaciones; estas búsquedas se basan en la suposición de que tiene conocimientos específicos sobre un recurso determinado.
Instrucciones de consulta
Una consulta contiene una o más afirmaciones que se unen lógicamente con condiciones. Una instrucción consta de un operando izquierdo, un operador y un operando derecho. Además, puede especificar el orden que se usará para los resultados de búsqueda. El orden ORDER BY contiene información equivalente a una cláusula SQL y está compuesto por elementos que contienen los atributos en los que se basó la búsqueda, así como un valor que indica si se va a utilizar el orden ascendente o descendente.
Puede buscar recursos mediante programación mediante la API de Java del servicio Repositorio. En este momento, no es posible utilizar la API de servicio Web para buscar recursos.
Comportamiento de ordenación
El orden no se respeta al invocar el ResourceRepositoryClient método searchProperties del objeto y especificar un orden. Por ejemplo, supongamos que crea un recurso con tres propiedades personalizadas, donde los nombres de atributo son name , secondName y asecondName . A continuación, se crea un elemento de orden de clasificación en el nombre del atributo y se establece el ascending valor en true .
A continuación, invoque el ResourceRepositoryClient método searchProperties del objeto y pase el orden. La búsqueda devuelve el recurso correcto, con las tres propiedades. Sin embargo, las propiedades no se ordenan por nombre de atributo. Se devuelven en el orden en que se añadieron: name , secondName , y asecondName .
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para buscar recursos, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Repositorio.
  3. Especifique la carpeta de destino para la búsqueda.
  4. Especifique los atributos utilizados en la búsqueda.
  5. Cree la consulta utilizada en la búsqueda.
  6. Cree el orden para los resultados de la búsqueda.
  7. Busque los recursos.
  8. Recupere los recursos del resultado de búsqueda.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder leer un recurso mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Especifique la carpeta de destino para la búsqueda
Cree una cadena que contenga la ruta de acceso base desde la cual realizar la búsqueda. La sintaxis incluye barras diagonales, como en este ejemplo: "/ path / folder ".
Especifique los atributos utilizados en la búsqueda
Puede basar la búsqueda en los atributos contenidos dentro de los recursos. Especifique los valores de los atributos en los que se realizará la búsqueda.
Crear la consulta utilizada en la búsqueda
Construya una consulta mediante instrucciones y condiciones. Cada instrucción especificará el atributo en el que se basará la búsqueda, la condición que se utilizará y el valor de atributo que se utilizará en la búsqueda.
Crear el orden para los resultados de búsqueda
El orden de clasificación consta de elementos, cada uno de los cuales contiene uno de los atributos utilizados en la búsqueda y un valor que indica si se va a utilizar el orden ascendente o descendente.
Buscar recursos
Busque los recursos utilizando la carpeta, la consulta y el orden de clasificación. Además, indique la profundidad de la búsqueda y un límite superior en el número de resultados que se van a devolver.
Recuperar los recursos del resultado de búsqueda
Repita la lista de recursos devueltos y extraiga la información para su posterior procesamiento.
Consulte también

Buscar recursos con la API de Java

Busque un recurso mediante la API de servicio Repositorio (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Especifique la carpeta de destino para la búsqueda
    Especifique el URI de la ruta de acceso base desde la que se ejecutará la búsqueda. En este ejemplo, el URI del recurso es /testFolder .
  4. Especifique los atributos utilizados en la búsqueda
    Especifique los valores de los atributos en los que se realizará la búsqueda. Los atributos existen dentro de un com.adobe.repository.infomodel.bean.Resource objeto. En este ejemplo, la búsqueda se realizará en el atributo name; por lo tanto, se utiliza un java.lang.String que contiene el nombre del Resource objeto, que es testResource en este caso.
  5. Crear la consulta utilizada en la búsqueda
    Para crear una consulta, cree un com.adobe.repository.query.Query objeto invocando el constructor predeterminado para la Query clase y agregue sentencias a la consulta.
    Para crear una instrucción, invoque el constructor para la com.adobe.repository.query.Query.Statement clase y pase los parámetros siguientes:
    • Operando izquierdo que contiene la constante de atributo de recurso. En este ejemplo, como el nombre del recurso se utiliza como base para la búsqueda, Resource.ATTRIBUTE_NAME se utiliza el valor estático.
    • Operador que contiene la condición utilizada en la búsqueda del atributo. El operador debe ser una de las constantes estáticas de la Query.Statement clase. En este ejemplo, se Query.Statement.OPERATOR_BEGINS_WITH utiliza el valor estático.
    • Operando derecho que contiene el valor de atributo en el que se realizará la búsqueda. En este ejemplo, se utiliza el atributo name, que String contiene el valor "testResource" . Especifique el espacio de nombres del operando izquierdo invocando el Query.Statement método setNamespace del objeto y pasando uno de los valores estáticos contenidos en la com.adobe.repository.infomodel.bean.ResourceProperty clase. En este ejemplo, ResourceProperty.RESERVED_NAMESPACE_REPOSITORY se utiliza.
    Agregue cada instrucción a la consulta invocando el Query método del addStatement objeto y pasando el Query.Statement objeto.
  6. Crear el orden para los resultados de búsqueda
    Para especificar el orden utilizado en los resultados de búsqueda, cree un com.adobe.repository.query.sort.SortOrder objeto invocando el constructor predeterminado de la SortOrder clase y agregue elementos al orden de clasificación.
    Para crear un elemento para el orden de clasificación, invoque uno de los constructores para la com.adobe.repository.query.sort.SortOrder.Element clase. En este ejemplo, como el nombre del recurso se utiliza como base para la búsqueda, el valor estático Resource.ATTRIBUTE_NAME se utiliza como primer parámetro y el orden ascendente (un boolean valor de true ) se especifica como segundo parámetro.
    Agregue cada elemento al orden invocando el SortOrder método del addSortElement objeto y pasando el SortOrder.Element objeto.
  7. Buscar recursos
    Para buscar resources en función de las propiedades de atributo, invoque el ResourceRepositoryClient método searchProperties del objeto y pase los siguientes parámetros:
    • Un String que contiene la ruta de acceso base desde la cual ejecutar la búsqueda. En este caso, "/testFolder" se utiliza.
    • Consulta utilizada en la búsqueda.
    • Profundidad de la búsqueda. En este caso, com.adobe.repository.infomodel.bean.ResourceCollection.DEPTH_INFINITE se utiliza para indicar que se utilizarán la ruta de acceso base y todas sus carpetas.
    • Un int valor que indica la primera fila desde la que se selecciona el conjunto de resultados sin paginar. En este ejemplo, 0 se especifica.
    • Un int valor que indica el número máximo de resultados que se van a devolver. En este ejemplo, 10 se especifica.
    • Orden utilizado en la búsqueda. El método devuelve un java.util.List conjunto de Resource objetos en el orden de clasificación especificado.
  8. Recuperar los recursos del resultado de búsqueda
    Para recuperar los recursos contenidos en el resultado de la búsqueda, repita el proceso List y convierta cada objeto en un objeto Resource para extraer su información. En este ejemplo, se muestra el nombre de cada recurso.
Consulte también

Creación de relaciones de recursos

Puede especificar relaciones entre los recursos del repositorio. Existen tres tipos de relaciones:
  • Dependencia : una relación en la que un recurso depende de otros recursos, lo que significa que todos los recursos relacionados son necesarios en el repositorio.
  • Membresía (sistema de archivos) : una relación en la que un recurso se encuentra dentro de una carpeta determinada.
  • Personalizado : una relación que se especifica entre los recursos. Por ejemplo, si un recurso se ha desaprobado y otro se ha introducido en el repositorio, puede especificar su propia relación de reemplazo.
Puede crear sus propias relaciones personalizadas. Por ejemplo, si almacena un archivo HTML en el repositorio y utiliza una imagen, puede especificar una relación personalizada para relacionar el archivo HTML con la imagen (ya que normalmente solo los archivos XML se asocian con imágenes mediante una relación de dependencia definida por el repositorio). Otro ejemplo de relación personalizada sería si desea generar una vista diferente del repositorio con una estructura de gráfico cíclica en lugar de una estructura de árbol. Puede definir un gráfico circular junto con un visor para recorrer esas relaciones. Por último, puede indicar que un recurso reemplaza a otro aunque los dos recursos sean completamente diferentes. En ese caso, puede definir un tipo de relación fuera del rango reservado y crear una relación entre esos dos recursos. Su aplicación sería el único cliente que podría detectar y procesar la relación, y podría utilizarse para realizar búsquedas en esa relación.
Puede especificar mediante programación las relaciones entre los recursos mediante la API de Java del servicio Repositorio o la API de servicio Web.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para especificar una relación entre dos recursos, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Repositorio.
  3. Especifique los URI de los recursos que se van a relacionar.
  4. Cree la relación.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder leer un recurso mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Especifique los URI de los recursos que se van a relacionar
Cree cadenas que contengan los URI del recurso que se va a relacionar. La sintaxis incluye barras diagonales, como en este ejemplo: "/ path / resource ".
Crear la relación
Invoque el método de servicio Repositorio para crear y especificar el tipo de relación.
Consulte también

Creación de recursos de relación mediante la API de Java

Cree recursos de relación mediante la API de Java del servicio Repositorio, lleve a cabo las siguientes tareas:
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Especifique los URI de los recursos que se van a relacionar
    Especifique los URI de los recursos que se van a relacionar. En este caso, dado que los recursos se nombran testResource1 y testResource2 y se encuentran en la carpeta denominada testFolder , sus URI son "/testFolder/testResource1" y "/testFolder/testResource2" . Los URI se almacenan como java.lang.String objetos. En este ejemplo, los recursos se escriben primero en el repositorio y se recuperan sus URI. Para obtener más información sobre cómo escribir un recurso, consulte Escritura de recursos .
  4. Crear la relación
    Invoque el ResourceRepositoryClient método del createRelationship objeto y pase los parámetros siguientes:
    • URI del recurso de origen.
    • URI del recurso de destino.
    • El tipo de relación, que es una de las constantes estáticas de la com.adobe.repository.infomodel.bean.Relation clase. En este ejemplo, se establece una relación de dependencia especificando el valor Relation.TYPE_DEPENDANT_OF .
    • Un boolean valor que indica si el recurso de destino se actualiza automáticamente al identificador com.adobe.repository.infomodel.Id basado en el nuevo recurso principal. En este ejemplo, debido a la relación de dependencia, se especifica el valor true . También puede recuperar una lista de recursos relacionados para un recurso determinado invocando el ResourceRepositoryClient método getRelated del objeto y pasando los parámetros siguientes:
    • URI del recurso para el que se recuperan los recursos relacionados. En este ejemplo, se especifica el recurso de origen ( "/testFolder/testResource1" ).
    • Un boolean valor que indica si el recurso especificado es el recurso de origen de la relación. En este ejemplo, el valor true se especifica porque así es.
    • El tipo de relación, que es una de las constantes estáticas de la Relation clase. En este ejemplo, se especifica una relación de dependencia utilizando el mismo valor utilizado anteriormente: Relation.TYPE_DEPENDANT_OF . El getRelated método devuelve un java.util.List conjunto de Resource objetos a través de los cuales se puede iterar para recuperar cada uno de los recursos relacionados, convirtiendo los objetos contenidos en el List en Resource al hacerlo. En este ejemplo, testResource2 se espera que esté en la lista de recursos devueltos.
Consulte también

Creación de recursos de relación mediante la API de servicio web

Cree recursos de relación mediante la API de repositorio (servicio Web):
  1. Incluir archivos de proyecto
    • Cree un ensamblado de cliente de Microsoft .NET que utilice el WSDL de repositorio.
    • Haga referencia al ensamblado de cliente de Microsoft .NET.
  2. Crear el cliente de servicios
    Mediante el ensamblado de cliente de Microsoft .NET, cree un RepositoryServiceService objeto invocando su constructor predeterminado. Establezca su Credentials propiedad utilizando un System.Net.NetworkCredential objeto que contenga el nombre de usuario y la contraseña.
  3. Especifique los URI de los recursos que se van a relacionar
    Especifique los URI de los recursos que se van a relacionar. En este caso, dado que los recursos se nombran testResource1 y testResource2 y se encuentran en la carpeta denominada testFolder , sus URI son "/testFolder/testResource1" y "/testFolder/testResource2" . Cuando se utiliza un idioma compatible con Microsoft .NET Framework (por ejemplo, C#), los URI se almacenan como System.String objetos. En este ejemplo, los recursos se escriben primero en el repositorio y se recuperan sus URI. Para obtener más información sobre cómo escribir un recurso, consulte Escritura de recursos .
  4. Crear la relación
    Invoque el RepositoryServiceService método del createRelationship objeto y pase los parámetros siguientes:
    • URI del recurso de origen.
    • URI del recurso de destino.
    • Tipo de relación. En este ejemplo, se establece una relación de dependencia especificando el valor 3 .
    • Un boolean valor que indica si se especificó el tipo de relación. En este ejemplo, se especifica el valor true .
    • Un boolean valor que indica si el recurso de destino se actualiza automáticamente al identificador Id basado en el nuevo recurso principal. En este ejemplo, debido a la relación de dependencia, se especifica el valor true .
    • Un boolean valor que indica si se especificó el encabezado de destino. En este ejemplo, se especifica el valor true .
    • Pasa null el último parámetro. También puede recuperar una lista de recursos relacionados para un recurso determinado invocando el RepositoryServiceService método getRelated del objeto y pasando los parámetros siguientes:
    • URI del recurso para el que se recuperan los recursos relacionados. En este ejemplo, se especifica el recurso de origen ( "/testFolder/testResource1" ).
    • Un boolean valor que indica si el recurso especificado es el recurso de origen de la relación. En este ejemplo, el valor true se especifica porque así es.
    • Un boolean valor que indica si se especificó el recurso de origen. En este ejemplo, se true proporciona el valor.
    • Matriz de enteros que contiene los tipos de relación. En este ejemplo, se especifica una relación de dependencia utilizando el mismo valor en la matriz que se utilizó anteriormente: 3 .
    • Pase null los dos parámetros restantes. El getRelated método devuelve una matriz de objetos que se pueden convertir en Resource objetos a través de los cuales se puede iterar para recuperar cada uno de los recursos relacionados. En este ejemplo, testResource2 se espera que esté en la lista de recursos devueltos.
Consulte también

Bloqueo de recursos

Puede bloquear un recurso o conjunto de recursos para su uso exclusivo por un usuario en particular o para uso compartido entre más de un usuario. Un bloqueo compartido indica que algo va a suceder con el recurso, pero no impide que nadie más actúe con ese recurso. Un bloqueo compartido debe considerarse un mecanismo de señalización. Un bloqueo exclusivo significa que el usuario que bloqueó el recurso va a cambiar el recurso y el bloqueo garantiza que nadie más pueda hacerlo hasta que el usuario ya no necesite acceder al recurso y haya liberado el bloqueo. Si un administrador de repositorio desbloquea un recurso, se eliminarán automáticamente todos los bloqueos exclusivos y compartidos de ese recurso. Este tipo de acción está pensado para situaciones en las que un usuario ya no está disponible y no ha desbloqueado el recurso.
Cuando un recurso está bloqueado, aparece un icono de candado al ver la ficha Recursos ubicada en Workbench, como se muestra en la siguiente ilustración.
Puede controlar mediante programación el acceso a los recursos mediante la API de Java del servicio Repositorio o la API de servicio Web.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para bloquear y desbloquear recursos, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Repositorio.
  3. Especifique el URI del recurso que se va a bloquear.
  4. Bloquear el recurso.
  5. Recupere los bloqueos del recurso.
  6. Desbloquear el recurso
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder leer un recurso mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Especifique el URI del recurso que se va a bloquear
Cree una cadena que contenga el URI del recurso que se va a bloquear. La sintaxis incluye barras diagonales, como en este ejemplo: "/ path / resource ".
Bloquear el recurso
Invoque el método de servicio Repositorio para bloquear el recurso, especificando el URI, el tipo de bloqueo y la profundidad de bloqueo.
Recuperar los bloqueos del recurso
Invoque el método de servicio Repositorio para recuperar los bloqueos del recurso, especificando el URI.
Desbloquear el recurso
Invocar el método del servicio Repositorio para desbloquear el recurso, especificando el URI.
Consulte también

Bloquear recursos con la API de Java

Bloquear recursos mediante la API del servicio Repositorio (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Especifique el URI del recurso que se va a bloquear
    Especifique el URI del recurso que se va a bloquear. En este caso, como el recurso denominado testResource está en la carpeta denominada testFolder , su URI es "/testFolder/testResource" . El URI se almacena como un java.lang.String objeto.
  4. Bloquear el recurso
    Invoque el ResourceRepositoryClient método del lockResource objeto y pase los parámetros siguientes:
    • URI del recurso.
    • Ámbito de bloqueo. En este ejemplo, como el recurso se bloqueará para uso exclusivo, el ámbito de bloqueo se especifica como com.adobe.repository.infomodel.bean.Lock.SCOPE_EXCLUSIVE .
    • Profundidad de bloqueo. En este ejemplo, dado que el bloqueo se aplicará únicamente al recurso concreto y a ninguno de sus miembros o elementos secundarios, la profundidad de bloqueo se especifica como Lock.DEPTH_ZERO .
    La versión sobrecargada del lockResource método que requiere cuatro parámetros emite una excepción. Asegúrese de utilizar el lockResource método que requiere tres parámetros, como se muestra en este tutorial.
  5. Recuperar los bloqueos del recurso
    Invoque el ResourceRepositoryClient método del getLocks objeto y pase el URI del recurso como parámetro. El método devuelve una lista de objetos Lock a través de la cual se puede iterar. En este ejemplo, el propietario del bloqueo, la profundidad y el ámbito se imprimen para cada objeto invocando los métodos getOwnerUserId , getDepth y getType del objeto Lock, respectivamente.
  6. Desbloquear el recurso
    Invoque el ResourceRepositoryClient método del unlockResource objeto y pase el URI del recurso como parámetro. Para obtener más información, consulte la Referencia de la API de AEM Forms .
Consulte también

Bloquear recursos mediante la API de servicio web

Bloquear recursos mediante la API de servicio Repositorio (servicio Web):
  1. Incluir archivos de proyecto
    • Cree un ensamblado de cliente de Microsoft .NET que utilice el WSDL de repositorio mediante Base64.
    • Haga referencia al ensamblado de cliente de Microsoft .NET.
  2. Crear el cliente de servicios
    Mediante el ensamblado de cliente de Microsoft .NET, cree un RepositoryServiceService objeto invocando su constructor predeterminado. Establezca su Credentials propiedad utilizando un System.Net.NetworkCredential objeto que contenga el nombre de usuario y la contraseña.
  3. Especifique el URI del recurso que se va a bloquear
    Especifique una cadena que contenga el URI del recurso que se va a bloquear. En este caso, como el recurso denominado testResource está en la carpeta testFolder , su URI es "/testFolder/testResource" . Cuando utilice un idioma compatible con Microsoft .NET Framework (por ejemplo, C#), almacene el URI en un System.String objeto.
  4. Bloquear el recurso
    Invoque el RepositoryServiceService método del lockResource objeto y pase los parámetros siguientes:
    • URI del recurso.
    • Ámbito de bloqueo. En este ejemplo, como el recurso se bloqueará para uso exclusivo, el ámbito de bloqueo se especifica como 11 .
    • Profundidad de bloqueo. En este ejemplo, dado que el bloqueo se aplicará únicamente al recurso concreto y a ninguno de sus miembros o elementos secundarios, la profundidad de bloqueo se especifica como 2 .
    • Un int valor que indica el número de segundos hasta que caduca el bloqueo. En este ejemplo, se utiliza el valor de 1000 .
    • Pasa null el último parámetro.
  5. Recuperar los bloqueos del recurso
    Invoque el RepositoryServiceService método del getLocks objeto y pase el URI del recurso como el primer parámetro y null para el segundo. El método devuelve una object matriz que contiene Lock objetos a través de los cuales se puede iterar. En este ejemplo, el propietario del bloqueo, la profundidad y el ámbito se imprimen para cada objeto mediante el acceso a los Lock campos ownerUserId , depth y type de cada objeto, respectivamente.
  6. Desbloquear el recurso
    Invoque el RepositoryServiceService método del unlockResource objeto y pase el URI del recurso como el primer parámetro y null para el segundo.
Consulte también

Eliminación de recursos

Puede eliminar recursos mediante programación desde una ubicación determinada del repositorio mediante la API de Java (SOAP) del servicio Repositorio.
Cuando elimina un recurso, la eliminación es normalmente permanente, aunque en algunos casos los repositorios de ECM pueden almacenar las versiones del recurso según sus mecanismos de historial. Por lo tanto, al eliminar un recurso, es importante asegurarse de que nunca más necesitará ese recurso. Los motivos comunes para eliminar un recurso incluyen la necesidad de aumentar el espacio disponible en la base de datos. Puede eliminar una versión de un recurso, pero si lo hace, debe especificar el identificador de recurso y no su identificador lógico (LID) o ruta. Si elimina una carpeta, todo lo que contenga, incluidas las subcarpetas y los recursos, se eliminará automáticamente.
Los recursos relacionados no se eliminan. Por ejemplo, si tiene un formulario que utiliza el archivo logo.gif y elimina logo.gif, se almacenará una relación en la tabla de relación pendiente. Como alternativa, para la desaprobación de versiones, establezca el estado del objeto de la última versión en desaprobado.
Una operación de eliminación no es segura para las transacciones en los sistemas ECM. Por ejemplo, si intenta eliminar 100 recursos y la operación falla en el recurso número 50, se eliminarán las primeras 49 instancias pero el resto no. De lo contrario, el comportamiento predeterminado es rollback (no compromiso).
Al utilizar el com.adobe.repository.bindings.dsc.client.ResourceRepositoryClient.deleteResources() método con el repositorio de ECM (Content Server de Documentum de EMC y IBM FileNet P8 Content Manager), la transacción no se revertirá si se produce un error en la eliminación de uno de los recursos especificados, lo que significa que los archivos que se han eliminado no se pueden eliminar.
Para obtener más información sobre el servicio Repositorio, consulte Referencia de servicios para AEM Forms .

Resumen de los pasos

Para eliminar un recurso, siga estos pasos:
  1. Incluir archivos de proyecto.
  2. Cree un cliente de servicio Repositorio.
  3. Especifique el URI del recurso que se va a eliminar.
  4. Elimine el recurso.
Incluir archivos de proyecto
Incluya los archivos necesarios en el proyecto de desarrollo. Si va a crear una aplicación cliente mediante Java, incluya los archivos JAR necesarios. Si utiliza servicios Web, incluya los archivos proxy.
Crear el cliente de servicios
Para poder leer un recurso mediante programación, debe establecer una conexión y proporcionar credenciales. Esto se logra creando un cliente de servicio.
Especifique el URI del recurso que se va a eliminar
Cree una cadena que contenga el URI del recurso que se va a eliminar. La sintaxis incluye barras diagonales, como en este ejemplo: "/ path / resource ". Si el recurso que se va a eliminar es una carpeta, la eliminación será recursiva.
Eliminar el recurso
Invoque el método del servicio Repositorio para eliminar el recurso, especificando el URI.
Consulte también

Eliminar recursos con la API de Java (SOAP)

Elimine un recurso mediante la API de repositorio (Java):
  1. Incluir archivos de proyecto
    Incluya archivos JAR de cliente en la ruta de clases del proyecto Java.
  2. Crear el cliente de servicios
    Cree un ResourceRepositoryClient objeto utilizando su constructor y pasando un ServiceClientFactory objeto que contenga propiedades de conexión.
  3. Especifique el URI del recurso que se va a eliminar
    Especifique el URI del recurso que se va a recuperar. En este caso, como el recurso llamado testResourceToBeDeleted está en la carpeta denominada testFolder, su URI es /testFolder/testResourceToBeDeleted . El URI se almacena como un java.lang.String objeto. En este ejemplo, el recurso se escribe primero en el repositorio y se recupera su URI. Para obtener más información sobre cómo escribir un recurso, consulte Escritura de recursos .
  4. Eliminar el recurso
    Invoque el ResourceRepositoryClient método del deleteResource objeto y pase el URI del recurso como parámetro.
Consulte también

Eliminar recursos mediante la API de servicio Web

Elimine un recurso mediante la API de repositorio (servicio Web):
  1. Incluir archivos de proyecto
    • Cree un ensamblado de cliente de Microsoft .NET que utilice el WSDL de repositorio mediante Base64.
    • Haga referencia al ensamblado de cliente de Microsoft .NET.
  2. Crear el cliente de servicios
    Mediante el ensamblado de cliente de Microsoft .NET, cree un RepositoryServiceService objeto invocando su constructor predeterminado. Establezca su Credentials propiedad utilizando un System.Net.NetworkCredential objeto que contenga el nombre de usuario y la contraseña.
  3. Especifique el URI del recurso que se va a eliminar
    Especifique el URI del recurso que se va a recuperar. En este caso, como el recurso denominado testResourceToBeDeleted está en la carpeta denominada testFolder , su URI es "/testFolder/testResourceToBeDeleted" . En este ejemplo, el recurso se escribe primero en el repositorio y se recupera su URI. Para obtener más información sobre cómo escribir un recurso, consulte Escritura de recursos .
  4. Eliminar el recurso
    Invoque el RepositoryServiceService método del deleteResources objeto y pase una System.String matriz que contenga el URI del recurso como el primer parámetro. Pase null el segundo parámetro.
Consulte también