Agregar extremos de EJB

Puede agregar mediante programación un extremo de EJB a un servicio mediante la API de Java de AEM Forms. Al agregar un extremo de EJB a un servicio, está habilitando una aplicación cliente para que invoque el servicio mediante el modo EJB. Es decir, al establecer las propiedades de conexión necesarias para invocar AEM Forms, puede seleccionar el modo EJB. (Consulte Establecimiento de propiedades de conexión.)

NOTA
No puede agregar un extremo de EJB mediante servicios web.
NOTA
Normalmente, se agrega un extremo EJB a un servicio de forma predeterminada. Sin embargo, se puede agregar un extremo EJB a un proceso implementado mediante programación o cuando se quita un extremo EJB y debe agregarse de nuevo.

Resumen de los pasos

Para agregar un extremo de EJB a un servicio, realice las siguientes tareas:

  1. Incluir archivos de proyecto.
  2. Crear un objeto EndpointRegistry Client.
  3. Establecer atributos de extremo de EJB.
  4. Cree un extremo de EJB.
  5. Habilite el extremo.

Incluir archivos de proyecto

Incluya los archivos necesarios en el proyecto de desarrollo. Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
  • jbossall-client.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)

Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.

Crear un objeto cliente EndpointRegistry

Para poder agregar mediante programación un extremo de EJB, debe crear un objeto EndpointRegistryClient.

Establecer atributos de extremo de EJB

Para crear un extremo de EJB para un servicio, especifique los siguientes valores:

  • Identificador de conector: Especifica el tipo de extremo que se va a crear. Para crear un extremo de EJB, especifique EJB.
  • Descripción: especifica la descripción del extremo.
  • Nombre: especifica el nombre del extremo.
  • Identificador de servicio: Especifica el servicio al que pertenece el extremo.
  • Nombre de operación: especifica el nombre de la operación que se invoca mediante el extremo. Al crear un extremo de EJB, especifique un carácter comodín ( *). Sin embargo, si desea especificar una operación específica en lugar de invocar todas las operaciones de servicio, especifique el nombre de la operación en lugar de utilizar el carácter comodín ( *).

Crear un extremo EJB

Después de establecer los atributos de extremo de EJB, puede crear un extremo de EJB para un servicio.

Habilitar el extremo

Después de crear un extremo, debe habilitarlo. Después de habilitar el punto de conexión, se puede utilizar para invocar el servicio. Después de habilitar el punto de conexión, puede verlo en la consola de administración.

Consulte también

Agregar un extremo EJB mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Agregar un extremo EJB mediante la API de Java

Agregar un extremo de EJB mediante la API de Java:

  1. Incluir archivos de proyecto.

    Incluya archivos JAR de cliente, como adobe-livecycle-client.jar, en la ruta de clase del proyecto Java. (

  2. Cree un objeto EndpointRegistry Client.

    • Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
    • Cree un objeto EndpointRegistryClient utilizando su constructor y pasando el objeto ServiceClientFactory.
  3. Establecer atributos de extremo de EJB.

    • Crear un objeto CreateEndpointInfo mediante su constructor.
    • Especifique el valor del identificador del conector invocando el método setConnectorId del objeto CreateEndpointInfo y pasando el valor de cadena EJB.
    • Especifique la descripción del extremo invocando el método setDescription del objeto CreateEndpointInfo y pasando un valor de cadena que describe el extremo.
    • Especifique el nombre del extremo invocando el método setName del objeto CreateEndpointInfo y pasando un valor de cadena que especifique el nombre.
    • Especifique el servicio al que pertenece el extremo invocando el método setServiceId del objeto CreateEndpointInfo y pasando un valor de cadena que especifica el nombre del servicio.
    • Especifique la operación que se invoca invocando el método setOperationName del objeto CreateEndpointInfo y pase un valor de cadena que especifique el nombre de la operación. SOAP Para los extremos de EJB y de la, especifique un carácter comodín ( *), que implica todas las operaciones.
  4. Cree un extremo de EJB.

    Cree el extremo invocando el método createEndpoint del objeto EndpointRegistryClient y pasando el objeto CreateEndpointInfo. Este método devuelve un objeto Endpoint que representa el nuevo extremo de EJB.

  5. Habilite el extremo.

    Habilite el extremo invocando el método enable del objeto EndpointRegistryClient y pasando el objeto Endpoint devuelto por el método createEndpoint.

SOAP Adición de extremos de

SOAP Mediante programación, puede agregar un extremo de a un servicio mediante la API de Java de AEM Forms. SOAP SOAP Al agregar un punto final de, habilita una aplicación cliente para invocar el servicio mediante el modo de. Es decir, al establecer las propiedades de conexión necesarias para invocar AEM Forms SOAP, puede seleccionar el modo de.

NOTA
SOAP No se puede agregar un extremo de mediante los servicios web.
NOTA
SOAP SOAP SOAP Normalmente, se agrega un punto de conexión de la a un servicio de forma predeterminada. Sin embargo, se puede agregar un punto de conexión de la distribución a un proceso que se implementa mediante programación o cuando se quita un punto de conexión de la distribución de la distribución y debe agregarse de nuevo.

Resumen de los pasos

SOAP Para agregar un punto final de a un servicio, realice las siguientes tareas:

  1. Incluir archivos de proyecto.
  2. Crear un objeto EndpointRegistryClient.
  3. SOAP Establezca atributos de extremo de la.
  4. SOAP Cree un punto final de.
  5. Habilite el extremo.

Incluir archivos de proyecto

Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente con Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.

Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
  • jbossall-client.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)

