Usa variables en Apigee Integration

Anuncio: Ahora la integración de aplicaciones está disponible para tu proyecto de Google Cloud. Ahora puedes usar la integración de Apigee y la integración de aplicaciones dentro del mismo proyecto de Google Cloud. Más información

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:

• Las variables de integración hacen un seguimiento de los datos durante el transcurso de una ejecución de integración completa.
• Las variables de tarea realizan un seguimiento de los datos durante el tiempo de una sola tarea.
• Variables de configuración: Almacena 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 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.
Nota: Las funciones variables enumeradas antes no son mutuamente excluyentes. Cualquier variable puede ser una variable de entrada, una de salida, ambas o ninguna.

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

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

Vista previa

Este producto o función está sujeto a las "Condiciones de las Ofertas de Fase Previa a la DG" de la sección Condiciones Generales del Servicio de las Condiciones específicas del Servicio. Los productos y las funciones que se encuentran en la fase previa a la DG están disponibles “tal cual” y podrían tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

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, etapa de pruebas o producción). No es necesario que actualices la integración de forma manual antes de subir la integración a un entorno nuevo. Application Integration te permite ingresar valores para las variables de configuración cuando publicas la integración.

Para obtener información sobre cómo crear variables de configuración y usarlas, consulta el instructivo Compila CICD 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:

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.

   Tipo de datos	Descripción
   Ninguno	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 a la integración	Durante la ejecución, la variable se proporcionará como una entrada al activador ejecutado.
   Resultado de la integración	El valor final de la variable al final de la ejecución se debe enviar al emisor de la integración.
   Entrada y salida de la integración	En la ejecución, la variable se proporcionará como una entrada al activador ejecutado y su valor final se enviará al emisor de la integración.

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

   4. Valor predeterminado: Ingresa el valor predeterminado para la variable. Este paso es opcional,
   5. 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.
      Nota: Este campo se muestra solo para las variables de tipo de datos JSON.
   6. 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.