Palabras clave de nombre de archivo en Jitterbit Integration Studio

Introducción

Las palabras clave de nombre de archivo se utilizan para generar nombres de archivo únicos para campos configurables que toman nombres de archivo como entrada. Estos incluyen ciertos campos disponibles al configurar puntos finales utilizando conectores. Las palabras clave de nombre de archivo son uno de los tipos de elementos de datos globales disponibles en Harmony. Los otros tipos de elementos de datos globales —variables de proyecto, variables globales y variables de Jitterbit— también están disponibles globalmente a lo largo de un proyecto. Se configuran de manera diferente, como se describe en Variables de proyecto, Variables globales y Variables de Jitterbit, respectivamente. Sin embargo, dado que todos los elementos de datos globales comparten el mismo espacio de nombres, sus nombres deben ser únicos en comparación con todos los demás elementos de datos globales.

Palabras clave disponibles

Las palabras clave enumeradas en la tabla a continuación están disponibles para usar en ciertos campos dentro de las pantallas de configuración de puntos finales. Las palabras clave no son sensibles a mayúsculas. Por ejemplo, [time] es equivalente a [TIME] y [Time].

Use filename keywords in configuration screens

Durante la configuración de puntos finales utilizando connectors, puede usar sustituciones de palabras clave de nombre de archivo en ciertos campos que tienen un ícono de variable . Las palabras clave de nombre de archivo se pueden usar en campos junto con otra entrada, incluidos otros términos clave o variables. Estas secciones se cubren a continuación:

• Fields where keywords can be used
• Select a filename keyword
• Toggle formats between pill and text
• Remove a filename keyword

Fields where keywords can be used

Las sustituciones de palabras clave están destinadas a ser utilizadas dentro de campos configurables que toman nombre(s) de archivo como entrada. Esto incluye ciertos campos disponibles durante la configuración de puntos finales de los conectores enumerados a continuación.

Read activities

• Optional Settings: After Processing > Rename File (File Share, FTP, Temporary Storage, y Local Storage Read activities)

• Configuraciones Opcionales: Archivo de Activación > Ruta de Archivo Absoluta (File Share, FTP, Almacenamiento Temporal, y Almacenamiento Local Lectura actividades)

• Configuraciones Opcionales: Carpeta de Éxito/Error > Carpeta de Éxito en Ruta Absoluta y Carpeta de Error en Ruta Absoluta (FTP y Almacenamiento Local Lectura actividades)

Actividades de Escritura

• Nombre(s) de Archivo (File Share, FTP, Almacenamiento Temporal, y Almacenamiento Local Escritura actividades)

• Configuraciones Opcionales: Compresión > Nombre(s) de Archivo en Archivo Comprimido (File Share, FTP, Almacenamiento Temporal, y Almacenamiento Local Escritura actividades)

• Configuraciones Opcionales: Carpeta de Éxito/Error > Carpeta de Éxito en Ruta Absoluta y Carpeta de Error en Ruta Absoluta (FTP y Almacenamiento Local Escritura actividades)

Seleccionar una palabra clave de nombre de archivo

Para acceder a las palabras clave de nombre de archivo, puedes hacer clic en el ícono de variable o ingresar un corchete cuadrado abierto [ para mostrar una lista de palabras clave y variables.

Dentro de la lista, el tipo de palabra clave o variable se indica con el ícono junto a su nombre:

• para palabra clave de nombre de archivo
• para variable global
• para variable de proyecto
• para variable de Jitterbit

En la lista, pasa el cursor sobre el nombre de la palabra clave para previsualizar información sobre ella:

El Valor que aparece en la ventana emergente de información siempre está vacío para una palabra clave de nombre de archivo. No se puede definir un valor predeterminado para una palabra clave de nombre de archivo en un campo de configuración.

Selecciona una palabra clave para agregar al campo en la ubicación de tu cursor, en cualquier parte de la cadena. La variable se muestra en un formato de píldora similar al que se muestra a continuación:

Para revisar información sobre la palabra clave, pasa el cursor sobre la píldora de la palabra clave:

Alternar formatos entre píldora y texto

Para cambiar el formato predeterminado de la píldora de la palabra clave a formato de texto, haz clic en el ícono de colapso :

Esto alterna la visualización del formato de píldora a un formato de texto, con el nombre de la variable encerrado entre corchetes cuadrados [ ]:

Para cambiar de un formato de texto de vuelta a un formato de píldora, cambia el enfoque fuera del campo, como haciendo clic en otro campo configurable. La entrada del campo regresa automáticamente al formato de píldora predeterminado.

Eliminar una palabra clave de nombre de archivo

Para eliminar una palabra clave de nombre de archivo, haz clic en el ícono de eliminar :

Limitaciones y soluciones alternativas

Al usar palabras clave de nombre de archivo en los campos Archivo de activación o Carpeta de éxito/error, una limitación es que las palabras clave no se resuelven al usar el archivo de activación o al crear el archivo de éxito o error, respectivamente.

Por ejemplo, supongamos que tienes un archivo fuente llamado customers.csv y la fecha actual es 2 de octubre de 2019.

Podrías intentar usar una combinación de palabras clave como esta para establecer el nombre del archivo de destino:

[file]_[date].csv

customers_2019-10-02.csv-_2019-10-02_02-02-54-525

Sin embargo, debido a que las palabras clave de nombre de archivo no se resuelven, en su lugar el resultado real es algo como esto, incluyendo las palabras clave no resueltas aún en corchetes:

[file]_[date].csv_2019-10-02_02-02-54-525

Una solución alternativa es usar una variable global en lugar de palabras clave de nombre de archivo para el nombre del archivo de destino:

1. Crea una variable global en una condición añadida a un nodo de destino de la transformación, y establece esa variable global para especificar el nombre del archivo fuente.

   En este ejemplo, se ha creado un nombre de archivo que utiliza el nombre del archivo fuente y la hora actual, en UTC:

   <trans>
   If(SourceInstanceCount() == 1,
     $filename_target = $jitterbit.source.filename + "_";
     $filename_target += Replace(GetUTCFormattedDateTime(Now(), "UTC", false), ":", "-");
   );
   true;
   </trans>
   

2. Usa la variable global (en el ejemplo, llamada filename_target) como el nombre del archivo de destino en el campo Carpeta de éxito/error.

La variable global se resuelve correctamente para el archivo de éxito o error, respectivamente.