Chiamata AEM Forms mediante l'API Java

Richiamo di processi a lunga durata basati sull'uomo

Chiamata AEM Forms tramite servizi Web

Trasmissione di dati a servizi AEM Forms tramite Java API

Chiamata di un servizio tramite una libreria client Java

Richiamo di un processo di breve durata tramite l'API di incitamento

Creazione di un'applicazione Web Java che richiama un processo longevo incentrato sull'uomo

Inclusione file libreria Java AEM Forms

Per richiamare un servizio AEM Forms a livello di programmazione utilizzando l'API Java, includete i file libreria richiesti (file JAR) nel percorso di classe del progetto Java. I file JAR inclusi nel percorso di classe dell'applicazione client dipendono da diversi fattori:

Il servizio AEM Forms da richiamare. Un'applicazione client può richiamare uno o più servizi.
Modalità in cui si desidera richiamare un servizio AEM Forms . È possibile utilizzare la modalità EJB o SOAP. (Vedere Impostazione delle proprietà di connessione.)

NOTA

(Solo chiavi in mano) Avviare il server AEM Forms con il comando standalone.bat -b <Server IP> -c lc_turnkey.xml per specificare un IP server per EJB.

Il server applicazione J2EE su cui è distribuito AEM Forms.

File JAR specifici del servizio

Nella tabella seguente sono elencati i file JAR necessari per richiamare servizi AEM Forms.

File	Descrizione	Dove si trova
adobe-livecycle-client.jar	Deve essere sempre incluso nel percorso di classe di un'applicazione client Java.	<>install directory>/sdk/client-libs/common
adobe-usermanager-client.jar	Deve essere sempre incluso nel percorso di classe di un'applicazione client Java.	<>install directory>/sdk/client-libs/common
adobe-utilities.jar	Deve essere sempre incluso nel percorso di classe di un'applicazione client Java.	<>install directory>/sdk//client-libs/<app server="">
adobe-applicationmanager-client-sdk.jar	Obbligatorio per richiamare il servizio Application Manager.	<>install directory>/sdk/client-libs/common
adobe-assembler-client.jar	Obbligatorio per richiamare il servizio Assembler.	<>install directory>/sdk/client-libs/common
adobe-backup-restore-client-sdk.jar	Richiesto per richiamare l'API del servizio Backup e ripristino.	<>install directory>/sdk/client-libs/common
adobe-barcodedforms-client.jar	Obbligatorio per richiamare il servizio moduli con codice a barre.	<>install directory>/sdk/client-libs/common
adobe-convertpdf-client.jar	Obbligatorio per richiamare il servizio Converti PDF.	<>install directory>/sdk/client-libs/common
adobe-distiller-client.jar	Obbligatorio per richiamare il servizio Distiller.	<>install directory>/sdk/client-libs/common
adobe-docconverter-client.jar	Obbligatorio per richiamare il servizio DocConverter.	<>install directory>/sdk/client-libs/common
adobe-contentservices-client.jar	Obbligatorio per richiamare il servizio Document Management.	<>install directory>/sdk/client-libs/common
adobe-encryption-client.jar	Richiesto per richiamare il servizio di cifratura.	<>install directory>/sdk/client-libs/common
adobe-forms-client.jar	Obbligatorio per richiamare il servizio Forms.	<>install directory>/sdk/client-libs/common
adobe-formdataintegration-client.jar	Richiesto per richiamare il servizio di integrazione dei dati del modulo.	<>install directory>/sdk/client-libs/common
adobe-generatepdf-client.jar	Richiesto per richiamare il servizio Generate PDF.	<>install directory>/sdk/client-libs/common
adobe-generate3dpdf-client.jar	Richiesto per richiamare il servizio Genera PDF 3D.	<>install directory>/sdk/client-libs/common
adobe-jobmanager-client-sdk.jar	Obbligatorio per richiamare il servizio Job Manager.	<>install directory>/sdk/client-libs/common
adobe-output-client.jar	Obbligatorio per richiamare il servizio Output.	<>install directory>/sdk/client-libs/common
adobe-pdfutility-client.jar	Obbligatorio per richiamare il servizio Utilità PDF o Utilità XMP.	<>install directory>/sdk/client-libs/common
adobe-reader-extensions-client.jar	Obbligatorio per richiamare il servizio di estensione Acrobat Reader DC.	<>install directory>/sdk/client-libs/common
adobe-repository-client.jar commons-codec-1.3.jar	Obbligatorio per richiamare il servizio Repository.	<>install directory>/sdk/client-libs/common <>install directory>/sdk/client-libs\thirdparty
adobe-rightsmanagement-client.jar namespace.jar jaxb-api.jar jaxb-impl.jar jaxb-libs.jar jaxb-xjc.jar relaxngDatatype.jar xsdlib.jar	Obbligatorio per richiamare il servizio Rights Management. Se AEM Forms è distribuito su JBoss, includete tutti questi file.	<>install directory>/sdk/client-libs/common Directory lib specifica per JBoss
adobe-signatures-client.jar	Obbligatorio per richiamare il servizio Signature.	<>install directory>/sdk/client-libs/common
adobe-taskmanager-client-sdk.jar	Richiesto per richiamare il servizio Task Manager.	<>install directory>/sdk/client-libs/common
adobe-truststore-client.jar	Obbligatorio per richiamare il servizio Archivio attendibili.	<>install directory>/sdk/client-libs/common

