Palabras Clave de Nombre de Archivo

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 extremos usando 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 Jitterbit) también están disponibles globalmente en todo un proyecto. Se configuran de manera diferente, como se describe en Variables del proyecto, Variables globales y Variables de Jitterbit, respectivamente. Sin embargo, como 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 siguiente tabla están disponibles para su uso en ciertos campos dentro de las pantallas de configuración del extremo. Las palabras clave no distinguen entre mayúsculas y minúsculas. Por ejemplo, [time] es equivalente a [TIME] y [Time].

Palabra clave	Sustitución
`[date]`	Sustituido con la fecha actual en el formato. `YYYY-Mon-DD`.
`[ext]`	Sustituido por la extensión de archivo, si corresponde, tal como se establece cuando se utiliza una fuente de tipo de archivo. El uso previsto de esta palabra clave es en un campo de nombre de archivo de destino de tipo de archivo.
`[file]`	Sustituido por el nombre del archivo base (es decir, excluyendo la extensión del archivo, si corresponde), tal como se establece cuando se utiliza una fuente de tipo de archivo. El uso previsto de esta palabra clave es en un campo de nombre de archivo de destino de tipo de archivo.
`[sequence]`	Sustituido por la secuencia del archivo: 1 para el primero, 2 para el segundo, y así sucesivamente. Similar a las funciones 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 Jitterbit jitterbit.source.filename proporciona el nombre de archivo completo, se configura con cada invocación de fuente y se puede utilizar en lugar de las palabras clave [file] y [ext].

Utilice Palabras Clave de Nombre de Archivo en las Pantallas de Configuración

Durante la configuración de extremos usando conectores, puede utilizar sustituciones de palabras clave de nombre de archivo en ciertos campos que tienen un icono de variable . Las palabras clave de nombre de archivo se pueden usar en campos junto con otras entradas, incluidas otras palabras clave o variables. Estas secciones se tratan a continuación:

Campos donde se pueden utilizar palabras clave
Seleccione una palabra clave de nombre de archivo
Alternar formatos entre píldora y texto
Eliminar una palabra clave de nombre de archivo

Advertencia

Como palabras clave, utilice la misma sintaxis que global y variables del proyecto, 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 Utilizar Palabras Clave

Las sustituciones de palabras clave están destinadas a usarse dentro de campos configurables que toman nombres de archivos como entrada. Esto incluye ciertos campos disponibles durante la configuración del extremo de los conectores que se enumeran a continuación.

Leer Actividades

Configuración opcional: después del procesamiento > Cambiar nombre de archivo (Compartir archivos, FTP, Almacenamiento temporal y Almacenamiento local Leer actividades)
Configuración opcional: Archivo de activación > Ruta de archivo absoluta (Compartir archivos, FTP, Almacenamiento temporal y Almacenamiento local Leer actividades)
Configuración opcional: Carpeta de éxito/error > Carpeta de éxito en ruta absoluta y Carpeta de error en ruta absoluta (FTP y Almacenamiento local Leer actividades)

Escribir Actividades

Nombre(s) de archivo (Archivo compartido, FTP, Almacenamiento temporal y Almacenamiento local Escribir actividades)
Configuraciones opcionales: Compresión > Nombre(s) de archivo en el archivo (Compartir archivos, FTP, Almacenamiento temporal y Almacenamiento local Escribir actividades)
Configuración opcional: Carpeta de éxito/error > Carpeta de éxito en ruta absoluta y Carpeta de error en ruta absoluta (FTP y Almacenamiento local Escribir actividades)

Nota

Una restricción en 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 en Limitaciones y soluciones.

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 introduzca un corchete abierto [ para mostrar una lista de palabras clave y variables.

Dentro de la lista, la palabra clave o tipo de variable se indica mediante el icono al lado de su nombre:

para la palabra clave del nombre de archivo
para variables globales
para la variable del proyecto
para la variable Jitterbit

En la lista, coloque el cursor sobre el nombre de la palabra clave para obtener una vista previa de la 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.

Seleccione una palabra clave para agregarla al campo en la ubicación del 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, coloque el cursor sobre la píldora de palabras clave:

Alternar Formatos Entre Píldora y Texto

Para cambiar el formato de píldora de palabras clave predeterminado a formato de texto, haga clic en el ícono de contraer :

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

Para cambiar de un formato de texto a formato de píldora, cambie el foco fuera del campo, por ejemplo, haciendo clic en otro campo configurable. La entrada del campo vuelve 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, haga clic en el icono de eliminación :

Limitaciones y Soluciones

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

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

Puede intentar utilizar una combinación de palabras clave como esta para establecer el nombre del archivo de destino:

[file]_[date].csv

Con este ejemplo, si se resolvieron las palabras clave del nombre del archivo, es posible que espere que el resultado sea un archivo exitoso con un nombre similar a este, con el guión bajo final y la marca de tiempo agregados por la funcionalidad Carpeta de éxito/error:

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, el resultado real es algo como esto, incluidas las palabras clave no resueltas que aún están entre paréntesis:

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

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

Cree una variable global en una condición agregada a un nodo de destino de la transformación y establezca esa variable global para especificar el nombre del archivo de origen.

En este ejemplo, se ha creado un nombre de archivo que utiliza el nombre del 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>
```
Utilice la variable global (en el ejemplo, llamada filename_target) como 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 desencadenante de origen, el uso de palabras clave de nombre de archivo no se resuelve correctamente en un nombre de archivo. Como solución alternativa, utilice una variable global configurada con un valor apropiado.