Consulta los conectores compatibles con Application Integration.

Recupera la carga útil de la API y envía un correo electrónico

Aprende a crear una integración de muestra en Application Integration. En los pasos que se indican a continuación, se describe cómo configurar el activador, las tareas, los perímetros, las variables y las asignaciones de datos necesarias para ejecutar una integración completa.

Descripción general

En esta guía de inicio rápido, recuperarás la cantidad de vistas de página de una API pública, transformarás los datos en un formato usable y enviarás la lista resultante en un correo electrónico, todo desde el editor de integración.

Para seguir la guía paso a paso en esta tarea directamente en la consola de Google Cloud, haz clic en Guiarme:

GUIARME

Cómo crear una integración nueva

Para crear una integración nueva, sigue estos pasos:

  1. En la consola de Google Cloud, ve a la página Application Integration.

    Ir a Application Integration

  2. En el menú de navegación, haz clic en Integraciones. Aparecerá la página Integraciones.
  3. Haz clic en Crear integración.
  4. Ingresa un nombre y una descripción en el diálogo Crear integración.

    Para esta guía de inicio rápido, ingresa el nombre my-test-integration y la descripción Integration for quickstart.

  5. Selecciona una región para la integración.
  6. Haz clic en Crear para abrir el editor de integración.

Agrega y configura un activador de API

Se requieren activadores para iniciar la secuencia de tareas que conforman una integración. Se puede usar cualquier activador disponible para iniciar una integración. Para la guía de inicio rápido, usa el Activador de API.

Para configurar el activador de API, sigue estos pasos:

  1. En el editor de integración, haz clic en Activadores para ver una lista de los activadores disponibles.
  2. Haz clic en Activador de API en el editor de integración.
  3. Para configurar el selector, haz clic en Activador de API. El activador aparecerá el panel de configuración.
  4. Application Integration propaga automáticamente la etiqueta y el ID del activador del activador. El ID del activador es generado por una máquina y no se puede editar el valor. Sin embargo, puedes editar el valor de la propiedad Etiqueta.

    Los cambios en las propiedades se guardan de forma automática.

Cómo agregar y configurar tareas

Una tarea es un conjunto ejecutable de pasos que puede tomar variables como entradas y generar variables como resultados. Al igual que con los activadores, se puede usar cualquier tarea disponible en una integración. En esta guía de inicio rápido, se usan las tareas Llamar a extremo REST, Asignación de datos y Enviar correos electrónicos. Los detalles de configuración para cada tarea se describen en los pasos que se indican a continuación.

Configura la tarea Call REST Endpoint

