Dropbox

Entità, operazioni e azioni

Tutti i connettori di integrazione forniscono un livello di astrazione per gli oggetti dell'applicazione connessa. Puoi accedere agli oggetti di un'applicazione solo tramite questa astrazione. L'astrazione ti viene mostrata come entità, operazioni e azioni.

• Entità : un'entità può essere considerata un oggetto o una raccolta di proprietà nell'applicazione o nel servizio connesso. La definizione di un'entità varia da un connettore all'altro. Ad esempio, in un connettore di database, le tabelle sono le entità, in un connettore del file server, le cartelle sono le entità e in un connettore del sistema di messaggistica, le code sono le entità.

  Tuttavia, è possibile che un connettore non supporti o non abbia entità, nel qual caso l'elenco Entities sarà vuoto.

• Operazione : un'operazione è l'attività che puoi eseguire su un'entità. Puoi eseguire una delle seguenti operazioni su un'entità:
  • Elenca
  • Scarica
  • Crea
  • Aggiorna
  • Elimina

  Selezionando un'entità dall'elenco disponibile, viene generato un elenco di operazioni disponibili per l'entità. Per una descrizione dettagliata delle operazioni, consulta le operazioni sulle entità dell'attività Connettori. Tuttavia, se un connettore non supporta alcuna delle operazioni sulle entità, queste operazioni non supportate non sono elencate nell'elenco Operations.

• Azione: un'azione è una funzione di prima classe resa disponibile per l'integrazione tramite l'interfaccia del connettore. Un'azione ti consente di apportare modifiche a una o più entità e varia da connettore a connettore. In genere, un'azione ha alcuni parametri di input e un parametro di output. Tuttavia, è possibile che un connettore non supporti alcuna azione, nel qual caso l'elenco Actions sarà vuoto.

Azioni

Questa sezione elenca le azioni supportate dal connettore. Per capire come configurare le azioni, consulta Esempi di azioni.

Azione CopyResource

Questa azione ti consente di copiare un file o una cartella in una posizione diversa nel Dropbox dell'utente.

Parametri di input dell'azione CopyResource

Per un esempio di come configurare l'azione CopyResource, consulta Esempi di azioni.

Azione CreateFolder

Questa azione ti consente di creare una cartella in un determinato percorso.

Parametri di input dell'azione CreateFolder

Per un esempio di come configurare l'azione CreateFolder, consulta Esempi di azioni.

Azione DeleteResource

Questa azione ti consente di eliminare il file o la cartella in un determinato percorso. Se il percorso è una cartella, verranno eliminati anche tutti i relativi contenuti.

Parametri di input dell'azione DeleteResource

Per un esempio di come configurare l'azione DeleteResource, consulta Esempi di azioni.

Azione MoveResource

Sposta un file o una cartella in una posizione diversa nella Dropbox dell'utente. Se il percorso di origine è una cartella, verranno spostati tutti i relativi contenuti. Tieni presente che al momento non supportiamo la ridenominazione solo in base alle maiuscole e minuscole.

Parametri di input dell'azione MoveResource

Per un esempio di come configurare l'azione MoveResource, consulta Esempi di azioni.

Azione RenameResource

Questa azione consente di rinominare una risorsa fornendo un percorso e un nuovo nome.

Parametri di input dell'azione RenameResource

Per un esempio di come configurare l'azione RenameResource, consulta Esempi di azioni.

Azione UnshareFolder

Questa azione consente di annullare la condivisione di una cartella. Richiede l'ambito sharing.write.

Parametri di input dell'azione UnshareFolder

Per un esempio di come configurare l'azione UnshareFolder, consulta Esempi di azioni.

Azione DownloadFile

Questa azione consente di scaricare un file. Richiede l'ambito files.content.read.

Parametri di input dell'azione DownloadFile

Per un esempio di come configurare l'azione DownloadFile, consulta Esempi di azioni.

Esempi di azioni

Questa sezione descrive come eseguire alcune delle azioni in questo connettore.

Esempio: copia una risorsa

Il seguente esempio mostra come copiare una risorsa con il percorso specificato in un percorso diverso:

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CopyResource, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro CopyResource della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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

Esempio: creare una cartella

L'esempio seguente mostra come creare una cartella in un determinato percorso:

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione CreateFolder, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro di risposta connectorOutputPayload dell'attività CreateFolder avrà un valore simile al seguente:

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

Esempio: elimina una risorsa

L'esempio seguente mostra come eliminare una risorsa:

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DeleteResource, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DeleteResource della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: sposta una risorsa

Il seguente esempio mostra come spostare una risorsa:

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione MoveResource, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro MoveResource della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
  "Status": "Success"
  }]

Esempio: rinominare una risorsa

Il seguente esempio mostra come rinominare una risorsa:

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione RenameResource, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro RenameResource della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: annullare la condivisione di una cartella

Il seguente esempio mostra come annullare la condivisione di una cartella:

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione UnshareFolder, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

   {
     "FolderId": "3336772979"
   }

Se l'azione ha esito positivo, il parametro UnshareFolder della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

[{
"Status": "Success"
}]

Esempio: scaricare un file

L'esempio seguente mostra come scaricare un file:

1. Nella finestra di dialogo Configure connector task, fai clic su Actions.
2. Seleziona l'azione DownloadFile, quindi fai clic su Fine.
3. Nella sezione Input attività dell'attività Connettori, fai clic su connectorInputPayload e poi inserisci un valore simile al seguente nel campo Default Value:

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

Se l'azione ha esito positivo, il parametro DownloadFile della risposta connectorOutputPayload dell'attività avrà un valore simile al seguente:

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