Saltar al contenido

Actividad de escritura en File Share en Jitterbit Studio

Introducción

Una actividad de escritura en File Share Write, utilizando su conexión de File Share, escribe datos en una red compartida y está destinada a ser utilizada como un objetivo para consumir datos en una operación o para ser llamada en un script.

Crear una actividad de escritura en File Share

Una instancia de una actividad de escritura en File Share Write se crea a partir de una conexión de File Share 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 File Share Write existente se puede editar desde estas ubicaciones:

Configurar una actividad de escritura en File Share

Siga estos pasos para configurar una actividad de escritura en File Share 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ú con las variables existentes de las que elegir.

  • Menú de puntos finales: Si tiene múltiples puntos finales del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del punto final actual. Haga clic en el menú para cambiar a un punto final diferente. Para más información, consulte Cambiar el punto final asignado en Pantallas de configuración.

    • Editar punto final: Aparece cuando pasa el cursor sobre el nombre del punto final actual. Haga clic para editar la configuración de conexión del punto final seleccionado actualmente.

  • Nombre: Ingrese un nombre para identificar la actividad de Escritura en Compartición de Archivos. El nombre debe ser único para cada actividad de Escritura en Compartición de Archivos y no debe contener barras diagonales (/) ni dos puntos (:).

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

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

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

    • Crear directorios automáticamente: Mantenga esta casilla de verificación 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 de verificación para omitir la creación del archivo de destino si no hay datos de destino.

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

    • Compresión: Si desea que los datos de destino se compriman, seleccione Comprimir archivos de destino. Estas opciones estarán disponibles:

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

      • Nombres de archivo en archivo(s): Ingrese el nombre del 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 en el 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, ingrese [file].[ext].

      • Modo: Por defecto, el modo Sobrescribir sobrescribe el archivo existente. Este es el único modo disponible.

      • Contraseña: Para cifrar el archivo, ingrese la contraseña deseada.

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

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

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

  • Descartar Cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea 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 durante el proceso de mapeo de transformación, donde puede mapear a campos de destino utilizando objetos de origen, scripts, variables, valores personalizados y más. También puede 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, haga clic para expandir esta sección y seleccione la casilla junto al plugin que se 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, consulte Plugins añadidos a una actividad.

  • Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

  • Finalizado: Haga 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, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le pide que confirme que desea descartar los cambios.

Próximos pasos

Después de configurar una actividad de Escritura en File Share, puede 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 File Share, completa la configuración de la operación añadiendo y configurando otras actividades o herramientas como pasos de la operación. También se pueden configurar los ajustes de operación de una operación, que incluyen 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 File Share, 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 File Share se pueden utilizar como un objetivo con estos patrones de operación:

Otros patrones no son válidos utilizando actividades de Escritura en File Share. 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.

Usar actividades de File Share en scripts

Las actividades de File Share Write 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.