Saltar al contenido

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:

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.

Consejo

Consulte la documentación de cada variable de Jitterbit para obtener información sobre qué variables se pueden configurar y en qué se pueden configurar.

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.

Advertencia

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

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.

Advertencia

Hay un problema conocido que variables de mapeo con puntos en el nombre de la variable no funcionan correctamente, lo que da como resultado una asignación de campo de destino incorrecta en la transformación. Hasta que se resuelva este problema, no se puede hacer referencia directa a las variables Jitterbit dentro de una transformación. Se pueden utilizar secuencias de comandos para crear un mecanismo alternativo para pasar valores.

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.

Advertencia

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

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.

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 utilizar puntos en el nombre de una variable si planea acceder a ellas con JavaScript. En su lugar, se recomienda crear variables Jitterbit que no contengan puntos y que utilicen guiones bajos en lugar de puntos. Consulte la información sobre variables globales, que también es aplicable a las variables Jitterbit.

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