Dropbox módulos

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.

Si necesita instrucciones para crear un escenario, consulte Crear un escenario en Adobe Workfront Fusion.

Para obtener información acerca de los módulos, vea Módulos en Adobe Workfront Fusion.

Requisitos de acceso

Debe tener el siguiente acceso para utilizar la funcionalidad de este artículo:

Adobe Workfront plan*
Pro o superior
Adobe Workfront licencia*
Plan, Trabajo
Adobe Workfront Fusion licencia**

Requisito de licencia actual: no se requiere licencia de Workfront Fusion.

O

Requisito de licencia heredado: Workfront Fusion para automatización e integración de trabajo

Producto

Requisito de producto actual: si tiene el plan Select o Prime Adobe Workfront, su organización debe adquirir Adobe Workfront Fusion así como Adobe Workfront para utilizar la funcionalidad descrita en este artículo. Workfront Fusion está incluido en el plan Workfront de Ultimate.

O

Requisito de productos heredados: su organización debe comprar Adobe Workfront Fusion y Adobe Workfront para utilizar la funcionalidad descrita en este artículo.

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.
IMPORTANT
El 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 del Dropbox

El conector del Dropbox utiliza lo siguiente:

URL básica
https://api.dropboxapi.com/2
Versión de API
2
Etiqueta de API
  • Dropbox

    Versión 5.3.9

  • Dropbox Empresa

    Versión 1.0.12

Crear una conexión con Dropbox

Para crear una conexión para los módulos de Dropbox:

  1. Haga clic en Agregar junto al cuadro Conexión.

  2. 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
    Nombre de conexión Escriba un nombre para esta conexión.
    Entorno Seleccione si esta conexión es para un entorno de producción o de no producción.
    Tipo Seleccione si desea conectarse a una cuenta de servicio o a una cuenta personal.
    ID de cliente Introduzca el Dropbox ID de cliente de .
    Secreto de cliente Escriba su Secreto de cliente Dropbox.
    Tipo de cuenta Seleccione si desea conectarse a una cuenta de Dropbox personal o a una cuenta de empresa (Dropbox Business).
  3. Haga clic en Continuar para guardar la conexión y volver al módulo.## Dropbox módulos y sus campos

Dropbox módulos y sus campos

Al configurar Dropbox módulos, 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. Un 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 en Adobe Workfront Fusion.

Módulos de activador

Observar archivos

Este módulo de tipo de Déclencheur devuelve los detalles del archivo cuando se modifica el archivo de una carpeta especificada.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Carpeta
Seleccione la carpeta en la que desee inspeccionar los cambios.
Ver también subcarpetas
Habilite esta opción para supervisar también las subcarpetas de la carpeta seleccionada en busca de archivos modificados.
Límite
Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

Módulos para obtener Dropbox archivos y carpetas

Archivos/carpetas de búsqueda

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Buscar
Introduzca el término de búsqueda.
Carpeta
Seleccione la carpeta en la que desea buscar. Este módulo busca en todo el Dropbox si no selecciona ninguna carpeta.
Estado del archivo
Seleccione el estado del archivo para restringir la búsqueda al estado del archivo seleccionado.
Categorías de archivo
Seleccione las categorías de archivo para restringir la búsqueda a las categorías seleccionadas.
Extensiones de archivo
Elija las extensiones de archivo que desea buscar.
Límite
Introduzca o asigne el número máximo de registros que desea que devuelva el módulo durante cada ciclo de ejecución de escenario.

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.

NOTE
Este módulo es útil para proporcionar archivos a módulos subsiguientes.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Forma de seleccionar archivos
Seleccione si desea asignar la ruta de acceso del archivo o seleccione el archivo manualmente.
Ruta de archivo / Archivo

Ruta de archivo

Introduzca o asigne la ruta de destino al archivo.

Archivo

