Premiers pas avec Apigee Integration et la connexion MySQL

Ce tutoriel explique comment se connecter à une instance de base de données MySQL à partir d'un exemple d'intégration, et comment effectuer des opérations List, Get, Create, Update et Delete sur une table de base de données MySQL.

Avant de commencer

  • Vérifiez que vous avez accès à Application Integration.

  • Sélectionnez le projet Google Cloud et effectuez les tâches suivantes :

    • Attribuez les rôles suivants au compte de service que vous souhaitez utiliser pour créer la connexion :
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor
    • Activez les services suivants :
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Si ces services n'ont pas encore été activés pour votre projet, vous êtes invité à les activer lors de la création de la connexion.

  • Assurez-vous d'avoir accès à un serveur MySQL permettant de créer une base de données. Pour obtenir la liste de tous les connecteurs et des versions compatibles, consultez la documentation de référence sur le connecteur.

Créer une base de données et une table dans MySQL

Exécutez les commandes suivantes à partir d'un système sur lequel un client MySQL est installé :
  1. Connectez-vous à votre serveur MySQL : 
    mysql --host=MYSQL_HOSTNAME_OR_IP_ADDRESS --port=PORT_NUMBER -uUSERNAME -pPASSWORD
    Remplacez les éléments suivants :
    • MYSQL_HOSTNAME_OR_IP_ADDRESS : le nom ou l'adresse IP de votre serveur MySQL.
    • PORT_NUMBER : le numéro de port de votre serveur MySQL.
    • USERNAME : le nom d'utilisateur de votre serveur MySQL.
    • PASSWORD : le mot de passe de l'utilisateur pour votre serveur MySQL.
  2. Créez une base de données MySQL : 
    CREATE DATABASE tutorialDB;
  3. Créez une table : 
    CREATE TABLE EMPLOYEE
  (
  employee_id int auto_increment primary key,
  employee_first_name varchar(500) NOT null,
  employee_last_name varchar(500) NOT null,
  employee_emailID varchar(500)
  );
  4. Ajoutez des lignes à la table EMPLOYEE que vous avez créée : 
    INSERT INTO EMPLOYEE (employee_first_name,employee_last_name,employee_emailID) values ("Peter","Dilliard","test-01@test.com");
INSERT INTO EMPLOYEE (employee_first_name,employee_last_name,employee_emailID) values ("Meaghan","Webb","test-02@test.com");
  5. Vérifiez que la table est créée et que les lignes sont ajoutées : 
    SELECT * FROM EMPLOYEE;
    Les lignes de table suivantes s'affichent : 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

Créer une connexion MySQL

