Dropbox

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 CopyResource

Cette action permet de copier un fichier ou un dossier vers un autre emplacement dans le Dropbox de l'utilisateur.

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

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

Action CreateFolder

Cette action permet de créer un dossier à un emplacement donné.

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

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

Action DeleteResource

Cette action permet de supprimer le fichier ou le dossier à un emplacement donné. Si le chemin d'accès est un dossier, tout son contenu sera également supprimé.

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

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

Action MoveResource

Cette action permet de déplacer un fichier ou un dossier vers un autre emplacement dans le Dropbox de l'utilisateur. Si le chemin d'accès source est un dossier, tout son contenu sera déplacé. Notez que vous ne pouvez pas modifier un nom en changeant uniquement la casse pour le moment.

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

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

Action RenameResource

Cette action permet de renommer une ressource en fournissant un chemin d'accès et un nouveau nom.

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

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

Action UnshareFolder

Cette action permet d'annuler le partage d'un dossier. Nécessite le niveau d'accès "sharing.write".

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

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

Action DownloadFile

Cette action permet de télécharger un fichier. Nécessite le niveau d'accès "files.content.read".

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

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

Exemples d'actions

Cette section explique comment effectuer certaines actions dans ce connecteur.

Exemple : Copier une ressource

L'exemple suivant montre comment copier une ressource ayant un chemin d'accès spécifié vers un autre chemin d'accès :

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

   {
     "From_Path": "/DropboxFolder/pptxFile.pptx",
     "To_Path": "/DropBoxFolder2/Folder/pptFile.pptx"
   }

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

[ { "Success": "true", "metadata_.tag": "file", 
  "metadata_name": "pptxFile.pptx", 
  "metadata_path_lower": "/testingdropboxupdated/abcde/pptxfile.pptx", 
  "metadata_path_display": "/TestingDropBoxUpdated/abcde/pptxFile.pptx", 
  "metadata_parent_shared_folder_id": "3204685267", "metadata_id": "id:8-07A6kHAoIAAAAAAAAC1w",
  "metadata_client_modified": "2024-06-13T11:06:37Z", "metadata_server_modified": "2024-07-12T10:19:02Z",
  "metadata_rev": "61d0a3560ecb5bf039dd3", "metadata_size": "17052", 
  "metadata_sharing_info_read_only": "false", "metadata_sharing_info_parent_shared_folder_id": "3204685267",
  "metadata_sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A", 
  "metadata_is_downloadable": "true", 
  "metadata_content_hash": "0234f7d4eaf914cb276716c8b2a24e24655d1f6f39ee549207e33a4255e2fba2" } ]

Exemple : Créer un dossier

L'exemple suivant montre comment créer un dossier à un emplacement donné :

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 :

   {
     "Path": "/TestDrobBoxFolder/newFolder"
   }

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

[ { "Id": "id:8-07A6kHAoIAAAAAAAAC2Q" } ]

Exemple : Supprimer une ressource

L'exemple suivant montre comment supprimer une ressource :

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

   {
     "Path": "/TestingDropBox/FolderToBeDeletedName"
   }

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

[{
"Status": "Success"
}]

Exemple : Déplacer une ressource

L'exemple suivant montre comment déplacer une ressource :

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

   {
     "From_Path": "/TestDropBoxFolder/Folder1/dummypdf2.pdf",
     "To_Path": "/EmptyFolder/Folder1/dummypdf2.pdf"
   }

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

[{
  "Status": "Success"
  }]

Exemple : Renommer une ressource

L'exemple suivant montre comment renommer une ressource :

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

   {
     "Path": "/TestDropBox/abcd",
     "NewName": "abcded"
   }

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

[{
"Status": "Success"
}]

Exemple : Annuler le partage d'un dossier

L'exemple suivant montre comment annuler le partage d'un dossier :

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

   {
     "FolderId": "3336772979"
   }

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

[{
"Status": "Success"
}]

Exemple : Télécharger un fichier

L'exemple suivant montre comment télécharger 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 :

   {
     "Id": "id:8-07A6kHAoIAAAAAAAABcg",
     "FileType": "file"
   }

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

[ { "Success": "true", "Name": "license.txt", 
  "Id": "id:8-07A6kHAoIAAAAAAAABcg", "ClientModified": "2024-07-09T09:52:41Z", 
  "ServerModified": "2024-07-09T09:52:41Z", "Revision": "61ccd7da2b987c0f52053", "Size": "11", 
  "LowerCasePath": "/sahil kapoor/testingdropboxupdated/uploadfolderwithnestedfolder/nestedfolder2/license.txt",
   "DisplayPath": "/Sahil Kapoor/TestingDropBoxUpdated/uploadFolderWithNestedFolder/NestedFolder2/license.txt",
    "PreviewURL": null, "IsDownloadable": "true", "HasExplicitSharedMembers": null, 
  "ContentHash": "f6dc724d119649460e47ce719139e521e082be8a9755c5bece181de046ee65fe", "Owner": null,
  "Title": null, "MimeType": null, "FileData": "SGVsbG8gd29ybGQ=", "parent_shared_folder_id": "3237290067",
  "sharing_info_read_only": "false", "sharing_info_parent_shared_folder_id": "3237290067", 
  "sharing_info_modified_by": "dbid:AACVLctlrEo-ouTSxUVSTi0loZCSZKc933A" } ]