Seleccione el archivo en el menú.

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Identificador de carpeta compartida
Introduzca o asigne el ID de la carpeta sobre la que desea recuperar los detalles.

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Lista
Seleccione si desea recuperar archivos o carpetas.
Mostrar solo los archivos descargables
Active esta opción para devolver solo los archivos descargables. Algunos tipos de archivos, como los documentos de Google, no se pueden descargar.
Carpeta
Introduzca o asigne la carpeta de la que desea recuperar archivos o carpetas.
Límite
Introduzca o asigne el número máximo de registros que desea que el módulo enumere durante cada ciclo de ejecución de escenario.

Revisiones de archivos de lista

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 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Forma de seleccionar archivos
Seleccione si desea asignar la ruta de acceso del archivo o seleccione el archivo manualmente.
Ruta de archivo / Archivo

Ruta de archivo

Introduzca o asigne la ruta de destino al archivo.

Archivo

Seleccione el archivo en el menú.

Límite
Introduzca o asigne el número máximo de registros que desea que el módulo enumere durante cada ciclo de ejecución de escenario.

Módulos para crear y editar Dropbox archivos y carpetas

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 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Carpeta
Seleccione la carpeta de su Dropbox en la que desee cargar el archivo.
Archivo Source

Escriba o asigne el archivo que desea agregar a la carpeta Dropbox seleccionada anteriormente.

Nombre de archivo

Introduzca o asigne el nombre del archivo, incluida su extensión.

Datos de archivo

Introduzca o asigne los datos del archivo (del módulo anterior, como Google Drive >Get a File).

Nota: El tamaño máximo del archivo cargado es de 150 MB.

Sobrescribir un archivo existente
Active esta opción para reemplazar el archivo existente con el nuevo archivo. Si esta opción se deja deshabilitada, se cambiará el nombre del archivo cargado.

Crear una carpeta

Este módulo de acción crea una carpeta nueva.

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Nombre de carpeta
Introduzca el nombre de la nueva carpeta.
Carpeta

Introduzca o asigne la ruta donde desea crear una nueva carpeta.

Nota:

Si usa una cuenta de Dropbox Business (con espacios de equipo), debe quitar la barra / o no hacer clic en Haga clic aquí para elegir la carpeta y crear una carpeta de equipo en la raíz.

Si no se quita la barra oblicua, se devuelve un error [409] path/malformed_path/...

Cambiar nombre automáticamente
Active esta opción para cambiar el nombre de la nueva carpeta, si ya existe una carpeta con el mismo nombre en la ubicación de destino.

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.

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Seleccionar para
Seleccione si desea crear o sobrescribir un archivo DOC.
Carpeta
Seleccione la ubicación de destino en la que desea crear un archivo.
Archivo Source

Escriba o asigne el archivo que desea agregar a la carpeta Dropbox.

Nombre del archivo

Introduzca el nombre del nuevo archivo DOC (sin extensión).

Contenido de archivo

Introduzca el contenido de texto del archivo DOC.

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Forma de seleccionar archivos
Seleccione si desea asignar o introducir la ruta del archivo, o seleccione el archivo manualmente.
Ruta de archivo / Archivo

Ruta de archivo

Introduzca o asigne la ruta de destino al archivo.

Archivo

Seleccione el archivo en el menú.

Visibilidad solicitada

Seleccione si el vínculo es público, de equipo o si está restringido con contraseña.

Nota: Las opciones Team only y Access with password solo están disponibles para los usuarios que tengan Dropbox Pro o una versión superior.

Fecha de caducidad del vínculo

Introduzca la fecha y la hora en que caducará el vínculo y dejará de ser accesible. Si este campo se deja vacío, el vínculo no caducará. Para obtener una lista de los formatos de fecha y hora admitidos, vea Coerción de tipos en Adobe Workfront Fusion.

Nota: Las opciones Team only y Access with password solo están disponibles para los usuarios que tengan Dropbox Pro o versiones posteriores.

Nivel de acceso de Link

Establezca el permiso para el destinatario del vínculo.

Viewer Los usuarios que usen el vínculo pueden ver el contenido y realizar comentarios sobre él.

