Variables de Jitterbit en Integration Studio

Descripción general

Las variables de jitterbit son uno de los tipos de elementos de datos globales disponibles en Harmony. Los demás 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 al compararlos con los de los demás elementos de datos globales.

El uso más común de las variables Jitterbit es leer una variable para recopilar información sobre lo ocurrido durante una operación o para obtener información global, como el nombre del archivo fuente actual. Otro uso común es usar 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. Operaciones anteriores 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 de Jitterbit de la API
• Variables de Jitterbit de NetSuite
• Variables de Jitterbit de la operación
• Scripting de variables de 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 Misceláneas

Visualización de variables de 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 facilita la inserción de referencias a variables de Jitterbit en secuencias de comandos, incluso en secuencias de comandos de transformación en modo secuencia de comandos .`/integration-studio/design/transformations/display-modes/script).
• En transformación modo de mapeo las variables de Jitterbit se muestran en la pestaña Variables, a la izquierda, en la categoría Variables de Jitterbit. Esta ubicación facilita la inserción de referencias a variables de 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 seleccionar una variable de Jitterbit, puede introducir manualmente la referencia de la variable utilizando la sintaxis estándar de corchetes de Jitterbit Script.

Establecer variables Jitterbit en secuencias de comandos o transformaciones

Si bien el uso más común de las variables Jitterbit es leer información, existen algunas variables Jitterbit que podrían ser útiles para comunicar información a un agente. En Integration Studio, las variables Jitterbit se pueden configurar mediante Jitterbit Script o JavaScript, de la misma manera que cualquier variable global se puede configurar.

Consejo

Consulta la documentación de cada variable de Jitterbit para obtener información sobre qué variables se pueden configurar y cómo se pueden 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.

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](/es/integration-studio/design/transformations/basics/`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 de Jitterbit a un secuencia de comandos abajo.

JavaScript

En JavaScript se utiliza dentro de secuencias de comandos creado como un componente del 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 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.

Advertencia

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

En JavaScript, no se debe mezclar el uso de SetVar (y GetVar) con $-Prefijo al establecer (y recuperar) una variable. Use solo una sintaxis. Mezclar dos sintaxis diferentes para la misma variable puede causar problemas en tiempo de ejecución.

En secuencias de comandos y [transformaciones](/es/integration-studio/design/transformations/basics/`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 de Jitterbit a un secuencia de comandos abajo.

Recuperar variables de 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 empezar con un signo de dólar $ o utiliza el Get Función para recuperar el valor de una variable Jitterbit:

• $: Con el prefijo de un 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.

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](/es/integration-studio/design/transformations/basics/`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 de 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 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 un signo de dólar inicial $ es opcional antes del nombre al recuperar valores. Los nombres jitterbit.operation.name y $jitterbit.operation.name son equivalentes al recuperar valores.

En secuencias de comandos y [transformaciones](/es/integration-studio/design/transformations/basics/`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 de Jitterbit a un secuencia de comandos abajo.

Advertencia

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

En JavaScript, no se debe mezclar el uso de SetVar (y GetVar) con $-Preceder al establecer (y recuperar) una variable. Use solo 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

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 su sintaxis.

Introduzca manualmente la sintaxis de la variable.

Utilice variables Jitterbit en las pantallas de configuración

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

• Seleccionar una variable de 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 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 icono 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 campos 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 del uso de 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, se pueden establecer valores para ciertas variables Jitterbit en un secuencia de comandos para que se evalúen en tiempo de ejecución.

Seleccione una variable para añadirla al campo donde se encuentre el 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 predeterminado de la píldora variable a formato de texto, haga clic en el icono icono de colapso:

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

Para cambiar del formato de texto al formato de píldora, desplace 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 icono 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 usan agentes privados pueden modificar programáticamente el comportamiento predeterminado de las variables de Jitterbit, así como crear nuevas variables de Jitterbit mediante el archivo de configuración del agente privado. Sin embargo, tenga en cuenta que esto se usa 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 recomienda el uso de otros caracteres, ya que podrían 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 usar puntos en el nombre de la variable si se planea acceder a ellas con JavaScript. En su lugar, se recomienda crear variables Jitterbit que no contengan puntos y que usen guiones bajos en lugar de puntos. Consulte la información sobre variables globales, lo cual también aplica a las variables Jitterbit.

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