Manipulación de directorios de archivos en Jitterbit App Builder

Este artículo revisará la manipulación de directorios de archivos en App Builder. Los temas incluyen la transferencia de archivos entre un binario y un sistema de archivos, la creación de directorios desde App Builder y la vinculación de directorios a un panel del sistema de archivos.

Prerrequisitos

Es necesario configurar un sistema de archivos en su servidor App Builder (local, S3 o red)
- Se recomienda almacenar el DataSourceID del sistema de archivos en la tabla de parámetros de la aplicación desde la que va a transferir archivos.
La base de datos desde la que está transfiriendo sus archivos debe estar vinculada a su sistema de archivos

Columnas en una tabla de archivos del sistema de archivos

Columna	Obligatorio (S/N)	Tipo de dato	Descripción
DataSourceID(*)	Sí	UUID	El DataSourceID de la fuente de datos del sistema de archivos
Nombre(*)	Sí	Cadena	El nombre del archivo cuando está almacenado en el sistema de archivos
Directorio(*)	Sí	Cadena	La ruta del archivo que se almacena en el sistema de archivos
Nombre completo	#	Cadena	El nombre del archivo cuando está almacenado en el sistema de archivos
IsDirectory	No	Booleano	Si el archivo que se almacena es una carpeta o no
Contenido	No	Binario	El archivo en sí
Extensión	#	Cadena	La extensión del archivo que se almacena
Creado el	No	Fecha y hora	Cuándo se insertó el archivo en el sistema de archivos
Modificado el	No	Fecha/Hora	Cuándo se actualizó el archivo en el sistema de archivos
Longitud	#	Entero	Longitud del archivo en bytes
FolderIcon	No	Binario	El icono de la carpeta en el sistema de archivos

Instrucciones para mover archivos desde el binario en una tabla de App Builder al sistema de archivos

Carpetas

Si ya tiene una carpeta en el sistema de archivos donde desea almacenar los archivos, no necesita configurar carpetas a través de App Builder.
Si desea crear una carpeta en el sistema de archivos, deberá configurar reglas en App Builder para hacerlo:
- Cree una regla de inserción XP CRUD desde la base de datos principal de sus aplicaciones dirigida a la tabla de archivos de su sistema de archivos
  - Las claves de la tabla de archivos que se deben seleccionar son DataSourceID (de su sistema de archivos), Name (nombre del archivo) y Directory (ruta del archivo)
    - DATASOURCEID(*) - Si almacenó el DataSourceID de su sistema de archivos en su tabla de parámetros, puede crear la regla a partir de esa tabla y usar ese campo parametrizado para apuntar al DataSourceID.
    - NOMBRE(*) - Puede usar el nombre que desee para el archivo o carpeta. Por seguridad, es común no usar el nombre real del archivo y generar uno nuevo al almacenarlo en un sistema de archivos.
    - DIRECTORIO(*) - Si la carpeta es la de mayor nivel en su sistema de archivos, use una cadena en blanco como directorio. Si crea una jerarquía de carpetas, el directorio es la ruta de archivo de la carpeta; App Builder asume automáticamente el primer '\' en la ruta de archivo.
  - Asigna un '1' al campo IsDirectory para todas las carpetas. Así, App Builder sabrá que debe crear una carpeta en el sistema de archivos, en lugar de intentar insertarla como un archivo.
  - Registra la regla de inserción como una acción en un evento y activa dicho evento. Si creó una carpeta de nivel superior en su sistema de archivos, debería aparecer en la tabla de archivos. Si la carpeta o archivo se encuentra en cualquier lugar que no sea el nivel superior, deberá configurar páginas para comprobar si se insertó correctamente o contactar a alguien con acceso al sistema de archivos para confirmar su creación.

Insertar archivos en el sistema de archivos

Cree una regla de inserción XP CRUD desde la fuente de datos y la tabla desde la que va a mover los archivos, con destino a la tabla de archivos de su sistema de archivos.
- Las claves del archivo son las mismas que las de la carpeta.
  - DATASOURCEID(*) - El DataSourceID del sistema de archivos. Puede codificar el valor o cruzarlo en la tabla de parámetros si lo almacenó.
  - NAME(*) - Es común no usar el nombre original del archivo en su sistema de archivos; sin embargo, puede hacerlo. Si no lo hace, asegúrese de establecer una convención de nomenclatura consistente y fácil de recordar. (Nota: Si planea previsualizar este archivo en un control de incrustación, debe concatenar la extensión del archivo al final del nombre. Hay documentación de SQL en línea que le ayudará a eliminar la extensión del nombre del archivo original).
  - DIRECTORIO(*) - La ruta donde se almacenará el archivo. Una serie de nombres de carpeta separados por '\'.
- Otro campo que debe definirse para los archivos es Contenido.
  - CONTENIDO- El archivo en sí. El binario que se almacena en la tabla.

Vinculación de directorios en un panel del sistema de archivos

Al vincular a una página que utiliza un sistema de archivos como fuente del panel, es necesario pasar un enlace para acceder a sus archivos.
- En el objeto desde el cual se va a vincular, debe agregar los campos a los que se va a vincular
  - Los campos a los que se vinculará son las claves principales de la tabla de archivos en su sistema de archivos (DataSourceID, Directorio y Nombre)
- Dondequiera que configure el enlace a la página del Sistema de Archivos, debe configurar los campos que acaba de agregar a su objeto como Criterios de Enlace. También puede hacerlo entre paneles si así lo desea.

Ejemplo de regla CRUD de XP para crear una subcarpeta

Aquí hay un ejemplo de regla CRUD de XP que le indica a App Builder que cree una subcarpeta llamada PaymentImport Fuera de la App BuilderDatacarpeta ubicada en el C: unidad. Este ejemplo asume que la ruta de la fuente de datos es C:/App BuilderData.

Configuración de la regla:

Propósito: XP CRUD
Acción: Cram
Origen de datos: Origen de los datos de la regla. Ejemplo: InvoicePortal
Origen de datos de destino: Origen de los datos de la regla. Ejemplo: Unidad C
Capa de destino: Capa lógica
Objetivo: Tabla con nombre de la regla. Ejemplo: Archivo

Columnas definidas en la regla:

DataSourceID: 'b24b8338-5c91-4e92-8481-8605944a558d'
Directorio: *
Nombre: 'PaymentImport'
IsDirectory: 1

Ejemplo de regla CRUD de XP para crear una subcarpeta