Pour autoriser une intégration à se connecter à votre base de données MySQL, créez une nouvelle connexion à votre base de données MySQL.

  1. Cliquez sur + Créer pour ouvrir la page Créer une connexion.
  2. Dans la section Emplacement, choisissez l'emplacement de la connexion.
    1. Dans la liste Région, sélectionnez la région dans laquelle vous souhaitez créer la connexion.

      Pour obtenir la liste de toutes les régions disponibles, consultez la section Emplacements.

    2. Cliquez sur Suivant.
  3. Dans la section Détails de connexion, saisissez les informations suivantes :
    1. Dans la liste Connecteur, sélectionnez MySQL (bêta).
    2. Dans la liste Version du connecteur, sélectionnez la version du connecteur.
    3. Dans le champ Nom de connexion, saisissez un nom pour l'instance de connexion.

      Les noms de connexion doivent répondre aux critères suivants :

      • Utilisez des lettres, des chiffres ou des traits d'union.
      • Les lettres doivent être en minuscules.
      • Les noms doivent commencer par une lettre et se terminer par une lettre ou un chiffre.
      • Les noms ne peuvent pas dépasser 63 caractères.
    4. Facultatif : dans le champ Description, ajoutez une description de l'instance de connexion.
    5. Facultatif : activez Cloud Logging.
    6. Dans la liste Compte de service, sélectionnez un compte de service disposant des rôles requis.
    7. Dans le champ Nom de la base de données, saisissez le nom de la base de données MySQL.
    8. Vous pouvez également configurer les paramètres du nœud de connexion :

      • Nombre minimal de nœuds : saisissez le nombre minimal de nœuds de connexion.
      • Nombre maximal de nœuds : saisissez le nombre maximal de nœuds de connexion.

      Un nœud est une unité (ou instance répliquée) de connexion qui traite des transactions. Vous avez besoin de davantage de nœuds pour traiter plus de transactions pour une connexion et, à l'inverse, moins de nœuds sont nécessaires pour traiter moins de transactions. Pour comprendre l'incidence des nœuds sur la tarification des connecteurs, consultez la page Tarifs des nœuds de connexion. Si vous ne saisissez aucune valeur, le nombre minimal de nœuds est défini par défaut sur 2 (pour une meilleure disponibilité) et le nombre maximal sur 50.

    9. Utiliser un proxy : cochez cette case pour configurer un serveur proxy pour la connexion, et spécifiez les valeurs suivantes :
      • Schéma d'authentification du proxy : sélectionnez le type d'authentification pour l'authentification auprès du serveur proxy. Les types d'authentification suivants sont compatibles :
        • Basique : authentification HTTP de base.
        • Condensé : authentification HTTP par condensé.
      • Utilisateur du proxy : nom d'utilisateur à utiliser pour l'authentification auprès du serveur proxy.
      • Mot de passe du proxy : secret Secret Manager du mot de passe de l'utilisateur.
      • Type SSL du proxy : type SSL à utiliser lors de la connexion au serveur proxy. Les types d'authentification suivants sont compatibles :
        • Auto : paramètre par défaut. Dans le cas d'une URL HTTPS, l'option "Tunnel" est utilisée. Dans le cas d'une URL HTTP, l'option "JAMAIS" est utilisée.
        • Toujours : la connexion SSL est toujours activée.
        • Jamais : la connexion n'est pas activée pour SSL.
        • Tunnel : la connexion s'effectue via un proxy de tunnelisation. Le serveur proxy ouvre une connexion à l'hôte distant et le trafic transite par le proxy.
      • Dans la section Serveur proxy, saisissez les détails du serveur proxy.
        1. Cliquez sur + Ajouter une destination.
        2. Sélectionnez un type de destination.
          • Adresse de l'hôte : spécifiez le nom d'hôte ou l'adresse IP de la destination.

            Si vous souhaitez établir une connexion privée à votre système backend, procédez comme suit :

    10. Facultatif : pour ajouter un libellé à la connexion, cliquez sur + Ajouter un libellé.
    11. Cliquez sur Suivant.
    12. Dans la section Destinations, saisissez les détails de l'hôte distant (système backend) auquel vous souhaitez vous connecter.
      • Dans la liste Type de destination, sélectionnez une adresse d'hôte.
        1. Dans le champ Adresse hôte, spécifiez le nom d'hôte ou l'adresse IP de la destination.
          1. Si vous souhaitez établir une connexion privée à vos systèmes backend, procédez comme suit :
            1. Créez un rattachement de service PSC.
            2. Créez un rattachement de point de terminaison, puis saisissez les détails du rattachement de point de terminaison dans le champ Adresse de l'hôte.
          2. Si vous souhaitez établir une connexion publique à vos systèmes backend avec une sécurité supplémentaire, vous pouvez envisager de configurer des adresses IP sortantes statiques pour vos connexions, puis de configurer vos règles de pare-feu pour ajouter à la liste d'autorisation uniquement les adresses IP statiques spécifiques.

        Pour saisir d'autres destinations, cliquez sur + Ajouter une destination.

      • Cliquez sur Suivant.
    13. Dans la section Authentification, vous pouvez fournir des identifiants :
      • Dans le champ Nom d'utilisateur, saisissez le nom d'utilisateur MySQL pour la connexion.
      • Dans le champ Mot de passe, saisissez le secret Secret Manager contenant le mot de passe associé au nom d'utilisateur MySQL.
        • Si vous avez déjà créé un secret et qu'il n'est pas disponible dans la liste, sélectionnez Saisir le secret manuellement. Dans la boîte de dialogue Ajouter un secret par ID de ressource, copiez et collez l'ID de ressource à partir de Secret Manager.
          • Pour utiliser la dernière version, copiez et collez l'ID de ressource à partir du secret parent, au format suivant : "projects/project-number/secrets/secret-name"
          • Pour sélectionner une version spécifique, copiez et collez l'ID de ressource de cette version spécifique au format "projects/project-number/secrets/secret-name/versions/1".

          Pour ajouter le secret, cliquez sur Ajouter un secret.

        • Si vous n'avez pas créé de secret à utiliser avec MySQL, cliquez sur Nouveau secret. Dans la boîte de dialogue Create Secret (Créer un secret), saisissez les détails suivants :
          • Dans le champ Nom, saisissez le nom du secret.
          • Dans le champ Valeur du secret, saisissez le contenu du secret ou importez un fichier contenant le secret.
          • Cliquez sur Créer un secret.
      • Dans la liste Version du secret, sélectionnez la version du secret mot de passe dans la liste déroulante des versions disponibles.
      • Cliquez sur Suivant.
  4. Dans la section Examen, vérifiez les informations de connexion et d'authentification.
  5. Cliquez sur Créer.

