Saltar al contenido

Variables de Jitterbit

Descripción General

Las variables Jitterbit 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 palabras clave de nombre de archivo) 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 Palabras clave del nombre de archivo, 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.

El caso de uso más común de las variables Jitterbit es leer una variable para poder recopilar información sobre lo que ocurrió durante una operación o recuperar información global como el nombre del archivo fuente actual. Otro caso de uso común es utilizar variables Jitterbit para cambiar la configuración predeterminada utilizada para procesar la cadena de operación.

Si una variable Jitterbit afecta la forma en que una función funciona, debe configurarse arriba en la cadena de la llamada a la función. Upstream operaciones o secuencias de comandos son aquellos que están vinculados dentro de una cadena de operación usando acciones de operación o el RunOperation o RunScript funciones. Upstream en este contexto también se refiere a cambiar el valor de la variable Jitterbit en el mismo secuencia de comandos, pero antes de la llamada a la función.

Si utiliza un agente privado, puede cambiar mediante programación el comportamiento de Jitterbit cambiando el valor predeterminado de una variable Jitterbit predefinida o creando y predefiniendo su propia variable Jitterbit.

Consulte estas páginas para obtener documentación sobre las variables Jitterbit predefinidas:

Visualización de Variables Jitterbit

Las variables Jitterbit se muestran en varios lugares:

  • En el editor de secuencia de comandos, las variables de Jitterbit se muestran en la paleta de componentes a la derecha dentro de la pestaña Variables en la subpestaña Variables de Jitterbit. Esta ubicación proporciona un fácil acceso para insertar referencias de variables Jitterbit en secuencias de comandos, incluso dentro de secuencias de comandos de transformación en modo secuencia de comandos.
  • En transformación modo de mapeo, las variables de Jitterbit se muestran dentro de la pestaña Variables a la izquierda en la categoría Variables de Jitterbit. Esta ubicación proporciona un fácil acceso para insertar referencias de variables Jitterbit durante el mapeo de transformación en el modo de mapeo.
  • En pantallas de configuración del extremo, Se puede acceder a las variables Jitterbit y usarlas en cualquier campo que tenga un ícono de variable ícono de variable. Como alternativa a seleccionar una variable Jitterbit, puede ingresar manualmente la referencia de la variable usando la sintaxis de corchetes estándar de Jitterbit Script.

Establecer Variables Jitterbit en Secuencias de Comandos o Transformaciones

Si bien el caso de uso más común de las variables Jitterbit es leer información, hay algunas variables Jitterbit que quizás quieras configurar para comunicar algo a un agente. En Cloud Studio, las variables Jitterbit se pueden configurar usando Jitterbit Script o JavaScript, de la misma manera que cualquier variable global se puede ajustar.

Sugerencia

Consulta la documentación de cada variable Jitterbit para obtener información sobre qué variables se pueden configurar y qué valores se pueden configurar.

Jitterbit Script

En Jitterbit Script utilizado dentro de secuencias de comandos y transformaciones, el valor de una variable Jitterbit se puede configurar comenzando con un signo de dólar $ o llamando al Set función.

  • $: Usando el signo de dólar $ sintaxis, $jitterbit.api.response="Success" establece la respuesta API (jitterbit.api.response) para devolver la cadena "Success" a la solicitud solicitante.
  • Set: Utilizando el Set función, Set("jitterbit.api.response", "Success") establece la respuesta API (jitterbit.api.response) para devolver la cadena "Success" a la solicitud solicitante.

Nota

Para las variables Jitterbit con un guion en su nombre, utilice el Get y Set funciones para recuperar y establecer sus valores. Por ejemplo: Set("jitterbit.target.http.response.header.X-Jitterbit-Authorization", $authorization).

En secuencias de comandos y transformaciones, las variables de Jitterbit también se muestran en la pestaña Variables de la paleta de componentes de secuencias de comandos, dentro de la subpestaña Variables de Jitterbit. Consulte Agregar una variable Jitterbit a un secuencia de comandos abajo.

JavaScript

En JavaScript utilizado dentro de secuencias de comandos creado como un componente de proyecto, las variables Jitterbit predefinidas por Jitterbit solo se pueden configurar con el Jitterbit.SetVar función. Esto se debe a que todas las variables Jitterbit predefinidas por Jitterbit contienen puntos dentro del nombre de la variable.

  • Jitterbit.SetVar: Usando Jitterbit.SetVar, el ejemplo de código Jitterbit.SetVar("$jitterbit.api.response", "Success") establece la respuesta API para devolver la cadena "Success" a la solicitud solicitante.