Para configurar la tarea Llamar al extremo REST, haz lo siguiente:

  1. Selecciona Tareas para ver una lista de tareas disponibles.
  2. Haz clic y coloca Llamar a extremo de REST en el editor de integración.
  3. Agrega una conexión perimetral del activador de API al Llama al extremo de REST colocando el cursor sobre un punto de control en Activador de API. Haz clic en una línea y arrástrala hasta un punto de control en la tarea Llamar a extremo de REST. El perímetro denota el flujo de control del activador de API a la tarea Llamar al extremo REST.

    Un perímetro es una conexión entre dos elementos en una integración. La conexión denota la dirección del flujo de control de un elemento (tarea o activador) a otro. Para obtener más información sobre los perímetros, consulta Perímetros.

  4. Para configurar la tarea, haz clic en Llamar a extremo de REST. La tarea aparecerá el panel de configuración. Establezce las siguientes propiedades:
    • Etiqueta: Ingresa un nombre personalizado para esta tarea. Por ejemplo, ingresa Call REST Endpoint Task.
    • Autenticación: Para esta guía de inicio rápido, no se requiere un perfil de autenticación. Si quieres obtener más información sobre el uso de perfiles de autenticación para otros casos de uso, consulta Crea perfiles de autenticación en Application Integration.
    • Entrada de tareas: Ingresa los detalles para llamar al extremo de REST. La información ingresada aquí se usa como entrada para la tarea Llamar al extremo REST. En el siguiente diagrama, se muestran las secciones Task Input y HTTP settings para la tarea Call REST Endpoint:

      Llamada a la entrada de la tarea de extremo de REST Llamada a la entrada de la tarea de extremo de REST

      Ingresa la siguiente información:

      • URL base del extremo: ingresa https://wikimedia.org/api/rest_v1/metrics/pageviews/per-article/en.wikipedia/desktop/user/Tree/monthly/20201001/20201031. Esta API pública de wikimedia.org muestra la cantidad de páginas vistas de un artículo denominado Árbol para un mes determinado.
      • Método HTTP: Selecciona GET mediante la lista del menú desplegable.
    • Configuración HTTP: Application Integration propaga los siguientes valores:
      1. Seguir los redireccionamientos: True
      2. La tarea debería fallar en error de HTTP True
    • Resultado de la tarea: Application Integration propaga tres variables para contener la salida de datos de respuesta de la llamada al extremo de REST. En el siguiente diagrama, se muestra el Resultado de la tarea y otras secciones para la tarea Llamar a extremo de REST:

      Resultado de la tarea del extremo de reposo de la llamada Resultado de la tarea del extremo de reposo de la llamada

      Revisa la siguiente información:

      • responseHeader(Llamar al extremo REST): Esta variable contiene los datos del encabezado de respuesta asociados con la tarea Llamar al extremo REST. Los datos variables son del tipo String (STR).
      • responseBody(Llamar al extremo REST): Esta variable contiene los datos del cuerpo de la respuesta asociados con la tarea Llamar al extremo REST. Los datos variables son del tipo String (STR).
      • responseStatus(Llamar al extremo REST): Esta variable contiene los datos de estado de la respuesta asociados con la tarea Llamar al extremo REST. Los datos variables son del tipo String (STR).
    • Los campos restantes deben contener los siguientes valores predeterminados:
      • Estrategia de ejecución para esta tarea: When all tasks succeed
      • Política de ejecución para la siguiente tarea: Run all match

    Los cambios en las propiedades se guardan de forma automática.

Agrega y configura la tarea de asignación de datos

Para configurar la tarea de asignación de datos, haz lo siguiente:

  1. Selecciona Tareas para ver una lista de tareas disponibles.
  2. Haz clic y coloca Data Mapping en el editor de integración.
  3. Agrega una conexión perimetral de Llamar al extremo REST a Asignación de datos. Para ello, coloca el cursor sobre un punto de control en Llamar al extremo REST, luego, haz clic en una línea y arrástrala hasta un punto de control en la tarea Asignación de datos. El borde denota el flujo de control de la tarea Llamar a extremo de REST a la tarea Asignación de datos.
  4. Para configurar la tarea, haz clic en Asignación de datos. El panel de configuración del aparecerá la tarea.
  5. Haz clic en Open Data Mapping Editor.

    El Editor de asignación de datos te permite asignar variables de entrada a las variables de salida deseadas con las funciones de transformación disponibles. Entonces, el resultado está disponible como una variable para cualquier otra tarea o activador de integración. Para obtener más información pasando datos como variables, consulta Variables.

    Para esta guía de inicio rápido, crea una asignación con el valor responseBody(Llamar al extremo REST) como entrada:

    1. Arrastra la variable responseBody del panel Variables a la primera fila de Entrada.
    2. Haz clic en + (Add a function) en el chip de variable responseBody para ver la lista de funciones disponibles. Puedes aplicar varias funciones para transformar los datos en la variable de entrada.

      En este caso, puedes convertir la carga útil en JSON y, luego, iterar sobre el array de respuestas para obtener la lista de nombres de productos necesarios en las notificaciones por correo electrónico. Para hacerlo, sigue estos pasos:

      • Selecciona TO_JSON() para convertir la string responseBody en JSON.
      • Haz clic en + (Agregar una función) en el chip de la variable responseBody para seleccionar y encadenar la función GET_PROPERTY().
      • Para agregar el parámetro de entrada para GET_PROPERTY(), haz clic en Variable o Valor y, en Valor, ingresa items.

        Esta función extraerá una propiedad de la carga útil JSON. Pasa la propiedad items como parámetro para esta función. Esto mostrará una lista de SOLO los nombres de los productos, sin otra información sobre ellos. La función se debe leer de la siguiente manera: 

        responseBody(Call REST Endpoint).TO_JSON().GET_PROPERTY(items)
      • Si necesitas quitar o borrar una función, haz clic en el símbolo -.
    3. Haz clic en el primer campo de la columna Salida a fin de crear una variable nueva para conservar el valor de los datos transformados. Completa los siguientes campos:
      • En el campo Nombre, ingresa JSONList.
      • En la lista Variable Type, selecciona Output from integration.
      • En la lista Tipo de datos, selecciona JSON.
      • Para crear la variable y cerrar el panel, haz clic en Crear. La nueva variable JSONList aparecerá en la lista Variables del lado izquierdo del Editor de asignación de datos.
    4. Cierra el Editor de asignación de datos una vez que se complete la asignación. Los cambios se guardarán automáticamente. En las siguientes imágenes, se muestra el editor de asignación de datos con la asignación creada en esta guía de inicio rápido:

      Editor de asignación de datos Editor de asignación de datos