Modalità di connessione e file JAR dell'applicazione J2EE

Nella tabella seguente sono elencati i file JAR che dipendono dalla modalità di connessione e dal server applicazione J2EE su cui AEM Forms è distribuito.

</thead align="left">

File	Descrizione	Dove si trova
activation.jar axis.jar commons-codec-1.3.jar commons-collections-3.1.jar commons-discovery.jar commons-logging.jar dom3-xml-apis-2.5.0.jar jaxen-1.1-beta-9.jar jaxrpc.jar log4j.jar mail.jar saaj.jar wsdl4j.jar xalan.jar xbean.jar xercesImpl.jar commons-httpclient-3.1.jar	se AEM Forms viene richiamato utilizzando la modalità SOAP, includete questi file JAR.	<>install directory>/sdk/client-libs/third-party
jboss-client.jar	se AEM Forms è distribuito su JBoss Application Server, includete questo file JAR. Le classi obbligatorie non vengono trovate dal caricatore di classe se jboss-client.jar e le barre di riferimento non sono co-posizionate.	Directory lib client JBoss Se distribuite l’applicazione client sullo stesso server applicazione J2EE, non è necessario includere questo file.
wlclient.jar	se AEM Forms è distribuito su BEA WebLogic Server®, includete questo file JAR.	Directory lib specifica per WebLogic Se distribuite l’applicazione client sullo stesso server applicazione J2EE, non è necessario includere questo file.
com.ibm.ws.admin.client_6.1.0.jar com.ibm.ws.webservices.thinclient_6.1.0.jar	se AEM Forms è distribuito su WebSphere Application Server, includete questi file JAR. (com.ibm.ws.webservices.thinclient_6.1.0.jar è richiesto per la chiamata al servizio Web).	Directory lib specifica per WebSphere ([WAS_HOME]/runtime) Se distribuite l’applicazione client sullo stesso server applicazione J2EE, non è necessario includere tali file.

Richiamo di scenari

La tabella seguente specifica gli scenari di chiamata ed elenca i file JAR richiesti per richiamare AEM Forms.

</thead align="left"> xmp-uti

Servizi	Modalità di incitamento	Server applicazioni J2EE	File JAR richiesti
servizio Forms	EJB	JBoss	adobe-livecycle-client.jar adobe-usermanager-client.jar jboss-client.jar adobe-forms-client.jar commons-httpclient-3.1.jar
servizio Forms Servizio estensioni Acrobat Reader DC Servizio Firma	EJB	JBoss	adobe-livecycle-client.jar adobe-usermanager-client.jar jboss-client.jar commons-httpclient-3.1.jar adobe-forms-client.jar adobe-reader-extensions-client.jar adobe-signatures-client.jar
servizio Forms	SOAP	WebLogic	adobe-livecycle-client.jar adobe-usermanager-client.jar wlclient.jar activation.jar axis.jar commons-codec-1.3.jar commons-collections-3.1.jar commons-discovery.jar commons-logging.jar dom3-xml-apis-2.5.0.jar jai_imageio.jar jaxen-1.1-beta-9.jar jaxrpc.jar log4j.jar mail.jar saaj.jar wsdl4j.jar xalan.jar xbean.jar xercesImpl.jar adobe-forms-client.jar
servizio Forms Servizio estensioni Acrobat Reader DC Servizio Firma	SOAP	WebLogic	adobe-livecycle-client.jar adobe-usermanager-client.jar wlclient.jar activation.jar axis.jar commons-codec-1.3.jar commons-collections-3.1.jar commons-discovery.jar commons-logging.jar dom3-xml-apis-2.5.0.jar jai_imageio.jar jaxen-1.1-beta-9.jar jaxrpc.jar log4j.jar mail.jar saaj.jar wsdl4j.jar xalan.jar xbean.jar xercesImpl.jar adobe-forms-client.jar adobe-reader-extensions-client.jar adobe-signatures-client.jar

Aggiornamento dei file JAR

Se state effettuando l'aggiornamento da LiveCycle a AEM Forms, si consiglia di includere i file AEM Forms JAR nel percorso di classe del progetto Java. Ad esempio, se utilizzate servizi come il servizio di Rights Management, si verificherà un problema di compatibilità se non includete file AEM Forms JAR nel percorso di classe.

Presupponendo che si stia effettuando l'aggiornamento a AEM Forms. Per utilizzare un'applicazione Java che richiama il servizio di Rights Management, includete le versioni AEM Forms dei seguenti file JAR:

adobe-rightsmanagement-client.jar
adobe-livecycle-client.jar
adobe-usermanager-client.jar

Consulta anche

Trasmissione di dati a servizi AEM Forms tramite Java API

