DocumentationAEM 6.5Guide de l’utilisateur

Connecter et envoyer des données de formulaire adaptatif à Microsoft® Power Automate connect-adaptive-form-with-power-automate

Last update: Sun Jul 14 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice
  • Développeur

Vous pouvez configurer un formulaire adaptatif pour exécuter un flux cloud Power Automate lors de l’envoi. Le formulaire adaptatif configuré envoie les données capturées, les pièces jointes et le document d’enregistrement au flux Cloud Power Automate pour traitement. Il vous permet de créer une expérience de capture de données personnalisée tout en tirant parti de la puissance de Microsoft® Power Automate pour élaborer des logiques commerciales autour des données capturées et automatiser les workflows client. Voici quelques exemples de ce que vous pouvez faire après l’intégration d’un formulaire adaptatif à Microsoft® Power Automate :

  • Utiliser des données de formulaires adaptatifs dans des processus d’entreprise Power Automate
  • Utilisez Power Automate pour envoyer des données capturées à plus de 500 sources de données ou à toute API publique
  • Exécuter des calculs complexes sur les données capturées
  • Enregistrer des données de formulaires adaptatifs dans les systèmes de stockage selon un planning prédéfini

L’éditeur de formulaires adaptatifs fournit l’action d’envoi Appeler un flux Microsoft® Power Automate pour envoyer des données de formulaires adaptatifs et des pièces jointes, et un document d’enregistrement est envoyé au flux de cloud Power Automate. Pour utiliser l’action Envoyer afin d’envoyer les données capturées à Microsoft® Power Automate, connectez votre instance de création AEM Forms à Microsoft® Power Automate.

Conditions préalables

Les éléments suivants sont requis pour connecter un formulaire adaptatif à Microsoft® Power Automate :

  • Licence Premium Microsoft® Power Automate
  • Flux Microsoft® Power Automate avec le déclencheur When an HTTP request is received pour accepter les données d’envoi de formulaire adaptatif
  • Utilisateur ou utilisatrice Experience Manager disposant de droits de création et d’administration de formulaires
  • Compte utilisé pour se connecter à Microsoft® Power Automate étant propriétaire du flux Power Automate configuré pour recevoir des données du formulaire adaptatif

Connecter votre instance AEM Forms à Microsoft® Power Automate connect-forms-server-with-power-automate

Effectuez les actions suivantes pour connecter votre instance de création AEM Forms à Microsoft® Power Automate :

  1. Créer une Microsoft
  2. Créer Microsoft
  3. Créer Microsoft
  4. Publier Microsoft

Créer une application Microsoft® Azure Active Directory ms-power-automate-application

  1. Connectez-vous au Portail Azure.

  2. Sélectionnez Azure Active Directory dans le volet de navigation de gauche.

  3. Sur la page Répertoire par défaut, sélectionnez Enregistrement des applications dans le panneau de gauche.

  4. Sur la page Enregistrements des applications, cliquez sur Nouveaux enregistrements.

  5. Spécifiez le nom, les types de compte pris en charge et l’URI de redirection sur la page. Dans l’URI de redirection, spécifiez ce qui suit et cliquez sur Enregistrer.

    • https://[AEM Forms Author instance]/libs/fd/powerautomate/content/dataverse/config.html
    • https://[AEM Forms Author instance]/libs/fd/powerautomate/content/flowservice/config.html

    Enregistrer une application Azure Active Directory

    note note
    NOTE
    Vous pouvez également spécifier des URI de redirection supplémentaires, si nécessaire, à partir de la page Authentification.
    Pour les types de compte pris en charge, sélectionnez un client unique, plusieurs clients ou un compte Microsoft® personnel, selon votre cas d’utilisation.

  6. Sur la page Authentification, activez les options suivantes, puis cliquez sur Enregistrer.

    • Jetons d’accès (utilisés pour les flux implicites)
    • Jetons d’ID (utilisés pour les flux implicites et hybrides)

  7. Sur la page des autorisations d’API, cliquez sur Ajouter une autorisation.

  8. Sous les API Microsoft®, sélectionnez le service de flux, puis les autorisations suivantes.

    • Flows.Manage.All
    • Flows.Read.All

    Cliquez sur Ajouter des autorisations pour enregistrer les autorisations.

  9. Sur la page des autorisations d’API, cliquez sur Ajouter une autorisation. Sélectionnez les API utilisées par mon entreprise et recherchez DataVerse.

  10. Activez user_impersonation et cliquez sur Ajouter des autorisations.

  11. (Facultatif) Sur la page Certificats et secrets, cliquez sur Nouveau secret client. Dans l’écran Ajouter un secret client, fournissez une description et un délai d’expiration du secret, puis cliquez sur Ajouter. Une chaîne secrète est générée.

  12. Conservez une note spécifique à l’URL de l’environnement Dynamics de votre organisation.