Configurer l'authentification

Saisissez les détails en fonction de l'authentification que vous souhaitez utiliser.

  • Nom d'utilisateur et mot de passe
    • Nom d'utilisateur : nom d'utilisateur MySQL à utiliser pour la connexion.
    • Mot de passe : secret Secret Manager contenant le mot de passe associé au nom d'utilisateur MySQL.

Configurer une intégration pour utiliser la connexion MySQL

Pour utiliser la connexion MySQL que vous avez créée dans une intégration, vous devez effectuer les tâches suivantes :

  1. Créer une intégration
  2. Ajouter et configurer un déclencheur d'API
  3. Ajouter et configurer une tâche de connecteur
  4. Connecter l'élément "Déclencheur d'API" à l'élément de tâche "Connecteurs"

Créer une intégration

  1. Dans l'interface utilisateur Apigee, sélectionnez votre organisation Apigee.
  2. Cliquez sur Développer > Intégrations.
  3. Cliquez sur Créer une intégration.
  4. Dans le champ Nom de l'intégration, saisissez le nom de l'intégration.
  5. Facultatif : Dans le champ Description, saisissez une description.
  6. Dans la liste Région, sélectionnez une région pour l'intégration. La liste Régions ne répertorie que les régions provisionnées dans votre projet Google Cloud. Pour provisionner une nouvelle région, cliquez sur Activer la région. Pour savoir comment provisionner de nouvelles régions, consultez la section Activer une nouvelle région.
  7. Pour ouvrir l'éditeur d'intégrations, cliquez sur Créer.

Ajouter et configurer un déclencheur d'API

Après avoir créé une intégration, vous pouvez ajouter et configurer un déclencheur d'API pour votre intégration. Pour cela, procédez comme suit :

  1. Dans la barre d'outils de l'éditeur d'intégrations, cliquez sur Déclencheurs pour afficher la liste des déclencheurs disponibles.
  2. Faites glisser l'élément API vers l'éditeur d'intégrations.

Ajouter et configurer une tâche de connecteur