Editor Los usuarios que usen el vínculo pueden editar, ver y comentar el contenido.

Max Los usuarios que usen el vínculo reciben el nivel de acceso máximo al que puede establecer el vínculo.

Restaurar un archivo

Este módulo de acción restaura una versión anterior de un archivo.

Especifique el fichero 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Forma de seleccionar archivos
Seleccione si desea asignar o introducir la ruta del archivo, o seleccione el archivo manualmente.
Ruta de archivo / Archivo

Ruta de archivo

Introduzca o asigne la ruta de destino al archivo.

Archivo

Seleccione el archivo en el menú.

Revisión
Introduzca o asigne el número de revisión de la revisión que desea restaurar.

Mover un archivo/carpeta

Este módulo de acción mueve un archivo o carpeta a una ubicación diferente.

Usted 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Forma de seleccionar archivos
Seleccione si desea asignar o introducir la ruta del archivo, o seleccione el archivo manualmente.
Ruta de archivo/carpeta / Archivo/carpeta

Ruta de archivo/carpeta

Introduzca o asigne la ruta de destino al archivo o carpeta.

Archivo/Carpeta

Seleccione el archivo o la carpeta en el menú.

A Carpeta
Introduzca o asigne la ubicación de destino del archivo o carpeta.
Nuevo nombre
Introduzca el nuevo nombre del archivo o la carpeta en la nueva ubicación.
Cambiar nombre automáticamente
Habilite esta opción para asegurarse de que si existe un archivo o una carpeta con el mismo nombre, el módulo cambia el nombre del nuevo archivo o carpeta agregando (NUMBER) después del nombre del archivo o carpeta. De lo contrario, se sobrescribe el archivo o la carpeta de la ubicación de destino.
Permitir transferencia de propiedad
Active esta opción para permitir movimientos por propietario, incluso si esto resultara en una transferencia de propiedad del contenido que se está moviendo.

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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Forma de seleccionar archivos
Seleccione si desea asignar o introducir la ruta del archivo, o seleccione el archivo manualmente.
Ruta de archivo/carpeta / Archivo/carpeta

Ruta de archivo/carpeta

Introduzca o asigne la ruta de destino al archivo o carpeta.

Archivo/Carpeta

Seleccione el archivo o la carpeta en el menú.

Cambiar nombre
Escriba el nombre de destino para el archivo, incluida la extensión de archivo.

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 ID 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.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
Forma de seleccionar archivos
Seleccione si desea asignar o introducir la ruta del archivo, o seleccione el archivo manualmente.
Ruta de archivo / Archivo

Ruta de archivo

Introduzca o asigne la ruta de destino al archivo.

Archivo

Seleccione el archivo en el menú.

Otros módulos

Realizar una llamada API

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 que no puedan realizar los otros Dropbox módulos.

Al configurar este módulo, se muestran los campos siguientes.

Conexión
Para obtener instrucciones acerca de cómo conectar su cuenta de Dropbox a Workfront Fusion, vea Crear una conexión con Dropbox en este artículo.
URL

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 extremos disponibles, consulte la Documentación de la API de Dropbox v2.

Método
Seleccione el método de solicitud HTTP que necesita para configurar la llamada de API. Para obtener más información, vea Métodos de solicitud HTTP en Adobe Workfront Fusion.
Encabezados
Introduzca los encabezados de solicitud deseados. Workfront Fusion agrega los encabezados de autorización automáticamente.
Cadena de consulta
Introduzca la cadena de consulta de solicitud.
Cuerpo

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.

INFO
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

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 Dropbox, o bien ha utilizado toda la cuota de almacenamiento de la cuenta Dropbox. Debe eliminar los archivos existentes de su cuenta de Dropbox o actualizar su plan.
  • La carpeta seleccionada anteriormente en 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 Dropbox. Para forzar la descarga de la imagen, reemplace 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

  1. Reemplazar www por dl.
  2. Quitar ?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")}}
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43