SOAP Estos archivos JAR son necesarios para crear un punto final de. SOAP Sin embargo, necesita archivos JAR adicionales si utiliza el extremo de la para invocar el servicio. Para obtener información sobre los archivos JAR de AEM Forms, consulte Inclusión de archivos de biblioteca Java de AEM Forms.

Crear un objeto cliente EndpointRegistry

SOAP Para agregar mediante programación un punto final de un servicio, debe crear un objeto EndpointRegistryClient.

SOAP Establecer atributos de punto de conexión de

SOAP Para agregar un extremo de la a un servicio, especifique los siguientes valores:

  • Valor del identificador del conector: Especifica el tipo de extremo que se va a crear. SOAP Para crear un extremo de la, especifique SOAP.
  • Descripción: especifica la descripción del extremo.
  • Nombre: especifica el nombre del extremo.
  • Valor del identificador de servicio: Especifica el servicio al que pertenece el extremo.
  • Nombre de operación: especifica el nombre de la operación que se invoca mediante el extremo. SOAP Al crear un extremo de la, especifique un carácter comodín ( *). Sin embargo, si desea especificar una operación específica en lugar de invocar todas las operaciones de servicio, especifique el nombre de la operación en lugar de utilizar el carácter comodín ( *).

SOAP Crear un punto de conexión de

SOAP SOAP Después de establecer los atributos del extremo de la, puede crear un extremo de la misma.

Habilitar el extremo

Después de crear un extremo, debe habilitarlo. Cuando el punto de conexión está habilitado, se puede utilizar para invocar el servicio. Después de habilitar el punto de conexión, puede verlo en la consola de administración.

Consulte también

SOAP Añadir un extremo de la mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

SOAP Añadir un extremo de la mediante la API de Java

SOAP Añadir un extremo de la a un servicio mediante la API de Java:

  1. Incluir archivos de proyecto.

    Incluya archivos JAR de cliente, como adobe-livecycle-client.jar, en la ruta de clase del proyecto Java.

  2. Cree un objeto EndpointRegistry Client.

    • Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
    • Cree un objeto EndpointRegistryClient utilizando su constructor y pasando el objeto ServiceClientFactory.
  3. SOAP Establezca atributos de extremo de la.

    • Crear un objeto CreateEndpointInfo mediante su constructor.
    • Especifique el valor del identificador del conector invocando el método setConnectorId del objeto CreateEndpointInfo y pasando el valor de cadena SOAP.
    • Especifique la descripción del extremo invocando el método setDescription del objeto CreateEndpointInfo y pasando un valor de cadena que describe el extremo.
    • Especifique el nombre del extremo invocando el método setName del objeto CreateEndpointInfo y pasando un valor de cadena que especifique el nombre.
    • Especifique el servicio al que pertenece el extremo invocando el método setServiceId del objeto CreateEndpointInfo y pasando un valor de cadena que especifica el nombre del servicio.
    • Especifique la operación que se invoca invocando el método setOperationName del objeto CreateEndpointInfo y pasando un valor de cadena que especifica el nombre de la operación. SOAP Para los extremos de EJB y de la, especifique un carácter comodín ( *), que implica todas las operaciones.
  4. SOAP Cree un punto final de.

    Cree el extremo invocando el método createEndpoint del objeto EndpointRegistryClient y pasando el objeto CreateEndpointInfo. SOAP Este método devuelve un objeto Endpoint que representa el nuevo extremo de la.

  5. Habilite el extremo.

    Habilite el extremo invocando el método enable del objeto EndpointRegistryClient y pase el objeto Endpoint devuelto por el método createEndpoint.