Chiamata di un servizio tramite una libreria client Java

Impostazione delle proprietà di connessione

Le proprietà di connessione vengono impostate per richiamare AEM Forms quando si utilizza l'API Java. Quando si impostano le proprietà di connessione, specificare se richiamare i servizi in remoto o in locale, nonché la modalità di connessione e i valori di autenticazione. I valori di autenticazione sono obbligatori se è abilitata la protezione del servizio. Tuttavia, se la protezione del servizio è disabilitata, non è necessario specificare i valori di autenticazione.

La modalità di connessione può essere SOAP o EJB. La modalità EJB utilizza il protocollo RMI/IIOP e le prestazioni della modalità EJB sono migliori delle prestazioni della modalità SOAP. La modalità SOAP viene utilizzata per eliminare una dipendenza del server applicazione J2EE o quando si trova un firewall tra AEM Forms e l'applicazione client. La modalità SOAP utilizza il protocollo https come trasporto sottostante e può comunicare attraverso i confini del firewall. Se non esiste una dipendenza da un server applicazione J2EE o un firewall, si consiglia di utilizzare la modalità EJB.

Per richiamare un servizio AEM Forms , impostate le seguenti proprietà di connessione:

DSC_DEFAULT_EJB_ENDPOINT: Se utilizzate la modalità di connessione EJB, questo valore rappresenta l'URL del server applicazione J2EE su cui AEM Forms è distribuito. Per richiamare AEM Forms in remoto, specificate il nome del server applicazione J2EE sul quale 'AEM Forms è distribuito. Se l'applicazione client si trova sullo stesso server applicazione J2EE, è possibile specificare localhost. A seconda del server applicazioni J2EE AEM Forms è distribuito, specificate uno dei seguenti valori:
- JBoss: https://<ServerName>:8080 (default port)
- WebSphere: iiop://<ServerName>:2809 (default port)
- WebLogic: t3://<ServerName>:7001 (default port)
DSC_DEFAULT_SOAP_ENDPOINT: Se si utilizza la modalità di connessione SOAP, questo valore rappresenta l'endpoint a cui viene inviata una richiesta di chiamata. Per richiamare AEM Forms in remoto, specificate il nome del server applicazione J2EE sul quale 'AEM Forms è distribuito. Se l'applicazione client si trova sullo stesso server applicazione J2EE, è possibile specificare localhost (ad esempio, http://localhost:8080).
- Il valore della porta 8080 è applicabile se l'applicazione J2EE è JBoss. Se il server applicazioni J2EE è IBM® WebSphere®, utilizzare la porta 9080. Analogamente, se il server applicazione J2EE è WebLogic, utilizzare la porta 7001. (Questi valori sono valori di porta predefiniti. Se modificate il valore della porta, utilizzate il numero di porta applicabile.
DSC_TRANSPORT_PROTOCOL: Se si utilizza la modalità di connessione EJB, specificare ServiceClientFactoryProperties.DSC_EJB_PROTOCOL per questo valore. Se si utilizza la modalità di connessione SOAP, specificare ServiceClientFactoryProperties.DSC_SOAP_PROTOCOL.
DSC_SERVER_TYPE: Specifica il server applicazioni J2EE su cui AEM Forms è distribuito. I valori validi sono JBoss, WebSphere, WebLogic.
- Se si imposta questa proprietà di connessione su WebSphere, il valore java.naming.factory.initial è impostato su com.ibm.ws.naming.util.WsnInitCtxFactory.
- Se si imposta questa proprietà di connessione su WebLogic, il valore java.naming.factory.initial è impostato su weblogic.jndi.WLInitialContextFactory.
- Analogamente, se si imposta questa proprietà di connessione su JBoss, il valore java.naming.factory.initial viene impostato su org.jnp.interfaces.NamingContextFactory.
- Se non si desidera utilizzare i valori predefiniti, è possibile impostare la proprietà java.naming.factory.initial su un valore che soddisfa i requisiti dell'utente.
NOTA

Invece di utilizzare una stringa per impostare la proprietà di connessione DSC_SERVER_TYPE, è possibile utilizzare un membro statico della classe ServiceClientFactoryProperties. È possibile utilizzare i seguenti valori: ServiceClientFactoryProperties.DSC_WEBSPHERE_SERVER_TYPE, ServiceClientFactoryProperties.DSC_WEBLOGIC_SERVER_TYPE o ServiceClientFactoryProperties.DSC_JBOSS_SERVER_TYPE.
DSC_CREDENTIAL_USERNAME: specifica il nome utente del modulo AEM. Affinché un utente possa richiamare correttamente un servizio AEM Forms , deve avere il ruolo Utente servizi. Un utente può anche avere un altro ruolo che include l'autorizzazione Richiamo assistenza. In caso contrario, viene generata un'eccezione quando tentano di richiamare un servizio. Se la protezione del servizio è disabilitata, non è necessario specificare questa proprietà di connessione.
DSC_CREDENTIAL_PASSWORD: specifica il valore della password corrispondente. Se la protezione del servizio è disabilitata, non è necessario specificare questa proprietà di connessione.
DSC_REQUEST_TIMEOUT: il limite di timeout della richiesta predefinita per la richiesta SOAP è di 1200000 millisecondi (20 minuti). A volte, una richiesta può richiedere più tempo per completare l'operazione. Ad esempio, una richiesta SOAP che recupera un insieme di record di grandi dimensioni può richiedere un limite di timeout più lungo. È possibile utilizzare ServiceClientFactoryProperties.DSC_REQUEST_TIMEOUT per aumentare il limite di timeout delle chiamate per le richieste SOAP.

