Contenitore di servizio

I servizi AEM Forms situati nel contenitore di servizi (inclusi i servizi standard come il servizio di crittografia, i processi a lunga durata e quelli a breve durata) possono essere richiamati utilizzando vari provider, ad esempio un provider EJB. Un provider EJB consente di richiamare i servizi AEM Forms tramite RMI/IIOP. Un provider di servizi web espone i servizi come servizi web (generazione WSDL) utilizzando standard quali SOAP/HTTP e SOAP/JMS.

Nella tabella seguente sono descritti i diversi modi in cui è possibile richiamare i servizi AEM Forms a livello di programmazione.

L’illustrazione seguente fornisce una rappresentazione visiva dei diversi modi in cui i servizi AEM Forms possono essere richiamati a livello di programmazione.

Il contenitore di servizi fornisce le seguenti funzionalità:

• Consente di richiamare i servizi AEM Forms con metodi diversi. Puoi configurare un servizio impostando gli endpoint in modo che possa essere richiamato utilizzando tutti i metodi: Remoto, API Java, servizi web e REST. (Vedi Gestione programmatica degli endpoint.)

• Converte un messaggio in un formato normalizzato denominato richiesta di chiamata. Una richiesta di chiamata viene inviata da un'applicazione client (o da un altro servizio) a un servizio situato nel contenitore del servizio. Una richiesta di chiamata contiene informazioni quali il nome del servizio da richiamare e i valori dei dati necessari per eseguire l'operazione. Molti servizi richiedono un documento per eseguire un'operazione. Pertanto, una richiesta di chiamata di solito contiene un documento, che può essere dati PDF, dati XDP, dati XML e così via.

• Esegue le richieste di chiamata ai servizi appropriati (il nome del servizio da richiamare fa parte della richiesta di chiamata).

• Esegue attività quali determinare se il chiamante dispone dell'autorizzazione per richiamare l'operazione di servizio specificata. La richiesta di chiamata deve contenere un nome utente e una password validi AEM forms.

  Esistono diversi modi per inviare una richiesta di chiamata a un servizio. Inoltre, esistono diversi modi per inviare i valori di input richiesti al servizio. Ad esempio, si supponga di utilizzare l’API Java per richiamare un servizio che richiede un documento PDF. Il metodo Java corrispondente contiene un parametro che accetta un documento PDF. In questa situazione, il tipo di dati del parametro è com.adobe.idp.Document. (Vedi Trasmissione di dati ai servizi AEM Forms tramite l’API Java.)

  Se invochi un servizio utilizzando cartelle controllate, viene inviata una richiesta di chiamata quando inserisci un file in una cartella controllata configurata. Se invochi un servizio tramite e-mail, una richiesta di chiamata viene inviata a un servizio quando un messaggio di posta elettronica arriva in una casella in entrata configurata.

  Il contenitore di servizi invia una risposta di chiamata dopo l'esecuzione dell'operazione. Una risposta di chiamata contiene informazioni quali i risultati dell'operazione. Ad esempio, se l’operazione modifica un documento PDF, la risposta di chiamata contiene il documento PDF modificato. Se l'operazione non è riuscita, la risposta alla chiamata contiene un messaggio di errore.

  Una risposta di chiamata può essere recuperata nello stesso modo in cui viene inviata una richiesta di chiamata. In altre parole, se la richiesta di chiamata viene inviata utilizzando l'API Java, è possibile recuperare una risposta di chiamata utilizzando l'API Java. Si supponga, ad esempio, che un’operazione modifichi un documento PDF. È possibile recuperare il documento PDF modificato ottenendo il valore restituito dal metodo Java che ha richiamato il servizio.

  Quando si richiama un processo di lunga durata, una risposta di chiamata contiene un valore di identificatore associato alla richiesta di chiamata. Utilizzando questo valore di identificatore, puoi controllare lo stato del processo in un secondo momento. Ad esempio, consideriamo il servizio a lungo termine mutuo ipotecario. Utilizzando il valore dell'identificatore, puoi verificare se il processo è stato completato correttamente. (Vedi Richiamo dei processi a lunga durata incentrati sull'uomo.)

  Il diagramma seguente mostra un’applicazione client (che utilizza l’API Java) che richiama un servizio.

  Quando un'applicazione client richiama un servizio, si verificano tre eventi:

  1. Un'applicazione client invia una richiesta di chiamata a un servizio.
  2. Il servizio esegue l'operazione specificata nella richiesta di chiamata.
  3. Il contenitore di servizi restituisce una risposta di chiamata all'applicazione client.

Consulta anche

Informazioni sui processi AEM Forms

Richiamo di AEM Forms utilizzando (obsoleto per i moduli AEM) AEM Forms Remoting

Richiamo di AEM Forms tramite l’API Java

Richiamo di AEM Forms tramite i servizi web

Richiamo dei processi a lunga durata incentrati sull'uomo

Richiamo di AEM Forms utilizzando le richieste REST