AEM Forms se puede invocar utilizando la API Java de AEM Forms. Al utilizar la API Java de AEM Forms, puede utilizar las bibliotecas API de invocación o de cliente Java. Las bibliotecas de cliente Java están disponibles para servicios como el servicio de Rights Management. Estas API con establecimiento inflexible de tipos le permiten desarrollar aplicaciones Java que invoquen AEM Forms.
La API de invocación son clases ubicadas en el paquete com.adobe.idp.dsc
. Con estas clases, puede enviar una solicitud de invocación directamente a un servicio y administrar una respuesta de invocación que se devuelve. Utilice la API de invocación para invocar procesos de corta duración o de larga duración creados mediante Workbench.
La forma recomendada de invocar un servicio mediante programación es utilizar una biblioteca de cliente Java que corresponda al servicio en lugar de la API de invocación. Por ejemplo, para invocar el servicio Encryption , utilice la biblioteca de cliente del servicio Encryption . Para realizar una operación del servicio de cifrado, invoque un método que pertenece al objeto cliente del servicio de cifrado. Puede cifrar un documento PDF con una contraseña invocando el método EncryptionServiceClient
del objeto encryptPDFUsingPassword
.
La API de Java admite las siguientes funciones:
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Invocación de procesos de larga vida centrados en el ser humano
Invocación de AEM Forms mediante servicios web
Configuración de las propiedades de conexión
Pasar datos a servicios de AEM Forms mediante la API de Java
Invocación de un servicio mediante una biblioteca de cliente Java
Invocación de un proceso de corta duración mediante la API de invocación
Creación de una aplicación web de Java que invoque un proceso prolongado centrado en el ser humano
Para invocar mediante programación un servicio de AEM Forms utilizando la API de Java, incluya los archivos de biblioteca necesarios (archivos JAR) en la ruta de clase del proyecto Java. Los archivos JAR que incluye en la ruta de clase de la aplicación cliente dependen de varios factores:
(Solo llave en mano) Inicie el servidor AEM Forms con el comando standalone.bat -b <Server IP> -c lc_turnkey.xml
para especificar una IP de servidor para EJB.
La siguiente tabla enumera los archivos JAR necesarios para invocar los servicios de AEM Forms.
Archivo |
Descripción |
Lugar de residencia |
---|---|---|
adobe-livecycle-client.jar |
Siempre debe incluirse en la ruta de clase de una aplicación cliente Java. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-usermanager-client.jar |
Siempre debe incluirse en la ruta de clase de una aplicación cliente Java. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-utilities.jar |
Siempre debe incluirse en la ruta de clase de una aplicación cliente Java. |
<>directorio de instalación>/sdk//client-libs/<app server=""> |
adobe-applicationmanager-client-sdk.jar |
Necesario para invocar el servicio del Administrador de aplicaciones. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-assembler-client.jar |
Necesario para invocar el servicio Assembler. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-backup-restore-client-sdk.jar |
Necesario para invocar la API de servicio de copia de seguridad y restauración. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-barcodedforms-client.jar |
Necesario para invocar el servicio de formularios con códigos de barras. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-convertpdf-client.jar |
Necesario para invocar el servicio Convert PDF. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-distiller-client.jar |
Necesario para invocar el servicio de Distiller. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-docconverter-client.jar |
Necesario para invocar el servicio DocConverter. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-contentservices-client.jar |
Necesario para invocar el servicio de gestión de documentos. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-encryption-client.jar |
Necesario para invocar el servicio de cifrado. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-forms-client.jar |
Necesario para invocar el servicio de Forms. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-formdataintegration-client.jar |
Necesario para invocar el servicio de integración de datos de formulario. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-generatepdf-client.jar |
Necesario para invocar el servicio Generate PDF. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-generate3dpdf-client.jar |
Necesario para invocar el servicio Generate 3D PDF. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-jobmanager-client-sdk.jar |
Necesario para invocar el servicio Administrador de trabajos. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-output-client.jar |
Necesario para invocar el servicio Output . |
<>directorio de instalación>/sdk/client-libs/common |
adobe-pdfutility-client.jar |
Necesario para invocar el servicio Utilidades de PDF o XMP Utilidades. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-reader-extensions-client.jar |
Necesario para invocar el servicio de extensiones de Acrobat Reader DC. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-repository-client.jar commons-codec-1.3.jar |
Necesario para invocar el servicio Repositorio. |
<>directorio de instalación>/sdk/client-libs/common <>directorio de instalación>/sdk/client-libs\thirdparty |
|
Necesario para invocar el servicio de Rights Management. Si AEM Forms está implementado en JBoss, incluya todos estos archivos. |
<>directorio de instalación>/sdk/client-libs/common Directorio de biblioteca específico de JBoss |
adobe-signatures-client.jar |
Necesario para invocar el servicio Signature. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-taskmanager-client-sdk.jar |
Necesario para invocar el servicio Administrador de tareas. |
<>directorio de instalación>/sdk/client-libs/common |
adobe-truststore-client.jar |
Necesario para invocar el servicio Almacén de confianza. |
<>directorio de instalación>/sdk/client-libs/common |
La siguiente tabla enumera los archivos JAR que dependen del modo de conexión y del servidor de aplicaciones J2EE en el que se implementa AEM Forms.
Archivo |
Descripción |
Lugar de residencia |
---|---|---|
|
si AEM Forms se invoca mediante el modo SOAP, incluya estos archivos JAR. |
<>directorio de instalación>/sdk/client-libs/thirdparty |
jboss-client.jar |
si AEM Forms está implementado en JBoss Application Server, incluya este archivo JAR. El cargador de clases no encontrará las clases requeridas si jboss-client.jar y los tarros a los que se hace referencia no están ubicados de manera conjunta. |
Directorio de biblioteca de cliente JBoss Si implementa la aplicación cliente en el mismo servidor de aplicaciones J2EE, no es necesario incluir este archivo. |
wlclient.jar |
si AEM Forms está implementado en BEA WebLogic Server®, incluya este archivo JAR. |
Directorio de bibliotecas específico de WebLogic Si implementa la aplicación cliente en el mismo servidor de aplicaciones J2EE, no es necesario incluir este archivo. |
|
|
Directorio de biblioteca específico de WebSphere ([WAS_HOME]/runtimes) Si implementa la aplicación cliente en el mismo servidor de aplicaciones J2EE, no es necesario incluir estos archivos. |
La siguiente tabla especifica las situaciones de invocación y enumera los archivos JAR necesarios para invocar AEM Forms correctamente.
Servicios |
Modo de invocación |
Servidor de aplicaciones J2EE |
Archivos JAR necesarios |
---|---|---|---|
Servicio de Forms |
EJB |
JBoss |
|
Servicio de Forms Servicio de extensiones de Acrobat Reader DC Servicio de firmas |
EJB |
JBoss |
|
Servicio de Forms |
SOAP |
WebLogic |
|
Servicio de Forms Servicio de extensiones de Acrobat Reader DC Servicio de firmas |
SOAP |
WebLogic |
|
Si está actualizando de LiveCycle a AEM Forms, se recomienda incluir los archivos JAR de AEM Forms en la ruta de clase de su proyecto Java. Por ejemplo, si utiliza servicios como el servicio de Rights Management, tendrá un problema de compatibilidad si no incluye archivos JAR de AEM Forms en la ruta de la clase.
Suponiendo que esté actualizando a AEM Forms. Para utilizar una aplicación Java que invoque el servicio de Rights Management, incluya las versiones de AEM Forms de los siguientes archivos JAR:
Consulte también
Invocación de AEM Forms mediante la API de Java
Configuración de las propiedades de conexión
Pasar datos a servicios de AEM Forms mediante la API de Java
Invocación de un servicio mediante una biblioteca de cliente Java
Las propiedades de conexión se establecen para invocar AEM Forms al utilizar la API de Java. Al configurar las propiedades de conexión, especifique si desea invocar los servicios de forma remota o local, así como el modo de conexión y los valores de autenticación. Los valores de autenticación son necesarios si la seguridad del servicio está habilitada. Sin embargo, si la seguridad del servicio está deshabilitada, no es necesario especificar los valores de autenticación.
El modo de conexión puede ser SOAP o EJB. El modo EJB utiliza el protocolo RMI/IIOP y el rendimiento del modo EJB es mejor que el del modo SOAP. El modo SOAP se utiliza para eliminar una dependencia del servidor de aplicaciones J2EE o cuando se encuentra un firewall entre AEM Forms y la aplicación cliente. El modo SOAP utiliza el protocolo https como transporte subyacente y puede comunicarse a través de los límites del cortafuegos. Si no hay ningún problema con la dependencia del servidor de aplicaciones J2EE o con un cortafuegos, se recomienda utilizar el modo EJB.
Para invocar correctamente un servicio de AEM Forms, establezca las siguientes propiedades de conexión:
DSC_DEFAULT_EJB_ENDPOINT: Si utiliza el modo de conexión EJB, este valor representa la URL del servidor de aplicaciones J2EE en el que se implementa AEM Forms. Para invocar AEM Forms de forma remota, especifique el nombre del servidor de aplicaciones J2EE en el que se implementa AEM Forms. Si la aplicación cliente está ubicada en el mismo servidor de aplicaciones J2EE, puede especificar localhost
. Dependiendo del servidor de aplicaciones J2EE en el que se implemente AEM Forms, especifique uno de los siguientes valores:
https://<ServerName>:8080 (default port)
iiop://<ServerName>:2809 (default port)
t3://<ServerName>:7001 (default port)
DSC_DEFAULT_SOAP_ENDPOINT: Si está utilizando el modo de conexión SOAP, este valor representa el punto final al que se envía una solicitud de invocación. Para invocar AEM Forms de forma remota, especifique el nombre del servidor de aplicaciones J2EE en el que se implementa AEM Forms. Si la aplicación cliente está ubicada en el mismo servidor de aplicaciones J2EE, puede especificar localhost
(por ejemplo, http://localhost:8080
).
8080
es aplicable si la aplicación J2EE es JBoss. Si el servidor de aplicaciones J2EE es IBM® WebSphere®, utilice el puerto 9080
. Del mismo modo, si el servidor de aplicaciones J2EE es WebLogic, utilice el puerto 7001
. (Estos valores son valores de puerto predeterminados. Si cambia el valor del puerto, utilice el número de puerto aplicable).DSC_TRANSPORT_PROTOCOL: Si está utilizando el modo de conexión EJB, especifique ServiceClientFactoryProperties.DSC_EJB_PROTOCOL
para este valor. Si está utilizando el modo de conexión SOAP, especifique ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL
.
DSC_SERVER_TYPE: Especifica el servidor de aplicaciones J2EE en el que se implementa AEM Forms. Los valores válidos son JBoss
, WebSphere
, WebLogic
.
WebSphere
, el valor java.naming.factory.initial
se establece en com.ibm.ws.naming.util.WsnInitCtxFactory
.WebLogic
, el valor java.naming.factory.initial
se establece en weblogic.jndi.WLInitialContextFactory
.JBoss
, el valor java.naming.factory.initial
se establece en org.jnp.interfaces.NamingContextFactory
.java.naming.factory.initial
en un valor que cumpla con sus requisitos si no desea utilizar los valores predeterminados.En lugar de utilizar una cadena para establecer la propiedad de conexión DSC_SERVER_TYPE
, puede utilizar un miembro estático de la clase ServiceClientFactoryProperties
. Se pueden utilizar los siguientes valores: ServiceClientFactoryProperties.DSC_WEBSPHERE_SERVER_TYPE
, ServiceClientFactoryProperties.DSC_WEBLOGIC_SERVER_TYPE
o ServiceClientFactoryProperties.DSC_JBOSS_SERVER_TYPE
.
DSC_CREDENTIAL_USERNAME: especifica el nombre de usuario de los formularios AEM. Para que un usuario invoque correctamente un servicio de AEM Forms, necesita la función de usuario de servicios. Un usuario también puede tener otra función que incluya el permiso Invocar servicio. De lo contrario, se genera una excepción cuando intentan invocar un servicio. Si la seguridad del servicio está deshabilitada, no es necesario especificar esta propiedad de conexión.
DSC_CREDENTIAL_PASSWORD: especifica el valor de contraseña correspondiente. Si la seguridad del servicio está deshabilitada, no es necesario especificar esta propiedad de conexión.
DSC_REQUEST_TIMEOUT: El límite de tiempo de espera predeterminado de la solicitud SOAP es de 1200000 milisegundos (20 minutos). En algún momento, una solicitud puede requerir más tiempo para completar la operación. Por ejemplo, una solicitud SOAP que recupera un gran conjunto de registros puede requerir un límite de tiempo de espera más largo. Puede utilizar ServiceClientFactoryProperties.DSC_REQUEST_TIMEOUT
para aumentar el límite de tiempo de espera de llamada de solicitud para las solicitudes SOAP.
Solo las invocaciones basadas en SOAP admiten la propiedad DSC_REQUEST_TIMEOUT.
Para establecer las propiedades de conexión, realice las siguientes tareas:
Cree un objeto java.util.Properties
utilizando su constructor.
Para establecer la propiedad de conexión DSC_DEFAULT_EJB_ENDPOINT
, invoque el método java.util.Properties
del objeto setProperty
y pase los siguientes valores:
ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT
Si está utilizando el modo de conexión SOAP, especifique el valor de enumeración ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT
en lugar del valor de enumeración ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT
.
Para establecer la propiedad de conexión DSC_TRANSPORT_PROTOCOL
, invoque el método java.util.Properties
del objeto setProperty
y pase los siguientes valores:
ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL
ServiceClientFactoryProperties.DSC_EJB_PROTOCOL
Si está utilizando el modo de conexión SOAP, especifique el valor de enumeración ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL
en lugar del valor de enumeración ServiceClientFactoryProperties.DSC_EJB_PROTOCOL
.
Para establecer la propiedad de conexión DSC_SERVER_TYPE
, invoque el método java.util.Properties
del objeto setProperty
y pase los siguientes valores:
El valor de enumeración ServiceClientFactoryProperties.DSC_SERVER_TYPE
Un valor de cadena que especifica el servidor de aplicaciones J2EE que aloja AEM Forms (por ejemplo, si AEM Forms está implementado en JBoss, especifique JBoss
).
DSC_CREDENTIAL_USERNAME
, invoque el método java.util.Properties
del objeto setProperty
y pase los siguientes valores:El valor de enumeración ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME
Un valor de cadena que especifica el nombre de usuario necesario para invocar AEM Forms
DSC_CREDENTIAL_PASSWORD
, invoque el método java.util.Properties
del objeto setProperty
y pase los siguientes valores:El valor de enumeración ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD
Un valor de cadena que especifica el valor de contraseña correspondiente
Configuración del modo de conexión EJB para JBoss
El siguiente ejemplo de código Java establece propiedades de conexión para invocar AEM Forms implementado en JBoss y utilizando el modo de conexión EJB.
Properties ConnectionProps = new Properties();
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "https://<hostname>:8080");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DOCUMENT_HTTP_ENDPOINT,"https://<hostname>:8080");
Configuración del modo de conexión EJB para WebLogic
El siguiente ejemplo de código Java establece las propiedades de conexión para invocar AEM Forms implementado en WebLogic y utilizando el modo de conexión EJB.
Properties ConnectionProps = new Properties();
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "t3://localhost:7001");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "WebLogic");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
Configuración del modo de conexión EJB para WebSphere
El siguiente ejemplo de código Java establece las propiedades de conexión para invocar AEM Forms implementado en WebSphere y utilizando el modo de conexión EJB.
Properties ConnectionProps = new Properties();
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "iiop://localhost:2809");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "WebSphere");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
Configuración del modo de conexión SOAP
El siguiente ejemplo de código Java establece las propiedades de conexión en modo SOAP para invocar AEM Forms implementado en JBoss.
Properties ConnectionProps = new Properties();
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "http://localhost:8080");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
Si selecciona el modo de conexión SOAP, asegúrese de incluir archivos JAR adicionales en la ruta de clase de la aplicación cliente.
Configuración de las propiedades de conexión cuando está deshabilitada la seguridad del servicio
El siguiente ejemplo de código Java establece las propiedades de conexión necesarias para invocar AEM Forms implementado en el servidor de aplicaciones JBoss y cuando la seguridad del servicio está deshabilitada.
Properties ConnectionProps = new Properties();
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://localhost:1099");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
Todos los inicios rápidos de Java asociados con la programación con AEM Forms muestran la configuración de conexión EJB y SOAP.
Configuración del modo de conexión SOAP con límite de tiempo de espera de solicitud personalizado
Properties ConnectionProps = new Properties();
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT, "http://localhost:8080");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL,ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL);
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, "JBoss");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME, "administrator");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD, "password");
ConnectionProps.setProperty(ServiceClientFactoryProperties.DSC_REQUEST_TIMEOUT, "1800000"); // Request timeout limit 30 Minutes
Uso de un objeto de contexto para invocar AEM Forms
Puede utilizar un objeto com.adobe.idp.Context
para invocar un servicio de AEM Forms con un usuario autenticado (el objeto com.adobe.idp.Context
representa a un usuario autenticado). Al utilizar un objeto com.adobe.idp.Context
, no es necesario establecer las propiedades DSC_CREDENTIAL_USERNAME
o DSC_CREDENTIAL_PASSWORD
. Puede obtener un objeto com.adobe.idp.Context
al autenticar usuarios mediante el método AuthenticationManagerServiceClient
del objeto authenticate
.
El método authenticate
devuelve un objeto AuthResult
que contiene los resultados de la autenticación. Puede crear un objeto com.adobe.idp.Context
invocando su constructor. A continuación, invoque el método com.adobe.idp.Context
del objeto initPrincipal
y pase el objeto AuthResult
, como se muestra en el siguiente código:
Context myCtx = new Context();
myCtx.initPrincipal(authResult);
En lugar de establecer las propiedades DSC_CREDENTIAL_USERNAME
o DSC_CREDENTIAL_PASSWORD
, puede invocar el método ServiceClientFactory
del objeto setContext
y pasar el objeto com.adobe.idp.Context
. Cuando utilice un usuario de AEM formularios para invocar un servicio, asegúrese de que tenga la función Services User
necesaria para invocar un servicio de AEM Forms.
El siguiente ejemplo de código muestra cómo utilizar un objeto com.adobe.idp.Context
dentro de la configuración de conexión que se utiliza para crear un objeto EncryptionServiceClient
.
//Authenticate a user and use the Context object within connection settings
// Authenticate the user
String username = "wblue";
String password = "password";
AuthResult authResult = authClient.authenticate(username, password.getBytes());
//Set a Content object that represents the authenticated user
//Use the Context object to invoke the Encryption service
Context myCtx = new Context();
myCtx.initPrincipal(authResult);
//Set connection settings
Properties connectionProps = new Properties();
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT, "jnp://<server>:1099");
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL, ServiceClientFactoryProperties.DSC_EJB_PROTOCOL);
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_SERVER_TYPE, ServiceClientFactoryProperties.DSC_JBOSS_SERVER_TYPE);
connectionProps.setProperty(ServiceClientFactoryProperties.DSC_DOCUMENT_HTTP_ENDPOINT,"jnp://<server>:1099");
//Create a ServiceClientFactory object
ServiceClientFactory myFactory = ServiceClientFactory.createInstance(connectionProps);
myFactory.setContext(myCtx);
//Create an EncryptionServiceClient object
EncryptionServiceClient encryptClient = new EncryptionServiceClient(myFactory);
Para obtener información detallada sobre la autenticación de un usuario, consulte Autenticación de usuarios.
En esta sección se tratan los siguientes casos de invocación:
El diagrama siguiente muestra una aplicación cliente que se ejecuta en su propia JVM e invoca una instancia independiente de AEM Forms.
En este escenario, una aplicación cliente se ejecuta en su propia JVM e invoca los servicios de AEM Forms.
Este escenario es el escenario de invocación en el que se basan todos los inicios rápidos.
El diagrama siguiente muestra una aplicación cliente que se ejecuta en su propia JVM e invoca instancias de AEM Forms ubicadas en un clúster.
Este escenario es similar a una aplicación cliente que invoca una instancia de AEM Forms independiente. Sin embargo, la dirección URL del proveedor es diferente. Si una aplicación cliente desea conectarse a un servidor de aplicaciones J2EE específico, la aplicación debe cambiar la URL para hacer referencia al servidor de aplicaciones J2EE específico.
No se recomienda hacer referencia a un servidor de aplicaciones J2EE específico porque la conexión entre la aplicación cliente y AEM Forms termina si el servidor de aplicaciones se detiene. Se recomienda que la URL del proveedor haga referencia a un administrador de JNDI a nivel de celda, en lugar de a un servidor de aplicaciones J2EE específico.
Las aplicaciones cliente que utilizan el modo de conexión SOAP pueden utilizar el puerto de equilibrador de carga HTTP para el clúster. Las aplicaciones cliente que utilizan el modo de conexión EJB pueden conectarse al puerto EJB de un servidor de aplicaciones J2EE específico. Esta acción gestiona el equilibrio de carga entre los nodos del clúster.
WebSphere
El siguiente ejemplo muestra el contenido de un archivo jndi.properties que se utiliza para conectarse a AEM Forms y que se implementa en WebSphere.
java.naming.factory.initial=com.ibm.websphere.naming.
WsnInitialContextFactory
java.naming.provider.url=corbaloc::appserver1:9810,:appserver2:9810
WebLogic
El siguiente ejemplo muestra el contenido de un archivo jndi.properties que se utiliza para conectarse a AEM Forms que se implementa en WebLogic.
java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory
java.naming.provider.url=t3://appserver1:8001, appserver2:8001
JBoss
El siguiente ejemplo muestra el contenido de un archivo jndi.properties que se utiliza para conectarse a AEM Forms y que se implementa en JBoss.
java.naming.factory.initial= org.jnp.interfaces.NamingContextFactory
java.naming.provider.url= jnp://appserver1:1099, appserver2:1099,
appserver3:1099
Consulte con su administrador para determinar el nombre y el número de puerto del servidor de aplicaciones J2EE.
Consulte también
Inclusión de archivos de biblioteca Java de AEM Forms
Pasar datos a servicios de AEM Forms mediante la API de Java
Invocación de un servicio mediante una biblioteca de cliente Java
Las operaciones de servicio de AEM Forms suelen consumir o producir documentos PDF. Al invocar un servicio, a veces es necesario pasar un documento PDF (u otros tipos de documento como datos XML) al servicio. Del mismo modo, a veces es necesario gestionar un documento PDF que se devuelve del servicio. La clase Java que permite pasar datos a y desde los servicios de AEM Forms es com.adobe.idp.Document
.
Los servicios de AEM Forms no aceptan un documento PDF como otros tipos de datos, como un objeto java.io.InputStream
o una matriz de bytes. Un objeto com.adobe.idp.Document
también se puede utilizar para pasar otros tipos de datos, como datos XML, a los servicios.
Un objeto com.adobe.idp.Document
es un tipo de Java serializable, por lo que se puede pasar a través de una llamada RMI. El lado receptor puede estar ubicado en el mismo lugar (mismo host, mismo cargador de clase), local (mismo host, diferente cargador de clase) o remoto (diferente host). El paso del contenido del documento está optimizado para cada caso. Por ejemplo, si el remitente y el receptor están ubicados en el mismo host, el contenido se pasa a través de un sistema de archivos local. (En algunos casos, los documentos se pueden pasar en la memoria).
Según el tamaño del objeto com.adobe.idp.Document
, los datos se transportan dentro del objeto com.adobe.idp.Document
o se almacenan en el sistema de archivos del servidor. Cualquier recurso de almacenamiento temporal ocupado por el objeto com.adobe.idp.Document
se elimina automáticamente al eliminar com.adobe.idp.Document
. (Consulte Disposición de objetos de documento).
A veces es necesario conocer el tipo de contenido de un objeto com.adobe.idp.Document
para poder pasarlo a un servicio. Por ejemplo, si una operación requiere un tipo de contenido específico, como application/pdf
, se recomienda determinar el tipo de contenido. (Consulte Determinación del tipo de contenido de un documento).
El objeto com.adobe.idp.Document
intenta determinar el tipo de contenido utilizando los datos suministrados. Si no se puede recuperar el tipo de contenido de los datos suministrados (por ejemplo, cuando los datos se suministraron como una matriz de bytes), defina el tipo de contenido. Para establecer el tipo de contenido, invoque el método com.adobe.idp.Document
del objeto setContentType
. (Consulte Determinación del tipo de contenido de un documento)
Si los archivos colaterales residen en el mismo sistema de archivos, la creación de un objeto com.adobe.idp.Document
es más rápida. Si los archivos colaterales residen en sistemas de archivos remotos, se debe realizar una operación de copia, lo que afecta al rendimiento.
Una aplicación puede contener tipos de datos com.adobe.idp.Document
y org.w3c.dom.Document
. Sin embargo, asegúrese de que califica completamente el tipo de datos org.w3c.dom.Document
. Para obtener información sobre la conversión de un objeto org.w3c.dom.Document
en un objeto com.adobe.idp.Document
, consulte Inicio rápido (modo EJB): Rellenado previo de Forms con diseños de flujo mediante la API de Java.
Para evitar una fuga de memoria en WebLogic mientras se utiliza un objeto com.adobe.idp.Document
, lea la información del documento en fragmentos de 2048 bytes o menos. Por ejemplo, el siguiente código lee la información del documento en trozos de 2048 bytes:
// Set up the chunk size to prevent a potential memory leak
int buffSize = 2048;
// Determine the total number of bytes to read
int docLength = (int) inDoc.length();
byte [] byteDoc = new byte[docLength];
// Set up the reading position
int pos = 0;
// Loop through the document information, 2048 bytes at a time
while (docLength > 0) {
// Read the next chunk of information
int toRead = Math.min(buffSize, docLength);
int bytesRead = inDoc.read(pos, byteDoc, pos, toRead);
// Handle the exception in case data retrieval failed
if (bytesRead == -1) {
inDoc.doneReading();
inDoc.dispose();
throw new RuntimeException("Data retrieval failed!");
}
// Update the reading position and number of bytes remaining
pos += bytesRead;
docLength -= bytesRead;
}
// The document information has been successfully read
inDoc.doneReading();
inDoc.dispose();
Consulte también
Invocación de AEM Forms mediante la API de Java
Configuración de las propiedades de conexión
Cree un objeto com.adobe.idp.Document
antes de invocar una operación de servicio que requiera un documento PDF (u otros tipos de documento) como valor de entrada. La clase com.adobe.idp.Document
proporciona constructores que permiten crear un documento a partir de los siguientes tipos de contenido:
com.adobe.idp.Document
existentejava.io.File
java.io.InputStream
java.net.URL
En el siguiente ejemplo de código se crea un objeto com.adobe.idp.Document
basado en una matriz de bytes.
Creación de un objeto Document basado en una matriz de bytes
Document myPDFDocument = new Document(myByteArray);
En el siguiente ejemplo de código se crea un objeto com.adobe.idp.Document
basado en otro objeto com.adobe.idp.Document
.
Creación de un objeto Document basado en otro documento
//Create a Document object based on a byte array
InputStream is = new FileInputStream("C:\\Map.pdf");
int len = is.available();
byte [] myByteArray = new byte[len];
int i = 0;
while (i < len) {
i += is.read(myByteArray, i, len);
}
Document myPDFDocument = new Document(myByteArray);
//Create another Document object
Document anotherDocument = new Document(myPDFDocument);
En el siguiente ejemplo de código se crea un objeto com.adobe.idp.Document
basado en un archivo PDF denominado map.pdf. Este archivo se encuentra en la raíz del disco duro C. Este constructor intenta establecer el tipo de contenido MIME del objeto com.adobe.idp.Document
utilizando la extensión de nombre de archivo.
El constructor com.adobe.idp.Document
que acepta un objeto java.io.File
también acepta un parámetro booleano. Al establecer este parámetro en true
, el objeto com.adobe.idp.Document
elimina el archivo. Esta acción significa que no es necesario quitar el archivo después de pasarlo al constructor com.adobe.idp.Document
.
Si establece este parámetro en false
significa que mantiene la propiedad de este archivo. Establecer este parámetro en true
es más eficaz. El motivo es que el objeto com.adobe.idp.Document
puede mover el archivo directamente al área local administrada en lugar de copiarlo (que es más lento).
Creación de un objeto Document basado en un archivo PDF
//Create a Document object based on the map.pdf source file
File mySourceMap = new File("C:\\map.pdf");
Document myPDFDocument = new Document(mySourceMap,true);
El siguiente ejemplo de código Java crea un objeto com.adobe.idp.Document
basado en un objeto java.io.InputStream
.
Creación de un documento basado en un objeto InputStream
//Create a Document object based on an InputStream object
InputStream is = new FileInputStream("C:\\Map.pdf");
Document myPDFDocument = new Document(is);
El siguiente ejemplo de código Java crea un objeto com.adobe.idp.Document
basado en un archivo PDF denominado map.pdf. Este archivo se encuentra dentro de una aplicación web llamada WebApp
que se ejecuta en localhost
. Este constructor intenta establecer el tipo de contenido MIME del objeto com.adobe.idp.Document
utilizando el tipo de contenido devuelto con el protocolo URL.
La dirección URL suministrada al objeto com.adobe.idp.Document
siempre se lee en el lateral donde se crea el objeto com.adobe.idp.Document
original, como se muestra en este ejemplo:
Document doc = new Document(new java.net.URL("file:c:/temp/input.pdf"));
El archivo c:/temp/input.pdf debe estar ubicado en el equipo cliente (no en el equipo servidor). El equipo cliente es donde se lee la dirección URL y donde se creó el objeto com.adobe.idp.Document
.
Creación de un documento basado en contenido accesible desde una dirección URL
//Create a Document object based on a java.net.URL object
URL myURL = new URL("http", "localhost", 8080,"/WebApp/map.pdf");
//Create another Document object
Document myPDFDocument = new Document(myURL);
Consulte también
Invocación de AEM Forms mediante la API de Java
Configuración de las propiedades de conexión
Las operaciones de servicio que devuelven un documento PDF (u otros tipos de datos, como datos XML) como valor de salida devuelven un objeto com.adobe.idp.Document
. Después de recibir un objeto com.adobe.idp.Document
, puede convertirlo a los siguientes formatos:
java.io.File
java.io.InputStream
La línea de código siguiente convierte un objeto com.adobe.idp.Document
en un objeto java.io.InputStream
. Supongamos que myPDFDocument
representa un objeto com.adobe.idp.Document
:
java.io.InputStream resultStream = myDocument.getInputStream();
Del mismo modo, puede copiar el contenido de un com.adobe.idp.Document
en un archivo local realizando las siguientes tareas:
java.io.File
.com.adobe.idp.Document
del objeto copyToFile
y pase el objeto java.io.File
.El siguiente ejemplo de código copia el contenido de un objeto com.adobe.idp.Document
en un archivo denominado OtherMap.pdf.
Copia del contenido de un objeto de documento en un archivo
File outFile = new File("C:\\AnotherMap.pdf");
myDocument.copyToFile (outFile);
Consulte también
Invocación de AEM Forms mediante la API de Java
Configuración de las propiedades de conexión
Determine el tipo MIME de un objeto com.adobe.idp.Document
invocando el método com.adobe.idp.Document
del objeto getContentType
. Este método devuelve un valor de cadena que especifica el tipo de contenido del objeto com.adobe.idp.Document
. En la tabla siguiente se describen los diferentes tipos de contenido que devuelve AEM Forms.
Tipo MIME |
Descripción |
---|---|
|
Documento PDF |
|
Paquete de datos XML (XDP), que se utiliza para formularios exportados de XML Forms Architecture (XFA) |
|
Marcadores, archivos adjuntos u otros documentos XML |
|
Formato de datos de Forms (FDF), que se utiliza para formularios Acrobat exportados |
|
Formato de datos XML Forms (XFDF), que se utiliza para formularios Acrobat exportados |
|
Formato de datos enriquecido y XML |
|
Formato de datos genérico |
|
Tipo MIME no especificado |
El siguiente ejemplo de código determina el tipo de contenido de un objeto com.adobe.idp.Document
.
Determinación del tipo de contenido de un objeto Document
//Determine the content type of the Document object
String ct = myDocument.getContentType();
System.out.println("The content type of the Document object is " +ct);
Consulte también
Invocación de AEM Forms mediante la API de Java
Configuración de las propiedades de conexión
Cuando ya no necesite un objeto Document
, se recomienda eliminarlo invocando su método dispose
. Cada objeto Document
consume un descriptor de archivo y hasta 75 MB de espacio RAM en la plataforma host de la aplicación. Si un objeto Document
no se ha eliminado, el proceso de recopilación de Java Garage lo elimina. Sin embargo, al eliminarlo antes mediante el método dispose
, puede liberar la memoria ocupada por el objeto Document
.
Consulte también
Invocación de AEM Forms mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Invocación de un servicio mediante una biblioteca de cliente Java
Las operaciones del servicio AEM Forms se pueden invocar utilizando la API con establecimiento inflexible de tipos de un servicio, conocida como biblioteca de cliente Java. Una biblioteca de cliente Java es un conjunto de clases concretas que proporcionan acceso a los servicios implementados en el contenedor de servicios. Se crea una instancia de un objeto Java que representa el servicio que se va a invocar en lugar de crear un objeto InvocationRequest
mediante la API de invocación. La API de invocación se utiliza para invocar procesos, como procesos de larga duración, creados en Workbench. (Consulte Invocación de procesos de larga duración centrados en los humanos).
Para realizar una operación de servicio, invoque un método que pertenezca al objeto Java. Una biblioteca de cliente Java contiene métodos que normalmente asignan una a una con operaciones de servicio. Cuando utilice una biblioteca de cliente Java, establezca las propiedades de conexión necesarias. (Consulte Configuración de las propiedades de conexión).
Después de establecer las propiedades de conexión, cree un objeto ServiceClientFactory
que se utilice para crear una instancia de un objeto Java que le permita invocar un servicio. Cada servicio que tiene una biblioteca de cliente Java tiene un objeto cliente correspondiente. Por ejemplo, para invocar el servicio Repositorio, cree un objeto ResourceRepositoryClient
utilizando su constructor y pasando el objeto ServiceClientFactory
. El objeto ServiceClientFactory
es responsable de mantener la configuración de conexión necesaria para invocar los servicios de AEM Forms.
Aunque la obtención de un ServiceClientFactory
suele ser rápida, algunos costes generales están relacionados cuando se utiliza por primera vez la fábrica. Este objeto está optimizado para su reutilización y, por lo tanto, cuando sea posible, utilice el mismo objeto ServiceClientFactory
cuando esté creando varios objetos de cliente Java. Es decir, no cree un objeto ServiceClientFactory
independiente para cada objeto de biblioteca de cliente que cree.
Existe una configuración del Administrador de usuarios que controla la duración de la afirmación de SAML que se encuentra dentro del objeto com.adobe.idp.Context
que afecta al objeto ServiceClientFactory
. Esta configuración controla todas las duraciones del contexto de autenticación en AEM Forms, incluidas todas las invocaciones realizadas mediante la API de Java. De forma predeterminada, el período de tiempo en el que se puede utilizar un objeto ServiceCleintFactory
es de dos horas.
Para explicar cómo invocar un servicio utilizando la API de Java, se invoca la operación writeResource
del servicio Repositorio. Esta operación coloca un nuevo recurso en el repositorio.
Puede invocar el servicio Repositorio utilizando una biblioteca de cliente Java y realizando los siguientes pasos:
Incluya archivos JAR del cliente, como adobe-repository-client.jar, en la ruta de clase de su proyecto Java. Para obtener información sobre la ubicación de estos archivos, consulte Inclusión de archivos de biblioteca Java de AEM Forms.
Establezca las propiedades de conexión necesarias para invocar un servicio.
Cree un objeto ServiceClientFactory
invocando el método estático ServiceClientFactory
del objeto createInstance
y pasando el objeto java.util.Properties
que contiene las propiedades de conexión.
Cree un objeto ResourceRepositoryClient
utilizando su constructor y pasando el objeto ServiceClientFactory
. Utilice el objeto ResourceRepositoryClient
para invocar las operaciones del servicio Repositorio.
Cree un objeto RepositoryInfomodelFactoryBean
usando su constructor y pase null
. Este objeto permite crear un objeto Resource
que representa el contenido añadido al repositorio.
Cree un objeto Resource
invocando el método RepositoryInfomodelFactoryBean
del objeto newImage
y pasando los siguientes valores:
new Id()
.new Lid()
.Establezca el valor devuelto en Resource
.
Cree un objeto ResourceContent
invocando el método RepositoryInfomodelFactoryBean
del objeto newImage
y convirtiendo el valor devuelto en ResourceContent
. Este objeto representa el contenido que se agrega al repositorio.
Cree un objeto com.adobe.idp.Document
pasando un objeto java.io.FileInputStream
que almacene el archivo XDP para agregarlo al repositorio. (Consulte Creación de un documento basado en un objeto InputStream).
Agregue el contenido del objeto com.adobe.idp.Document
al objeto ResourceContent
invocando el método ResourceContent
del objeto setDataDocument
. Pase el objeto com.adobe.idp.Document
.
Establezca el tipo MIME del archivo XDP que desea agregar al repositorio invocando el método ResourceContent
del objeto setMimeType
y pasando application/vnd.adobe.xdp+xml
.
Agregue el contenido del objeto ResourceContent
al objeto Resource
invocando el método Resource
del objeto ‘s setContent
y pasando el objeto ResourceContent
.
Añada una descripción del recurso invocando el método Resource
del objeto ‘s setDescription
y pasando un valor de cadena que represente una descripción del recurso.
Agregue el diseño de formulario al repositorio invocando el método ResourceRepositoryClient
del objeto writeResource
y pasando los siguientes valores:
Resource
que se creóConsulte también
Inicio rápido (modo EJB): Escritura de un recurso mediante la API de Java
Invocación de AEM Forms mediante la API de Java
Inclusión de archivos de biblioteca Java de AEM Forms
Puede invocar un proceso de corta duración mediante la API de invocación de Java. Cuando se invoca un proceso de corta duración mediante la API de invocación, se pasan los valores de parámetro necesarios mediante un objeto java.util.HashMap
. Para que cada parámetro pase a un servicio, invoque el método java.util.HashMap
del objeto put
y especifique el par nombre-valor que requiere el servicio para realizar la operación especificada. Especifique el nombre exacto de los parámetros que pertenecen al proceso de corta duración.
Para obtener información sobre cómo invocar un proceso de larga duración, consulte Invocación de procesos de larga duración centrados en el ser humano.
La discusión aquí es sobre el uso de la API de invocación para invocar el siguiente proceso breve de AEM Forms llamado MyApplication/EncryptDocument
.
Este proceso no se basa en un proceso de AEM Forms existente. Para seguir con el ejemplo de código, cree un proceso denominado MyApplication/EncryptDocument
con Workbench. (Consulte Uso de Workbench).
Cuando se invoca este proceso, realiza las siguientes acciones:
SetValue
. El parámetro de entrada para este proceso es una variable de proceso document
denominada inDoc
.PasswordEncryptPDF
. El documento PDF cifrado con contraseña se devuelve en una variable de proceso denominada outDoc
.Invoque el proceso de corta duración MyApplication/EncryptDocument
utilizando la API de invocación de Java:
Incluya archivos JAR del cliente, como adobe-livecycle-client.jar, en la ruta de clase de su proyecto Java. (Consulte Inclusión de archivos de biblioteca Java de AEM Forms).
Cree un objeto ServiceClientFactory
que contenga propiedades de conexión. (Consulte Configuración de las propiedades de conexión).
Cree un objeto ServiceClient
utilizando su constructor y pasando el objeto ServiceClientFactory
. Un objeto ServiceClient
permite invocar una operación de servicio. Gestiona tareas como la localización, el envío y las solicitudes de invocación de enrutamiento.
Cree un objeto java.util.HashMap
utilizando su constructor.
Invoque el método java.util.HashMap
del objeto put
para que cada parámetro de entrada pase al proceso de larga duración. Dado que el proceso de corta duración MyApplication/EncryptDocument
requiere un parámetro de entrada de tipo Document
, solo debe invocar el método put
una vez, como se muestra en el siguiente ejemplo.
//Create a Map object to store the parameter value for inDoc
Map params = new HashMap();
InputStream inFile = new FileInputStream("C:\\Adobe\Loan.pdf");
Document inDoc = new Document(inFile);
params.put("inDoc", inDoc);
Cree un objeto InvocationRequest
invocando el método ServiceClientFactory
del objeto createInvocationRequest
y pasando los siguientes valores:
MyApplication/EncryptDocument
, especifique MyApplication/EncryptDocument
.invoke
.java.util.HashMap
que contiene los valores de parámetro que requiere la operación de servicio.true
, que crea una solicitud sincrónica (este valor es aplicable para invocar un proceso de corta duración).Envíe la solicitud de invocación al servicio invocando el método ServiceClient
del objeto invoke
y pasando el objeto InvocationRequest
. El método invoke
devuelve un objeto InvocationReponse
.
Se puede invocar un proceso de larga duración pasando el valor false
como el cuarto parámetro del método createInvocationRequest
. Pasar el valor false
crea una solicitud asincrónica.
Recupere el valor devuelto del proceso invocando el método InvocationReponse
del objeto getOutputParameter
y pasando un valor de cadena que especifica el nombre del parámetro de salida. En esta situación, especifique outDoc
( outDoc
es el nombre del parámetro de salida para el proceso MyApplication/EncryptDocument
). Establezca el valor devuelto en Document
, como se muestra en el siguiente ejemplo.
InvocationResponse response = myServiceClient.invoke(request);
Document encryptDoc = (Document) response.getOutputParameter("outDoc");
Cree un objeto java.io.File
y asegúrese de que la extensión del archivo sea .pdf.
Invoque el método com.adobe.idp.Document
del objeto copyToFile
para copiar el contenido del objeto com.adobe.idp.Document
en el archivo. Asegúrese de utilizar el objeto com.adobe.idp.Document
que el método getOutputParameter
devolvió.
Consulte también
Inicio rápido: Invocación de un proceso de corta duración mediante la API de invocación
Invocación de procesos de larga vida centrados en el ser humano