Consulta los conectores compatibles con Application Integration.

Variables

Una variable es un elemento de integración que contiene 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 tiempo de diseño o se pueden transferir de forma dinámica a la integración en tiempo de ejecución.
• Las variables pueden hacer referencia a otras variables de una integración.
• Las variables pueden ser accesibles de forma global para todas las tareas o de forma local para una tarea específica.

Tipos de variables

Application Integration admite cuatro tipos de variables:

• Variables de integración: hacen un seguimiento de los datos a lo largo de toda la ejecución de una integración.
• Variables de tarea: monitoriza los datos durante la duración de una sola tarea.
• Variables de configuración: almacenan los datos de configuración de la integración.
• Variables de sistema: almacenan los datos de configuración de la integración.

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 de las variables se pueden leer y escribir durante toda la ejecución de la integración.

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

• Se usan como entradas de la integración (variables de entrada).
• Se devuelven como salidas de la integración (variables de salida).
• Se usa para mantener el estado temporal durante la ejecución de una integración.
Nota: Los roles de las variables que se indican arriba no son mutuamente excluyentes. Cualquier variable puede ser una variable de entrada, una variable de salida, ambas o ninguna.

El valor de una variable no tiene que definirse de forma estática en la integración. Los valores de las variables se pueden transferir a una integración mediante un activador. Sin embargo, si una variable se define de forma estática en la integración y la misma variable se proporciona de forma dinámica con un activador, la asignación de valor dinámico sobrescribirá la asignación estática.

Tipos de datos admitidos

Se admiten los siguientes tipos de datos para las variables de integración:

• Cadena y array de cadenas
• Entero y matriz de enteros
• Doble y matriz doble
• Booleano y matriz booleana
• JSON

Variables de tarea

Las variables de tarea son variables predefinidas que se generan automáticamente en una tarea. Si una tarea tiene una salida, todas esas salidas están disponibles en una variable de tarea. No puedes eliminar ni editar una variable de tarea. Por ejemplo, en la tarea Llamar a un punto final REST, el cuerpo de la respuesta se almacena en la variable responseBody.

Variables de configuración

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Las variables config te permiten externalizar la configuración de 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 endpoints de URL que se basan en el entorno de desarrollo (QA, staging o producción). No es necesario que actualices tu integración manualmente antes de subirla a un nuevo entorno. Integración de aplicaciones te permite introducir valores para las variables de configuración cuando publicas la integración.

Para ver y editar las variables config definidas en su integración, haga clic en la variable_add Variable config de integración en el panel Variables. Para saber cómo crear variables de configuración y usarlas, consulta el tutorial Crea una integración de CICD.

Variables del sistema

Las variables del sistema se generan automáticamente al crear una integración. Puedes usar estas variables en tus tareas de integración y para la gestión de errores. La integración contiene las siguientes variables generadas por el sistema:

• ErrorInfo: si la ejecución falla, puedes acceder a los detalles del error con la variable ErrorInfo:

  {
    "ErrorInfo": {
    "message": String,
    "code": Number
    }
  }
  

  Actualmente, puede acceder a los mensajes de error creando una variable de integración llamada ErrorMessage. Sin embargo, te recomendamos que uses la variable ErrorInfo.message generada por el sistema para acceder a los mensajes de error.

• ExecutionMode: el modo de ejecución basado en el activador. Los valores válidos son SYNC y ASYNC.
• ExecutionId: ID de ejecución de la integración.
• IntegrationName: el nombre de la integración.
• Region: la región de la integración.
• ProjectId: el ID del proyecto que contiene la integración.

Ver variables

Puedes usar el panel Variables para crear, editar, ver, duplicar y eliminar variables en tu integración. El panel Variables también muestra el número total de referencias de variables de la integración.

Para ver el panel Variables, haga clic en (Mostrar/ocultar panel) en la barra de navegación del diseñador.

En la siguiente imagen se muestra un ejemplo de diseño del panel Variables:

Ver y editar variables de configuración

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Para ver las variables config definidas en su integración, haga clic en variable_add Variable config de integración en el panel Variables. Se abrirá el panel Variables de configuración, que muestra todas las variables de configuración definidas en su integración. Solo tienes que hacer clic en el campo Valor para editar el valor de la variable de configuración.

En la siguiente imagen se muestra un ejemplo de diseño del panel Variables de configuración:

Crear una variable

Para crear una variable, sigue estos pasos:

1. En la barra de navegación del editor de integraciones, haga clic en (Mostrar u ocultar panel) para que se muestre el panel Variables.
2. Haz clic en + Crear.
3. En el panel Crear variable, haga lo siguiente:
   1. Nombre: introduce el nombre de la variable.
   2. Tipo de variable: elija el tipo de variable.

   Tipo de datos	Descripción
   Ninguno	Una variable local en una integración.
   Variable config para la integración	Una variable config en una integración.
   Entrada de la integración	Durante la ejecución, la variable se proporcionará como entrada al activador ejecutado.
   Salida de la integración	El valor final de la variable al final de la ejecución debe enviarse 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á como salida a la persona que llama a la integración.

   3. Tipo de datos: elija el tipo de datos de la variable. Puede identificar el tipo de datos de una variable mediante el icono situado junto al nombre de la variable.

      Tipo de datos	Ejemplo
      Cadena	Alex
      Número entero	30
      Doble	30.5
      Booleano	true
      JSON	{ "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
      Array de cadenas	Alex, Kai, Raha
      Matriz de números enteros	30, 25, 22
      Matriz doble	30.5, 25.34, 22.134
      Matriz booleana	true, false, false

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

   4. Valor predeterminado: introduce el valor predeterminado de la variable. Este campo es opcional.
   5. Esquema: selecciona el esquema JSON de la variable.
      • Generar a partir de una carga útil de JSON de muestra: genera un esquema JSON a partir de una carga útil de JSON de muestra. La carga útil de muestra se descarta después de que se genere el esquema. Solo se guardará el esquema generado.
      • Introduce un esquema JSON: introduce manualmente un esquema JSON completo.
      • Inferir a partir del valor predeterminado: genera un esquema JSON a partir del valor predeterminado proporcionado.
      • Ninguno: no hay ningún esquema JSON.
      Nota: Este campo solo se muestra en las variables de tipo de datos JSON.
   6. Máscara de 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 la integración. Para habilitar el enmascaramiento de la variable, debes habilitar las variables de enmascaramiento de tu integración y región. Para obtener información sobre cómo habilitar el enmascaramiento en la integración y en la región, consulta los artículos Editar una integración y Editar regiones.

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

4. Haz clic en Crear.

Usar variables en integraciones

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

Una vez creado el objeto Event, se crea un gráfico de tareas en memoria mediante la definición de la integración. Los valores de las variables entrantes se transfieren a las tareas en función de la configuración. A medida que se ejecuta la integración, las tareas leen y escriben datos en el objeto Event para que los usen las tareas posteriores o para formar los datos de salida de la integración.

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 tiene el formato $paramKey$, donde paramKey es el nombre de la variable. Por ejemplo, una condición de borde podría tener este aspecto:

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

Cuotas y límites

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

Siguientes pasos

• Consulta cómo crear CI/CD para tu integración.
• Consulta cómo ocultar datos sensibles en los registros.
• Añadir y configurar una tarea de asignación de datos