Conteneur de services

Les services AEM Forms situés dans le 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 l’appel des services AEM Forms via RMI/IIOP. Un fournisseur de services Web expose les services en tant que services Web (génération WSDL) à l’aide de 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 distante

L’intégration distante permet aux clients Flex d’appeler les opérations de service. (Voir Appel d’AEM Forms à l’aide d’ (obsolète pour les formulaires AEM) AEM Forms Remoting.)

API Java

Une API Java peut appeler un service AEM Forms. L’API Java est organisée en bibliothèques clientes et l’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é en tant que service Web, le WSDL respectant les normes de service Web définies par le W3C.

Un service peut être appelé à partir de n’importe quelle pile de services Web, y compris .NET Framework et le SDK Sun™ Web Services. (Voir Appel d’AEM Forms à l’aide des 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 présente une représentation visuelle des différentes manières dont les services AEM Forms peuvent être appelés par programmation.

REMARQUE

Outre l’utilisation du SDK AEM Forms pour créer des applications clientes pouvant appeler les services AEM Forms, vous pouvez créer des composants qui peuvent être déployés sur le conteneur de services. Par exemple, vous pouvez créer un composant Bank qui contient des types de données personnalisés qui peuvent être utilisés dans des 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 méthodes différentes. Vous pouvez configurer un service en définissant des points de fin afin qu’il puisse être appelé à l’aide de toutes les méthodes : Remoting, l’API Java, les services web et REST. (Voir Gestion des points de fin par programmation.)

  • Convertit un message dans 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 situé 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 requièrent 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).

  • exécute des tâches telles que la détermination de l’autorisation de l’appelant à 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 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. Supposons, par exemple, que vous utilisiez l’API Java pour appeler un service nécessitant 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 Transmission de données aux services AEM Forms à l’aide de l’API Java.)

    Si vous appelez un service à l’aide de 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 par courrier électronique, une demande d’appel est envoyée à un service lorsqu’un message électronique 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 par 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 terminé avec succès. (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 client 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

Appel d’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

Appel d’AEM Forms à l’aide de requêtes REST

Sur cette page