NOTA

Solo le chiamate basate su SOAP supportano la proprietà DSC_REQUEST_TIMEOUT.

Per impostare le proprietà di connessione, eseguire le operazioni seguenti:

Creare un oggetto java.util.Properties utilizzando il relativo costruttore.
Per impostare la proprietà di connessione DSC_DEFAULT_EJB_ENDPOINT, richiamare il metodo java.util.Properties dell'oggetto setProperty e passare i seguenti valori:
- Il valore di enumerazione ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT
- Una stringa che specifica l'URL del server applicazione J2EE che ospita AEM Forms
NOTA

Se si utilizza la modalità di connessione SOAP, specificare il valore di enumerazione ServiceClientFactoryProperties.DSC_DEFAULT_SOAP_ENDPOINT invece del valore di enumerazione ServiceClientFactoryProperties.DSC_DEFAULT_EJB_ENDPOINT.
Per impostare la proprietà di connessione DSC_TRANSPORT_PROTOCOL, richiamare il metodo java.util.Properties dell'oggetto setProperty e passare i seguenti valori:
- Il valore di enumerazione ServiceClientFactoryProperties.DSC_TRANSPORT_PROTOCOL
- Il valore di enumerazione ServiceClientFactoryProperties.DSC_EJB_PROTOCOL
NOTA

Se si utilizza la modalità di connessione SOAP, specificare il valore di enumerazione ServiceClientFactoryProperties.DSC_SOAP_PROTOCOLinvece del valore di enumerazione ServiceClientFactoryProperties.DSC_EJB_PROTOCOL.
Per impostare la proprietà di connessione DSC_SERVER_TYPE, richiamare il metodo java.util.Properties dell'oggetto setProperty e passare i seguenti valori:
- Il valore di enumerazione ServiceClientFactoryProperties.DSC_SERVER_TYPE
- Un valore di stringa che specifica il server applicazione J2EE che ospita AEM Forms (ad esempio, se AEM Forms è distribuito su JBoss, specificare JBoss).
  1. Per impostare la proprietà di connessione DSC_CREDENTIAL_USERNAME, richiamare il metodo java.util.Properties dell'oggetto setProperty e passare i seguenti valori:
- Il valore di enumerazione ServiceClientFactoryProperties.DSC_CREDENTIAL_USERNAME
- Una stringa che specifica il nome utente richiesto per richiamare AEM Forms
  1. Per impostare la proprietà di connessione DSC_CREDENTIAL_PASSWORD, richiamare il metodo java.util.Properties dell'oggetto setProperty e passare i seguenti valori:
- Il valore di enumerazione ServiceClientFactoryProperties.DSC_CREDENTIAL_PASSWORD
- Valore stringa che specifica il valore della password corrispondente

Impostazione della modalità di connessione EJB per JBoss

L'esempio di codice Java seguente imposta le proprietà di connessione per richiamare AEM Forms distribuito su JBoss e utilizzare la modalità di connessione 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");

Impostazione della modalità di connessione EJB per WebLogic

L'esempio di codice Java seguente imposta le proprietà di connessione per richiamare AEM Forms distribuito su WebLogic e utilizzare la modalità di connessione 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");

Impostazione della modalità di connessione EJB per WebSphere

L'esempio di codice Java seguente imposta le proprietà di connessione per richiamare AEM Forms distribuito su WebSphere e utilizzare la modalità di connessione 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");

Impostazione della modalità di connessione SOAP

L'esempio di codice Java seguente imposta le proprietà di connessione in modalità SOAP per richiamare AEM Forms distribuito su 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");

NOTA

Se selezionate la modalità di connessione SOAP, accertatevi di includere ulteriori file JAR nel percorso di classe dell'applicazione client.

Impostazione delle proprietà di connessione quando la protezione del servizio è disabilitata

L'esempio di codice Java seguente imposta le proprietà di connessione necessarie per richiamare AEM Forms distribuito su JBoss Application Server e quando la protezione del servizio è disabilitata.

 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");

NOTA

Tutti gli avvii rapidi Java associati alla programmazione con AEM Forms mostrano le impostazioni di connessione EJB e SOAP.

Impostazione della modalità di connessione SOAP con il limite di timeout della richiesta personalizzata

 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

Utilizzo di un oggetto Context per richiamare AEM Forms

