Utilisation du service Invoke dans l’éditeur de règles visuel pour les formulaires basés sur les composants principaux

Il s’agit d’une fonctionnalité de préversion accessible par le biais de notre canal de pré-version.

L’éditeur de règles visuelles d’un formulaire adaptatif prend en charge la fonction Invoke Service, qui vous permet de sélectionner un service dans la liste de modèles de données de formulaire (FDM) configurés pour votre instance. Vous pouvez associer directement les champs de formulaire aux paramètres d’entrée du service. Pour mapper les champs de formulaire aux paramètres de sortie, utilisez l’option de payload d’événement pour le service de modèle de données de formulaire spécifié. En outre, l’éditeur de règles visuel vous permet de créer des règles pour les gestionnaires de succès et d’échec pour les opérations Invoke Service en fonction de ses réponses de sortie. Les gestionnaires de succès gèrent l’exécution réussie de l’opération Invoke Service, tandis que les gestionnaires d’échec corrigent les erreurs qui se produisent.

Avantages de l’utilisation du service Invoke dans l’éditeur de règles de formulaire

Voici quelques avantages de l’utilisation de l’opération Invoke Service dans l’éditeur de règles d’un formulaire adaptatif :

Appeler les gestionnaires de service pour les réponses de succès et d’échec

L’éditeur de règles visuel vous permet de créer des règles pour les gestionnaires de succès et d’échec pour les opérations Invoke Service en fonction de ses réponses en sortie. L’image ci-dessous illustre le service Invoke dans l’éditeur de règles visuelles pour un formulaire adaptatif :

Pour ajouter un gestionnaire de succès ou d’échec, cliquez sur Ajouter un gestionnaire de succès ou Ajouter un gestionnaire d’échec, respectivement.

Lorsque vous cliquez sur Ajouter un gestionnaire de succès, l’éditeur de règles Invoke Service Success Handler s’affiche, ce qui vous permet de spécifier des règles ou une logique pour gérer la réponse de sortie Invoke Service lorsque l’opération est réussie. Vous pouvez spécifier des règles même sans définir de conditions. Cependant, vous pouvez ajouter des conditions pour le gestionnaire de succès en cliquant sur l’option Ajouter une condition .

Vous pouvez ajouter plusieurs règles pour gérer les réponses réussies pour l’opération Invoke Service :

{width="50%,"}

De même, vous pouvez ajouter des règles pour gérer la réponse de sortie Invoke Service lorsque l’opération échoue. L’image ci-dessous affiche l’éditeur de règles Invoke Service Failure Handler :

Vous pouvez également ajouter plusieurs règles pour gérer les réponses infructueuses à partir de l’opération Invoke Service.

La fonction Activer la validation des erreurs sur le serveur permet également aux validations ajoutées par l’auteur lors de la conception d’un formulaire adaptatif à exécuter sur le serveur.

Conditions préalables à l’utilisation du service Invoke dans l’éditeur de règles

Vous trouverez ci-dessous les conditions préalables à remplir avant d’utiliser Invoke Service dans l’éditeur de règles :

Exploration du service Invoke à travers différents cas d’utilisation

Le service d’appel de l’éditeur de règles visuel vous permet d’effectuer plusieurs opérations utiles. Vous pouvez l’utiliser pour remplir les options de liste déroulante, définir des panneaux répétables ou simples et valider les champs du formulaire, le tout en fonction de la réponse de sortie du service d’appel. Vous améliorez ainsi la flexibilité et l’interactivité de vos formulaires.

Le tableau ci-dessous décrit quelques scénarios dans lesquels le service Invoke peut être utilisé :

Créez un formulaire Get Information qui récupère les valeurs en fonction de l’entrée saisie dans la zone de texte Pet ID. La capture d’écran ci-dessous montre le formulaire utilisé dans ces cas pratiques :

Champs de formulaire

Ajoutez les champs suivants au formulaire :

NOTE

Dans le champ Bind Reference de la boîte de dialogue Properties des champs de formulaire, sélectionnez et accédez à la propriété binaire que vous avez ajoutée dans le modèle de données de formulaire (FDM).

Configuration des panneaux

Définissez les panneaux comme répétitifs avec les contraintes suivantes :

Vous pouvez ajuster les valeurs des panneaux répétitifs en fonction de vos besoins.

Source de données

