SendGrid

Configurer l'authentification

Entités, opérations et actions

Tous les connecteurs Integration Connectors fournissent une couche d'abstraction pour les objets de l'application connectée. Vous ne pouvez accéder aux objets d'une application que par le biais de cette abstraction. L'abstraction vous est présentée en tant qu'entités, opérations et actions.

• Entité : une entité peut être considérée comme un objet ou un ensemble de propriétés dans l'application ou le service connectés. La définition d'une entité diffère d'un connecteur à l'autre. Par exemple, dans un connecteur de base de données, les tables sont les entités, alors que dans un connecteur de serveur de fichiers, ce sont les dossiers, et dans un connecteur de système de messagerie, ce sont les files d'attente.

  Toutefois, il est possible qu'un connecteur n'accepte ou ne possède aucune entité. Dans ce cas, la liste Entities est vide.

• Opération : une opération est l'activité que vous pouvez effectuer sur une entité. Voici les opérations possibles :
  • List
  • Get
  • Create
  • Update
  • Delete

  Lorsque vous sélectionnez une entité dans la liste proposée, cela génère une liste d'opérations disponibles pour l'entité. Pour obtenir une description détaillée des opérations, consultez les opérations d'entité de la tâche "Connecteurs". Cependant, si un connecteur n'accepte pas l'une des opérations d'entité, cette opération non compatible ne figure pas dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration par le biais de l'interface du connecteur. Une action vous permet de modifier une ou plusieurs entités, et varie d'un connecteur à l'autre. Normalement, une action comporte des paramètres d'entrée et un paramètre de sortie. Toutefois, il est possible qu'un connecteur n'accepte aucune action, auquel cas la liste Actions est vide.

Actions

Dans cette section, vous trouverez une liste non exhaustive des actions prises en charge par le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action SendMail2

Cette action envoie un e-mail avec une pièce jointe.

Paramètres d'entrée de l'action "Envoyer un e-mail"

Paramètres de sortie de l'action "Envoyer un e-mail"

Cette action renvoie un message de confirmation indiquant si l'e-mail a bien été envoyé.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : Envoyer un e-mail

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action SendMail2, puis cliquez sur OK.
3. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
       "FromName": "Name",
       "FromEmail": "cloudysanfrancisco@gmail.com",
       "Subject": "[{\"value\": \"cymbalgroup.com\",\"type\": \"text/plain\"}]",
       "TemplateId": "d-c4bc730a0b094a3a9d9cabb7347b5edc",
       "Personalizations": "[{\"subject\": \"Test Subject3\",\"send_at\": 1698659820,\"from\": {\"name\": \"hi\",\"email\": \"email@gmail\"},\"to\":      
       [{\"email\": \"email@gmail.com\",\"name\": \"test\"}\n ]}]",
       "Content": "[{\"value\": \"abc@cdata.com\",\"type\": \"text/plain\"}]"
   }

Cette action renvoie un message de confirmation. Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche aura une valeur semblable à la suivante :

[{
"Success": "True"
}]

Exemples d'opérations d'entité

Cette section explique comment effectuer certaines opérations d'entité dans ce connecteur.

Exemple : Lister tous les contacts

Cet exemple liste tous les contacts de l'entité NMCContacts.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez NMCContacts dans la liste Entity.
3. Sélectionnez l'opération List, puis cliquez sur OK.
4. (Facultatif) Dans la section Entrée de la tâche de la tâche Connecteurs, vous pouvez filtrer votre ensemble de résultats en spécifiant une clause de filtre. Exemple : City='Bangalore'. Vous pouvez également spécifier plusieurs conditions de filtre à l'aide des opérateurs logiques. Par exemple, City='Bangalore' and region='asia-south2'.

Exemple : Récupérer un enregistrement

Cet exemple récupère un enregistrement ayant l'ID spécifié à partir de l'entité NMCSegments.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez NMCSegments dans la liste Entity.
3. Sélectionnez l'opération Get, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur EntityId, puis saisissez 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 dans le champ Valeur par défaut.

   Ici, 0d44bb3f-d28e-4bcf-aba2-c77be831ad46 est une valeur de clé primaire dans l'entité NMCSegments.

Exemple : Créer un enregistrement

Cet exemple crée un enregistrement dans l'entité NMCSenders.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez NMCSenders dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Nickname": "Test",
   "FromEmail": "test1@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test1@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
   "Id": 5360940.0
   }

Exemple : Créer un enregistrement

Cet exemple crée un enregistrement dans l'entité NMCLists.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez NMCLists dans la liste Entity.
3. Sélectionnez l'opération Create, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Name": "TEST_CON_LIST1699262238224",
   "ContactCount": 3.0}

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
   "Id": "d927f128-b718-447a-affe-417f1a8b3abd"}

Exemple : Mettre à jour un enregistrement

Cet exemple met à jour un enregistrement dans l'entité NMCSenders.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez NMCSenders dans la liste Entity.
3. Sélectionnez l'opération Update, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur connectorInputPayload, puis saisissez une valeur semblable à la suivante dans le champ Default Value :

   {
   "Nickname": "Test",
   "FromEmail": "test2@examplepetstore.com",
   "FromName": "testuser",   
   "ReplytoEmail": "test2@examplepetstore.com",  
   "Address": "NA", 
   "City": "NA", 
   "Country": "India"}

5. Cliquez sur entityId, puis saisissez 5360940.0 dans le champ Valeur par défaut.

   Si l'intégration aboutit, le champ connectorOutputPayload de la tâche "Connecteurs" aura une valeur semblable à la suivante :

   {
   "Id":"5360940.0"
   }

Exemple : Supprimer un enregistrement

Cet exemple supprime l'enregistrement ayant l'ID spécifié dans l'entité NMCSegments.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Entities.
2. Sélectionnez NMCSegments dans la liste Entity.
3. Sélectionnez l'opération Delete, puis cliquez sur OK.
4. Dans la section Entrée de la tâche de la tâche Connecteurs, cliquez sur entityId, puis saisissez c58b9151-7279-428a-bac2-12b4bf2b48b0 dans le champ Valeur par défaut.