Variables globales

Introducción

Las variables globales 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 Jitterbit y palabras clave de nombre de archivo) también están disponibles globalmente en todo el proyecto. Se configuran de forma diferente, como se describe en Variables de proyecto, Variables de Jitterbit, 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 cuando se los compara con los de todos los demás elementos de datos globales.

Las variables globales se declaran primero en una operación, después de lo cual quedan disponibles para ser referenciadas en la misma operación o en operaciones abajo en la cadena y secuencias de comandos. Las operaciones o secuencias de comandos posteriores son aquellos que están vinculados dentro de una cadena de operación utilizando acciones de operación o el RunOperation o RunScript funciones. Las operaciones posteriores pueden estar dentro del mismo flujo de trabajo o en flujos de trabajo abajo en la cadena.

Las variables globales también se pueden utilizar como origen o destino dentro de la operación como se describe en Lectura de variables y Escritura de variable.

Es posible que desee utilizar variables globales si su caso de uso implica compartir información con partes posteriores de una cadena de operación, como en estos ejemplos:

• Utilizar valores creados en una transformación en una transformación posterior. Por ejemplo, puede ser necesario un ID de sesión (obtenido de un servicio web de inicio de sesión) al llamar a servicios web posteriores para la autenticación.
• Utilizar un valor creado en una parte de una transformación en una etapa posterior de esa misma transformación. Por ejemplo, se puede inicializar e incrementar un número de registro para cada registro insertado en un destino a fin de identificar su número de elemento.
• Utilizar un valor devuelto en una transformación en la configuración de componentes en operaciones posteriores. Por ejemplo, la configuración de URL devuelta por una transformación se puede utilizar para configurar la URL del servicio web de una llamada de servicio web posterior.

Las variables globales pasan a través de operaciones encadenadas. Estas incluyen operaciones que están vinculadas a una operación anterior dentro de la cadena de operación mediante acciones de operación "en caso de éxito" o "en caso de error", así como aquellos que se vinculan a través de la RunOperation función. Las variables globales también se pueden utilizar dentro de la misma transformación.

Visualización de variables globales

Las variables globales definidas se muestran en varios lugares:

• En el panel del proyecto, las variables globales se muestran en la pestaña Componentes en la categoría Variables globales. Desde aquí, puede ver si se hace referencia a la variable global en otra parte del proyecto y ver las dependencias.
• En el editor de secuencia de comandos, las variables globales se muestran en la paleta de componentes de secuencias de comandos dentro de la pestaña Variables en la subpestaña Variables globales. Esta ubicación proporciona un acceso fácil para insertar referencias de variables globales 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 globales se muestran dentro de la pestaña Variables a la izquierda, en la categoría Variables globales. Esta ubicación proporciona un acceso fácil para insertar referencias de variables globales durante el mapeo de transformación en el modo de mapeo.
• En pantallas de configuración de extremo, se puede acceder a las variables globales y usarlas en cualquier campo que tenga una icono de variable. Como alternativa a la selección de una variable global, puede ingresar manualmente la referencia de la variable utilizando la sintaxis de corchetes estándar de Jitterbit Script.

Crear y actualizar variables globales

Las variables globales se crean o actualizan utilizando Jitterbit Script (en secuencias de comandos y transformaciones) o JavaScript (solo en secuencias de comandos creados como un componente del proyecto). Vea Tipos de Secuencia de comandos y creación para obtener información sobre la creación de los diferentes tipos de secuencias de comandos. Las variables globales configuradas en una conexión de variable se crean o actualizan automáticamente (consulte Conexión de variable).

Nombres de variables globales

Los nombres de las variables globales pueden estar compuestos de caracteres alfanuméricos (las letras a-z y A-Z, y los dígitos 0-9), puntos (.) y guiones bajos (_). (No se recomiendan otros caracteres, como los guiones, ya que pueden causar problemas). Los nombres de las variables globales no distinguen entre mayúsculas y minúsculas; una variable denominada GlobalVar se trata igual que globalvar.

Es una buena práctica utilizar puntos o guiones bajos al definir variables globales para que sean fáciles de encontrar. Por ejemplo, una variable global creada en un Jitterbit Script llamado org.account.filename comienza con org, seguido de account, etc., organizándolo de manera efectiva cuando se encuentra en una lista entre otras variables globales construidas de manera similar. Tenga en cuenta que para las variables globales creadas en JavaScript (o para las variables globales de Jitterbit Script que podrían usarse más adelante en JavaScript) recomendamos usar guiones bajos en lugar de puntos. El uso de puntos en las variables globales definidas por el usuario causa problemas en tiempo de ejecución. Se proporciona más información en JavaScript subsección siguiente.

Jitterbit Script

En Jitterbit Script se utiliza dentro de secuencias de comandos y transformaciones, una variable global se puede definir comenzando con un signo de dólar $ o llamando al Set función:

