Dropbox

Entidades, operaciones y acciones

Todos los conectores de integración proporcionan una capa de abstracción para los objetos de la aplicación conectada. Solo puedes acceder a los objetos de una aplicación a través de esta abstracción. La abstracción se te muestra como entidades, operaciones y acciones.

• Entidad: una entidad se puede considerar como un objeto o un conjunto de propiedades en la aplicación o el servicio conectados. La definición de una entidad varía de un conector a otro. Por ejemplo, en un conector de base de datos, las tablas son las entidades; en un conector de servidor de archivos, las carpetas son las entidades; y en un conector de sistema de mensajería, las colas son las entidades.

  Sin embargo, es posible que un conector no admita o no tenga ninguna entidad. En ese caso, la lista Entities estará vacía.

• Operación: una operación es la actividad que puedes realizar en una entidad. Puedes realizar cualquiera de las siguientes operaciones en una entidad:
  • Mostrar
  • Obtener
  • Crear
  • Actualizar
  • Eliminar

  Al seleccionar una entidad de la lista disponible, se genera una lista de operaciones disponibles para la entidad. Para ver una descripción detallada de las operaciones, consulta las operaciones de entidades de la tarea Connectors. Sin embargo, si un conector no admite ninguna de las operaciones de entidad, esas operaciones no admitidas no se mostrarán en la lista Operations.

• Acción: una acción es una función de primera clase que se pone a disposición de la integración a través de la interfaz del conector. Una acción te permite hacer cambios en una o varias entidades y varía de un conector a otro. Normalmente, una acción tendrá algunos parámetros de entrada y un parámetro de salida. Sin embargo, es posible que un conector no admita ninguna acción, en cuyo caso la lista Actions estará vacía.

Acciones

En esta sección se enumeran las acciones que admite el conector. Para saber cómo configurar las acciones, consulta los ejemplos de acciones.

Acción CopyResource

Esta acción te permite copiar un archivo o una carpeta en otra ubicación de la cuenta de Dropbox del usuario.

Parámetros de entrada de la acción CopyResource

Para ver un ejemplo de cómo configurar la acción CopyResource, consulta Ejemplos de acciones.

Acción CreateFolder

Esta acción te permite crear una carpeta en una ruta determinada.

Parámetros de entrada de la acción CreateFolder

Para ver un ejemplo de cómo configurar la acción CreateFolder, consulte Ejemplos de acciones.

Acción DeleteResource

Esta acción te permite eliminar el archivo o la carpeta de una ruta determinada. Si la ruta es una carpeta, también se eliminará todo su contenido.

Parámetros de entrada de la acción DeleteResource

Para ver un ejemplo de cómo configurar la acción DeleteResource, consulta Ejemplos de acciones.

Acción MoveResource

Mover un archivo o una carpeta a otra ubicación en el Dropbox del usuario. Si la ruta de origen es una carpeta, se moverá todo su contenido. Ten en cuenta que actualmente no admitimos el cambio de nombre solo en mayúsculas y minúsculas.

Parámetros de entrada de la acción MoveResource

Para ver un ejemplo de cómo configurar la acción MoveResource, consulta Ejemplos de acciones.

Acción RenameResource

Esta acción te permite cambiar el nombre de un recurso proporcionando una ruta y un nombre nuevo.

Parámetros de entrada de la acción RenameResource

Para ver un ejemplo de cómo configurar la acción RenameResource, consulta Ejemplos de acciones.

UnshareFolder action

Esta acción te permite dejar de compartir una carpeta. Requiere el ámbito sharing.write.

Parámetros de entrada de la acción UnshareFolder

Para ver un ejemplo de cómo configurar la acción UnshareFolder, consulta Ejemplos de acciones.

Acción DownloadFile

Esta acción te permite descargar un archivo. Requiere el ámbito files.content.read.

Parámetros de entrada de la acción DownloadFile

Para ver un ejemplo de cómo configurar la acción DownloadFile, consulta Ejemplos de acciones.

Ejemplos de acciones

En esta sección se describe cómo realizar algunas de las acciones de este conector.

Ejemplo: copiar un recurso

En el siguiente ejemplo se muestra cómo copiar un recurso con una ruta especificada en otra ruta:

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CopyResource y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea CopyResource tendrá un valor similar al siguiente:

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

Ejemplo: crear una carpeta

En el siguiente ejemplo se muestra cómo crear una carpeta en una ruta determinada:

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción CreateFolder y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload de la respuesta CreateFolder tendrá un valor similar al siguiente:

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

Ejemplo: eliminar un recurso

En el siguiente ejemplo se muestra cómo eliminar un recurso:

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DeleteResource y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DeleteResource tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: mover un recurso

En el siguiente ejemplo se muestra cómo mover un recurso:

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción MoveResource y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea MoveResource tendrá un valor similar al siguiente:

[{
  "Status": "Success"
  }]

Ejemplo: cambiar el nombre de un recurso

En el siguiente ejemplo se muestra cómo cambiar el nombre de un recurso:

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción RenameResource y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea RenameResource tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: dejar de compartir una carpeta

En el siguiente ejemplo se muestra cómo dejar de compartir una carpeta:

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción UnshareFolder y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

   {
     "FolderId": "3336772979"
   }

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea UnshareFolder tendrá un valor similar al siguiente:

[{
"Status": "Success"
}]

Ejemplo: descargar un archivo

En el siguiente ejemplo se muestra cómo descargar un archivo:

1. En el cuadro de diálogo Configure connector task, haz clic en Actions.
2. Seleccione la acción DownloadFile y, a continuación, haga clic en Hecho.
3. En la sección Entrada de tarea de la tarea Conectores, haz clic en connectorInputPayload y, a continuación, introduce un valor similar al siguiente en el campo Default Value:

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

Si la acción se realiza correctamente, el parámetro connectorOutputPayload response de la tarea DownloadFile tendrá un valor similar al siguiente:

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