Adición de extremos de carpeta inspeccionada

Puede agregar mediante programación un punto final de carpeta inspeccionada a un servicio mediante la API de Java de AEM Forms. Al agregar un punto final de carpeta inspeccionada, permite a los usuarios colocar un archivo (como un archivo de PDF) en una carpeta. Cuando el archivo se coloca en la carpeta, el servicio configurado se invoca y manipula el archivo. Una vez que el servicio realiza la operación especificada, guarda el archivo modificado en una carpeta de salida especificada. Una carpeta vigilada está configurada para analizarse a un intervalo de tasa fija o con una programación cron, como todos los lunes, miércoles y viernes al mediodía.

Para agregar mediante programación un extremo de carpeta inspeccionada a un servicio, considere el siguiente proceso de corta duración denominado EncryptDocument. (Consulte Explicación de los procesos de AEM Forms.)

aw_aw_encryptdocumentprocess

Este proceso acepta un documento de PDF no protegido como valor de entrada y, a continuación, pasa el documento de PDF no protegido a la operación EncryptPDFUsingPassword del servicio Encryption. El documento de PDF se cifra con una contraseña y el documento de PDF cifrado con contraseña es el valor de salida de este proceso. El nombre del valor de entrada (el documento de PDF no protegido) es InDoc y el tipo de datos es com.adobe.idp.Document. El nombre del valor de salida (el documento de PDF cifrado con contraseña) es SecuredDoc y el tipo de datos es com.adobe.idp.Document.

NOTA
No puede agregar un punto final de carpeta inspeccionada mediante los servicios web.

Resumen de los pasos

Para agregar un punto final de carpeta inspeccionada a un servicio, realice las siguientes tareas:

  1. Incluir archivos de proyecto.
  2. Crear un objeto EndpointRegistryClient.
  3. Establezca los atributos del punto final de la carpeta inspeccionada.
  4. Especifique los valores de configuración.
  5. Defina los valores de parámetros de entrada.
  6. Defina un valor de parámetro de salida.
  7. Cree un punto final de carpeta inspeccionada.
  8. Habilite el extremo.

Incluir archivos de proyecto

Incluya los archivos necesarios en el proyecto de desarrollo. Si está creando una aplicación cliente con Java, incluya los archivos JAR necesarios. Si utiliza servicios web, asegúrese de incluir los archivos proxy.

Los siguientes archivos JAR deben agregarse a la ruta de clase del proyecto:

  • adobe-livecycle-client.jar
  • adobe-usermanager-client.jar
  • adobe-utilities.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)
  • jbossall-client.jar (requerido si AEM Forms está implementado en el servidor de aplicaciones JBoss)

Para obtener información sobre la ubicación de estos archivos JAR, consulte Inclusión de archivos de biblioteca Java de AEM Forms.

Crear un objeto cliente EndpointRegistry

Para agregar mediante programación un extremo de carpeta inspeccionada, debe crear un objeto EndpointRegistryClient.

Establecer atributos de extremo de carpeta inspeccionada

