Variables de Jitterbit¶

Descripción General¶

Las variables Jitterbit son uno de los tipos de elementos de datos globales disponibles en Harmony. Los otros 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 un proyecto. Se configuran de manera diferente, como se describe en Variables del 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 en comparación con todos los demás elementos de datos globales.

El caso de uso más común de las variables Jitterbit es 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. Otro caso de uso común es utilizar 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. Upstream operaciones o secuencias de comandos son aquellos que están vinculados dentro de una cadena de operación usando 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.

Si utiliza un agente privado, puede cambiar mediante programación 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 API Jitterbit
• Variables NetSuite Jitterbit
• 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 Jitterbit de Transformación
• Variables de Jitterbit del servicio web
• Variables de Jitterbit diversas

Visualización de Variables 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 proporciona un fácil acceso para insertar referencias de variables Jitterbit en secuencias de comandos, incluso dentro de secuencias de comandos de transformación en modo secuencia de comandos.
• En transformación modo de mapeo, las variables de Jitterbit se muestran dentro de la pestaña Variables a la izquierda en la categoría Variables de Jitterbit. Esta ubicación proporciona un fácil acceso para insertar referencias de variables Jitterbit durante el mapeo de transformación en el modo de mapeo.
• En pantallas de configuración del extremo, Se puede acceder a las variables Jitterbit y usarlas en cualquier campo que tenga un ícono de variable . Como alternativa a seleccionar una variable Jitterbit, puede ingresar manualmente la referencia de la variable usando la sintaxis de corchetes estándar de Jitterbit Script.

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

Jitterbit Script¶

En Jitterbit Script utilizado 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 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 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 Jitterbit a un secuencia de comandos abajo.

JavaScript¶

En JavaScript utilizado 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 API para devolver la cadena "Success" a la solicitud solicitante.

En secuencias de comandos y transformaciones, 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 Jitterbit a un secuencia de comandos abajo.

Recuperar Variables Jitterbit en un Secuencia de Comandos o Transformación¶

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 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: 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 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 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 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 secuencias de comandos y transformaciones, 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 Jitterbit a un secuencia de comandos abajo.

Agregar una Variable Jitterbit a un Secuencia de Comandos¶

Ya sea en Jitterbit Script o JavaScript utilizado dentro de secuencias de comandos creadas dentro de una operación, las variables de Jitterbit se muestran en la pestaña Variables de la paleta de componentes, dentro de la subpestaña Variables de Jitterbit:

Para agregar la sintaxis de la 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 la sintaxis de la variable.
• Ingrese manualmente la sintaxis de la variable.

Utilizar Variables Jitterbit en las Pantallas de Configuración¶

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

• Seleccionar una variable 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 ícono 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 ícono 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:

El Valor y la 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 de cómo se utiliza 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, puede establecer valores para ciertas variables Jitterbit en un secuencia de comandos para evaluarlos en tiempo de ejecución.

Seleccione una variable para agregarla al campo en la ubicación del 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 información sobre la variable, coloque el cursor sobre la píldora de la variable:

Alternar Formatos Entre Píldora y Texto¶

Para cambiar el formato de píldora variable predeterminado a formato de texto, haga clic en el ícono de contracción :

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

Para cambiar de un formato de texto a un formato de píldora, cambie 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 ícono de eliminar :

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