Variables de Jitterbit en Design Studio

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 el proyecto. Se configuran de forma diferente, como se describe en Variables globales y [Variables del proyecto](/es/design-studio/design-studio-reference/variables/project-variables`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 usos más comunes de las variables Jitterbit son la lectura de 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. Con menos frecuencia, se escriben en las 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. Operaciones anteriores 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.

Dado que estas variables son predefinidas, los proyectos rara vez crean o modifican el valor predeterminado de una variable Jitterbit. Sin embargo, al usar 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:

Visualización de variables de 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, accesible desde las pantallas de secuencias de comandos y transformaciones. Cada variable de Jitterbit predefinida por Jitterbit se documenta en una página de esta sección.

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

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.

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

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.

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

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.

Advertencia

Hay un problema conocido que variables de mapeo con puntos en el nombre de la variable no funcionan correctamente, lo que resulta en una asignación incorrecta del campo de destino en la transformación. Hasta que se resuelva este problema, no se podrá hacer referencia directa a las variables Jitterbit dentro de una transformación. Se puede usar scripting para crear un mecanismo alternativo para pasar valores.

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.

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

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

Utilice variables Jitterbit en las pantallas de definición

En una pantalla de definición (durante la configuración de orígenes o destinos), puede hacer referencia a las variables de Jitterbit mediante [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 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 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 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).