Variables de Jitterbit en Integration Studio

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 el proyecto. Se configuran de forma diferente, como se describe en Variables de 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 cuando se los compara con los de 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 para obtener información global, como el nombre del archivo de origen actual. Otro caso de uso común es usar variables Jitterbit para cambiar las configuraciones predeterminadas que se usan 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 de función. Upstream operaciones o secuencias de comandos son aquellos que están vinculados dentro de una cadena de operación utilizando acciones de operación o el RunOperation o RunScript funciones. En este contexto, "upstream" 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 usa un agente privado, puede cambiar programáticamente 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:

• Variables Jitterbit de la API
• Variables Jitterbit de NetSuite
• Variables de operación Jitterbit
• Creación de scripts para variables Jitterbit
• Variables de jitterbit de SFDC
• Variables de Jitterbit de origen
• Variables de Jitterbit de destino
• Variables de Jitterbit de texto
• Variables de Jitterbit de Transformación
• Variables de Jitterbit del servicio web
• Variables de Jitterbit diversas

Visualización de variables Jitterbit

Las variables Jitterbit se muestran en varios lugares:

• En el editor de secuencia de comandos, Las variables Jitterbit se muestran en la paleta de componentes a la derecha, dentro de la pestaña Variables, en la subpestaña Variables Jitterbit. Esta ubicación proporciona un acceso fácil 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 Jitterbit se muestran dentro de la pestaña Variables a la izquierda en la categoría Variables Jitterbit. Esta ubicación proporciona un acceso fácil para insertar referencias de variables Jitterbit durante el mapeo de transformación en el modo de mapeo.
• En pantallas de configuración de extremo, se puede acceder a las variables Jitterbit y usarlas en cualquier campo que tenga una Icono de variable. Como alternativa a la selección de una variable de Jitterbit, puede ingresar manualmente la referencia de la variable utilizando 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 para las variables Jitterbit es leer información, existen algunas variables Jitterbit que puede que desee configurar para comunicar algo a un agente. Integration Studio Las variables Jitterbit se pueden configurar usando Jitterbit Script o JavaScript, de la misma manera que cualquier variable global se puede configurar.

Jitterbit Script

En Jitterbit Script se utiliza 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 de la API (jitterbit.api.response) para devolver la cadena "Success" a la solicitud solicitante.
• Set: Usando el Set función, Set("jitterbit.api.response", "Success") Establece la respuesta de la API (jitterbit.api.response) para devolver la cadena "Success" a la solicitud solicitante.

En secuencias de comandos y transformaciones, Las variables 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 Jitterbit. Consulte Agregar una variable Jitterbit a un secuencia de comandos abajo.

JavaScript

En JavaScript se utiliza 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 de la API para devolver la cadena "Success" a la solicitud solicitante.

En secuencias de comandos y transformaciones, Las variables 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 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 utilizando Jitterbit Script (en secuencias de comandos o transformaciones) o usando JavaScript (sólo en secuencias de comandos creados como un 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: Usando el Get función, el ejemplo de código Get("jitterbit.operation.error") devuelve el mismo valor.

En secuencias de comandos y transformaciones, Las variables 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 Jitterbit. Consulte Agregar una variable Jitterbit a un secuencia de comandos abajo.

JavaScript

En JavaScript secuencias de comandos dentro de una operación, las variables Jitterbit predefinidas por Jitterbit solo se pueden acceder 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 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 Jitterbit. Consulte Agregar una variable Jitterbit a un secuencia de comandos abajo.

Agregar una variable Jitterbit a un secuencia de comandos

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

Para agregar la sintaxis 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 mediante conectores, puede utilizar variables Jitterbit en cualquier campo que tenga una Icono 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
• Alternar formatos entre píldora y texto
• Eliminar una variable

Seleccionar una variable Jitterbit

Para acceder a las variables de Jitterbit, puede hacer clic en el icono icono de variable o ingrese 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:

• para la palabra clave del nombre de archivo
• para la variable global
• para la variable del proyecto
• 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:

Los valores Valor y 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 es posible definir un valor predeterminado para una variable Jitterbit en un campo de configuración. En su lugar, se pueden establecer valores para determinadas variables Jitterbit en un secuencia de comandos para que se evalúen 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:

Para revisar la información sobre la variable, pase el cursor sobre el icono de la variable:

Alternar formatos entre píldora y texto

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

Esto cambia 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 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 botón eliminar icono:

Tutoriales la variable 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.

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