Contenitore servizio service-container

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

Converte un messaggio in un formato normalizzato denominato richiesta di chiamata. Viene inviata una richiesta di chiamata da un'applicazione client (o da un altro servizio) a un servizio 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 contiene in genere un documento, che può essere costituito da dati PDF, dati XDP, dati XML e così via.

Indirizza 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 per i moduli AEM.

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. Si supponga, ad esempio, 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 richiami un servizio utilizzando cartelle controllate, viene inviata una richiesta di chiamata quando inserisci un file in una cartella controllata configurata. Se si richiama un servizio tramite posta elettronica, viene inviata una richiesta di chiamata a un servizio quando un messaggio di posta elettronica arriva in una casella in entrata configurata.

Il contenitore del servizio invia una risposta di chiamata una volta eseguita l'operazione. Una risposta alla chiamata contiene informazioni quali i risultati dell'operazione. Se, ad esempio, l'operazione modifica un documento PDF, la risposta alla chiamata contiene il documento PDF modificato. Se l'operazione non è riuscita, la risposta alla chiamata contiene un messaggio di errore.

È possibile recuperare una risposta di chiamata 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, si consideri il servizio di lunga durata di MortgageLoan. Utilizzando il valore dell’identificatore, puoi verificare se il processo è stato completato correttamente. (Vedi Richiamare 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 del servizio restituisce una risposta di chiamata all'applicazione client.