Para crear un punto final de carpeta inspeccionada para un servicio, especifique los siguientes valores:

  • Identificador de conector: especifica el tipo de extremo que se crea. Para crear un punto final de carpeta inspeccionada, especifique WatchedFolder.
  • Descripción: especifica la descripción del extremo.
  • Nombre: especifica el nombre del extremo.
  • Identificador de servicio: Especifica el servicio al que pertenece el extremo. Por ejemplo, para agregar un extremo de carpeta inspeccionada al proceso introducido en esta sección (un proceso se convierte en servicio cuando se activa mediante Workbench), especifique EncryptDocument.
  • Nombre de operación: especifica el nombre de la operación que se invoca mediante el extremo. Normalmente, cuando se crea un extremo de carpeta inspeccionada para un servicio que se originó a partir de un proceso creado en Workbench, el nombre de la operación es invoke.

Especificar valores de configuración

Especifique valores de configuración para un punto final de carpeta inspeccionada al agregar mediante programación un punto final de carpeta inspeccionada a un servicio. Un administrador especifica estos valores de configuración si se agrega un punto final de carpeta inspeccionada mediante la consola de administración.

La siguiente lista especifica los valores de configuración que se establecen al agregar mediante programación un punto final de carpeta inspeccionada a un servicio:

  • url: especifica la ubicación de la carpeta vigilada. En un entorno agrupado, este valor debe apuntar a una carpeta de red compartida a la que se pueda acceder desde todos los equipos del clúster.
  • asincrónico: Identifica el tipo de invocación como asincrónico o sincrónico. Los procesos transitorios y sincrónicos solo se pueden invocar sincrónicamente. El valor predeterminado es True. Se recomienda asincrónico.
  • cronExpression: Quartz lo usa para programar el sondeo del directorio de entrada.
  • purgeDuration: Este es un atributo obligatorio. Los archivos y carpetas de la carpeta de resultados se depuran cuando son anteriores a este valor. Este valor se mide en días. Este atributo es útil para garantizar que la carpeta de resultados no se llene. El valor de -1 días indica que nunca se eliminará la carpeta de resultados. El valor predeterminado es -1.
  • repeatInterval: Intervalo, en segundos, para analizar la carpeta inspeccionada para obtener información. A menos que la restricción esté habilitada, este valor debe ser mayor que el tiempo para procesar un trabajo promedio; de lo contrario, el sistema puede sobrecargarse. El valor predeterminado es 5.
  • repeatCount: El número de veces que una carpeta inspeccionada analiza la carpeta o directorio. El valor -1 indica un escaneo indefinido. El valor predeterminado es -1.
  • throttleOn: Limita el número de trabajos de carpetas inspeccionadas que se pueden procesar en un momento dado. El número máximo de trabajos está determinado por el valor batchSize.
  • userName: nombre de usuario utilizado al invocar un servicio de destino desde la carpeta inspeccionada. Este valor es obligatorio. El valor predeterminado es SuperAdmin.
  • domainName: el dominio del usuario. Este valor es obligatorio. El valor predeterminado es DefaultDom.
  • batchSize: número de archivos o carpetas que se van a recoger por análisis. Utilice este valor para evitar sobrecargas en el sistema; el análisis de demasiados archivos al mismo tiempo puede provocar un bloqueo. El valor predeterminado es 2.
  • waitTime: tiempo, en milisegundos, a esperar antes de analizar una carpeta o archivo después de crearlo. Por ejemplo, si el tiempo de espera es de 36 000 000 milisegundos (una hora) y el archivo se creó hace un minuto, el archivo se recopilará después de que hayan transcurrido 59 minutos o más. Este atributo es útil para asegurarse de que un archivo o carpeta se copia completamente en la carpeta de entrada. Por ejemplo, si tiene un archivo grande para procesar y tarda diez minutos en descargarse, establezca el tiempo de espera en 10*60 *1000 milisegundos. Esta configuración evita que la carpeta vigilada analice el archivo si no ha estado esperando durante diez minutos. El valor predeterminado es 0.
  • excludeFilePattern: El patrón que usa una carpeta vigilada para determinar qué archivos y carpetas analizar y recoger. Ningún archivo o carpeta que tenga este patrón se analizará para su procesamiento. Esta configuración es útil cuando la entrada es una carpeta que contiene varios archivos. El contenido de la carpeta se puede copiar en una carpeta que tenga un nombre que recogerá la carpeta vigilada. Este paso evita que la carpeta inspeccionada recoja una carpeta para procesarla antes de que la carpeta se copie completamente en la carpeta de entrada. Por ejemplo, si el valor excludeFilePattern es data*, no se recogen todos los archivos y carpetas que coinciden con data*. Esto incluye archivos y carpetas con los nombres data1, data2, etc. Además, el patrón se puede complementar con patrones de comodines para especificar patrones de archivo. La carpeta vigilada modifica la expresión regular para admitir patrones de comodines como *.* y *.pdf. Estas expresiones regulares no admiten estos patrones comodín.
  • includeFilePattern: El patrón que usa la carpeta vigilada para determinar qué carpetas y archivos analizar y recoger. Por ejemplo, si este valor es *, se recogerán todos los archivos y carpetas que coincidan con input*. Esto incluye archivos y carpetas con los nombres input1, input2, etc. El valor predeterminado es *. Este valor indica todos los archivos y carpetas. Además, el patrón se puede complementar con patrones de comodines para especificar patrones de archivo. La carpeta vigilada modifica la expresión regular para admitir patrones de comodines como *.* y *.pdf. Estas expresiones regulares no admiten estos patrones comodín. Este valor es obligatorio.
  • resultFolderName: La carpeta donde se almacenan los resultados guardados. Esta ubicación puede ser una ruta de acceso de directorio absoluta o relativa. Si los resultados no aparecen en esta carpeta, compruebe la carpeta de errores. Los archivos de solo lectura no se procesan y se guardan en la carpeta de errores. El valor predeterminado es result/%Y/%M/%D/. Esta es la carpeta de resultados dentro de la carpeta vigilada.
  • preserveFolderName: ubicación donde se almacenan los archivos después de realizar el análisis y la recogida correctamente. Esta ubicación puede ser una ruta de directorio absoluta, relativa o nula. El valor predeterminado es preserve/%Y/%M/%D/.
  • failureFolderName: Carpeta donde se guardan los archivos de error. Esta ubicación siempre es relativa a la carpeta vigilada. Los archivos de solo lectura no se procesan y se guardan en la carpeta de errores. El valor predeterminado es failure/%Y/%M/%D/.
  • preserveOnFailure: Conservar archivos de entrada si no se puede ejecutar la operación en un servicio. El valor predeterminado es True.
  • overwriteDuplicateFilename: Cuando se establece en true, los archivos de la carpeta de resultados y de la carpeta de conservación se sobrescriben. Cuando se establece en false, los archivos y carpetas que tienen un sufijo de índice numérico se utilizan para el nombre. El valor predeterminado es False.