Créez une configuration cloud de Dataverse de Microsoft® Power Automate. microsoft-power-automate-dataverse-cloud-configuration

  1. Dans l’instance de création AEM Forms, accédez à Outils hammer > Général  > Navigateur de configuration.

  2. Sur la page du navigateur de configuration, sélectionnez  Créer.

  3. Dans la boîte de dialogue Créer une configuration, indiquez un titre pour la configuration, activez Configurations cloud et sélectionnez Créer. Un conteneur de configurations pour Cloud Services est ainsi créé. Vérifiez que le nom du dossier ne contient aucun espace.

  4. Accédez à Outils marteau  > Services cloud  > Dataverse de Microsoft® Power Automate et ouvrez le conteneur de configuration que vous avez créé à l’étape précédente.

    note note
    NOTE
    Lorsque vous créez un formulaire adaptatif, indiquez le nom du conteneur dans le champ Conteneur de configurations.

  5. Sur la page de configuration, sélectionnez  Créer pour créer une configuration Microsoft®® Power Automate Flow Service dans AEM Forms.

  6. Sur la page Configurer le service Dataverse pour Microsoft® Power Automate, indiquez l’ID client (également appelé ID de l’application), le Secret client, l’URL OAuth et l’URL de l’environnement Dynamics. Utilisez l’ID client, le secret client, l’URL OAuth et l’URL de l’environnement Dynamics de l’application Microsoft® Azure Active Directory que vous avez créée dans la section précédente. Utilisez l’option Points d’entrée de l’interface utilisateur de l’application Microsoft® Azure Active Directory pour trouver l’URL OAuth.

    Utilisez l’option Points d’entrée de l’interface utilisateur de l’application Microsoft Power Automate pour trouver l’URL OAuth.

  7. Sélectionnez Connexion. Si cela vous est demandé, connectez-vous à votre compte Microsoft® Azure. Sélectionnez Enregistrer.

Créer la configuration cloud du service de flux de Microsoft® Power Automate create-microsoft-power-automate-flow-cloud-configuration

  1. Accédez à Outils marteau  > Services cloud  > Service de flux de Microsoft® Power Automate, puis ouvrez le conteneur de configuration que vous avez créé à l’étape précédente.

    note note
    NOTE
    Lorsque vous créez un formulaire adaptatif, indiquez le nom du conteneur dans le champ Conteneur de configurations.

    1. Sur la page de configuration, sélectionnez **Créer** pour créer une configuration Microsoft®® Power Automate Flow Service dans AEM Forms.

  2. Sur la page Configurer le Dataverse pour Microsoft® Power Automate, indiquez l’ID client (également appelé ID de l’application), le Secret client, l’URL OAuth et l’URL de l’environnement Dynamics. Utilisez l’ID client, le secret client, l’URL OAuth et l’ID d’environnement Dynamics. Utilisez l’option Points d’entrée dans l’interface utilisateur de l’application Microsoft® Azure Active Directory pour trouver l’URL OAuth. Ouvrez le lien Mes flux et sélectionnez Mes flux pour utiliser l’ID répertorié dans l’URL en tant qu’ID d’environnement Dynamics.

  3. Sélectionnez Connexion. Si cela vous est demandé, connectez-vous à votre compte Microsoft® Azure. Sélectionnez Enregistrer.

Publiez les configurations cloud du Dataverse de Microsoft® Power Automate et du Service de flux de Microsoft® Power Automate. publish-microsoft-power-automate-dataverse-cloud-configuration

  1. Accédez à Outils marteau  > Services cloud  > Dataverse de Microsoft® Power Automate, ouvrez le conteneur de configuration que vous avez créé lors de la section Créer une configuration cloud du Dataverse de Microsoft® Power Automate précédente.
  2. Sélectionnez la configuration dataverse puis choisissez Publier.
  3. Sur la page de Publication, sélectionnez Toutes les configurations et choisissez Publier. Publiez les configurations cloud du Dataverse de Power Automate et du service de flux de Power Automate.

Votre instance de création AEM Forms est maintenant connectée à Microsoft® Power Automate. Vous pouvez désormais envoyer des données de formulaires adaptatifs à un flux Power Automate.

Utilisez l’action d’envoi Appeler un flux Microsoft® Power Automate pour envoyer des données à un flux Power Automate. use-the-invoke-microsoft-power-automate-flow-submit-action

Après la connexion de votre instance de création AEM Forms à Microsoft® Power Automate, effectuez l’action suivante pour configurer votre formulaire adaptatif afin d’envoyer les données capturées à un flux Microsoft® lors de la soumission du formulaire.

  1. Connectez-vous à votre instance Création, sélectionnez votre formulaire adaptatif et cliquez sur Propriétés.

  2. Dans le conteneur de configuration, recherchez et sélectionnez le conteneur créé dans la section Créer une configuration cloud du Dataverse de Microsoft® Power Automate, puis choisissez Enregistrer et fermer.

  3. Ouvrez le formulaire adaptatif pour le modifier et accéder à la section Envoi des propriétés du Conteneur de formulaires adaptatifs.

  4. Dans le conteneur de propriétés, pour Envoyer des actions, sélectionnez l’option Appeler un flux Power Automate. Une liste des flux Power Automate disponibles se trouve désormais dans l’option Flux Power Automate. Sélectionnez le flux requis afin que les données de formulaires adaptatifs lui soient soumises lors de l’envoi.

    Configurer l’action d’envoi

NOTE
Avant d’envoyer le formulaire adaptatif, assurez-vous que le déclencheur When an HTTP Request is received avec le schéma JSON en-dessous est ajouté à votre flux Power Automate.
        {
            "type": "object",
            "properties": {
                "attachments": {
                    "type": "array",
                    "items": {
                        "type": "object",
                        "properties": {
                            "filename": {
                                "type": "string"
                            },
                            "data": {
                                "type": "string"
                            },
                            "contentType": {
                                "type": "string"
                            },
                            "size": {
                                "type": "integer"
                            }
                        },
                        "required": [
                            "filename",
                            "data",
                            "contentType",
                            "size"
                        ]
                    }
                },
                "templateId": {
                    "type": "string"
                },
                "templateType": {
                    "type": "string"
                },
                "data": {
                    "type": "string"
                },
                "document": {
                    "type": "object",
                    "properties": {
                        "filename": {
                            "type": "string"
                        },
                        "data": {
                            "type": "string"
                        },
                        "contentType": {
                            "type": "string"
                        },
                        "size": {
                            "type": "integer"
                        }
                    }
                }
            }
        }

Voir également,

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