Office365

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 la liste des actions prises en charge par le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action CancelEvent

Cette action permet d'annuler un événement.

Paramètres d'entrée de l'action CancelEvent

Pour savoir comment configurer l'action CancelEvent, consultez Exemples d'actions.

Action MoveMail

Cette action permet de déplacer un e-mail.

Paramètres d'entrée de l'action MoveMail

Pour savoir comment configurer l'action MoveMail, consultez Exemples d'actions.

Action AssignLicense

Cette action permet d'attribuer une licence.

Paramètres d'entrée de l'action AssignLicense

Pour savoir comment configurer l'action AssignLicense, consultez Exemples d'actions.

Action ForwardEvent

Cette action permet de transférer un événement.

Paramètres d'entrée de l'action ForwardEvent

Pour savoir comment configurer l'action ForwardEvent, consultez Exemples d'actions.

Action UploadFile

Cette action permet d'importer un fichier.

Paramètres d'entrée de l'action UploadFile

Pour savoir comment configurer l'action UploadFile, consultez Exemples d'actions.

Action DownloadFile

Cette action permet de télécharger un fichier.

Paramètres d'entrée de l'action DownloadFile

Pour savoir comment configurer l'action DownloadFile, consultez Exemples d'actions.

Action CreateFolder

Cette action permet de créer un dossier.

Paramètres d'entrée de l'action CreateFolder

Pour savoir comment configurer l'action CreateFolder, consultez Exemples d'actions.

Action SendMail

Cette action permet d'envoyer un e-mail.

Paramètres d'entrée de l'action SendMail

Pour savoir comment configurer l'action SendMail, consultez Exemples d'actions.

Action ForwardMail

Cette action permet de transférer un e-mail.

Paramètres d'entrée de l'action ForwardMail

Pour savoir comment configurer l'action ForwardMail, consultez Exemples d'actions.

Action DownloadEmail

Cette action permet de télécharger un e-mail.

Paramètres d'entrée de l'action DownloadEmail

Pour savoir comment configurer l'action DownloadMail, consultez Exemples d'actions.

Action DownloadAttachments

Cette action permet de télécharger les pièces jointes d'un e-mail.

Paramètres d'entrée de l'action DownloadAttachments

Pour savoir comment configurer l'action DownloadAttachments, consultez Exemples d'actions.

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : Annuler un événement

Cet exemple annule un événement ayant l'ID spécifié.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CancelEvent, 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 :

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-GAAA=",   
   "Comment": "Canceled due to rain"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CancelEvent aura une valeur semblable à la suivante :

[{
"Status": "Success"
}]

Exemple : Attribuer et supprimer une licence

Cet exemple attribue et supprime des licences pour l'utilisateur spécifié.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action AssignLicense, 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 :

   {
   "UserID": "ee58217f-b22e-4300-a876-53db3c71a87b",   
   "AddLicenseSkuId": "c42b9cae-ea4f-4ab7-9717-81576235ccac",   
   "RemoveLicenses": "c42b9cae-ea4f-4ab7-9717-81576235ccac"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche AssignLicense aura une valeur semblable à la suivante :

[{
"Status": "Success"
}]

Exemple : Transférer un événement

Cet exemple transfère un événement.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ForwardEvent, 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 :

   {
   "EventId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAENAAAhfASdetQfTZ3pESzwWnAbAAA_CxGjAAA=",   
   "Comment": "forwarded due to rain",   
   "ToRecipients": "test99@example.com"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ForwardEvent aura une valeur semblable à la suivante :

[{
"Status": "Success"
}]

Exemple : Importer un fichier

Cet exemple importe un fichier.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action UploadFile, 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 :

   {
   "FileName": "Document1234.docx",   
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "Content": "test"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche UploadFile aura une valeur semblable à la suivante :

 [{
"Id": "01VCU572JX6F3L3NKLQVB2BXETRHLEAUAY",   
"@test.context": "https://example.com/v1.0/$metadata#users('7954f490-5a43-083fc215362a')/drive/items('01VCU5BZO354PWSELRRZ')/test/$entity",   
"@example.downloadurl": "https://example.com/test/admin123/_layouts/15/download.aspx?UniqueId=bd76224r7-4........
"Status": "Success"
}] 

Exemple : Télécharger un fichier

Cet exemple télécharge un fichier.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action DownloadFile, 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 :

   {
   "FileId": "01VCU572LDCGQYZOSMHZDZGN5HCXS5P6EP"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadFile aura une valeur semblable à la suivante :

[{
"Status": "Success",
"FileData": "UEsDBBQAAAAIAEoTdVdSWj6GTAEAABoFAAATAAAAWNdLnhtbLWUTU7DMBCFr2J"
}]

Exemple : Créer un dossier

Cet exemple crée un dossier.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action CreateFolder, 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 :

   {
   "ParentId": "01VCU572N6Y2GOVW7725BZO354PWSELRRZ",   
   "FolderName": "outbox1234"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche CreateFolder aura une valeur semblable à la suivante :

[{
"Status": "Success"
}]

Exemple : Envoyer un e-mail

Cet exemple envoie un e-mail aux destinataires spécifiés.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action SendMail, 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 :

   {
   "ToRecipients": "test097@example.com",   
   "Content": "Testing",   
   "Subject": "Test subject",   
   "FileName": "Google"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche SendMail aura une valeur semblable à la suivante :

[{
"Status": "Success"
}]

Exemple : Transférer un e-mail

Cet exemple transfère un e-mail.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action ForwardMail, 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 :

   {
   "MessageId": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGAAAAAACvzgT4b7T_Qav2LM_bB-PKBwAhfASdetQfTpESzwWnAbAAA0sITVAAA=",   
   "ToRecipients": "test097@example.com",   
   "Comment": "forwarded message"
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche ForwardMail aura une valeur semblable à la suivante :

[{
"Status": "Success"
}]

Exemple : Télécharger un e-mail

Cet exemple télécharge un e-mail.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action DownloadEmail, 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 :

   {
   "MessageId": "fTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITVAAA="
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadEmail aura une valeur semblable à la suivante :

[{
"Status": "Success",   
"FileData": "RnJvbTogRk5VIExOVSA8YWRtaW4xMjNANzNzY21nLm9ubWljcm9zb2Z0LmNvbT4NClRvOiB0ZXN0IDx0ZXN0.......
}]

Exemple : Télécharger des pièces jointes

Cet exemple télécharge des pièces jointes.

1. Dans la boîte de dialogue Configure connector task, cliquez sur Actions.
2. Sélectionnez l'action DownloadAttachments, 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 :

   {
   {"MessageId": "PKBwAhfASdetQfTZ3pESzwWnAbAAAAAAEJAAAhfASdetQfTZ3pESzwWnAbAAA0sITWAAA=",   
   "DownloadTo": "My files/Office355/reports/"}
   }

Si l'action aboutit, le paramètre de réponse connectorOutputPayload de la tâche DownloadAttachments aura une valeur semblable à la suivante :

[{
"Id": "AAMkAGQ2NGQwNWU0LTU2MjUtNDZmNy04NGQzLTY4ZmU4Y2E4Y2JiNgBGTWAAABEgAQAF3EBDrnTc1Cj8akAYrJjdM=",
"Name": "demoattachment.docx",
"ContentBytes": "UEsDBBQAAAAIALskYlcppqeszQEAAHQJAAATAAAAWAAAI3RyYXNoXS8wMDAwLmRhdP........",
"LastmodifiedDatetime": "2023-11-21T10:09:09Z",
"ContentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"FileData": null,
"json:repeatelementorder#": null,
"size": "23575",
"isinline": "false
}]