Variables de Jitterbit¶

Descripción General¶

Las variables de 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 un proyecto. Se configuran de manera diferente, como se describe en Variables globales y Variables del proyecto.)

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

Los casos de uso más comunes de las variables Jitterbit son 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. Con menos frecuencia, se escriben variables Jitterbit al 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 mediante 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.

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 de Jitterbit API
• Variables de Jitterbit de Extremo alojado
• Variables Jitterbit de NetSuite
• Variables de Jitterbit de operación
• Secuencias de comandos de variables Jitterbit
• Variables de Jitterbit SFDC
• Variables Jitterbit de origen
• Variables de Jitterbit objetivo
• Variables de Jitterbit de texto
• Variables Jitterbit de Transformación
• Variables Jitterbit del servicio web
• Varias variables de Jitterbit

Visualización de Variables Jitterbit¶

Al diseñar su proyecto, las variables Jitterbit están disponibles en la pestaña Elementos de datos del generador de secuencia de comandos, accesible desde las pantallas de secuencias de comandos y transformaciones. Cada variable de Jitterbit predefinida por Jitterbit está documentada 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 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 se puede configurar cualquier variable global.

Jitterbit Script¶

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

• $: Usando el signo del 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.

En secuencias de comandos y transformaciones, las variables de 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 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 del proyecto, las variables Jitterbit predefinidas por Jitterbit se pueden configurar solo con el Jitterbit.SetVar() función. Esto se debe a que todas las variables de 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.

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

En JavaScript, no mezcle y combine su 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.

Recuperar Variables Jitterbit en Secuencias de Comandos o Transformaciones¶

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 utilizar 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: Utilizando 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 de 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 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 de 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 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 JavaScript, no mezcle y combine su 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 mostrarán 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.

Utilice Variables Jitterbit en Pantallas de Definición¶

En una pantalla de definición (durante la configuración de fuentes o destinos), puede hacer referencia a 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, entonces puede hacer referencia a ella usando corchetes como [jitterbit.source.filename].

Cree Nuevas Variables o Establezca Valores Predeterminados en Agentes Privados¶

Aquellos que usan Agentes Privados pueden cambiar mediante programación 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 sólo en casos de uso poco comunes 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.

Cambiar los valores predeterminados o crear nuevas variables Jitterbit se realiza desde estas secciones del archivo de configuración del Agente Privado:

• [PredefinedGlobalVariables]
  Verifique o cambie los valores predeterminados para las variables Jitterbit.

• [PredefinedServerGlobalDataElement]
  Defina sus 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 y 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).