Conteneur de services service-container

Les exemples et les échantillons de ce document sont réservés à l’environnement AEM Forms sur JEE.

Les services AEM Forms du conteneur de services (y compris les services standard tels que le service Encryption, les processus de longue durée et de courte durée) peuvent être appelés à l’aide de divers fournisseurs, tels qu’un fournisseur EJB. Un fournisseur EJB permet aux services AEM Forms d’être appelés via RMI/IIOP. Un fournisseur de services web expose les services en tant que services Web (génération WSDL) en utilisant des normes telles que SOAP/HTTP et SOAP/JMS.

Le tableau suivant décrit les différentes manières dont vous pouvez appeler les services AEM Forms par programmation.

Méthode d’appel
Description
Intégration à distance
L’intégration à distance permet aux clients Flex d’appeler des opérations de service. (Voir Appel d’AEM Forms à l’aide d’AEM Forms Remoting (obsolète pour AEM forms)).
API Java
Une API Java peut appeler un service AEM Forms. L’API Java est organisée en bibliothèques client et en API d’appel Java. (Voir Appel d’AEM Forms à l’aide de l’API Java).
Services Web

AEM Forms prend en charge les normes de service web telles que SOAP/HTTP. Un service peut être exposé comme un service Web, dont le WSDL est conforme aux normes de service web définies par le W3C.

Un service peut être appelé à partir de n’importe quelle pile de services web, notamment .NET Framework et le SDK Sun™ Web Services. (Voir Appel d’AEM Forms à l’aide de services web).

Requêtes REST
AEM Forms prend en charge les requêtes REST. Un service peut être appelé directement à partir d’une page HTML. (Voir Appel d’AEM Forms à l’aide de requêtes REST).

L’illustration suivante fournit une représentation visuelle des différentes manières dont les services AEM Forms peuvent être appelés par programmation.

NOTE
En plus d’utiliser le SDK AEM Forms pour créer des applications clientes qui peuvent appeler les services AEM Forms, vous pouvez également créer des composants qui peuvent être déployés dans le conteneur de services. Par exemple, vous pouvez créer un composant Bank qui contient des types de données personnalisés pouvant être utilisés dans les processus. En d’autres termes, vous pouvez créer un type de données tel que com.adobe.idp.BankAccount. Vous pouvez ensuite créer des instances com.adobe.idp.BankAccount dans vos applications clientes.

Le conteneur de services offre les fonctionnalités suivantes :

  • 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 d’une application cliente (ou d’un autre service) à un service dans le 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.

Voir également

Présentation des processus AEM Forms

Appeler AEM Forms à l’aide d’AEM Forms Remoting (obsolète pour AEM Forms)

Appel d’AEM Forms en utilisant l’API Java

Appel d’AEM Forms utilisant des services Web

Appel de processus pour des intervenants humains de longue durée

Appeler AEM Forms à l’aide de demandes REST

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2