È possibile utilizzare un oggetto com.adobe.idp.Context per richiamare un servizio AEM Forms con un utente autenticato (l'oggetto com.adobe.idp.Context rappresenta un utente autenticato). Quando si utilizza un oggetto com.adobe.idp.Context, non è necessario impostare le proprietà DSC_CREDENTIAL_USERNAME o DSC_CREDENTIAL_PASSWORD. È possibile ottenere un oggetto com.adobe.idp.Context durante l'autenticazione degli utenti utilizzando il metodo AuthenticationManagerServiceClient dell'oggetto authenticate.

Il metodo authenticate restituisce un oggetto AuthResult che contiene i risultati dell'autenticazione. È possibile creare un oggetto com.adobe.idp.Context richiamandone il costruttore. Quindi, richiamare il metodo com.adobe.idp.Context dell'oggetto initPrincipal e passare l'oggetto AuthResult, come illustrato nel codice seguente:

 Context myCtx = new Context();
 myCtx.initPrincipal(authResult);

Anziché impostare le proprietà DSC_CREDENTIAL_USERNAME o DSC_CREDENTIAL_PASSWORD, è possibile richiamare il metodo ServiceClientFactory dell'oggetto setContext e passare l'oggetto com.adobe.idp.Context. Quando si utilizza un utente di moduli AEM per richiamare un servizio, assicurarsi di avere il ruolo Services User richiesto per richiamare un servizio AEM Forms .

L'esempio di codice seguente mostra come utilizzare un oggetto com.adobe.idp.Context all'interno delle impostazioni di connessione, utilizzato per creare un oggetto 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);

NOTA

Per informazioni complete sull'autenticazione di un utente, vedere Autenticazione di utenti.

Richiamo di scenari

In questa sezione vengono descritti i seguenti scenari di richiamo:

Un'applicazione client in esecuzione nella propria macchina virtuale Java (JVM) richiama un'istanza autonoma AEM Forms.
Un'applicazione client in esecuzione nel proprio JVM richiama istanze AEM Forms cluster.

Applicazione client che richiama un'istanza autonoma AEM Forms

Il diagramma seguente mostra un'applicazione client in esecuzione nella propria JVM e che richiama un'istanza autonoma AEM Forms.

In questo scenario, un'applicazione client è in esecuzione in una propria JVM e richiama servizi AEM Forms.

NOTA

Questo scenario è lo scenario di richiamo su cui si basano tutti gli avvii rapidi.

Applicazione client che richiama istanze AEM Forms cluster

Il diagramma seguente mostra un'applicazione client in esecuzione nella propria JVM e che richiama istanze AEM Forms presenti in un cluster.

Questo scenario è simile a quello di un'applicazione client che richiama un'istanza autonoma AEM Forms. Tuttavia, l'URL del fornitore è diverso. Se un'applicazione client desidera connettersi a un server applicazione J2EE specifico, l'applicazione deve modificare l'URL per fare riferimento al server applicazione J2EE specifico.

Non è consigliabile fare riferimento a uno specifico server applicazione J2EE perché la connessione tra l'applicazione client e AEM Forms viene terminata se il server applicazioni si arresta. È consigliabile che l'URL del provider faccia riferimento a un gestore JNDI a livello di cella, invece di un server applicazione J2EE specifico.

Le applicazioni client che utilizzano la modalità di connessione SOAP possono utilizzare la porta di bilanciamento del carico HTTP per il cluster. Le applicazioni client che utilizzano la modalità di connessione EJB possono connettersi alla porta EJB di un server applicazione J2EE specifico. Questa azione gestisce il bilanciamento del carico tra i nodi del cluster.

WebSphere

L'esempio seguente mostra il contenuto di un file jndi.properties utilizzato per connettersi a AEM Forms distribuito su WebSphere.

 java.naming.factory.initial=com.ibm.websphere.naming.
 WsnInitialContextFactory
 java.naming.provider.url=corbaloc::appserver1:9810,:appserver2:9810

WebLogic

L'esempio seguente mostra il contenuto di un file jndi.properties utilizzato per connettersi a AEM Forms distribuito su WebLogic.

 java.naming.factory.initial=weblogic.jndi.WLInitialContextFactory
 java.naming.provider.url=t3://appserver1:8001, appserver2:8001

JBoss

L'esempio seguente mostra il contenuto di un file jndi.properties utilizzato per connettersi a AEM Forms distribuito su JBoss.

 java.naming.factory.initial= org.jnp.interfaces.NamingContextFactory
 java.naming.provider.url= jnp://appserver1:1099, appserver2:1099,
 appserver3:1099

NOTA

Consultate l’amministratore per determinare il nome del server applicazione J2EE e il numero di porta.

Consulta anche

Trasmissione di dati a servizi AEM Forms tramite Java API

Chiamata di un servizio tramite una libreria client Java

Trasmissione di dati a servizi AEM Forms tramite Java API

le operazioni del servizio AEM Forms in genere consumano o producono documenti PDF. Quando si richiama un servizio, talvolta è necessario trasmettere al servizio un documento PDF (o altri tipi di documento, come i dati XML). Analogamente, talvolta è necessario gestire un documento PDF restituito dal servizio. La classe Java che consente di trasmettere dati a e da servizi AEM Forms è com.adobe.idp.Document.

