Saltar al contenido

Actividad de escritura en Almacenamiento Local

Introducción

Una actividad de escritura en Almacenamiento Local Write, utilizando su conexión de Almacenamiento Local, escribe datos en un punto final de Almacenamiento Local y está destinada a ser utilizada como un objetivo en una operación o llamada en un script.

Crear una actividad de escritura en Almacenamiento Local

Una instancia de una actividad de escritura en Almacenamiento Local Write se crea a partir de una conexión de Almacenamiento Local utilizando su tipo de actividad Write.

Para crear una instancia de una actividad, arrastre el tipo de actividad al lienzo de diseño o copie el tipo de actividad y péguelo en el lienzo de diseño. Para más detalles, consulte Crear una instancia de actividad o herramienta en Reutilización de componentes.

Una actividad de escritura en Almacenamiento Local Write existente se puede editar desde estas ubicaciones:

Configurar una actividad de escritura en Almacenamiento Local

Siga estos pasos para configurar una actividad de escritura en Almacenamiento Local Write:

Paso 1: Ingrese un nombre, proporcione un esquema de solicitud y especifique configuraciones

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú que enumera las variables existentes de las que elegir.

  • Nombre: Ingresa un nombre para identificar la actividad de Escritura en Almacenamiento Local. El nombre debe ser único para cada actividad de Escritura en Almacenamiento Local y no debe contener barras diagonales (/) ni dos puntos (:).

  • Proporcionar esquema de solicitud: El esquema de solicitud define la estructura de los datos que utiliza la actividad de Escritura en Almacenamiento Local. Si se requiere un esquema de solicitud depende de si la actividad se utiliza como el objetivo de una transformación (ver Uso de esquemas). Para instrucciones sobre cómo completar esta sección de la configuración de la actividad, consulta Esquemas definidos en una actividad.

  • Nombre(s) de archivo: Ingresa el nombre del(los) archivo(s) que deseas escribir dentro de la(s) ruta(s) especificada(s) en la conexión de Almacenamiento Local. Cualquiera de las palabras clave de nombre de archivo se puede usar para generar nombres de archivo únicos (por ejemplo, result[date][time].[ext]). Si se especifican datos en formato ZIP, consulta las opciones de Compresión descritas a continuación.

  • Configuraciones opcionales: Haz clic para expandir configuraciones opcionales adicionales.

    • Crear directorios automáticamente: Mantén esta casilla seleccionada para crear automáticamente cualquier directorio que aún no exista en la ruta de destino.

    • No crear archivos vacíos: Selecciona esta casilla para omitir la creación del archivo de destino si no hay datos de destino.

    • Agregar al archivo: Selecciona esta casilla para agregar al archivo de destino existente en lugar de sobrescribirlo.

    • Escribir encabezados: Selecciona esta casilla si estás utilizando un destino de texto plano y deseas escribir encabezados (nombres de columna/campo) en la primera línea.

    • Tipo de fin de línea: Especifica cómo escribir los saltos de línea al escribir en un destino. Ten en cuenta que los caracteres de fin de línea en los datos mismos no se convierten. Las opciones son las siguientes:

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

    • Codificación de Caracteres: Especifica la codificación de caracteres para definir una codificación específica para el archivo de destino. Si dejas el campo en blanco, Harmony intenta detectar la codificación. Si deseas sobrescribir la predeterminada, puedes elegir entre cualquiera de los tipos de codificación listados en Codificaciones de caracteres soportadas.

    • Carpeta de Éxito/Error: Estas opciones se utilizan para archivar una copia de todos los archivos procesados. Esto se puede usar en lugar de la opción Después de procesar para Renombrar Archivo en la fuente del archivo para permitirte escribir en una ubicación separada en lugar de en una subcarpeta en la misma ubicación.

      • Usar Carpeta de Éxito: Selecciona esta casilla para escribir un archivo en la carpeta especificada después del procesamiento exitoso en la ruta de destino principal. Si se escribe un archivo en múltiples rutas, la operación es exitosa solo si todas las rutas son exitosas. Si esta casilla está seleccionada, también proporciona la Carpeta de Éxito en Ruta Absoluta en la máquina del agente privado.

      • Usar Carpeta de Error: Selecciona esta casilla para escribir un archivo en la carpeta especificada después de un procesamiento no exitoso. Si al menos una ruta no es exitosa, entonces el archivo se escribe en esta carpeta. Si esta casilla está seleccionada, también proporciona la Carpeta de Error en Ruta Absoluta en la máquina del agente privado.

        Precaución

        Un archivo se escribe solo si la falla se debe a errores en el procesamiento de la actividad de Escritura en Almacenamiento Local. No se escribe un archivo si, por ejemplo, la conexión de Almacenamiento Local no es exitosa, causando que toda la operación falle.

        Nota

        Al usar palabras clave de nombre de archivo en estos campos, las palabras clave no se resuelven. Para una solución alternativa, consulta Limitación y solución alternativa en Palabras clave de nombre de archivo.

      Los archivos se nombran como se especifica en el campo Nombre(s) de Archivo anterior, 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ñade un guion bajo adicional y un contador.

      Por ejemplo, si un archivo llamado data.csv se procesa correctamente, se podría escribir una copia llamada data.csv_2018-01-01_12-00-00-000 en la carpeta especificada como la carpeta de éxito. Si tal archivo ya existe 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 errores, cualquier archivo que falle se escribe en un archivo en la carpeta de errores.

    • Compresión: Selecciona la casilla para Comprimir archivos de destino si deseas que los datos de destino se compriman. Estas opciones estarán disponibles:

      • Formato: Usa el menú desplegable para seleccionar el formato de compresión deseado. Actualmente, solo se admite el formato ZIP.

      • Nombres de archivos en el/los archivo(s): Ingresa el nombre del/los archivo(s) de destino que se van a comprimir dentro del archivo. Cualquiera de las palabras clave de nombre de archivo está disponible para generar nombres de archivo únicos. El/los archivo(s) se escriben automáticamente en el archivo a nivel raíz.

        Consejo

        Para mantener el/los nombre(s) de archivo en el archivo igual que el/los nombre(s) de archivo definidos en el destino, ingresa [file].[ext].

      • Modo: Usa el menú desplegable para seleccionar entre estos modos:

        • Sobrescribir: Este modo sobrescribe el archivo existente.

        • Agregar: Si el archivo no está encriptado, este modo añade archivos comprimidos al archivo existente. No se admite agregar a un archivo ZIP encriptado.

      • Contraseña: Para encriptar el archivo, ingresa la contraseña deseada.

      • Modo de encriptación: Si se proporciona una contraseña, usa el menú desplegable para seleccionar entre los dos modos de encriptación disponibles: AES y ZIP estándar.

  • Guardar y salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

  • Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente paso. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

  • Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 2: Revisar los esquemas de datos

  • Esquema de Datos: Si se proporciona durante la configuración de la actividad, se muestra el esquema de datos de la solicitud. Si la operación utiliza una transformación, los esquemas de datos se muestran nuevamente más adelante durante el proceso de mapeo de transformación, donde puedes mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más. También puedes definir esquemas directamente en una transformación.

  • Agregar Plugin(s): Los plugins son aplicaciones proporcionadas por Jitterbit o por el usuario que amplían las capacidades nativas de Harmony. Para aplicar un plugin a la actividad, haz clic para expandir esta sección y selecciona la casilla junto al plugin que se va a utilizar. Para obtener instrucciones adicionales sobre el uso de plugins, incluidos los detalles sobre la configuración de cualquier variable requerida utilizada por el plugin, consulta Plugins añadidos a una actividad.

  • Regresar: Haz clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Terminado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

  • Descartar Cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Próximos pasos