Pour configurer une tâche Connecteurs afin de lister toutes les entités de la table employee, procédez comme suit :

  1. Dans la barre d'outils de l'éditeur d'intégrations, cliquez sur Tâches pour afficher la liste des tâches disponibles.
  2. Faites glisser l'élément Connecteurs vers l'éditeur d'intégrations.
  3. Cliquez sur l'élément de tâche Connecteurs dans le concepteur pour ouvrir le panneau Connecteurs.
  4. Dans le panneau Connecteurs, cliquez sur Configurer le connecteur.

    Dans la boîte de dialogue Éditeur de tâche du connecteur qui s'affiche, procédez comme suit :

    1. Dans la liste Région, sélectionnez la région de connexion dans laquelle vous avez créé votre connexion MySQL.
    2. Dans la liste Connexion, sélectionnez la connexion MySQL que vous avez créée, puis cliquez sur Suivant.
    3. Dans la section Type, sélectionnez Entités, puis cliquez sur Suivant.
    4. Dans la liste Entité, sélectionnez employé.
    5. Dans la liste Opération, sélectionnez Liste, puis cliquez sur Suivant.
    6. Pour terminer la configuration de la connexion et fermer la boîte de dialogue, cliquez sur OK.

Connecter l'élément "Déclencheur d'API" à l'élément de tâche "Connecteurs"

Ensuite, ajoutez une connexion périphérique pour connecter le déclencheur d'API à la tâche "Connecteurs". Une connexion périphérique est une connexion entre deux éléments d'une intégration. Pour plus d'informations sur les périphérie et les conditions périphériques, consultez la section Périphéries.

Pour ajouter la connexion périphérique, procédez comme suit :

  1. En bas de l'élément "Déclencheur d'API", cliquez sur le point de contrôle Duplication.
  2. Faites glisser la connexion périphérique au niveau du point de contrôle Jointure en haut de l'élément de tâche "Connecteurs".

Tester l'intégration

Pour tester l'intégration, procédez comme suit :

  1. Dans la barre d'outils de l'éditeur d'intégrations, cliquez sur Tester.
  2. Facultatif : modifiez la valeur du Délai d'exécution (en minutes), puis cliquez sur Tester l'intégration.
  3. Une fois l'intégration terminée avec succès, la boîte de dialogue Tester l'intégration affiche le message Exécution de l'intégration réussie. Pour consulter les journaux, cliquez sur Afficher les journaux.
  4. Développez la section Paramètres de réponse. Dans Charge utile de sortie du connecteur, le résultat suivant s'affiche : 
    [ {
    "employee_id": 1.0,
    "employee_first_name": "Peter",
    "employee_last_name": "Dilliard",
    "employee_emailID": "test-01@test.com"
  },
  {
    "employee_id": 2.0,
    "employee_first_name": "Meaghan",
    "employee_last_name": "Webb",
    "employee_emailID": "test-02@test.com"
  } ]

Effectuer d'autres opérations sur la table de base de données MySQL

Lorsque vous configurez une tâche "Connecteurs" dans votre intégration, vous pouvez sélectionner l'une des opérations suivantes :

  • List
  • Get
  • Créer
  • Mettre à jour
  • Supprimer

Vous avez déjà utilisé l'opération List pour afficher toutes les lignes de la table employee. Dans les sections suivantes de ce tutoriel, vous allez utiliser les opérations Get, Create, Update et Delete pour ajouter, modifier ou supprimer des lignes de la table employee.

Obtenir une ligne d'une table

Si vous connaissez l'ID d'entité (ou clé primaire) de la ligne que vous souhaitez récupérer, fournissez cette valeur en tant qu'entrée à une opération Get dans votre intégration. Les détails renvoyés par l'opération Get sont semblables à ceux renvoyés par l'opération List. Toutefois, alors que l'opération List récupère les détails de toutes les lignes de la table correspondant à la requête spécifiée, l'opération Get ne récupère les détails que de la ligne de table correspondant à l'ID d'entité spécifié.

N'oubliez pas que, même si l'opération List renvoie par défaut toutes les lignes de la table, l'opération Get nécessite un ID d'entité en tant que paramètre de recherche. Ainsi, pour utiliser l'opération Get, vous devez connaître l'ID de la ligne que vous souhaitez récupérer ou fournir une valeur par défaut pour l'ID d'entité.