servizi AEM Forms non accettano un documento PDF come altri tipi di dati, ad esempio un oggetto java.io.InputStream o un array di byte. Un oggetto com.adobe.idp.Document può essere utilizzato anche per trasmettere ai servizi altri tipi di dati, come i dati XML.

Un oggetto com.adobe.idp.Document è un tipo serializzabile Java e può quindi essere trasmesso su una chiamata RMI. Il lato ricevente può essere collocato (stesso host, stesso loader di classe), locale (stesso host, diverso loader di classe) o remoto (host diverso). La trasmissione del contenuto del documento è ottimizzata per ogni caso. Ad esempio, se il mittente e il destinatario si trovano sullo stesso host, il contenuto viene trasmesso su un file system locale. In alcuni casi, i documenti possono essere passati in memoria.

A seconda delle dimensioni dell'oggetto com.adobe.idp.Document, i dati vengono memorizzati all'interno dell'oggetto com.adobe.idp.Document o nel file system del server. Tutte le risorse di memorizzazione temporanea occupate dall'oggetto com.adobe.idp.Document vengono rimosse automaticamente al momento dello smaltimento com.adobe.idp.Document. (Vedere Eliminazione di oggetti documento.)

A volte è necessario conoscere il tipo di contenuto di un oggetto com.adobe.idp.Document prima di trasmetterlo a un servizio. Ad esempio, se un'operazione richiede un tipo di contenuto specifico, come application/pdf, è consigliabile determinare il tipo di contenuto. (Vedere Definizione del tipo di contenuto di un documento.)

L'oggetto com.adobe.idp.Document tenta di determinare il tipo di contenuto utilizzando i dati forniti. Se il tipo di contenuto non può essere recuperato dai dati forniti (ad esempio, quando i dati sono stati forniti come array di byte), impostare il tipo di contenuto. Per impostare il tipo di contenuto, richiamare il metodo com.adobe.idp.Document dell'oggetto setContentType. (Vedere Definizione del tipo di contenuto di un documento)

Se i file collaterali risiedono sullo stesso file system, la creazione di un oggetto com.adobe.idp.Document è più rapida. Se i file collaterali risiedono su file system remoti, è necessario eseguire un'operazione di copia, che influisce sulle prestazioni.

Un'applicazione può contenere sia tipi di dati com.adobe.idp.Document che org.w3c.dom.Document. Tuttavia, accertati di qualificare completamente il tipo di dati org.w3c.dom.Document. Per informazioni sulla conversione di un oggetto org.w3c.dom.Document in un oggetto com.adobe.idp.Document, vedere Avvio rapido (modalità EJB): Precompilazione di Forms con layout scorrevoli mediante l'API Java.

NOTA

Per evitare una perdita di memoria in WebLogic durante l'utilizzo di un oggetto com.adobe.idp.Document, leggere le informazioni del documento in blocchi di almeno 2048 byte. Ad esempio, il codice seguente legge le informazioni del documento in blocchi di 2048 byte:

        // 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();

Consulta anche

Creazione di documenti

Creare un oggetto com.adobe.idp.Document prima di richiamare un'operazione di servizio che richiede un documento PDF (o altri tipi di documento) come valore di input. La classe com.adobe.idp.Document fornisce costruttori che consentono di creare un documento dai seguenti tipi di contenuto:

Array a byte
Un oggetto com.adobe.idp.Document esistente
Oggetto java.io.File
Oggetto java.io.InputStream
Oggetto java.net.URL

Creazione di un documento basato su un array di byte

Nell'esempio di codice seguente viene creato un oggetto com.adobe.idp.Document basato su un array di byte.

Creazione di un oggetto Document basato su un array di byte

 Document myPDFDocument = new Document(myByteArray);

Creazione di un documento basato su un altro documento

Nell'esempio di codice seguente viene creato un oggetto com.adobe.idp.Document basato su un altro oggetto com.adobe.idp.Document.

Creazione di un oggetto Document basato su un altro 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);

Creazione di un documento basato su un file

Nell'esempio di codice seguente viene creato un oggetto com.adobe.idp.Document basato su un file PDF denominato map.pdf. Questo file si trova nella radice del disco rigido C. Questo costruttore tenta di impostare il tipo di contenuto MIME dell'oggetto com.adobe.idp.Document utilizzando l'estensione del nome file.

Il costruttore com.adobe.idp.Document che accetta un oggetto java.io.File accetta anche un parametro booleano. Impostando questo parametro su true, l'oggetto com.adobe.idp.Document elimina il file. Questo significa che non è necessario rimuovere il file dopo averlo passato al costruttore com.adobe.idp.Document.

Impostando questo parametro su false si mantiene la proprietà del file. L'impostazione di questo parametro su true è più efficiente. Il motivo è che l'oggetto com.adobe.idp.Document può spostare il file direttamente nell'area gestita locale invece di copiarlo (il che è più lento).