• $: Usando el signo de dólar $ sintaxis, $ServerURL=URL crea o actualiza una variable global llamada ServerURL con el valor de URL (el nombre de otra variable o el nombre de un campo en una transformación).
• Set: Usando el Set función, Set("ServerURL", URL) crea o actualiza una variable global llamada ServerURL con el valor de URL (el nombre de otra variable o el nombre de un campo en una transformación).

JavaScript

En JavaScript se utiliza dentro de secuencias de comandos creada como un componente de proyecto, la sintaxis utilizada para configurar una variable global depende de si el nombre de la variable global contiene un punto:

• El nombre no incluye un punto (recomendado): Una variable global que no contiene un punto en su nombre se puede crear o actualizar utilizando var $<name>o actualizado simplemente usando $<name> sin var:

  • var $: La expresión var $ServerURL="https://www.example.com/"crea o actualiza una variable global ServerURL con un valor de cadena de https://www.example.com/ Una nueva variable global debe preceder a la $ con var.
  • $: La expresión $ServerURL="https://www.example.com/" actualiza la misma variable global ServerURL con la misma cadena URL. Esto funciona solo para variables globales que ya existen.

• El nombre incluye un punto (recomendado solo para variables Jitterbit y valores de objetos JavaScript): Una variable que contiene puntos en su nombre se puede actualizar o recuperar en JavaScript solo con el Jitterbit.SetVar y Jitterbit.GetVar funciones. Como estas funciones no están pensadas para variables globales definidas por el usuario, consulte Variables Jitterbit para más información.

  Advertencia

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

Extremo variable

Durante la configuración de una Conexión variable, se puede crear o actualizar automáticamente una variable global.

Es decir, si durante la configuración se proporciona el nombre de una variable que aún no existe, se crea automáticamente una variable global. Si se proporciona el nombre de una variable global que ya existe, esta se asocia al extremo Variable.

Para obtener detalles sobre cómo crear o actualizar una variable global utilizando este método, consulte Conexión de variable.

Recuperar variables globales en secuencias de comandos o transformaciones

El valor de una variable global se puede devolver utilizando Jitterbit Script (en secuencias de comandos o transformaciones) o usando JavaScript (sólo en secuencias de comandos creados como componente del proyecto).

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 global:

• $: Con el prefijo signo de dólar $, el ejemplo de código $serverURL recupera el valor (o campo en una transformación) de la variable global llamada "serverURL".
• Get: Usando el Get función, el ejemplo de código Get("serverURL") devuelve el mismo valor (o campo en una transformación).

En secuencias de comandos y transformaciones, las variables globales existentes también se muestran en la pestaña Variables de la paleta de componentes de secuencias de comandos dentro de la subpestaña Variables globales. Consulte Agregar una variable global a un secuencia de comandos abajo.

JavaScript

En JavaScript secuencias de comandos dentro de una operación, la sintaxis utilizada para recuperar el valor de una variable global depende de si el nombre de la variable global contiene un punto.

• El nombre no incluye un punto (recomendado): El valor de una variable global que no contiene un punto en su nombre se puede recuperar comenzando con un signo de dólar $. Con el prefijo del signo de dólar $, la expresión $ServerURL recupera el valor de la variable global llamada ServerURL.

• Nombre con puntos (recomendado solo para variables Jitterbit y valores de objetos JavaScript): Una variable que contiene un punto en su nombre se puede actualizar o recuperar en JavaScript solo con el Jitterbit.SetVar y Jitterbit.GetVar funciones. Como estas funciones no están pensadas para variables globales definidas por el usuario, consulte la sección sobre Variables Jitterbit para más información.

  Advertencia

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

  En JavaScript, no mezcle y combine el uso de SetVar (y GetVar) con $-Prefijo al configurar (y recuperar) una variable. Utilice solo una sintaxis. Mezclar dos sintaxis diferentes para la misma variable puede causar problemas en tiempo de ejecución.

  Si un JavaScript falla, se pierden todos los cambios realizados en el valor de una variable global. Solo si el JavaScript se completa correctamente, los valores de las variables globales modificados estarán disponibles fuera del secuencia de comandos.

En secuencias de comandos y transformaciones, las variables globales existentes también se muestran en la pestaña Variables de la paleta de componentes de secuencias de comandos dentro de la subpestaña Variables globales. Consulte Agregar una variable global a un secuencia de comandos abajo.

Agregar una variable global a un secuencia de comandos

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

Para agregar la sintaxis 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 globales en las pantallas de configuración

Durante la configuración de varios componentes del proyecto, incluida la configuración del extremo mediante conectores, puede utilizar variables globales en cualquier campo que tenga una icono de variable. Las variables se pueden utilizar en campos junto con otros datos de entrada, incluso con otras variables o palabras clave. Estas acciones se describen a continuación:

• Seleccionar una variable global
• Alternar formatos entre píldora y texto
• Definir un valor predeterminado
• Eliminar una variable

Seleccione una variable global