Advertencia

El código JavaScript Jitterbit.SetVar y Jitterbit.GetVar las funciones están diseñadas específicamente para acceder a las variables Jitterbit predefinidas. No deben utilizarse para acceder a las variables globales definidas por el usuario.

En JavaScript, no mezcle ni combine el uso de SetVar (y GetVar) con $-prefacio al configurar (y recuperar) una variable. Utilice sólo una sintaxis. Mezclar dos sintaxis diferentes para la misma variable puede causar problemas en tiempo de ejecución.

En secuencias de comandos y transformaciones, las variables de Jitterbit también se muestran en la pestaña Variables de la paleta de componentes de secuencias de comandos, dentro de la subpestaña Variables de Jitterbit. Consulte Agregar una variable Jitterbit a un secuencia de comandos abajo.

Recuperar Variables Jitterbit en un Secuencia de Comandos o Transformación

El valor de una variable Jitterbit se puede devolver usando Jitterbit Script (en secuencias de comandos o transformaciones) o usando JavaScript (solo en secuencias de comandos creados como componente del proyecto) de la misma manera una variable global se puede recuperar.

Jitterbit Script

En secuencias de comandos y transformaciones, puedes comenzar con un signo de dólar $ o utiliza el Get función para recuperar el valor de una variable Jitterbit:

  • $: Con el prefijo signo de dólar $, el ejemplo de código $jitterbit.operation.error recupera el valor de la variable Jitterbit "jitterbit.operation.error".
  • Get: Utilizando el Get función, el ejemplo de código Get("jitterbit.operation.error") devuelve el mismo valor.

Nota

Para las variables Jitterbit con un guion en su nombre, utilice el Get y Set funciones para recuperar y establecer sus valores. Por ejemplo: Get("jitterbit.target.http.response.header.X-Jitterbit-Authorization").

En secuencias de comandos y transformaciones, las variables de Jitterbit también se muestran en la pestaña Variables de la paleta de componentes de secuencias de comandos, dentro de la subpestaña Variables de Jitterbit. Consulte Agregar una variable Jitterbit a un secuencia de comandos abajo.

JavaScript

En JavaScript secuencias de comandos dentro de una operación, solo se puede acceder a las variables Jitterbit predefinidas por Jitterbit con el Jitterbit.SetVar y Jitterbit.GetVar funciones. Esto se debe a que todas las variables Jitterbit predefinidas por Jitterbit contienen puntos dentro del nombre de la variable.

  • Jitterbit.GetVar: Usando Jitterbit.GetVar, el ejemplo de código Jitterbit.GetVar("$jitterbit.operation.error") devuelve el valor de la variable Jitterbit llamada "jitterbit.operation.error". Tenga en cuenta que el signo de dólar inicial $ es opcional antes del nombre cuando se recuperan valores. Los nombres jitterbit.operation.name y $jitterbit.operation.name son equivalentes al recuperar valores.

En secuencias de comandos y transformaciones, las variables de Jitterbit también se muestran en la pestaña Variables de la paleta de componentes de secuencias de comandos, dentro de la subpestaña Variables de Jitterbit. Consulte Agregar una variable Jitterbit a un secuencia de comandos abajo.

Advertencia

El código JavaScript Jitterbit.SetVar y Jitterbit.GetVar las funciones están diseñadas específicamente para acceder a las variables Jitterbit predefinidas. No deben utilizarse para acceder a las variables globales definidas por el usuario.

En JavaScript, no mezcle ni combine el uso de SetVar (y GetVar) con $-prefacio al configurar (y recuperar) una variable. Utilice sólo una sintaxis. Mezclar dos sintaxis diferentes para la misma variable puede causar problemas en tiempo de ejecución.

Agregar una Variable Jitterbit a un Secuencia de Comandos

Ya sea en Jitterbit Script o JavaScript utilizado dentro de secuencias de comandos creadas dentro de una operación, las variables de Jitterbit se muestran en la pestaña Variables de la paleta de componentes, dentro de la subpestaña Variables de Jitterbit:

variables de jitterbit