Agrega y configura la tarea Enviar correo electrónico

Para configurar la tarea Enviar correo electrónico, haz lo siguiente:

  1. Selecciona Tareas en el editor de integración para ver la lista de tareas disponibles.
  2. Haz clic y coloca Enviar correo electrónico en el editor de integración.
  3. Agrega una conexión perimetral de Asignación de datos a Enviar correo electrónico; para ello, coloca el cursor sobre un punto de control en Asignación de datos y, luego, Haz clic en una línea y arrástrala hasta un punto de control de la tarea Enviar correo electrónico. El perímetro denota el flujo de control de la tarea de Asignación de datos a la tarea de Enviar correo electrónico.
  4. Para configurar la tarea, haz clic en Enviar correo electrónico. Aparecerá el panel de configuración de la tarea. En la sección Task Input, establece las siguientes propiedades:
    • A los destinatarios: Ingresa tu dirección de correo electrónico. Usa este correo electrónico para confirmar que la integración se completó correctamente.
    • Asunto: Ingresa Email from Application Integration.
    • Cuerpo en texto sin formato: Selecciona la variable JSONList que creaste antes en la tarea Asignación de datos.
    • Las opciones restantes pueden dejarse en la configuración predeterminada.

    Los cambios en las propiedades se guardan de forma automática.

Verifica las conexiones perimetrales necesarias

Verifica que hayas agregado una conexión perimetral entre la tarea y los activadores en tu integración. La conexión denota la dirección del flujo de control de un elemento (tarea o activador) a otro. Para obtener más información sobre los perímetros, consulta Perímetros.

La conexión completa debería aparecer como se muestra en la siguiente figura:

Imagen que muestra el flujo de inicio rápido Imagen que muestra el flujo de inicio rápido

Prueba la integración

Para probar la nueva integración, sigue estos pasos:

  1. Haz clic en Probar en la barra de herramientas del editor de integración.

    Aparecerá el panel Test Integration.

  2. Haz clic en Probar integración.

Para obtener más información sobre las pruebas, consulta Prueba y publica integraciones.

Cuando la compilación se completa de forma correcta, la integración envía un correo electrónico con los valores JSON a la dirección de correo electrónico especificada en la tarea Enviar correo electrónico. Confirma la recepción del correo electrónico en tu cliente de correo electrónico.

El correo electrónico que envió la integración debe contener un cuerpo similar al siguiente: 

[{
   "project": "en.wikipedia",
   "article": "Tree",
   "granularity": "monthly",
   "timestamp": "2020100100",
   "access": "desktop",
   "agent": "user",
   "views": 33828.0
}]

Además de verificar el contenido del correo electrónico, puedes inspeccionar los registros para ver el estado y la carga útil de una integración determinada. Para ver los registros, haz lo siguiente:

  1. Haz clic en Registros en la barra de herramientas del editor de integración.
  2. En la página Registros de ejecución, puedes ver los detalles de cada intento para ejecutar una integración. Cada entrada incluye detalles para el intento de ejecución, incluidos los siguientes:
    • Nombre de la integración
    • ID de ejecución
    • Estado
    • Hora de inicio
    • Duración
    • Versión de integración
    • ID de activador
    • Cloud Logging
  3. Haz clic en la flecha desplegable (>) junto a la integración ejecutada para ver una lista expandida de tareas y variables en la integración, junto con el estado de la tarea y las cargas útiles de la variable.

Cuotas y límites

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