Variables de Jitterbit en Design Studio

Descripción general

Las variables Jitterbit son uno de los tres tipos de elementos de datos globales disponibles en Harmony. (Los otros dos tipos de elementos de datos globales, variables globales y variables de proyecto, también están disponibles globalmente en todo el proyecto. Se configuran de forma diferente, como se describe en Variables globales y Variables del proyecto.)

Las variables de Jitterbit siempre están disponibles en todo el proyecto. Están predefinidas por Jitterbit o configuradas en el archivo de configuración de Jitterbit.

Los casos de uso más comunes para las variables Jitterbit son 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. Con menor frecuencia, se escriben variables Jitterbit al cambiar las configuraciones predeterminadas utilizadas 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 mediante acciones de operación o 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.

Como estas variables son variables predefinidas, los proyectos rara vez crean o cambian el valor predeterminado de una variable Jitterbit. Sin embargo, cuando se utiliza un agente privado, se pueden crear variables Jitterbit o modificar su valor predeterminado. Consulte Crear nuevas variables o establecer valores predeterminados en agentes privados a continuación para obtener más detalles.

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

• Variables Jitterbit de la API
• Variables Jitterbit del extremo alojado
• 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

Al diseñar su proyecto, las variables de Jitterbit están disponibles en la pestaña Elementos de datos del generador de secuencia de comandos, al que se puede acceder desde las pantallas de secuencias de comandos y transformaciones. Cada variable de Jitterbit predefinida por Jitterbit se documenta en una página en esta sección.

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 se puede configurar cualquier variable global.

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 los secuencias de comandos y transformaciones, las variables Jitterbit también se mostrarán en la pestaña Variables de la paleta de componentes de secuencias de comandos, dentro de la subpestaña Variables Jitterbit.

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 los secuencias de comandos y transformaciones, las variables Jitterbit también se mostrarán en la pestaña Variables de la paleta de componentes de secuencias de comandos, dentro de la subpestaña Variables Jitterbit.

En JavaScript, no debe combinar el uso de SetVar (y GetVar) con $-Presentar una variable antes de su configuración (y recuperación). Utilice una única sintaxis. Mezclar dos sintaxis diferentes para la misma variable puede causar problemas en tiempo de ejecución.

Recuperar variables Jitterbit en secuencias de comandos o transformaciones

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 los secuencias de comandos y transformaciones, las variables Jitterbit también se mostrarán en la pestaña Variables de la paleta de componentes de secuencias de comandos, dentro de la subpestaña Variables Jitterbit.

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 JavaScript, no debe combinar el uso de SetVar (y GetVar) con $-Presentar una variable antes de su configuración (y recuperación). Utilice una única sintaxis. Mezclar dos sintaxis diferentes para la misma variable puede causar problemas en tiempo de ejecución.

En los secuencias de comandos y transformaciones, las variables Jitterbit también se mostrarán en la pestaña Variables de la paleta de componentes de secuencias de comandos, dentro de la subpestaña Variables Jitterbit.

Utilizar variables Jitterbit en las pantallas de definición

En una pantalla de definición (durante la configuración de fuentes o destinos), puede hacer referencia a las variables Jitterbit utilizando el [JitterbitVariableName] sintaxis.

Por ejemplo, si está utilizando la variable Jitterbit como parte de un nombre de archivo o como una propiedad de un objeto diferente que no está en un secuencia de comandos, puede hacer referencia a ella utilizando corchetes como [jitterbit.source.filename].

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