Definir valores de parámetros de entrada

Al crear un punto final de carpeta inspeccionada, debe definir los valores de parámetro de entrada. Es decir, debe describir los valores de entrada que se pasan a la operación que invoca la carpeta vigilada. Por ejemplo, considere el proceso introducido en este tema. Tiene un valor de entrada denominado InDoc y su tipo de datos es com.adobe.idp.Document. Al crear un punto final de carpeta inspeccionada para este proceso (una vez activado un proceso, se convierte en un servicio), debe definir el valor del parámetro de entrada.

Para definir los valores de parámetro de entrada necesarios para un punto final de carpeta inspeccionada, especifique los siguientes valores:

Nombre del parámetro de entrada: El nombre del parámetro de entrada. El nombre de un valor de entrada se especifica en Workbench para un proceso. Si el valor de entrada pertenece a una operación de servicio (un servicio que no es un proceso creado en Workbench), el nombre de entrada se especifica en el archivo component.xml. Por ejemplo, el nombre del parámetro de entrada para el proceso introducido en esta sección es InDoc.

Tipo de asignación: se usa para configurar los valores de entrada necesarios para invocar la operación de servicio. Existen dos tipos de asignación:

  • Literal: el extremo de la carpeta inspeccionada utiliza el valor introducido en el campo tal como se muestra. Se admiten todos los tipos básicos de Java. Por ejemplo, si una API utiliza entradas como String, long, int y Boolean, la cadena se convierte en el tipo adecuado y se invoca el servicio.
  • Variable: el valor introducido es un patrón de archivo que la carpeta vigilada utiliza para elegir la entrada. Por ejemplo, si selecciona Variable para el tipo de asignación y el documento de entrada debe ser un archivo de PDF, puede especificar *.pdf como valor de asignación.