Pour obtenir les détails d'une ligne spécifiée, procédez comme suit pour configurer la tâche Connectors que vous avez créée précédemment :

  1. Dans l'éditeur d'intégrations, cliquez sur l'élément de tâche "Connecteurs" pour afficher le volet de configuration Connecteurs.
  2. Dans le volet de configuration Connecteurs, cliquez sur Configurer le connecteur. Dans la boîte de dialogue Éditeur de tâche du connecteur qui s'affiche, procédez comme suit :
    1. Dans la section Définir les entités/action, sélectionnez Obtenir dans la liste Opérations.
    2. Cliquez sur OK.
  3. Dans le volet de configuration Connecteurs, développez la section Entrée de la tâche. Ensuite, procédez comme suit :
    1. Cliquez sur l'ID d'entité.
    2. Dans la boîte de dialogue Modifier la variable qui s'affiche, sélectionnez Entrée pour l'intégration.
    3. Cliquez sur Enregistrer.
  4. Dans la barre d'outils de l'éditeur d'intégrations, cliquez sur Tester.
  5. Facultatif : modifiez la valeur du Délai d'exécution (en minutes).
  6. Saisissez l'ID d'entité de l'entité pour laquelle vous souhaitez récupérer les détails. Par exemple, 2.
  7. Cliquez sur Tester l'intégration.
  8. Une fois l'intégration terminée avec succès, la boîte de dialogue Tester l'intégration affiche le message Exécution de l'intégration réussie. Pour consulter les journaux, cliquez sur Afficher les journaux.
  9. Développez la section Paramètres de réponse. Dans Charge utile de sortie du connecteur, le résultat suivant s'affiche : 
    [ {
    "employee_id": 2.0,
    "employee_first_name": "Meaghan",
    "employee_last_name": "Webb",
    "employee_emailID": "test-02@test.com"
  } ]
  10. Vous pouvez vérifier que les informations affichées ici coïncident avec les informations de la ligne correspondante dans votre table MySQL. Pour afficher ces informations dans votre table MySQL, exécutez la commande suivante à partir de votre client MySQL : 
    SELECT * FROM employee WHERE employee_id=2;
    La ligne de table suivante s'affiche : 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

Ajouter une ligne à une table

L'opération Create vous permet d'ajouter une ligne dans une table. Lorsque vous utilisez l'opération Create, vous devez fournir toutes les valeurs de l'entité dans la charge utile d'entrée du connecteur.

Pour ajouter une ligne à l'aide de l'opération Create, procédez comme suit pour configurer la tâche Connectors que vous avez créée précédemment :

  1. Dans l'éditeur d'intégrations, cliquez sur l'élément de tâche "Connecteurs" pour afficher le volet de configuration Connecteurs.
  2. Dans le volet de configuration Connecteurs, cliquez sur Configurer le connecteur. Dans la boîte de dialogue Éditeur de tâche du connecteur qui s'affiche, procédez comme suit :
    1. Dans la section Définir les entités/action, dans la liste Opérations, sélectionnez Créer.
    2. Cliquez sur OK.
  3. Dans le volet de configuration Connecteurs, développez la section Entrée de la tâche. Ensuite, procédez comme suit :
    1. Cliquez sur l'ID d'entité.
    2. Dans la boîte de dialogue Modifier la variable qui s'affiche, sélectionnez Entrée pour l'intégration.
    3. Cliquez sur Enregistrer.
  4. Dans la barre d'outils de l'éditeur d'intégrations, cliquez sur Tester.
  5. Facultatif : modifiez la valeur du Délai d'exécution (en minutes).
  6. Saisissez les détails de l'entité que vous souhaitez créer. Par exemple, pour ajouter un nouvel employé dans la table employee, saisissez le code JSON suivant : 
    {
  "employee_first_name": "Mary",
  "employee_last_name": "Smith",
  "employee_emailID": "test-03@test.com"
}
  7. Cliquez sur Tester l'intégration.
  8. Une fois l'intégration terminée avec succès, la boîte de dialogue Tester l'intégration affiche le message Exécution de l'intégration réussie. Pour consulter les journaux, cliquez sur Afficher les journaux.
  9. Développez la section Paramètres de réponse. Dans Charge utile de sortie du connecteur, le résultat suivant s'affiche : 
    {
  "employee_first_name": "Mary",
  "employee_last_name": "Smith",
  "employee_emailID": "test-03@test.com"
}
    Sous Charge utile de sortie du connecteur, l'ID d'entité s'affiche en tant que sortie : 
    {
  "employee_id": 3.0
}
  10. Vous pouvez vérifier que la ligne est ajoutée dans votre table MySQL. Pour afficher ces informations dans votre table MySQL, exécutez la commande suivante à partir de votre client MySQL : 
    SELECT * FROM employee;
    Les lignes de table suivantes s'affichent : 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
