Office 365

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 via 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é. 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, dans un connecteur de serveur de fichiers, les dossiers sont les entités et, dans un connecteur de système de messagerie, les files d'attente sont les entités.

  Toutefois, il est possible qu'un connecteur ne soit pas compatible 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é. Vous pouvez effectuer l'une des opérations suivantes sur une entité :
  • Liste
  • Obtenir
  • Créer
  • Mettre à jour
  • Supprimer

  La sélection d'une entité dans la liste disponible 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 de connecteur. Toutefois, si un connecteur n'est pas compatible avec l'une des opérations d'entité, ces opérations non compatibles ne sont pas listées dans la liste Operations.

• Action : une action est une fonction de première classe mise à la disposition de l'intégration via 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 ne prenne en charge aucune action, auquel cas la liste Actions est vide.

Actions

Cette section répertorie les actions compatibles avec le connecteur. Pour savoir comment configurer les actions, consultez Exemples d'actions.

Action CancelEvent

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

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

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

Action MoveMail

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

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

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

Action AssignLicense

Cette action vous permet d'attribuer une licence.

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

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

Action ForwardEvent

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

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

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

Action UploadFile

Cette action vous permet d'importer un fichier.

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

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

Action DownloadFile

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

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

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

Action "CreateFolder" (Créer un dossier)

Cette action vous permet de créer un dossier.

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

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

Action SendMail

Cette action vous permet d'envoyer un e-mail.

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

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

Action ForwardMail

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

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

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

Action DownloadEmail

Cette action vous 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 la section Exemples d'actions.

Action DownloadAttachments

Cette action vous 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 la section 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 avec 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 réussit, le paramètre de réponse connectorOutputPayload de la tâche CancelEvent aura une valeur semblable à celle-ci:

[{
"Status": "Success"
}]

Exemple : Attribuer et supprimer une licence

Cet exemple attribue et retire 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 réussit, le paramètre de réponse connectorOutputPayload de la tâche AssignLicense aura une valeur semblable à celle-ci:

[{
"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 réussit, le paramètre de réponse connectorOutputPayload de la tâche ForwardEvent aura une valeur semblable à celle-ci:

[{
"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 réussit, le paramètre de réponse connectorOutputPayload de la tâche UploadFile aura une valeur semblable à celle-ci:

 [{
"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 réussit, le paramètre de réponse connectorOutputPayload de la tâche DownloadFile aura une valeur semblable à celle-ci:

[{
"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 réussit, le paramètre de réponse connectorOutputPayload de la tâche CreateFolder aura une valeur semblable à celle-ci:

[{
"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 réussit, le paramètre de réponse connectorOutputPayload de la tâche SendMail aura une valeur semblable à celle-ci:

[{
"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 réussit, le paramètre de réponse connectorOutputPayload de la tâche ForwardMail aura une valeur semblable à celle-ci:

[{
"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 réussit, le paramètre de réponse connectorOutputPayload de la tâche DownloadEmail aura une valeur semblable à celle-ci:

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

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

Cet exemple télécharge les 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 réussit, le paramètre de réponse connectorOutputPayload de la tâche DownloadAttachments aura une valeur semblable à celle-ci:

[{
"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
}]