Valor de asignación: especifica el valor del tipo de asignación. Por ejemplo, si selecciona un tipo de asignación Variable, puede especificar *.pdf como patrón de archivo.

Tipo de datos: Especifica el tipo de datos de los valores de entrada. Por ejemplo, el tipo de datos del valor de entrada del proceso introducido en esta sección es com.adobe.idp.Document.

Definir un valor de parámetro de salida

Al crear un punto final de carpeta inspeccionada, debe definir un valor de parámetro de salida. Es decir, debe describir el valor de salida que devuelve el servicio que invoca el punto final de la carpeta inspeccionada. Por ejemplo, considere el proceso introducido en este tema. Tiene un valor de salida denominado SecuredDoc y su tipo de datos es com.adobe.idp.Document. Al crear un punto final de carpeta inspeccionada para este proceso (una vez activado un proceso, se convierte en un servicio), debe definir el valor del parámetro de salida.

Para definir un valor de parámetro de salida necesario para un punto final de carpeta inspeccionada, especifique los siguientes valores:

Nombre del parámetro de salida: El nombre del parámetro de salida. El nombre de un valor de salida de proceso se especifica en Workbench. Si el valor de salida pertenece a una operación de servicio (un servicio que no es un proceso creado en Workbench), el nombre de salida se especifica en el archivo component.xml. Por ejemplo, el nombre del parámetro de salida para el proceso introducido en esta sección es SecuredDoc.

Tipo de asignación: se usa para configurar la salida del servicio y la operación. Las opciones disponibles son las siguientes:

  • Si el servicio devuelve un solo objeto (un solo documento), el patrón es %F.pdf y el destino de origen es sourcefilename.pdf. Por ejemplo, el proceso introducido en esta sección devuelve un solo documento. Como resultado, el tipo de asignación puede definirse como %F.pdf ( %F significa que debe usar el nombre de archivo dado). El patrón %E especifica la extensión del documento de entrada.
  • Si el servicio devuelve una lista, el patrón es Result\%F\ y el destino de origen es Result\sourcefilename\source1 (salida 1) y Result\sourcefilename\source2 (salida 2).
  • Si el servicio devuelve un mapa, el patrón es Result\%F\ y el destino de origen es Result\sourcefilename\file1 y Result\sourcefilename\file2. Si la asignación tiene más de un objeto, el patrón es Result\%F.pdf y el destino de origen es Result\sourcefilename1.pdf (salida 1), Result\sourcefilenam2.pdf (salida 2), etc.

Tipo de datos: Especifica el tipo de datos del valor devuelto. Por ejemplo, el tipo de datos del valor devuelto del proceso introducido en esta sección es com.adobe.idp.Document.

Crear un extremo de carpeta inspeccionada

Después de establecer los atributos del punto de conexión, los valores de configuración y definir los valores de parámetros de entrada y salida, debe crear el punto de conexión de la carpeta inspeccionada.

Habilitar el extremo

Después de crear un punto final de carpeta inspeccionada, debe habilitarlo. Cuando el punto de conexión está habilitado, se puede utilizar para invocar el servicio. Después de habilitar el punto de conexión, puede verlo en la consola de administración.

Consulte también

Añadir un punto final de carpeta inspeccionada mediante la API de Java

Incluir archivos de biblioteca Java de AEM Forms

Estableciendo propiedades de conexión

Añadir un punto final de carpeta inspeccionada mediante la API de Java

