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

Actividad de escritura en Almacenamiento Local 1

Consejo

Los campos con un ícono variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar una lista de 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:

    Configuraciones opcionales de actividad de Escritura en Almacenamiento Local 1

    • 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: Seleccione esta casilla para omitir la creación del archivo de destino si no hay datos de destino.

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

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

    • Tipo de fin de línea: Especifique cómo escribir los saltos de línea al escribir en un destino. Tenga 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: Especifique la codificación de caracteres para definir una codificación de caracteres específica para el archivo de destino. Si deja el campo en blanco, Harmony intenta detectar la codificación. Si desea sobrescribir la predeterminada, puede elegir entre cualquiera de los tipos de codificación enumerados en Codificaciones de caracteres compatibles.

    • 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 del procesamiento para Renombrar archivo en la fuente de archivos para permitirle escribir en una ubicación separada en lugar de en una subcarpeta en la misma ubicación.

      • Usar carpeta de éxito: Seleccione 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 se selecciona esta casilla, también proporcione la Carpeta de Éxito en Ruta Absoluta en la máquina del agente privado.

      • Usar carpeta de error: Seleccione 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 se selecciona esta casilla, también proporcione 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 tiene éxito, lo que causa 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, consulte 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 arriba, 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 con éxito, 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: Seleccione la casilla para Comprimir archivos de destino si desea que los datos de destino se compriman. Estas opciones se vuelven disponibles:

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

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

        Consejo

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

      • Modo: Use 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, utiliza 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

Actividad de Escritura en Almacenamiento Local 2

  • 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 utilizará. Para obtener instrucciones adicionales sobre el uso de plugins, incluidos detalles sobre la configuración de cualquier variable requerida utilizada por el plugin, consulta Plugins añadidos a una actividad.

  • Atrás: 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.

Pasos siguientes

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 añadiendo y configurando otras actividades o herramientas como pasos de la 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 pueden usarse como un objetivo con estos patrones de operación:

Otros patrones no son válidos al usar actividades de Escritura en Almacenamiento Local. Consulte los patrones de validación en la página de validez de operaciones.

Cuando esté listo, despliegue y ejecute la operación y valide el comportamiento revisando los registros de operaciones.

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, consulte Puntos finales en Jitterbit Script o Puntos finales en JavaScript.