Crear un objetivo de archivo local en Jitterbit Design Studio

Introducción

Un archivo local en un agente privado puede ser utilizado como un objetivo en Jitterbit. Debe residir en la máquina donde está instalado el agente privado y no puede ser utilizado con agentes en la nube. (Consulta Objetivo de Almacenamiento Temporal para un enfoque aplicable a agentes en la nube.)

Se puede utilizar cualquier tipo de archivo. Los tipos comúnmente utilizados para archivos locales son texto (.txt), CSV (.csv), XML (.xml) y JSON (.json).

Prerrequisito

Antes de poder usar un objetivo de archivo local, debes haber habilitado la Ubicación de Archivo Local en tu agente privado de Jitterbit. Consulta Habilitar ubicación de archivo local para más detalles.

Crear un objetivo de archivo local

Puedes optar por crear un nuevo objetivo de archivo local por su cuenta, o dentro de una operación existente. Para más información sobre cómo funcionan las fuentes y los objetivos dentro de las operaciones, consulta Crear una operación.

Crear un nuevo objetivo de archivo local como un objetivo independiente

Dentro de tu proyecto en Jitterbit Design Studio, puedes crear un nuevo objetivo de Compartición de Archivos de cualquiera de las siguientes maneras:

• Ve a Archivo > Nuevo > Nuevo Objetivo; o

• En el árbol a la izquierda, haz clic derecho en Objetivos y selecciona Nuevo Objetivo; o

• En la barra de herramientas superior, haz clic en el ícono azul de objetivo .

En la ventana emergente, selecciona Compartición de Archivos como el tipo:

Tu nuevo objetivo aparece en su propia pestaña de Nuevo Objetivo en el panel derecho de la ventana.

Crear un nuevo objetivo de archivo local en una operación existente

Un objetivo generalmente se crea por defecto cuando creas una nueva operación. (La excepción es una operación que consiste solo en un script). Con una operación existente, puedes especificar el tipo de su objetivo de la siguiente manera:

• Haciendo doble clic en el ícono del objetivo; en el popup, selecciona Crear Nuevo Objetivo; o

• Haciendo clic derecho en el ícono del objetivo y seleccionando Crear Nuevo Objetivo.

En la pantalla de configuración que aparece, utiliza el menú desplegable Tipo para seleccionar Archivo Local, como se muestra arriba.

Usar un objetivo de archivo local existente en una operación existente

Para usar un objetivo de Archivo Local existente en una operación existente con un objetivo, puedes configurarlo de cualquiera de las siguientes maneras:

• Dentro de la operación, haciendo doble clic en el ícono del objetivo, y en el popup resultante, seleccionando el objetivo de Archivo Local deseado de la lista; o

• Dentro de la operación, haciendo clic derecho en el ícono del objetivo, eligiendo Seleccionar Objetivo Existente, y en el popup resultante, seleccionando el objetivo de Archivo Local deseado de la lista; o

• Arrastrando el objetivo de Archivo Local deseado desde el árbol a la izquierda y soltándolo sobre el ícono del objetivo existente de la operación.

Configurar un objetivo de archivo local

Después de haber creado un objetivo de Archivo Local, la pantalla de configuración se abrirá en la vista principal de Design Studio. Puedes regresar a la pantalla de configuración en cualquier momento haciendo doble clic en el ícono del objetivo en la operación, o haciendo doble clic en el objetivo en el árbol a la izquierda.

Configuración básica

La pantalla de configuración aparecerá similar a este ejemplo:

• Nombre: Ingresa un nombre apropiado y único para el destino.
• Tipo: Usa el menú desplegable para seleccionar Archivo Local, si no está especificado ya.

