Escenario 1 del Tutorial del Conector: Obtener Archivo¶

Obtener un Archivo de Texto de Dropbox y Escribirlo en un Servidor FTP¶

Este escenario demuestra el uso de una actividad de obtención de archivos de Dropbox. En este ejemplo, se obtiene un archivo de texto de Dropbox y luego se escribe en un servidor FTP. El archivo resultante será un archivo JSON que incluye tanto el contenido de el archivo y los metadatos sobre el archivo recibido de Dropbox. (Para un ejemplo donde solo el contenido del archivo se devuelve, sin los metadatos, consulte Escenario 2: Obtener archivo.)

Aquí está la operación completa:

Para completar esta operación y escenario, necesitará un archivo de texto en la carpeta de su aplicación de Dropbox. A archivo de muestra customers.csv se proporciona en el assets/sample-data directory de los archivos de origen del conector de Dropbox para este fin.

Este es un ejemplo del archivo de salida que se creará, que es un archivo JSON con metadatos y el archivo contenidos en una sola estructura:

{
  "name": "customers.csv",
  "clientModified": "2018-03-16T14:40:39-07:00",
  "serverModified": "2018-04-10T14:10:52-07:00",
  "rev": "49a708770",
  "size": 2231,
  "sharingInfo": {
    "readOnly": null,
    "parentSharedFolderId": null,
    "modifiedBy": null
  },
  "content": "Y29tcGFueSxhZGRy...I2NzcsKDc4MikgMzQzLTAyNjA=",
  "link": null
}

1. Copie el Archivo de Muestra a Dropbox¶

Copie el archivo de muestra (customers.csv) desde el assets/sample-data directory de el conector de Dropbox a su cuenta de Dropbox.

2. Agregue una Actividad de Obtención de Archivos de Dropbox a una Operación¶

Arrastre un tipo de actividad Obtener archivo de Dropbox desde el paleta de componentes de diseño a la caída del componente zone en el tela de diseño para crear una instancia de una actividad de obtención de archivos de Dropbox en una nueva operación. Haga doble clic la actividad para abrirlo.

Ingrese en la configuración un nombre (como “Buscar archivo”), una ruta de carpeta (puede usar el valor predeterminado de /), y el nombre del archivo que se va a descargar (como customer.csv):

Al hacer clic en el botón Siguiente, accederá a una pantalla donde podrá revisar el esquema de datos:

Esto muestra lo que se devuelve (la respuesta) de Dropbox. Estará en formato XML y muestra que los metadatos sobre el archivo se devuelve además de la content campo, que contiene el contenido real.

Haga clic en Terminado para volver al flujo de trabajo.

3. Agregue una Actividad de Escritura FTP a la Operación¶

Usando el extremo FTP llamado ” FTP” que configuró para este tutorial (vea Escenarios del tutorial en Tutorial del conector de Dropbox), arrastre una escritura FTP tipo de actividad a una área de inserción de componentes en la operación justo después de la actividad “Dropbox Fetch File”.

Configúrelo con un nombre (como “Escribir”), proporcione un esquema JSON (puede copiar y pegar el archivo JSON de ejemplo mostrado anteriormente y establezca el nombre de archivo de esquema en customers.json como se muestra) y nombre de archivo (como dropbox_result_[date]_[time].json). Este nombre de archivo creará un nuevo nombre de archivo con marca de tiempo cada vez que se ejecuta la operación.

La actividad “FTP Write” se verá así:

Haga clic en Siguiente y luego en Terminado para cerrar la configuración de “Escritura FTP “.

4. Agregue una Transformación a la Operación¶

Pase el cursor sobre el área entre las dos actividades en la operación y haga clic en la área de inserción de componentes para abrir un menú donde puede seleccionar Nueva Transformación.

Configure la transformación con un nombre (como “Obtener a FTP”). Si ha creado el esquema en FTP Write actividad como se describe anteriormente, puede usar el enlace Coincidencias exactas de mapa automático para mapear automáticamente todos los campos de la Respuesta “Dropbox Fetch File” al destino “FTP Write”. Haga clic en Volver al Flujo de Trabajo para guardar la transformación configuración y volver al flujo de trabajo.

5. Nombre la Operación¶

Si aún no lo ha hecho, asigne nombres apropiados a su operación (y flujo de trabajo).

6. Ejecute la Operación¶

Suponiendo que ha colocado un customers.csv archivo en la carpeta de su aplicación de Dropbox, ahora puede desplegar y ejecute el proyecto (o simplemente la operación).

En el registro de operación, debería ver que la operación se recibe y luego se completa con éxito:

7. Confirme el Éxito¶

Para confirmar el éxito, abra su servidor FTP y verifique que el archivo se haya agregado. (Si está utilizando el Jitterbit servidor FTP de entrenamiento, un visor web para él se encuentra en https://training2.jitterbit.com/WebInterface/login.html.)

El nuevo archivo debe estar en el directorio raíz con un nombre similar a dropbox_result_[date]_[time].json. Si usted descarga y visualiza el archivo, verás que se parece a esto:

{
  "name": "customers.csv",
  "clientModified": "2018-03-16T14:40:39-07:00",
  "serverModified": "2018-04-10T14:10:52-07:00",
  "rev": "49a708770",
  "size": 2231,
  "sharingInfo": {
    "readOnly": null,
    "parentSharedFolderId": null,
    "modifiedBy": null
  },
  "content": "Y29tcGFueSxhZGRy...I2NzcsKDc4MikgMzQzLTAyNjA=",
  "link": null
}

El archivo es un archivo JSON, con los metadatos de Dropbox como los primeros campos. El content el campo se muestra como cadena codificada en base64.

En Escenario 2: Obtener archivo (el siguiente escenario) veremos cómo trabajar con la respuesta de Dropbox para acceder a la forma no codificada de este contenido.