Consultez la liste des connecteurs compatibles avec Application Integration.

Tests fonctionnels

Preview — Functional tests

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document décrit les tests fonctionnels dans Application Integration, et explique comment créer et gérer des tests fonctionnels pour vos intégrations. En testant votre flux d'intégration, vous pouvez vous assurer qu'elle fonctionne comme prévu.

Présentation

Les tests fonctionnels vous permettent de créer et d'exécuter plusieurs tests sur vos intégrations complexes qui connectent et gèrent les services Google Cloud et d'autres applications métier. En testant votre flux d'intégration, vous pouvez vous assurer qu'elle fonctionne comme prévu. Vous pouvez tester votre intégration à l'aide de différentes variables d'entrée afin d'identifier les défaillances du flux d'intégration.

Configurations de test

Application Integration vous permet d'ajouter plusieurs scénarios de test à votre intégration. Pour les déclencheurs, vous pouvez configurer les valeurs d'entrée dans un scénario de test. Pour les tâches, vous pouvez mettre à jour les configurations de test suivantes:

• Type de stratégie fictive:vous pouvez définir trois options pour votre tâche :
  • No mock (Aucune simulation) : cette stratégie vous permet d'exécuter la tâche et d'y ajouter des assertions.
  • Simulation d'exécution:cette stratégie vous permet de simuler une tâche comme ayant réussi ou échoué.
  • Mock output (Résultat fictif) : cette stratégie vous permet de simuler le résultat des tâches du nœud suivant de l'intégration.