Creazione di un oggetto Document basato su un file 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);

Creazione di un documento basato su un oggetto InputStream

Nell'esempio di codice Java riportato di seguito viene creato un oggetto com.adobe.idp.Document basato su un oggetto java.io.InputStream.

Creazione di un documento basato su un oggetto InputStream

 //Create a Document object based on an InputStream object
 InputStream is = new FileInputStream("C:\\Map.pdf");
 Document myPDFDocument = new Document(is);

Creazione di un documento basato su contenuto accessibile da un URL

Nell'esempio di codice Java riportato di seguito viene creato un oggetto com.adobe.idp.Document basato su un file PDF denominato map.pdf. Questo file si trova all'interno di un'applicazione Web denominata WebApp in esecuzione su localhost. Questo costruttore tenta di impostare il tipo di contenuto MIME dell'oggetto com.adobe.idp.Document utilizzando il tipo di contenuto restituito con il protocollo URL.

L'URL fornito all'oggetto com.adobe.idp.Document viene sempre letto sul lato in cui viene creato l'oggetto com.adobe.idp.Document originale, come illustrato nell'esempio seguente:

     Document doc = new Document(new java.net.URL("file:c:/temp/input.pdf"));

Il file c:/temp/input.pdf deve trovarsi sul computer client (non sul computer server). Nel computer client viene letto l'URL e viene creato l'oggetto com.adobe.idp.Document.

Creazione di un documento basato su contenuto accessibile da un 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);

Consulta anche

Gestione dei documenti restituiti

Le operazioni di servizio che restituiscono un documento PDF (o altri tipi di dati come i dati XML) come valore di output restituiscono un oggetto com.adobe.idp.Document. Dopo aver ricevuto un oggetto com.adobe.idp.Document, è possibile convertirlo nei seguenti formati:

Oggetto java.io.File
Oggetto java.io.InputStream
Array a byte

La riga di codice seguente converte un oggetto com.adobe.idp.Document in un oggetto java.io.InputStream. Si supponga che myPDFDocument rappresenti un oggetto com.adobe.idp.Document:

     java.io.InputStream resultStream = myDocument.getInputStream();

Allo stesso modo, potete copiare il contenuto di un com.adobe.idp.Document in un file locale eseguendo le seguenti operazioni:

Creare un oggetto java.io.File.
Richiamare il metodo com.adobe.idp.Document dell'oggetto copyToFile e passare l'oggetto java.io.File.

Nell'esempio di codice seguente il contenuto di un oggetto com.adobe.idp.Document viene copiato in un file denominato OtherMap.pdf.

Copia del contenuto di un oggetto documento in un file

 File outFile = new File("C:\\AnotherMap.pdf");
 myDocument.copyToFile (outFile);

Consulta anche

Determinazione del tipo di contenuto di un documento

Determinare il tipo MIME di un oggetto com.adobe.idp.Document richiamando il metodo com.adobe.idp.Document dell'oggetto getContentType. Questo metodo restituisce un valore di stringa che specifica il tipo di contenuto dell'oggetto com.adobe.idp.Document. La tabella seguente descrive i diversi tipi di contenuto restituiti da AEM Forms .

Tipo MIME	Descrizione
`application/pdf`	documento PDF
`application/vnd.adobe.xdp+xml`	XML Data Packaging (XDP), utilizzato per i moduli XFA (XML Forms Architecture) esportati
`text/xml`	Segnalibri, allegati o altri documenti XML
`application/vnd.fdf`	Forms Data Format (FDF), utilizzato per i moduli Acrobat esportati
`application/vnd.adobe.xfdf`	XML Forms Data Format (XFDF), utilizzato per i moduli Acrobat esportati
`application/rdf+xml`	Formato dati RTF e XML
`application/octet-stream`	Formato dati generico
`NULL`	Tipo MIME non specificato

L'esempio di codice seguente determina il tipo di contenuto di un oggetto com.adobe.idp.Document.

Determinazione del tipo di contenuto di un oggetto 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);

Consulta anche

Eliminazione degli oggetti documento

Se non è più necessario un oggetto Document, è consigliabile eliminarlo richiamandone il metodo dispose. Ogni oggetto Document utilizza un descrittore di file e fino a 75 MB di spazio RAM sulla piattaforma host dell'applicazione. Se un oggetto Document non viene eliminato, il processo di raccolta Java Garage lo dispone. Tuttavia, prima di procedere con lo smaltimento utilizzando il metodo dispose, è possibile liberare la memoria occupata dall'oggetto Document.

Consulta anche

Chiamata di un servizio tramite una libreria client Java

le operazioni del servizio AEM Forms possono essere invocate utilizzando l'API fortemente tipizzata di un servizio, nota come libreria client Java. Una libreria client Java è un insieme di classi concrete che forniscono l'accesso ai servizi distribuiti nel contenitore di servizi. È possibile creare un'istanza di un oggetto Java che rappresenta il servizio da richiamare invece di creare un oggetto InvocationRequest utilizzando l'API Invocation. L'API Invocation viene utilizzata per richiamare i processi, ad esempio quelli di lunga durata, creati in Workbench. (Vedere Richiamo di processi a lunga durata basati sull'uomo.)

