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 su uso 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].
| Palabra clave | Sustitución |
|---|---|
[date] |
Sustituido por la fecha actual en el formato YYYY-Mon-DD. |
[ext] |
Sustituido por la extensión del archivo, si la hay, según se estableció al usar una fuente de tipo archivo. El uso previsto de esta palabra clave es en un campo de nombre de archivo de destino de tipo archivo. |
[file] |
Sustituido por el nombre base del archivo (es decir, excluyendo la extensión del archivo, si la hay), según se estableció al usar una fuente de tipo archivo. El uso previsto de esta palabra clave es en un campo de nombre de archivo de destino de tipo archivo. |
[sequence] |
Sustituido por la secuencia del archivo: 1 para el primero, 2 para el segundo, y así sucesivamente. Similar a las funciones de Jitterbit SourceInstanceCount y TargetInstanceCount. |
[time] |
Sustituido por la hora actual en el formato HHMMSS. |
[unique] |
Sustituido por un GUID, un identificador único aleatorio. |
Consejo
Tenga en cuenta que la variable de Jitterbit jitterbit.source.filename proporciona el nombre de archivo completo, se establece con cada invocación de origen y se puede usar en lugar de las palabras clave [file] y [ext].
Utilice palabras clave en los nombres de archivo en las pantallas de configuración
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, incluyendo otras palabras clave o variables. Estas secciones se cubren a continuación:
- Campos donde se pueden usar palabras clave
- Seleccionar una palabra clave del nombre de archivo
- Eliminar una palabra clave del nombre de archivo
Advertencia
Dado que las palabras clave utilizan la misma sintaxis que las global y project variables, es posible crear una variable global o de proyecto que tenga el mismo nombre. Debido a que esto puede causar confusión, recomendamos no crear variables globales o de proyecto que tengan el mismo nombre que estas palabras clave.
Las palabras clave anulan cualquier variable del mismo nombre cuando se evalúa el componente del proyecto.
Campos donde se pueden usar palabras clave
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 que se enumeran a continuación.
Leer actividades
-
Configuraciones Opcionales: Después del procesamiento > Cambiar nombre del archivo (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)
Nota
Una restricción sobre el uso de palabras clave de nombre de archivo en Archivo de activación y Carpeta de éxito/error se describe más adelante en esta página bajo Limitaciones y soluciones alternativas.
Seleccione una palabra clave de nombre de archivo
Para acceder a las palabras clave del nombre de archivo, puede hacer clic en el icono de variable o ingresar un corchete abierto [ para mostrar un menú que enumera palabras clave y variables.
Dentro de la lista, la palabra clave o el tipo de variable se indica mediante el icono situado junto a su nombre:
para palabra clave de nombre de archivo para variable global para variable de proyecto para variable de Jitterbit
Seleccione una palabra clave para agregar al campo en la ubicación de su 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:

Eliminar una palabra clave de nombre de archivo
Para eliminar una palabra clave del nombre de archivo, haga clic en el icono de eliminación :

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
Con este ejemplo, si las palabras clave de nombre de archivo se resolvieran, podrías esperar que el resultado fuera un archivo de éxito llamado algo como esto, con el guion bajo final y la marca de tiempo añadidos por la funcionalidad de Carpeta de éxito/error:
customers_2019-10-02.csv-_2019-10-02_02-02-54-525
Sin embargo, debido a que las palabras clave del nombre de archivo no se resuelven, el resultado real es algo como esto, incluyendo las palabras clave no resueltas aún entre 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 del nombre de archivo para el nombre de archivo de destino:
-
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 de archivo de origen.
En este ejemplo, se ha creado un nombre de archivo que utiliza el nombre de archivo de origen y la hora actual, en UTC:
<trans> If(SourceInstanceCount() == 1, $filename_target = $jitterbit.source.filename + "_"; $filename_target += Replace(GetUTCFormattedDateTime(Now(), "UTC", false), ":", "-"); ); true; </trans> -
Usa la variable global (en el ejemplo, llamada
filename_target) como el nombre de archivo de destino en el campo Carpeta de Éxito/Error.La variable global se resuelve correctamente para el archivo de éxito o error, respectivamente.
Nota
De manera similar, con un Archivo de Activación de origen, el uso de palabras clave del nombre de archivo no se resuelve correctamente en un nombre de archivo. Como solución alternativa, usa una variable global configurada con un valor apropiado.