• Type d'assertion:vous pouvez ajouter plusieurs assertions à une tâche sélectionnée dans un test. Différents types d'assertions sont disponibles :
  • Assert execution (Assertner l'exécution) : ce type d'assertion vous permet de vérifier si la tâche a bien été exécutée.
  • Assert parameters (Assertion des paramètres) : ce type d'assertion vous permet de sélectionner le paramètre que vous souhaitez revendiquer et de fournir une valeur avec laquelle le comparer.

Avant de commencer

• Pour obtenir les autorisations nécessaires pour créer et gérer des tests fonctionnels, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur d'intégrations d'applications (roles/integrations.integrationEditor) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

  Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

• Assurez-vous d'avoir créé une intégration.

Créer un test fonctionnel

Pour créer un test fonctionnel, sélectionnez l'une des options suivantes :

Console

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Integrations (Intégrations).

   La page Intégrations s'affiche. Elle liste toutes les intégrations disponibles dans le projet Google Cloud.

3. Sélectionnez une intégration existante pour laquelle vous souhaitez créer un test.

   La page de l'éditeur d'intégration s'affiche.

4. Cliquez sur le menu "Actions" more_vert, puis sur Créer un test fonctionnel. Dans le volet Créer un test fonctionnel qui s'affiche, procédez comme suit :
   1. Dans la liste Déclencheur, sélectionnez un déclencheur.
   2. Dans le champ Nom du test, saisissez le nom de votre test.
   3. Dans le champ Description, saisissez la description de votre test.
   4. Cliquez sur Créer.

      Sur la page de l'éditeur d'intégrations, le canevas de concepteur affiche Functional Test Mode:on (Mode de test fonctionnel : activé). L'image suivante affiche le volet Créer un test fonctionnel:

      

      Remarque:Vous ne pouvez pas modifier votre intégration en mode test fonctionnel.

5. Configurez la configuration de test pour votre déclencheur et vos tâches.

API

Pour importer un scénario de test pour une version d'intégration, utilisez la méthode CreateTestCase:

    curl -v -s -X POST
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer $(gcloud auth print-access-token) \
        -d 'TEST_CASE_JSON' \
        'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/PROJECT_LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases'
    

Remplacez TEST_CASE_JSON par le corps de votre scénario de test:

    '{"display_name":"TEST_CASE_NAME", "workflow_id":"INTEGRATION_VERSION", "trigger_id":"TRIGGER_ID"}'
    

Les champs suivants sont obligatoires dans le corps du scénario de test:

• TEST_CASE_NAME: nom du scénario de test
• INTEGRATION_VERSION: version de votre intégration
• TRIGGER_ID: ID du déclencheur d'API dans votre intégration

Configurer les configurations de test pour les déclencheurs

Pour configurer les configurations de test du déclencheur, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Intégrations.

   Accéder à l'intégration

2. Sélectionnez une intégration existante comportant un test fonctionnel.

   La page de l'éditeur d'intégration s'affiche.

3. Cliquez sur le menu "Actions" more_vert, puis sur Afficher le test fonctionnel.

   Sur la page de l'éditeur d'intégrations, le canevas de concepteur affiche Functional Test Mode:on (Mode de test fonctionnel : activé). L'image suivante montre le volet Test configuration (Configuration du test) du déclencheur:

   

4. Sur la page de l'éditeur d'intégrations, cliquez sur le déclencheur pour ouvrir le volet de configuration du déclencheur. Ensuite, procédez comme suit :
   • Si vous disposez de variables d'entrée pour votre intégration, l'onglet Tester la configuration les affiche. Les valeurs que vous saisissez dans les variables sont enregistrées automatiquement.
   • Pour afficher les propriétés du déclencheur, cliquez sur l'onglet Propriétés du déclencheur.

Configurer les configurations de test pour les tâches

Pour configurer les propriétés de test pour la tâche d'intégration, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Intégrations.

   Accéder à l'intégration

2. Sélectionnez une intégration existante comportant un test fonctionnel.

   La page de l'éditeur d'intégration s'affiche.

3. Cliquez sur le menu "Actions" more_vert, puis sur Afficher le test fonctionnel.

   Sur la page de l'éditeur d'intégrations, le canevas de concepteur affiche Functional Test Mode:on (Mode de test fonctionnel : activé).

4. Sur la page de l'éditeur d'intégrations, cliquez sur la tâche pour ouvrir le volet de configuration du test. L'image suivante montre le volet Tester la configuration de cette tâche:

   

   Dans l'onglet Tester la configuration, procédez comme suit :
   1. Dans Mock policy type (Type de stratégie fictive), sélectionnez l'une des stratégies fictives suivantes :
      • Si vous sélectionnez No mock (Aucune simulation), votre tâche s'exécute à partir du workflow principal comme effectué par le modèle de tâche. Par défaut, le type de stratégie No mock (Aucune simulation) est sélectionné pour les tâches.
      • Si vous sélectionnez Exécution simulée, vous devez sélectionner l'une des options suivantes pour État d'exécution simulée :
        • Passer
        • Échec
      • Si vous sélectionnez Mock Output (Sortie fictive), pour Task Output list (Liste des sorties de tâches), vous devez fournir le résultat des tâches du prochain nœud de l'intégration.
   2. Dans la section Stratégie d'assertion, procédez comme suit :
      1. Dans le champ Type d'assertion, sélectionnez l'une des options suivantes :
         • Si vous sélectionnez Assert execution (Assertir l'exécution), choisissez l'une des options suivantes pour Execution status to assert (État de l'exécution à revendiquer) :
           • Opération réussie
           • Échec
           • Non exécuté
         • Si vous sélectionnez Assert parameters (Asserrer les paramètres), procédez comme suit :
           1. Dans Paramètres à assertion, sélectionnez si vous souhaitez valider les paramètres, y compris les paramètres d'entrée et de sortie.
           2. Sélectionnez l'opérateur pour comparer le paramètre revendiqué avec la valeur saisie. Les opérations permettant de comparer le paramètre revendiqué peuvent être les suivantes :
              • Égal à
              • Différent de
              • Contient
           3. Dans le champ Valeur, saisissez la valeur à laquelle vous souhaitez comparer le paramètre.
      2. Facultatif: Pour ajouter d'autres assertions, cliquez sur + Add Assertion (Ajouter une assertion).

Exécuter un test fonctionnel

Pour exécuter un test fonctionnel, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Intégrations.

   Accéder à l'intégration

2. Sélectionnez l'intégration pour laquelle vous souhaitez exécuter le test fonctionnel.

   La page de l'éditeur d'intégration s'affiche.

3. Cliquez sur le menu "Actions" more_vert, puis sur Afficher le test fonctionnel.

   Sur la page de l'éditeur d'intégrations, le canevas de concepteur affiche Functional Test Mode:on (Mode de test fonctionnel : activé).

4. Dans la liste Test, sélectionnez le scénario de test que vous souhaitez exécuter.
5. Cliquez sur Tester. La page Test Integration (Intégration du test) s'affiche. Ensuite, procédez comme suit :
   1. Sur la page Test Integration (Intégration des tests), saisissez le délai d'exécution.
   2. Cliquez sur Tester l'intégration.

      Vous pouvez afficher les journaux de vos tests fonctionnels. Pour afficher et inspecter les journaux d'exécution du test, cliquez sur Afficher les journaux.

Télécharger les scénarios de test

Pour télécharger un scénario de test pour une version d'intégration, procédez comme suit:

1. Pour répertorier les scénarios de test et obtenir le TEST_CASE_ID, utilisez la méthode listTestCase:

     curl -v -s
         -H "Content-Type: application/json" \
         -H "Authorization: Bearer $(gcloud auth print-access-token) \
         'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/PROJECT_LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases'
       

   Dans la réponse, copiez le TEST_CASE_ID du scénario de test que vous souhaitez télécharger.

2. Pour télécharger un scénario de test, utilisez la méthode GetTestCase:

     curl -v -s
         -H "Content-Type: application/json" \
         -H "Authorization: Bearer $(gcloud auth print-access-token) \
         'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/PROJECT_LOCATION/integrations/INTEGRATION_NAME/versions/INTEGRATION_VERSION/testCases/TEST_CASE_ID'
       

   Remplacez TEST_CASE_ID par l'ID du scénario de test que vous avez copié à l'étape précédente.

Répertorier les exécutions de test

Vous pouvez afficher la liste des exécutions de test sur la page Journaux. Pour cela, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Application Integration.

   Accéder à Application Integration

2. Dans le menu de navigation, cliquez sur Journaux.
3. Dans le champ Filtrer, ajoutez un filtre pour le nom de l'intégration en respectant le format suivant:

   Integration name:INTEGRATION_NAME:TEST_CASE_NAME.

   Remplacez les éléments suivants :

   • INTEGRATION_NAME: nom de l'intégration contenant les tests fonctionnels.
   • TEST_CASE_NAME: nom du scénario de test pour lequel vous souhaitez répertorier les exécutions de test.

   Par exemple, Integration name:example-integration-name:example-test-case.

Supprimer un test fonctionnel

Pour afficher un test fonctionnel, procédez comme suit :

1. Dans la console Google Cloud, accédez à la page Intégrations.

   Accéder à l'intégration

2. Sélectionnez une intégration existante pour laquelle vous souhaitez créer un test.

   La page de l'éditeur d'intégration s'affiche.

3. Cliquez sur le menu "Actions" more_vert, puis sur Afficher le test fonctionnel.

   Sur la page de l'éditeur d'intégrations, le canevas de concepteur affiche Functional Test Mode:on (Mode de test fonctionnel : activé).

4. Dans la liste Test, sélectionnez le scénario de test que vous souhaitez supprimer.
5. Cliquez sur Supprimer.

Tarification

La gestion des tests supplémentaires n'entraîne aucuns frais supplémentaires. Pour en savoir plus sur la tarification, consultez la section Tarifs d'Application Integration.

Limites

Les tests fonctionnels sont soumis aux limites suivantes:

• Les scénarios de test ne sont pas clonés lorsque vous clonez une intégration. Vous devez créer manuellement des scénarios de test pour différentes versions d'intégration.
• Vous ne pouvez pas ajouter d'assertions sur les déclencheurs pour les variables de sortie. Pour contourner ce problème, vous pouvez ajouter des assertions à la dernière tâche exécutée pour les variables de sortie.

Étapes suivantes

• Découvrez comment créer une intégration.
• En savoir plus sur les tâches compatibles et les déclencheurs