Saltar al contenido

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:

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

Actividades de Escritura

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:

File Share write filename pill

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 :

File Share write filename pill remove

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:

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