Dropbox

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

• Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

  No entanto, é possível que um conector não aceite ou não tenha entidades. Nesse caso, a lista Entities estará vazia.

• Operação: uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:
  • Lista
  • Receber
  • Criar
  • Atualizar
  • Excluir

  Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não oferecer suporte a nenhuma das operações da entidade, como as operações não estão listadas na lista Operations.

• Ação: uma ação é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer alterações em uma ou mais entidades e varia de um conector para outro. Normalmente, uma ação tem alguns parâmetros de entrada, . No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.

Ações

Nesta seção, listamos as ações compatíveis com o conector. Para entender como configurar as ações, consulte Exemplos de ação.

Ação CopyResource

Essa ação permite copiar um arquivo ou uma pasta para um local diferente no Dropbox do usuário.

Parâmetros de entrada da ação CopyResource

Para saber como configurar a ação CopyResource, consulte Exemplos de ação.

Ação CreateFolder

Essa ação permite criar uma pasta em um determinado caminho.

Parâmetros de entrada da ação CreateFolder

Por exemplo, sobre como configurar a ação CreateFolder, consulte Exemplos de ação.

Ação DeleteResource

Essa ação permite excluir o arquivo ou a pasta em um determinado caminho. Se o caminho for uma pasta, todo o conteúdo dela também será excluído.

Parâmetros de entrada da ação DeleteResource

Por exemplo, sobre como configurar a ação DeleteResource, consulte Exemplos de ação.

Ação MoveResource

Mova um arquivo ou uma pasta para outro local no Dropbox do usuário. Se o caminho de origem for uma pasta, todo o conteúdo dela será movido. No momento, não oferecemos suporte à renomeação somente de maiúsculas e minúsculas.

Parâmetros de entrada da ação MoveResource

Por exemplo, sobre como configurar a ação MoveResource, consulte Exemplos de ação.

Ação RenomearResource

Essa ação permite renomear um recurso fornecendo um caminho e um novo nome.

Parâmetros de entrada da ação RenomearResource

Por exemplo, sobre como configurar a ação RenameResource, consulte Exemplos de ação.

Ação Cancelar compartilhamento de pasta

Esta ação permite cancelar o compartilhamento de uma pasta. Requer o escopo sharing.write.

Parâmetros de entrada da ação UnshareFolder

Por exemplo, sobre como configurar a ação UnshareFolder, consulte Exemplos de ação.

Ação DownloadFile

Esta ação permite fazer o download de um arquivo. Requer o escopo files.content.read.

Parâmetros de entrada da ação DownloadFile

Por exemplo, sobre como configurar o DownloadFile, consulte os Exemplos de ação.

Exemplos de ação

Esta seção descreve como executar algumas das ações neste conector.

Exemplo: copiar um recurso

O exemplo a seguir mostra como copiar um recurso com o caminho especificado para um caminho diferente:

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CopyResource e clique em Concluído.
3. Na seção Entrada de tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Campo Default Value:

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

Se a ação for bem-sucedida, o CopyResource resposta da tarefa connectorOutputPayload terá um valor semelhante ao seguinte:

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

Exemplo: criar uma pasta

O exemplo abaixo mostra como criar uma pasta em um determinado caminho:

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação CreateFolder e clique em Concluído.
3. Na seção Entrada de tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Campo Default Value:

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

Se a ação for bem-sucedida, a resposta connectorOutputPayload da tarefa CreateFolder terá um valor semelhante ao seguinte:

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

Exemplo: excluir um recurso

O exemplo a seguir mostra como excluir um recurso:

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DeleteResource e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o DeleteResource resposta da tarefa connectorOutputPayload terá um valor semelhante ao seguinte:

[{
"Status": "Success"
}]

Exemplo: mover um recurso

O exemplo abaixo mostra como mover um recurso:

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação MoveResource e clique em Concluído.
3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value:

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

Se a ação for bem-sucedida, o MoveResource resposta da tarefa connectorOutputPayload terá um valor semelhante ao seguinte:

[{
  "Status": "Success"
  }]

Exemplo: renomear um recurso

O exemplo abaixo mostra como renomear um recurso:

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação RenameResource e clique em Concluído.
3. Na seção Entrada de tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Campo Default Value:

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

Se a ação for bem-sucedida, o RenameResource resposta da tarefa connectorOutputPayload terá um valor semelhante ao seguinte:

[{
"Status": "Success"
}]

Exemplo: cancelar o compartilhamento de uma pasta

O exemplo a seguir mostra como cancelar o compartilhamento de uma pasta:

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação UnshareFolder e clique em Concluído.
3. Na seção Entrada de tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Campo Default Value:

   {
     "FolderId": "3336772979"
   }

Se a ação for bem-sucedida, o UnshareFolder resposta da tarefa connectorOutputPayload terá um valor semelhante ao seguinte:

[{
"Status": "Success"
}]

Exemplo: fazer o download de um arquivo

O exemplo abaixo mostra como fazer o download de um arquivo:

1. Na caixa de diálogo Configure connector task, clique em Actions.
2. Selecione a ação DownloadFile e clique em Concluído.
3. Na seção Entrada de tarefa da tarefa Conectores, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Campo Default Value:

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

Se a ação for bem-sucedida, o DownloadFile resposta da tarefa connectorOutputPayload terá um valor semelhante ao seguinte:

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