Módulos de Dropbox
En un escenario de Adobe Workfront Fusion, puede automatizar los flujos de trabajo que usan Dropbox o Dropbox Business, así como conectarlo a varias aplicaciones y servicios de terceros. Esto le permite automatizar actividades como la supervisión, la búsqueda, la recuperación, la inclusión, la creación y edición de archivos y carpetas en su Dropbox.
Para obtener instrucciones sobre cómo crear un escenario, vea los artículos en Crear escenarios: índice de artículos.
Para obtener información acerca de los módulos, vea los artículos en Módulos: índice de artículos.
Requisitos de acceso
Para utilizar la funcionalidad de este artículo debe tener el siguiente acceso:
Para saber qué plan, tipo de licencia o acceso tiene, póngase en contacto con el administrador de Workfront.
Para obtener información sobre Adobe Workfront Fusion licencias, consulte Adobe Workfront Fusion licencias.
Requisitos previos
- Para usar módulos de Dropbox, debe tener una cuenta de Dropbox.
Información de API del Dropbox
El conector del Dropbox utiliza lo siguiente:
Crear una conexión a Dropbox
Para crear una conexión para los módulos de Dropbox:
-
Haga clic en Add junto al cuadro Conexión.
-
Rellene los campos siguientes:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 layout-auto html-authored no-header Connection name Introduzca un nombre para esta conexión. Environment Seleccione si esta conexión es para un entorno de producción o de no producción. Type Seleccione si desea conectarse a una cuenta de servicio o a una personal. Client ID Escriba su Dropbox Client ID. Client Secret Escriba su Dropbox Client Secret. Account Type Seleccione si desea conectarse a una cuenta personal o a una cuenta de empresa de Dropbox (Dropbox Business). -
Haga clic en Continue para guardar la conexión y volver al módulo.Módulos de ## Dropbox y sus campos
Módulos de Dropbox y sus campos
Al configurar módulos de Dropbox, Workfront Fusion muestra los campos que se indican a continuación. Junto con estos, podrían mostrarse Dropbox campos adicionales, según factores como el nivel de acceso en la aplicación o el servicio. El título en negrita en un módulo indica un campo obligatorio.
Si ve el botón Asignar encima de un campo o función, puede utilizarlo para establecer variables y funciones para ese campo. Para obtener más información, vea Asignar información de un módulo a otro.
Módulos de activador
Watch Files
Este módulo de tipo Activador devuelve los detalles del archivo cuando se modifica el archivo de una carpeta especificada.
Módulos para obtener archivos y carpetas de Dropbox
Search Files/Folders
Este módulo de búsqueda busca registros en un objeto de Dropbox que coincidan con la consulta de búsqueda especificada.
Puede asignar esta información en módulos subsiguientes en el escenario.
Download a File
Este módulo de acción descarga un archivo de una carpeta.
Especifique el archivo y su ubicación.
El módulo devuelve el ID del archivo y cualquier campo asociado, junto con cualquier campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Get a Folder Metadata
Este módulo de acción recupera los detalles de la carpeta compartida.
Especifique el ID de la carpeta.
El módulo devuelve el ID de la carpeta y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
List All Files/Subfolders in a Folder
Este módulo de acción enumera los archivos o carpetas de una carpeta concreta.
Especifique el ID de la carpeta.
El módulo devuelve los ID de los archivos o carpetas y cualquier campo asociado, junto con cualquier campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
List File Revisions
Este módulo de acción recupera todas las revisiones de archivo (un historial de versiones) de un archivo concreto.
Especifique el ID del archivo.
El módulo devuelve cualquier campo estándar asociado con el registro, junto con los campos y valores personalizados a los que accede la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Módulos para crear y editar archivos y carpetas de Dropbox
Upload a File
Este módulo de acción carga un archivo en una carpeta.
Especifique información como la ubicación del archivo, el archivo que desea cargar y un nuevo nombre opcional para el archivo.
El módulo devuelve el identificador del archivo y cualquier campo asociado, junto con cualquier otro campo personalizado y valor al que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Create a Folder
Este módulo de acción crea una nueva carpeta.
Especifique la ruta y el nombre de la carpeta.
El módulo devuelve el ID de la carpeta y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Create/Overwrite a Text File
Este módulo de acción crea un archivo DOC o sobrescribe el contenido de uno existente.
Especifique el archivo de origen y la carpeta.
El módulo devuelve el ID de la carpeta y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Create/Update a Share Link
Este módulo de acción crea un vínculo público a un archivo.
Especifique el archivo y la información sobre el vínculo.
El módulo devuelve el ID del vínculo y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Restore a File
Este módulo de acción restaura una versión anterior de un archivo.
Especifique el archivo y el número de revisión que desee.
El módulo devuelve el ID de la versión y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Move a File/Folder
Este módulo de acción mueve un archivo o carpeta a una ubicación diferente.
El usuario especifica el archivo o carpeta y cómo y dónde desea moverlo.
El módulo devuelve el ID del archivo o la carpeta y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Rename a File/Folder
Este módulo de acción cambia el nombre de un archivo o carpeta.
Especifique el archivo o la carpeta y el nuevo nombre.
El módulo devuelve el ID del archivo o la carpeta y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Delete a File/Folder
Este módulo de acción elimina un archivo o una carpeta.
Especifique el archivo o la carpeta.
El módulo devuelve el identificador del registro y cualquier campo asociado, junto con cualquier campo y valor personalizados a los que acceda la conexión. Puede asignar esta información en módulos subsiguientes en el escenario.
Al configurar este módulo, se muestran los campos siguientes.
Otros módulos
Make an API Call
Este módulo de acción le permite realizar una llamada autenticada personalizada a la API Dropbox. De este modo, puede crear una automatización del flujo de datos imposibles de realizar por los otros Dropbox módulos.
Al configurar este módulo, se muestran los campos siguientes.
Escriba una ruta relativa a Escriba una ruta relativa a https://api.dropboxapi.com. Por ejemplo: /2/files/list_folder
Nota: para obtener la lista de puntos finales disponibles, consulte la Documentación de la API de Dropbox versión 2.
Añada el contenido del cuerpo para la llamada de API en forma de objeto JSON estándar.
Nota:
Cuando utilice afirmaciones condicionales como if en su JSON, coloque las comillas fuera de la afirmación condicional.
/2/files/list_folder{"path": "/Text files","limit": 10,"recursive": false,"include_deleted": false}Problemas comunes
No se puede cargar o actualizar un archivo
Cuando falla la carga o actualización de un archivo, se dan varias situaciones:
- El archivo cargado es demasiado grande y supera el tamaño máximo de archivo permitido para el plan de Dropbox, o bien se ha utilizado toda la cuota de almacenamiento de la cuenta de Dropbox. Debe eliminar los archivos existentes de su cuenta de Dropbox o actualizar su plan.
- La carpeta seleccionada anteriormente, a la que se está cargando el archivo, ya no existe. El escenario se detiene y debe volver a seleccionar la carpeta de destino.
La imagen a la que se hace referencia mediante un vínculo compartido no se representa
La dirección URL devuelta por Dropbox >Create a shared link no se vincula directamente a una imagen, sino a una página Dropbox. Para forzar la descarga de la imagen, sustituya el ?dl=0 final por ?dl=1. Para forzar el procesamiento de la imagen (por ejemplo, en un explorador Web o en Facebook Messenger), añada &raw=1 a la dirección URL.
Si necesita obtener el vínculo directo o sin procesar de la imagen para su sitio web o para otros módulos de Workfront Fusion, debe modificar la dirección URL compartida inicial de la siguiente manera:
URL original:
https://www.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png?dl=0
- Reemplazar
wwwpordl. - Eliminar
?dl=0.
URL final:
https://dl.dropbox.com/s/ia8qtvs20f3a5ux/Screen%20Shot%202018-10-15%20at%204.21.11%20PM.png
Para modificar automáticamente la dirección URL, puede usar la función replace() dos veces:
-
Reemplazar www por dl
-
Y para quitar ?dl=0
Para hacerlo en un solo paso, combine estas funciones:
También puede copiarlo y pegarlo en el campo. Reemplazar 1.url por la URL.
{{replace(replace(1.url; "?dl=0"; ""); "www"; "dl")}}