Consulta los conectores compatibles con Application Integration.

Variables

Una variable es un elemento de integración que conserva y transporta datos entre las tareas, los activadores y los bordes de una integración.

  • Las variables se pueden definir de forma estática en el momento del diseño o se pueden pasar de forma dinámica a la integración en el entorno de ejecución.
  • Las variables pueden hacer referencia a otras variables en una integración.
  • Todas las tareas pueden acceder a las variables de manera global o acceder a una tarea específica de forma local.

Hay tres tipos de variables disponibles:

Variables de integración

Las variables de integración son similares a las variables que se usan en un lenguaje de programación. Los datos en las variables se pueden leer y escribir durante la ejecución de la integración.

Las variables de integración se pueden usar de las siguientes maneras:

  • Se toman como entradas a la integración (variables de entrada).
  • Se muestran como resultados de la integración (variables de salida).
  • Se usa para mantener el estado temporal durante la ejecución de una integración.

El valor de una variable no se debe definir de forma estática en la integración. Los valores de las variables se pueden pasar a una integración mediante un activador. Sin embargo, si una variable está definida de manera estática en la integración y la misma variable se proporciona de forma dinámica con el activador, la asignación de valor dinámico reemplazará la asignación estática.

Tipos de datos admitidos para las variables de integración

Los siguientes tipos de datos son compatibles con las variables de integración:

  • String y array de strings
  • Números enteros y array de números enteros
  • Doble y array doble
  • Booleano y array booleano
  • JSON

Referencias de variables

Las tareas, los activadores y los bordes de una integración leen y escriben en variables mediante referencias de variables. Una referencia de variable toma el formato $paramKey$, en el que paramKey es el nombre de la variable. Por ejemplo, un condicional de borde podría verse de la siguiente manera:

NOT ($isNameUnique$ = false OR $numAccounts$ > 1)

En este ejemplo, isNameUnique es una variable del tipo de datos booleano y numAccounts es un parámetro del tipo de datos de número entero.

Variables de tarea

Las variables de tarea son variables predefinidas que se generan automáticamente de una tarea. Si una tarea tiene un resultado, todos estos resultados estarán disponibles en una variable de tarea. No puedes borrar o editar una variable de tarea. Por ejemplo, en la tarea Extremo de llamada de REST, el cuerpo de la respuesta se almacena en la variable responseBody.

Variables de configuración

Las variables de configuración te permiten externalizar la configuración para la integración. Con las variables de configuración, puedes configurar aspectos de tu integración, como los detalles del conector, los detalles de autenticación o los extremos de URL que se basan en el entorno de desarrollo (QA, pruebas o producción). No es necesario que actualices tu integración de forma manual antes de subirla a un entorno nuevo. La integración de aplicaciones te permite ingresar valores para las variables de configuración cuando publicas la integración.

Si deseas obtener información para crear variables de configuración y usarlas, consulta el instructivo Compila CI/CD para tu integración.

Ver variables

Puedes usar el panel Variables para crear, editar, ver, duplicar y borrar variables en tu integración. En el panel Variables, también se muestra un recuento de las referencias de variables totales dentro de la integración.

Para ver el panel Variables, haz clic en (Panel de activación) en la barra de navegación del diseñador.

En la siguiente imagen, aparece un diseño de muestra del panel Variables:

Variables del diseñador de integraciones Variables del diseñador de integraciones

Crea una variable

Para crear un clúster, realiza los siguientes pasos:

  1. En la barra de navegación del editor de integración, haz clic en (Panel de activación) para abrir el panel Variables.
  2. Haz clic en +Crear.
  3. Haz lo siguiente en el panel Crear variable:
    1. Nombre: Ingresa el nombre de la variable.
    2. Tipo de variable: Elige el tipo de variable.
    3. Tipo de datos Descripción
      Ninguno Es una variable local en una integración.
      Variable de configuración para la integración Una variable de configuración en una integración
      Entrada para la integración Durante la ejecución, la variable se proporcionará como entrada al activador ejecutado.
      Resultado de la integración El valor final de la variable al final de la ejecución debe mostrarse al llamador de la integración.
      Entrada y salida de la integración Durante la ejecución, la variable se proporcionará como entrada al activador ejecutado y su valor final se enviará al llamador de la integración.
    4. Tipo de datos:elige el tipo de datos de la variable. Puedes identificar el tipo de datos de una variable con el ícono junto al nombre de la variable.
      Tipo de dato Ejemplo
      Cadena Alex
      Número entero 30
      Doble 30.5
      Booleano true
      JSON { "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
      Array de strings Alex, Kai, Raha
      Array de números enteros 30, 25, 22
      Array doble 30.5, 25.34, 22.134
      Array booleano true, false, false

      Para obtener información sobre los tipos de datos compatibles, consulta Tipos de datos compatibles.

    5. Valor predeterminado: Ingresa el valor predeterminado para la variable. Este paso es opcional,
    6. Esquema: Selecciona el esquema JSON para la variable.
      • Inferir de una carga útil JSON de muestra: genera un esquema JSON a partir de una carga útil JSON de muestra. La carga útil de muestra se descarta después de que se genera el esquema. Solo se guardará el esquema generado.
      • Ingresar un esquema JSON: ingresa manualmente un esquema JSON completo.
      • Inferir del valor predeterminado: genera un esquema JSON con el valor predeterminado proporcionado.
      • Ninguno: No hay esquema JSON.
    7. Enmascarar la variable en los registros (vista previa): Selecciona esta opción para habilitar el enmascaramiento de la variable en los registros de ejecución de integración. Para habilitar el enmascaramiento para la variable, debes habilitar las variables de enmascaramiento para tu integración y región. Si quieres obtener información para habilitar el enmascaramiento para la integración y la región, consulta Edita una integración y Edita regiones.

      Para obtener información sobre el enmascaramiento, consulta Enmascara datos sensibles en registros.

  4. Haz clic en Crear.

Usa datos variables en integraciones

Durante la ejecución de una integración, los datos de tiempo de ejecución se pasan como variables que se declaran para la integración o tarea. Una vez que comienza la ejecución, los datos de entrada se convierten en un objeto en la memoria llamado Event.

Después de crear el objeto Event, se compila un gráfico de tareas en la memoria con la definición de integración. Los valores de las variables entrantes se pasan a las tareas según tu configuración. A medida que se ejecuta la integración, las tareas leen y escriben datos en el objeto de Event para que las usen las tareas posteriores o para que formen los datos de salida de la integración.

Cuotas y límites

Para obtener información sobre las cuotas y los límites, consulta Cuotas y límites.

¿Qué sigue?