Para acceder a las variables globales, puede hacer clic en el botón icono de variable o ingrese un corchete abierto [ para mostrar una lista de variables y palabras clave (si están disponibles para el campo actual).

Dentro de la lista, cada 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:

La Descripción en la ventana emergente de información es [Ninguna] para una variable global. Un Valor se completa solo si la variable global tiene un valor predeterminado especificado en este campo de configuración.

El fondo del ícono es sólido si la variable global tiene un valor predeterminado especificado en este campo de configuración, o está vacío si no lo tiene. El fondo del ícono no se ve afectado si la misma variable global tiene un valor especificado en otro campo de configuración, ya que solo se utiliza un valor predeterminado que esté especificado en el campo actual.

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 la información sobre la variable, pase el cursor sobre el icono 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 botón icono de colapso:

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

En formato de texto, puedes definir un valor predeterminado.

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.

Definir un valor predeterminado

En el tiempo de ejecución de la operación, un valor predeterminado definido dentro de un campo de configuración, como se muestra a continuación, se utiliza solo si el valor de la variable no se ha establecido durante el tiempo de ejecución. Esto es diferente durante la prueba de secuencia de comandos, donde —como aún no se habrán instanciado los valores del secuencia de comandos arriba en la cadena se utiliza en su lugar cualquier valor predeterminado definido dentro de un campo de configuración.

Para definir un valor predeterminado dentro de un campo de configuración, primero cambie al formato de texto.

Inmediatamente después del nombre de la variable global dentro de los corchetes [ ], especifique el valor predeterminado entre llaves { }:

Cuando se especifican valores predeterminados, se utiliza el valor de la variable global si está definida; de lo contrario, se utiliza el valor predeterminado.

Si no desea que se interprete la variable global, utilice una barra invertida \ para escapar del conjunto de corchetes [ ].

Por ejemplo, lo siguiente no utiliza el valor de serverURL incluso si está definido, pero en su lugar siempre se utiliza http://server/index.asp:

\[serverURL{http://server/index.asp}]

Eliminar una variable

Para eliminar la variable, haga clic en el botón eliminar icono:

Ver dependencias de variables globales

Las dependencias de una variable global son otros componentes que dependen de la variable porque leen desde la variable global o escriben en ella. Una vez que se ha creado y utilizado una variable global en un proyecto, puede ver estas dependencias.

Después de crear una variable global, la opción Ver dependencias está disponible en la pestaña Componentes del panel del proyecto (consulte menú de acciones de componentes en la pestañaComponentes del panel Proyecto). La opción Ver dependencias cambia la vista en el panel del proyecto para mostrar otras partes del proyecto de las que depende la variable global.

En la vista de dependencia, el nombre de la variable global seleccionada aparece en la parte superior, debajo de las capacidades de búsqueda y filtrado existentes. El nombre de la variable global va seguido de una lista de Dependencias de las que depende la variable. Esta lista está organizada por categorías como Actividad y Secuencia de comandos y, además, se clasifica en Lectura o Escritura para indicar el tipo de acceso de una referencia de variable en particular:

Por ejemplo:

• Si un secuencia de comandos contiene $myVar1='abc', está escribiendo un valor en la variable y haciendo referencia myVar1 para acceso de escritura.
• Si un secuencia de comandos contiene $myVar2=$myVar1, se refiere a myVar2 para acceso de escritura y myVar1 para acceso de lectura.
• Si un secuencia de comandos contiene If(myVar1=='abc', TRUE, FALSE), se refiere a myVar1 para acceso de lectura.

Tutoriales variables globales

Consulte estas secciones para obtener detalles sobre el uso de variables globales en proyectos:

• Convertir una variable global en una variable de proyecto
• Comprobar si hay valores nulos o indefinidos
• Establecer y acceder a variables de matriz

Convertir una variable global en una variable de proyecto

Puede convertir una variable global ya existente en una variable de proyecto.

Las variables globales se pueden convertir en variables de proyecto durante la configuración de variables de proyecto. Al configurar una variable de proyecto, ingrese el nombre de una variable global existente en el campo de nombre. Al intentar guardar, un mensaje le solicitará que confirme que desea convertir la variable global en una variable de proyecto:

Al hacer clic en Continuar, todas las referencias y dependencias de la variable global se transfieren a la variable del proyecto. Esto incluye las referencias a la variable global anterior dentro de los secuencias de comandos, que ahora hacen referencia a la variable del proyecto. (Tenga en cuenta que un valor para una variable del proyecto establecido en un secuencia de comandos durante la ejecución de la cadena de operación anula el valor predeterminado especificado en la configuración de la variable del proyecto).

Para obtener más detalles sobre las variables del proyecto, consulte Variables del proyecto.

Comprobar valores nulos o indefinidos

Una variable global que no ha sido definida tiene un valor nulo.

Por ejemplo, IsNull(Get("GlobalVariableName"))devuelve verdadero si una variable global con el nombre GlobalVariableName aún no se ha definido. Esto se puede utilizar para comprobar si se ha definido o no una variable global.

Establecer y acceder a variables de matriz

Puede crear matrices de variables globales, también conocidas como variables de matriz. Consulte Matrices para obtener información sobre cómo configurar y recuperar valores de variables de matriz.