Después de configurar una actividad de Escritura en Almacenamiento Local, puedes usarla dentro de una operación o script como se describe a continuación.

Completar la operación

Después de configurar una actividad de Escritura en Almacenamiento Local, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de operación. También puedes configurar la configuración de operación de una operación, que incluye la capacidad de encadenar operaciones que están en los mismos o diferentes flujos de trabajo.

Una vez que se ha creado una actividad de Escritura en Almacenamiento Local, las acciones del menú para esa actividad son accesibles desde el panel del proyecto en las pestañas de Flujos de trabajo o Componentes, y desde el lienzo de diseño. Consulta el menú de acciones de actividad para más detalles.

Las actividades de Escritura en Almacenamiento Local se pueden utilizar como un objetivo con estos patrones de operación:

Otros patrones no son válidos utilizando actividades de Escritura en Almacenamiento Local. Consulta los patrones de validación en la página de Validez de operación.

Cuando estés listo, despliega y ejecuta la operación y valida el comportamiento revisando los registros de operación.

Usando actividades de Almacenamiento Local en scripts

Las actividades de Escritura en Almacenamiento Local también se pueden referenciar en un script para su uso con funciones de script que utilizan un targetId como parámetro, incluyendo estas:

Funciones de Script de Jitterbit

  • ArchiveFile
  • FlushAllFiles
  • FlushFile
  • WriteFile

Funciones de Jitterbit en JavaScript

  • Jitterbit.WriteFile

Para más detalles sobre cómo referenciar actividades en scripts, consulta Endpoints en Jitterbit Script o Endpoints en JavaScript.