• Parámetros de Conexión: Especifica los detalles para tu conexión de Archivo Local:

  • Examinar: El botón Examinar, si está habilitado, se puede usar para ingresar rápidamente la ruta de la carpeta. Solo se puede usar si el agente de Jitterbit está instalado localmente en la misma máquina donde se está ejecutando Design Studio. Si esta opción está deshabilitada, es posible que necesites habilitar archivos locales como se describe en Habilitar ubicación de archivos locales. Si seleccionas una carpeta o archivo usando Examinar, los campos de Carpeta(s)—y posiblemente Nombre(s) de Archivo—se llenarán automáticamente.

  • Carpeta(s): Ingresa una ruta local en la máquina donde está instalado el agente de Jitterbit que apunte a la carpeta donde deben residir el(los) archivo(s) de destino.

    • La ruta no puede contener ninguno de estos caracteres: \~ % $ ? " \< > :
    • Los separadores de ruta ('/'o '\') utilizados deben ser apropiados para el sistema operativo de la máquina donde está instalado el agente privado.
    • Se pueden especificar múltiples rutas usando valores delimitados por comas. Si se especifican múltiples rutas, el mismo archivo se escribe en múltiples ubicaciones.

  • Nombre(s) de Archivo: Ingresa el nombre deseado para el(los) archivo(s) de destino. Se pueden usar variables en este campo. Si se especifica un archivo comprimido (ZIP), consulta la sección "Compresión" de los parámetros de conexión adicionales en Opciones a continuación. El archivo se escribirá automáticamente en el archivo comprimido en el nivel raíz. (Requerido.)

• Probar Conexión: Hacer clic en el botón probará el destino de Archivo Local y verificará que se pueda establecer una conexión con la carpeta especificada; fallará si la ruta no es una ruta válida en el sistema operativo donde se está ejecutando el agente de Jitterbit. Si recibes un error, asegúrate de haber habilitado archivos locales como se describe en Habilitar ubicación de archivos locales.

• Haga clic en el botón Guardar en la barra de herramientas principal o en la barra de herramientas del destino para guardar la configuración.

Opciones

Se pueden especificar parámetros de conexión adicionales haciendo clic en Opciones en la parte inferior de la sección Parámetros de Conexión:

• Tipo de Fin de Línea: Determina cómo Jitterbit escribe los saltos de línea al escribir en un destino. Tenga en cuenta que los caracteres de fin de línea en los datos no se convertirán. Opciones disponibles:

  • Predeterminado: Caracteres de fin de línea estándar para la plataforma en la que se está ejecutando el agente.
  • Windows: CRLF (ASCII 13 y ASCII 10)
  • Unix: LF (ASCII 10)

• Escribir Encabezados: Si está marcado y es un destino de texto plano, se escribirá un encabezado de nombres de columna/campo como la primera línea.

• No Crear Archivos Vacíos: Si está marcado, se omitirá la creación del archivo de destino si no hay datos de destino.
• Crear Directorios Automáticamente: Si está marcado, se crearán automáticamente los directorios intermedios necesarios para completar las rutas (como se especifica arriba en Parámetros de Conexión).
• Codificación de Caracteres: Se utiliza para especificar una codificación de caracteres para el archivo de destino. Si se deja en blanco, Jitterbit intentará detectar la codificación. Para especificar una codificación diferente a la predeterminada, inserte una de las codificaciones admitidas descritas en Codificaciones de caracteres admitidas.

• Carpeta de Éxito/Error: Especifica si se utilizarán carpetas de éxito y/o error para archivar una copia de todos los archivos procesados.

  • Si se especifica una carpeta de éxito, al procesar exitosamente el destino, se escribirá una copia del archivo en un archivo en esa carpeta.
  • El archivo tendrá el mismo nombre que el especificado en el campo Nombre(s) de Archivo arriba, pero con un guion bajo al final y una marca de tiempo añadida. Si ya hay un archivo con el mismo nombre en esa carpeta, se añadirá un guion bajo adicional y un contador.
  • Ejemplo: si un archivo llamado data.csv se procesa exitosamente, se podría escribir una copia llamada data.csv_2018-01-01_12-00-00-000 en la carpeta especificada como Carpeta de Éxito. Si ya existe un archivo así de una ejecución anterior, se añadiría un nuevo archivo data.csv_2018-01-01_12-00-00-000_1.
  • De manera similar, si se especifica una carpeta de error, cualquier archivo que falle se escribirá en un archivo en la Carpeta de Error.

• Compresión: Si se selecciona la casilla de verificación Comprimir archivos de destino, los archivos de destino se comprimirán utilizando el formato ZIP. Las opciones adicionales son:

  • Nombre(s) de archivo en el archivo: Acepta variables y palabras clave de nombre de archivo. Para mantener el nombre del archivo en el archivo igual al nombre de archivo definido en el destino, utiliza un formato de [file].[ext] como se muestra arriba.
  • Modo: Uno de Sobrescribir o Agregar. Sobrescribir reemplazará un archivo existente. Para archivos no encriptados, Agregar añadirá archivos a un archivo existente. Este modo solo está disponible para destinos de Archivo Local (y Almacenamiento Temporal).
  • Contraseña: Para archivos encriptados, proporciona una contraseña.
  • Modo de encriptación: Si se proporciona una contraseña, hay dos modos de encriptación disponibles: AES o ZIP Estándar.