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 supervisar, buscar, recuperar, enumerar, crear y editar 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:
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| paquete de Adobe Workfront | Cualquiera |
| Licencia de Adobe Workfront |
Nuevo: estándar O Actual: Trabajo o superior |
| Licencia de Adobe Workfront Fusion** |
Actual: No se requiere licencia de Workfront Fusion O Heredado: Workfront Fusion para la automatización e integración del trabajo |
| Producto |
Nuevo:
O Actual: Su organización debe comprar Adobe Workfront Fusion. |
Para obtener más información sobre esta tabla, consulte Requisitos de acceso en la documentación.
Para obtener información sobre las licencias de Adobe Workfront Fusion, consulte licencias de Adobe Workfront Fusion.
Requisitos previos
- Para usar módulos Dropbox, debe tener una cuenta de Dropbox.
- Para utilizar el conector de Dropbox, primero debe crear una aplicación en Dropbox.
> Para obtener más información, busque "Crear una aplicación" en la guía para desarrolladores de Dropbox. - Al crear la aplicación, use el siguiente URI de redireccionamiento:
https://app.workfrontfusion.com/oauth/cb/dropbox - Dropbox debe aprobar las aplicaciones con más de 50 usuarios.
> Para obtener más información, busque “Aprobación de producción” en la guía para desarrolladores de Dropbox.
Información de API de Dropbox
El conector de Dropbox utiliza lo siguiente:
Crear una conexión a Dropbox
Para crear una conexión para los módulos de Dropbox:
-
En cualquier módulo, haga clic en Agregar 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 6-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 Introduza su Client ID de Dropbox. Client Secret Introduzca su Dropbox Client Secret. Account Type Seleccione si desea conectarse a una cuenta personal o a una cuenta de empresa de Dropbox (Dropbox Business). Excluir encabezado dropbox-api-path-root Active esta opción para excluir el encabezado dropbox-api-path-root en las aplicaciones de Dropbox con acceso a la carpeta de la aplicación. -
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 a estos, pueden aparecer campos de Dropbox adicionales, en función de factores como el nivel de acceso del que disponga 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
Ver archivos
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
Descargar un archivo
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.
Obtener metadatos de carpeta
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.
Enumerar todos los archivos/subcarpetas de una carpeta
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.
Enumerar revisiones de archivos
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.
Buscar archivos/carpetas
Este módulo de búsqueda busca registros en un objeto en Dropbox que coincidan con la consulta de búsqueda especificada.
Puede asignar esta información en módulos subsiguientes en el escenario.
Módulos para crear y editar archivos y carpetas de Dropbox
Crear una carpeta
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.
Crear o sobrescribir un archivo de texto
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.
Al configurar este módulo, se muestran los campos siguientes.
Crear/actualizar un vínculo compartido
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.
Eliminar un archivo o carpeta
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.
Mover un archivo/carpeta
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.
Cambiar el nombre de un archivo o carpeta
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.
Restaurar un archivo
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.
Cargar un archivo
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.
Otros módulos
Realizar una llamada de API
Este módulo de acción le permite realizar una llamada autenticada personalizada a la API de 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.
https://api.dropboxapi.com. Por ejemplo: /2/files/list_folderAñ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.
Ejemplo:
La siguiente llamada de API devuelve los primeros 10 archivos de la carpeta /Text files de su cuenta de Dropbox:
URL: /2/files/list_folder
Cuerpo:
{
"path": "/Text files",
"limit": 10,
"recursive": false,
"include_deleted": false
}
Las coincidencias de la búsqueda se pueden encontrar en la salida del módulo en Paquete > Cuerpo > entradas.
En nuestro ejemplo, se devolvieron 10 tickets.
Problemas comunes
No se puede cargar o actualizar un archivo
Los siguientes pueden ser motivos por los que falla la carga o actualización de un archivo:
- 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 el Dropbox >Crear un vínculo compartido no vincula directamente a una imagen, sino a una página de 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 enlace directo o sin procesar de la imagen para su sitio web o para otros módulos de Workfront Fusion, debe modificar la 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")}}