Conteneur de services service-container

Permet d’appeler les services AEM Forms à l’aide de différentes méthodes. Vous pouvez configurer un service en définissant des points d’entrée afin qu’il puisse être appelé à l’aide de toutes les méthodes : Remoting, l’API Java, les services web et REST. (Voir Gestion par programmation des points d’entrée).

Convertit un message en un format normalisé appelé demande d’appel. Une demande d’appel est envoyée par une application cliente (ou un autre service) à un service du conteneur de services. Une demande d’appel contient des informations telles que le nom du service à appeler et les valeurs de données requises pour effectuer l’opération. De nombreux services nécessitent un document pour effectuer une opération. Par conséquent, une demande d’appel contient généralement un document, qui peut être des données PDF, des données XDP, des données XML, etc.

Achemine les demandes d’appel vers les services appropriés (le nom du service à appeler fait partie de la demande d’appel).

Effectue des tâches telles que déterminer si l’appelant a l’autorisation d’appeler l’opération de service spécifiée. La demande d’appel doit contenir un nom d’utilisateur et un mot de passe AEM Forms valides.

Il existe différentes manières d’envoyer une demande d’appel à un service. Il existe également différentes manières d’envoyer les valeurs d’entrée requises au service. Par exemple, supposons que vous utilisiez l’API Java pour appeler un service qui nécessite un document PDF. La méthode Java correspondante contient un paramètre qui accepte un document PDF. Dans ce cas, le type de données du paramètre est com.adobe.idp.Document. (Voir Transmettre des données aux services AEM Forms à l’aide de l’API Java).

Si vous appelez un service en utilisant des dossiers de contrôle, une demande d’appel est envoyée lorsque vous placez un fichier dans un dossier de contrôle configuré. Si vous appelez un service en utilisant l’e-mail, une demande d’appel est envoyée à un service lorsqu’un e-mail arrive dans une boîte de réception configurée.

Le conteneur de services renvoie une réponse d’appel une fois l’opération effectuée. Une réponse d’appel contient des informations telles que les résultats de l’opération. Par exemple, si l’opération modifie un document PDF, la réponse d’appel contient le document PDF modifié. Si l’opération a échoué, la réponse d’appel contient un message d’erreur.

Une réponse d’appel peut être récupérée de la même manière qu’une demande d’appel est envoyée. En d’autres termes, si la demande d’appel est envoyée à l’aide de l’API Java, une réponse d’appel peut être récupérée à l’aide de l’API Java. Supposons, par exemple, qu’une opération modifie un document PDF. Vous pouvez récupérer le document PDF modifié en obtenant la valeur renvoyée de la méthode Java qui a appelé le service.

Lorsqu’un processus de longue durée est appelé, une réponse d’appel contient une valeur d’identifiant associée à la demande d’appel. Cette valeur d’identifiant vous permet de vérifier ultérieurement l’état du processus. Prenons l’exemple du service de longue durée MortgageLoan. À l’aide de la valeur d’identifiant, vous pouvez vérifier si le processus s’est correctement terminé. (Voir Appel de processus pour des intervenants humains de longue durée.)

Le diagramme suivant montre une application cliente (qui utilise l’API Java) appelant un service.

Lorsqu’une application cliente appelle un service, trois événements se produisent :

1. Une application cliente envoie une demande d’appel à un service.
2. Le service effectue l’opération spécifiée dans la demande d’appel.
3. Le conteneur de services renvoie une réponse d’appel à l’application cliente.