Para agregar la sintaxis de la variable a un secuencia de comandos (Jitterbit Script o JavaScript), utilice uno de estos métodos:

  • Arrastre la variable desde la paleta al secuencia de comandos para insertar la sintaxis de la variable.
  • Haga doble clic en la variable en la paleta para insertar la sintaxis de la variable en la ubicación del cursor dentro del secuencia de comandos.
  • Comience a escribir el nombre de la variable y luego presione Control+Space para mostrar una lista de sugerencias de autocompletado. Seleccione una variable para insertar la sintaxis de la variable.
  • Ingrese manualmente la sintaxis de la variable.

Utilizar Variables Jitterbit en las Pantallas de Configuración

Durante la configuración de varios componentes del proyecto, incluida la configuración del extremo usando conectores, puede utilizar variables Jitterbit en cualquier campo que tenga un ícono de variable ícono de variable. Las variables se pueden utilizar en campos junto con otras entradas, incluso con otras variables o palabras clave. Estas acciones se describen a continuación:

Seleccionar una Variable Jitterbit

Para acceder a las variables de Jitterbit, puede hacer clic en el ícono de variable ícono de variable o introduzca un corchete abierto [ para mostrar una lista de variables y palabras clave (si están disponibles para el campo actual).

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

  • nombre_archivo_palabra_clave para la palabra clave del nombre de archivo
  • palabra clave del nombre de archivo para la variable global
  • variable del proyecto para la variable del proyecto
  • Variable Jitterbit para la variable Jitterbit

En la lista, pase el cursor sobre el nombre de la variable para obtener una vista previa de la información sobre ella:

FTP escribir nombres de archivos seleccionar variable

El Valor y la Descripción que aparecen en la ventana emergente de información siempre están vacíos para una variable Jitterbit. Para obtener una descripción de cómo se utiliza cada variable, consulte las páginas de este tema.

No se puede definir un valor predeterminado para una variable Jitterbit en un campo de configuración. En su lugar, puede establecer valores para ciertas variables Jitterbit en un secuencia de comandos para evaluarlos en tiempo de ejecución.

Seleccione una variable 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:

Pastilla de escritura de nombres de archivos FTP

Para revisar información sobre la variable, coloque el cursor sobre la píldora de la variable:

FTP escribir nombres de archivos al pasar el cursor

Alternar Formatos Entre Píldora y Texto

Para cambiar el formato de píldora variable predeterminado a formato de texto, haga clic en el ícono de contracción icono de contracción:

FTP escribir nombres de archivos colapso de la píldora

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

FTP escribe texto de nombres de archivos

Para cambiar de un formato de texto a un 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 Variable

Para eliminar la variable, haga clic en el ícono de eliminar icono de cerrar:

FTP escribir nombres de archivos eliminar píldora

Tutoriales Variables Jitterbit

Esta sección incluye detalles sobre el uso de variables Jitterbit en proyectos.

Crear Nuevas Variables o Establecer Valores Predeterminados en Agentes Privados

Quienes utilicen agentes privados pueden cambiar programáticamente el comportamiento predeterminado de las variables Jitterbit, así como crear nuevas variables Jitterbit a través del archivo de configuración del agente privado. Sin embargo, tenga en cuenta que esto se utiliza solo en casos de uso excepcionales implementados por usuarios avanzados. La mayoría de los casos de uso se pueden manejar creando una variable de proyecto en lugar de una variable Jitterbit.

El cambio de valores predeterminados o la creación de nuevas variables Jitterbit se realiza desde estas secciones del archivo de configuración del agente privado:

  • [PredefinedGlobalVariables]
    Verificar o cambiar los valores predeterminados de las variables Jitterbit.

  • [PredefinedServerGlobalDataElement]
    Define tus propias variables Jitterbit personalizadas y valores predeterminados.

Los nombres de las variables Jitterbit pueden estar compuestos por estos caracteres: letras (a-z, A-Z), números (0-9), puntos y guiones bajos. No se recomiendan otros caracteres, ya que pueden causar problemas.

Nota

Al actualizar un agente privado, el archivo de configuración se conserva y no se sobrescribe con la última versión.

Advertencia

Al crear nuevas variables Jitterbit, no se recomienda utilizar puntos en el nombre de una variable si planea acceder a ellas con JavaScript. En su lugar, se recomienda crear variables Jitterbit que no contengan puntos y que utilicen guiones bajos en lugar de puntos. Consulte la información sobre variables globales, que también se aplica a las variables Jitterbit.

Para obtener más información sobre cómo editar o crear variables Jitterbit, consulte Editar el archivo de configuración (jitterbit.conf).