|           3 | Mary                | Smith              | test-03@test.com |
+-------------+---------------------+--------------------+------------------+

Mettre à jour une ligne dans une table

Utilisez l'opération Update pour modifier les valeurs d'une ligne de table. Par exemple, vous pouvez utiliser cette opération pour mettre à jour l'ID d'adresse e-mail d'un employé dans la table employee. Pour spécifier l'entité que vous souhaitez mettre à jour, vous pouvez fournir l'ID d'entité comme vous l'avez fait pour l'opération Get. Vous pouvez également utiliser le paramètre Clause de filtre pour transmettre les valeurs qui seront utilisées pour filtrer les lignes de la table. Cette méthode est utile si vous souhaitez apporter la même modification sur plusieurs lignes en fonction de critères de recherche spécifiques.

Pour mettre à jour une ligne de table, procédez comme suit pour configurer la tâche Connectors que vous avez créée précédemment :

  1. Dans l'éditeur d'intégrations, cliquez sur l'élément de tâche "Connecteurs" pour afficher le volet de configuration Connecteurs.
  2. Dans le volet de configuration Connecteurs, cliquez sur Configurer le connecteur. Dans la boîte de dialogue Éditeur de tâche du connecteur qui s'affiche, procédez comme suit :
    1. Dans la section Définir les entités/action, dans la liste Opérations, sélectionnez Mettre à jour.
    2. Cliquez sur OK.
  3. Dans le volet de configuration Connecteurs, développez la section Entrée de la tâche. Ensuite, procédez comme suit :
    1. Cliquez sur Clause de filtre.
    2. Dans la boîte de dialogue Modifier la variable qui s'affiche, sélectionnez Entrée pour l'intégration.
    3. Cliquez sur Enregistrer.
  4. Dans la barre d'outils de l'éditeur d'intégrations, cliquez sur Tester.
  5. Facultatif : modifiez la valeur du Délai d'exécution (en minutes).
  6. Saisissez les critères de filtrage. Par exemple, pour rechercher un employé avec l'ID d'adresse e-mail test-03@test.com, saisissez ce qui suit : 
    employee_emailID="test-03@test.com"
  7. Saisissez les valeurs à mettre à jour. Par exemple, pour mettre à jour l'ID d'adresse e-mail de tous les employés de la table employee dont l'ID d'adresse e-mail actuel correspond à la clause de filtre test-03@test.com, saisissez le JSON suivant : 
    {
  "employee_emailID": "msmith@test.com"
}
  8. Cliquez sur Tester l'intégration.
  9. Une fois l'intégration terminée avec succès, la boîte de dialogue Tester l'intégration affiche le message Exécution de l'intégration réussie.

    Pour vérifier que l'entité a bien été mise à jour, utilisez l'opération Get pour obtenir les détails de l'entité spécifiée.

  10. Vous pouvez vérifier que la ligne est mise à jour dans votre table MySQL. Pour afficher ces informations dans votre table MySQL, exécutez la commande suivante à partir de votre client MySQL : 
    SELECT * FROM employee;
    Les lignes de table suivantes s'affichent : 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