Dans cet exemple, l’API Swagger Petstore est utilisée pour configurer une source de données. Le modèle de données de formulaire est configuré pour le service getPetById, qui récupère les détails de l’animal de compagnie en fonction de l’identifiant saisi.

Publions le fichier JSON suivant à l’aide du service addPet dans l’API Swagger Petstore :

{
        "id": 101,
        "category": {
            "id": 1,
            "name": "Labrador"
        },
        "name": "Lisa",
        "photoUrls": [
            "https://example.com/photos/lisa1.jpg",
            "https://example.com/photos/lisa2.jpg"
        ],
        "tags": [
            {
                "id": 1,
                "name": "vaccinated"
            },
            {
                "id": 2,
                "name": "friendly"
            },
            {
                "id": 3,
                "name": "house-trained"
            }
        ],
        "status": "available"
    }

Les règles et la logique sont implémentées à l’aide de l’action Invoke Service dans l’éditeur de règles sur la zone de texte Pet ID pour démontrer les cas d’utilisation mentionnés.

Examinons maintenant en détail la mise en oeuvre de chaque cas d’utilisation.

Cas d’utilisation 1 : renseigner des valeurs de liste déroulante à l’aide de la sortie d’Invoke Service

Ce cas pratique montre comment renseigner dynamiquement les options de liste déroulante en fonction de la sortie d’un Invoke Service.

Implémentation

Pour ce faire, créez une règle sur la zone de texte Pet ID pour appeler le service getPetById. Dans la règle, définissez la propriété enum de la liste déroulante photo-url sur photoUrls dans Ajouter un gestionnaire de succès.

Sortie

Entrez 101 dans la zone de texte Pet ID pour remplir de manière dynamique les options de liste déroulante en fonction de la valeur saisie.

Cas d’utilisation 2 : définition d’un panneau répétable à l’aide de la sortie du service Invoke

Ce cas pratique montre comment renseigner dynamiquement des panneaux répétables en fonction de la sortie d’un service d’appel.

Considérations

Implémentation

Créez une règle sur la zone de texte Pet ID pour appeler le service getPetById. Dans Ajouter un gestionnaire de succès, ajoutez une autre réponse de gestionnaire de succès. Définissez la valeur du panneau tags sur tags dans la règle.

Sortie

Entrez 101 dans la zone de texte Pet ID pour remplir dynamiquement le panneau répétable en fonction de la valeur d’entrée.

Cas d’utilisation 3 : définition d’un panneau à l’aide de la sortie d’Invoke Service

Ce cas pratique montre comment définir dynamiquement la valeur d’un panneau en fonction de la sortie d’un Invoke Service.

Considérations

Implémentation

Créez une règle sur la zone de texte Pet ID pour appeler le service getPetById. Dans Ajouter un gestionnaire de succès, ajoutez une autre réponse de gestionnaire de succès. Définissez la valeur de la zone de texte categoryname sur category.name dans la règle.

Sortie

Entrez 101 dans la zone de texte Pet ID pour remplir le panneau de manière dynamique en fonction de la valeur d’entrée.

Cas d’utilisation 4 : utilisation du paramètre de sortie du service Invoke pour valider d’autres champs

Ce cas pratique montre comment utiliser la sortie d’un service d’appel pour valider dynamiquement d’autres champs de formulaire.

Implémentation

Créez une règle sur la zone de texte Pet ID pour appeler le service getPetById. Dans Ajouter un gestionnaire d’échec, ajoutez une réponse de gestionnaire d’échec. Masquez le bouton Submit si un Pet ID incorrect est saisi.

Sortie

Saisissez 102 dans la zone de texte Pet ID et le bouton Submit est masqué.

Questions fréquentes

Q : Que se passe-t-il si j’ai créé une règle à l’aide du service Invoke et que j’ai ensuite effectué la mise à niveau vers la dernière version des composants principaux ?

A : Lorsque vous effectuez une mise à niveau vers la dernière version des composants principaux, la règle Invoke Service est automatiquement mise à jour vers la dernière interface utilisateur, car elle est rétrocompatible.

Q : Puis-je ajouter plusieurs règles pour gérer les réponses de succès ou d’échec pour l’opération Invoke Service ?

A : Oui, vous pouvez ajouter plusieurs règles pour gérer les réponses de succès ou d’échec pour l’opération Invoke Service.

Articles connexes

Ressources supplémentaires