Añada un punto final de carpeta inspeccionada mediante la API de Java de AEM Forms:

  1. Incluir archivos de proyecto.

    Incluya archivos JAR de cliente, como adobe-livecycle-client.jar, en la ruta de clase del proyecto Java.

  2. Cree un objeto EndpointRegistry Client.

    • Cree un objeto ServiceClientFactory que contenga propiedades de conexión.
    • Cree un objeto EndpointRegistryClient utilizando su constructor y pasando el objeto ServiceClientFactory.
  3. Establezca los atributos del punto final de la carpeta inspeccionada.

    • Crear un objeto CreateEndpointInfo mediante su constructor.
    • Especifique el valor del identificador del conector invocando el método setConnectorId del objeto CreateEndpointInfo y pasando el valor de cadena WatchedFolder.
    • Especifique la descripción del extremo invocando el método setDescription del objeto CreateEndpointInfo y pasando un valor de cadena que describe el extremo.
    • Especifique el nombre del extremo invocando el método setName del objeto CreateEndpointInfo y pasando un valor de cadena que especifique el nombre.
    • Especifique el servicio al que pertenece el extremo invocando el método setServiceId del objeto CreateEndpointInfo y pasando un valor de cadena que especifica el nombre del servicio.
    • Especifique la operación que se invoca invocando el método setOperationName del objeto CreateEndpointInfo y pasando un valor de cadena que especifica el nombre de la operación. Normalmente, al crear un punto final de carpeta inspeccionada para un servicio que se originó a partir de un proceso creado en Workbench, se invoca el nombre de la operación.
  4. Especifique los valores de configuración.

    Para que cada valor de configuración se establezca para el extremo de la carpeta inspeccionada, debe invocar el método setConfigParameterAsText del objeto CreateEndpointInfo. Por ejemplo, para establecer el valor de configuración url, invoque el método setConfigParameterAsText del objeto CreateEndpointInfo y pase los siguientes valores de cadena:

    • Un valor de cadena que especifica el nombre del valor de configuración. Al establecer el valor de configuración url, especifique url.
    • Un valor de cadena que especifica el valor del valor de configuración. Al establecer el valor de configuración url, especifique la ubicación de la carpeta vigilada.
    NOTA
    Para ver todos los valores de configuración establecidos para el servicio EncryptDocument, consulte el ejemplo de código Java ubicado en QuickStart: Agregar un extremo de carpeta inspeccionada mediante la API de Java.
  5. Defina los valores de parámetros de entrada.

    Defina un valor de parámetro de entrada invocando el método setInputParameterMapping del objeto CreateEndpointInfo y pase los siguientes valores:

    • Valor de cadena que especifica el nombre del parámetro de entrada. Por ejemplo, el nombre del parámetro de entrada para el servicio EncryptDocument es InDoc.
    • Valor de cadena que especifica el tipo de datos del parámetro de entrada. Por ejemplo, el tipo de datos del parámetro de entrada InDoc es com.adobe.idp.Document.
    • Valor de cadena que especifica el tipo de asignación. Por ejemplo, puede especificar variable.
    • Valor de cadena que especifica el valor del tipo de asignación. Por ejemplo, puede especificar *.pdf como patrón de archivo.
    NOTA
    Invoque el método setInputParameterMapping para cada valor de parámetro de entrada que desee definir. Dado que el proceso EncryptDocument sólo tiene un parámetro de entrada, es necesario invocar este método una vez.
  6. Defina un valor de parámetro de salida.

    Defina un valor de parámetro de salida invocando el método setOutputParameterMapping del objeto CreateEndpointInfo y pase los siguientes valores:

    • Valor de cadena que especifica el nombre del parámetro de salida. Por ejemplo, el nombre del parámetro de salida para el servicio EncryptDocument es SecuredDoc.
    • Valor de cadena que especifica el tipo de datos del parámetro de salida. Por ejemplo, el tipo de datos del parámetro de salida SecuredDoc es com.adobe.idp.Document.
    • Valor de cadena que especifica el tipo de asignación. Por ejemplo, puede especificar %F.pdf.
  7. Cree un punto final de carpeta inspeccionada.

    Cree el extremo invocando el método createEndpoint del objeto EndpointRegistryClient y pasando el objeto CreateEndpointInfo. Este método devuelve un objeto Endpoint que representa el extremo de la carpeta inspeccionada.

  8. Habilite el extremo.

    Habilite el extremo invocando el método enable del objeto EndpointRegistryClient y pasando el objeto Endpoint devuelto por el método createEndpoint.