|           3 | Mary                | Smith              | msmith@test.com  |
+-------------+---------------------+--------------------+------------------+

Supprimer une ligne dans une table

Vous pouvez utiliser l'opération Delete pour supprimer une ou plusieurs lignes d'une table. Fournissez l'ID d'entité ou utilisez la clause de filtrage pour spécifier les lignes que vous souhaitez supprimer. N'oubliez pas que si vous utilisez la clause de filtrage pour spécifier des critères vis-à-vis des lignes à supprimer, il est possible de supprimer plusieurs lignes correspondant au filtre donné. Si vous souhaitez supprimer une seule ligne spécifique, utilisez l'ID d'entité.

Pour supprimer une ligne de table à l'aide de l'ID d'entité, procédez comme suit pour configurer la tâche Connecteurs que vous avez créée précédemment :

  1. Dans l'éditeur d'intégrations, cliquez sur l'élément de tâche "Connecteurs" pour afficher le volet de configuration Connecteurs.
  2. Dans le volet de configuration Connecteurs, cliquez sur Configurer le connecteur. Dans la boîte de dialogue Éditeur de tâche du connecteur qui s'affiche, procédez comme suit :
    1. Dans la section Définir les entités/action, sélectionnez Obtenir dans la liste Opérations.
    2. Cliquez sur OK.
  3. Dans le volet de configuration Connecteurs, développez la section Entrée de la tâche. Ensuite, procédez comme suit :
    1. Cliquez sur l'ID d'entité.
    2. Dans la boîte de dialogue Modifier la variable qui s'affiche, sélectionnez Entrée pour l'intégration.
    3. Cliquez sur Enregistrer.
  4. Dans la barre d'outils de l'éditeur d'intégrations, cliquez sur Tester.
  5. Facultatif : modifiez la valeur du Délai d'exécution (en minutes).
  6. Saisissez l'ID d'entité de l'entité pour laquelle vous souhaitez récupérer les détails. Par exemple, 2.
  7. Cliquez sur Tester l'intégration.
  8. Une fois l'intégration terminée avec succès, la boîte de dialogue Tester l'intégration affiche le message Exécution de l'intégration réussie.

    Pour vérifier que la ligne de la table a bien été supprimée, utilisez l'opération Get pour obtenir les détails de la ligne que vous avez supprimée. Cette erreur devrait renvoyer une erreur pour l'ID d'entité spécifié.

    Vous pouvez également utiliser l'opération List et éventuellement fournir une clause de filtrage pour la ou les lignes de table que vous avez supprimées. Cette fonction renvoie la liste des lignes restantes, qui peut être vide.

    Par exemple, si vous avez supprimé la ligne de table avec l'ID d'entité 3, si vous spécifiez la clause de filtrage employee_emailID="msmith@test.com" ou l'ID d'entité 3 pour l'opération List, les paramètres de réponse dans les journaux affichent [].

  9. Vous pouvez vérifier que la ligne est supprimée dans votre table MySQL. Pour vérifier cela dans votre table MySQL, exécutez la commande suivante à partir de votre client MySQL : 
    SELECT * FROM employee;
    Les lignes de table suivantes s'affichent : 
    +-------------+---------------------+--------------------+------------------+
| employee_id | employee_first_name | employee_last_name | employee_emailID |
+-------------+---------------------+--------------------+------------------+
|           1 | Peter               | Dilliard           | test-01@test.com |
|           2 | Meaghan             | Webb               | test-02@test.com |
+-------------+---------------------+--------------------+------------------+

Étapes suivantes

Essayez de créer des intégrations avec d'autres connecteurs. Pour obtenir la liste de tous les connecteurs compatibles, consultez la Documentation de référence sur les connecteurs.