Per eseguire un'operazione di servizio, richiamare un metodo che appartiene all'oggetto Java. Una libreria client Java contiene metodi che in genere associano uno a uno con le operazioni del servizio. Quando utilizzate una libreria client Java, impostate le proprietà di connessione richieste. (Vedere Impostazione delle proprietà di connessione.)

Dopo aver impostato le proprietà di connessione, creare un oggetto ServiceClientFactory utilizzato per creare un'istanza di un oggetto Java che consente di richiamare un servizio. Ogni servizio con una libreria client Java ha un oggetto client corrispondente. Ad esempio, per richiamare il servizio Repository, creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory. L'oggetto ServiceClientFactory è responsabile della gestione delle impostazioni di connessione necessarie per richiamare servizi AEM Forms.

Anche se ottenere un ServiceClientFactory è in genere veloce, alcuni sovraccarichi sono coinvolti quando la fabbrica viene utilizzata per la prima volta. Questo oggetto è ottimizzato per il riutilizzo e quindi, quando possibile, utilizza lo stesso oggetto ServiceClientFactory quando si creano più oggetti client Java. Ovvero, non creare un oggetto ServiceClientFactory separato per ciascun oggetto libreria client creato.

È presente un'impostazione di User Manager che controlla la durata dell'asserzione SAML all'interno dell'oggetto com.adobe.idp.Context che interessa l'oggetto ServiceClientFactory. Questa impostazione controlla tutti i tempi di vita del contesto di autenticazione in AEM Forms, incluse tutte le chiamate eseguite utilizzando l'API Java. Per impostazione predefinita, il periodo di tempo in cui è possibile utilizzare un oggetto ServiceCleintFactory è di due ore.

NOTA

Per spiegare come richiamare un servizio utilizzando l'API Java, viene richiamata l'operazione writeResource del servizio Repository. Questa operazione consente di inserire una nuova risorsa nella directory archivio.

È possibile richiamare il servizio Repository utilizzando una libreria client Java ed eseguendo i seguenti passaggi:

Includete file JAR client, ad esempio adobe-repository-client.jar, nel percorso di classe del progetto Java. Per informazioni sulla posizione di questi file, vedere Inclusione file libreria Java AEM Forms.
Impostare le proprietà di connessione necessarie per richiamare un servizio.
Creare un oggetto ServiceClientFactory richiamando il metodo ServiceClientFactory statico dell'oggetto createInstance e passando l'oggetto java.util.Properties che contiene le proprietà di connessione.
Creare un oggetto ResourceRepositoryClient utilizzando il relativo costruttore e passando l'oggetto ServiceClientFactory. Utilizzare l'oggetto ResourceRepositoryClient per richiamare le operazioni del servizio Repository.
Creare un oggetto RepositoryInfomodelFactoryBean utilizzando il relativo costruttore e passare null. Questo oggetto consente di creare un oggetto Resource che rappresenta il contenuto aggiunto alla directory archivio.
Creare un oggetto Resource richiamando il metodo RepositoryInfomodelFactoryBean dell'oggetto newImage e passando i seguenti valori:
- Un valore ID univoco specificando new Id().
- Un valore UUID univoco specificando new Lid().
- Nome della risorsa. È possibile specificare il nome del file XDP.
Inserite il valore restituito in Resource.
Creare un oggetto ResourceContent richiamando il metodo RepositoryInfomodelFactoryBean dell'oggetto newImage e collocando il valore restituito su ResourceContent. Questo oggetto rappresenta il contenuto aggiunto alla directory archivio.
Creare un oggetto com.adobe.idp.Document passando un oggetto java.io.FileInputStream che memorizza il file XDP da aggiungere alla directory archivio. Vedere Creazione di un documento basato su un oggetto InputStream.
Aggiungete il contenuto dell'oggetto com.adobe.idp.Document all'oggetto ResourceContent richiamando il metodo ResourceContent dell'oggetto setDataDocument. Passa l'oggetto com.adobe.idp.Document.
Impostare il tipo MIME del file XDP da aggiungere all'archivio richiamando il metodo ResourceContent dell'oggetto setMimeType e passando application/vnd.adobe.xdp+xml.
Aggiungete il contenuto dell'oggetto ResourceContent all'oggetto Resource richiamando il metodo Resource object ‘s setContent e passando l'oggetto ResourceContent.
Aggiungete una descrizione della risorsa richiamando l'oggetto Resource ‘s setDescription e passando un valore di stringa che rappresenta una descrizione della risorsa.
Aggiungere la struttura del modulo all'archivio richiamando il metodo writeResource dell'oggetto ResourceRepositoryClient e passando i valori seguenti:
- Valore stringa che specifica il percorso della raccolta di risorse contenente la nuova risorsa
- L'oggetto Resource creato

Consulta anche

Avvio rapido (modalità EJB): Creazione di una risorsa tramite l'API Java