Saltar al contenido

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. Los campos que especifican nombres de archivos están disponibles al configurar orígenes y destinos basados en archivos.

Palabras Clave Disponibles

Estas palabras clave están disponibles para usar dentro de campos configurables para nombres de archivos que permiten el uso de una variable. Como se muestra a continuación en Ingresar palabras clave de nombre de archivo, puede probar su disponibilidad ingresando un solo corchete izquierdo]([); Si aparece una lista desplegable de palabras clave y variables, las palabras clave aparecerán en la parte superior y podrán usarse. Las sustituciones de palabras clave no distinguen entre mayúsculas y minúsculas: [TIME] y [Time] son equivalentes a [time].

Esta lista muestra las palabras clave disponibles y por qué se sustituyen:

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. Consulte Advertencia debajo de esta tabla.
[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. Consulte la Advertencia que aparece a continuación en la tabla.
[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.

Advertencia

Como las palabras clave usan la misma sintaxis que las variables globales y del proyecto, una vez que use una palabra clave y guarde el elemento del proyecto, aparecerá en la lista de variables globales para su proyecto y como una entrada duplicada en la lista desplegable.. También es posible crear directamente una variable global o de proyecto que tenga el mismo nombre y terminar con entradas adicionales en la lista desplegable. Como 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 anularán cualquier variable del mismo nombre cuando se evalúe el elemento del proyecto.

Tenga en cuenta que [file] y [ext] se establecen en la fuente y están disponibles como variables $file y $ext respectivamente. Sin embargo, el uso previsto está en los nombres de archivo de un destino y no deben leerse directamente desde las variables globales. 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 su lugar.

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

Durante la configuración de fuentes y destinos, puede utilizar sustituciones de palabras clave de nombres de archivos en ciertos campos que tienen entrada de texto. Las sustituciones de palabras clave están destinadas a usarse dentro de campos configurables que toman nombres de archivos como entrada. Aunque puede utilizar cualquiera de estas palabras clave en fuentes o destinos, solo funcionan en ciertos usos y contextos. En estas ubicaciones, puede utilizar palabras clave de nombre de archivo:

Fuentes

  • Para fuentes de archivos compartidos, sitios FTP, almacenamiento temporal y archivos locales:

    • Archivo de activación (ruta de archivo absoluta)
    • Después del procesamiento (cambiar nombre del archivo)

  • Para sitios FTP, almacenamiento temporal y fuentes de archivos locales:

    • Carpeta de éxito/error (carpeta de éxito/error en la ruta absoluta)

Objetivos

  • Para destinos de archivos compartidos, sitios FTP y almacenamiento temporal:

    • Nombre(s) de archivo
    • Compresión (nombre(s) de archivo en el archivo)

  • Para sitios FTP y destinos de archivos locales:

    • Carpeta de éxito/error (carpeta de éxito/error en la ruta absoluta)

Consulte la siguiente sección Limitaciones para conocer las restricciones actuales sobre la despliegue de palabras clave de nombre de archivo.

Introduzca las Palabras Clave del Nombre del Archivo

Para utilizar una palabra clave junto con otros campos de entrada, incluidas otras palabras clave o variables, ingrese un corchete abierto ([) al campo. En la lista, coloque el cursor sobre el nombre de la palabra clave para obtener una vista previa de la información al respecto. Seleccione una palabra clave para insertarla en la ubicación de su cursor, en cualquier lugar de la cadena:

ejemplo de carpeta de error exitoso

Las variables ingresadas mediante este método se muestran como texto entre corchetes [ ] dentro del campo. Ingrese cualquier entrada adicional o agregue varias palabras clave y variables utilizando el mismo método descrito anteriormente:

ejemplo de nombre de archivo

Nombre de Archivo Palabra Clave Tutoriales

Consulte estas secciones para obtener detalles sobre el uso de palabras clave de nombre de archivo en sus proyectos:

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, si 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 resolvieran las palabras clave del nombre del archivo, esperaría que el resultado fuera un archivo exitoso con el nombre, con el guión bajo final y la marca de tiempo agregados por la funcionalidad Carpeta de éxito/error, como por ejemplo:

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 incluirá las palabras clave no resueltas que aún están entre paréntesis, como por ejemplo:

[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:

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

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

    [filename_target].csv

    La variable global se resolverá correctamente para el archivo de éxito o error, respectivamente, según sea necesario.

Nota

De manera similar, con un archivo desencadenante de origen, el uso de palabras clave de nombre de archivo no se resolverá correctamente en un nombre de archivo. Como solución alternativa, utilice una variable global configurada con un valor apropiado.

Ejemplos de Palabras Clave de Nombre de Archivo

  1. Un objetivo que utiliza el [date] y [time] variables de palabras clave para crear un nombre de archivo único cada vez que se utiliza el destino:

    objetivo de ejemplo 1

  2. Este ejemplo muestra cómo agregar al [date] y [time] variables de palabras clave del ejemplo anterior el archivo [file] y extensión [ext] de la fuente en el nombre del archivo creado:

    objetivo de ejemplo 2