Prueba la integración de muestra

Cuando configuras la integración de aplicaciones en tu proyecto de Google Cloud por primera vez, esta integración crea, de forma predeterminada, una integración de muestra no publicada llamada ExampleIntegration-EcomOrderProcessing.

Ver integración de muestra

Para ver la integración de muestra, haz lo siguiente:

En la consola de Google Cloud, ve a la página Application Integration.
Ir a Application Integration
En el menú de navegación, haz clic en Integraciones. Aparecerá la página Integraciones.
Haz clic en la integración llamada ExampleIntegration-EcomOrderProcessing.
La integración de ejemplo se abre en el editor de integración de forma similar al siguiente diseño:

Integración de muestra de comercio electrónico

Puedes usar esta integración de ejemplo para obtener una experiencia práctica de los diversos activadores, tareas y conceptos de Application Integration.

En la integración de muestra, se ilustra una situación básica de backend de comercio electrónico que implementa la siguiente operación de procesamiento de pedidos:

Recibe la siguiente carga útil de solicitud de pedido desde un extremo de la API:

{
  "order_no": "12345",
  "buyer_id": "raambo",
  "line_items": [
    {
      "line": 1,
      "sku": "tr100",
      "vendor": "Internal",
      "quantity": 1,
      "price_per_unit": 10
    },
    {
      "line": 2,
      "sku": "tbz",
      "vendor": "External",
      "quantity": 24.0,
      "price_per_unit": 1
    }
  ]
}

Extrae la carga útil del pedido y calcula el valor total del pedido.
Verifica si el valor total del pedido es mayor o igual a USD 100. Si es así, obtén una aprobación adicional para continuar.
Verifica si alguno de los artículos del pedido tiene un proveedor externo. Si es así, envía los detalles al proveedor mediante una llamada a la API de REST.
Envía la respuesta del pedido con el valor total del pedido, los artículos del proveedor externo filtrados y su respectivo estado de respuesta HTTP.

En la siguiente tabla, se enumeran todos los activadores, las tareas y las condiciones perimetrales que se usan en ExampleIntegration-EcomOrderProcessing:

Componente	Configuración		Descripción
Activador de API (OrderProcessAPITrigger)	ID del activador: `api_trigger/ecom-order-processing_API_1`		Invoca la integración para cada solicitud de pedido.
Tarea de asignación de datos (Busca el precio total del pedido)	Entrada	Salida	Extrae la variable de entrada JSON `order_request` y itera por todos los artículos del pedido con la función de asignación FOR_EACH para calcular el valor total del precio del pedido. Para calcular el valor del precio total del pedido, se multiplica el artículo `quantity` y el `price_per_item` con las funciones de asignación GET_PROPERTY y MULTIPLY. Luego, el valor final se convierte en un tipo de datos doble y se almacena en la variable de salida `total_order_value`.
	orders_request.line_items .FOR_EACH(~obj1->~obj1 .GET_PROPERTY("quantity") .TO_DOUBLE() .MULTIPLY(~obj1 .GET_PROPERTY("price_per_unit") .TO_DOUBLE())) .TO_DOUBLE_ARRAY() .SUM()	`total_order_value`
Condición de borde (Total OrderValue Above Threshold)	Condición: `$total_order_value$ >= $threshold_order_value$`		Comprueba si el valor total del pedido es mayor o igual a USD 100. Si es así, el control se pasa a una tarea de aprobación.
Condición de borde (TotalOrderValue Below Threshold)	Condición: `$total_order_value$ < $threshold_order_value$`		Verifica si el valor total del pedido es inferior a USD 100. Si es así, el control se pasa a la tarea Filtrar elementos externos.
Tarea Aprobación (Aprobación)	Destinatarios: `Enter the approver's email address` Para probar esta integración de muestra, puedes usar tu correo electrónico para confirmar que se completó correctamente. Nota: En su proyecto de Google Cloud, debes otorgar el rol de IAM responsable de aprobación de Application Integration a todas las direcciones de correo electrónico proporcionadas en el campo Destinatarios. Para obtener instrucciones sobre cómo otorgar roles de IAM, consulta Cómo otorgar, cambiar y revocar el acceso.		Envía un correo electrónico de solicitud de aprobación a uno o más usuarios de integración. El correo electrónico incluye un vínculo a la integración en el que los usuarios pueden aprobar o rechazar la solicitud de forma manual.
Tarea de asignación de datos (Filtrar elementos externos)	Entrada	Salida	Extrae la variable de entrada JSON `order_request` y filtra todos los artículos del pedido con proveedores externos con la función de asignación FILTER. Luego, los valores filtrados se almacenan en la variable de salida `filtered_external_items`.
Tarea de asignación de datos (Filtrar elementos externos)	orders_request .GET_PROPERTY("line_items") .FILTER(~obj1->~obj1 .GET_PROPERTY("vendor") .TO_STRING() .EQUALS("External"))	`filtered_external_items`
Para cada tarea de bucle (bucle For Each)	Lista para iterar: `filtered_external_items` ID del activador de API: `api_trigger/ecom-order-processing_API_2` Nombre de la integración: `ExampleIntegration-EcomOrderProcessing`		Itera en la variable `filtered_external_items` y llama a la subintegración para cada elemento del array. También intercala la respuesta de cada ejecución en `rest_call_response_status`, en la que cada elemento del array tiene la respuesta de una ejecución en particular.
Activador de API (Report ExternalOrders)	ID del activador: `api_trigger/ecom-order-processing_API_2`		Invoca la subintegración para cada elemento de filtered_external_items.
Tarea de llamada de extremo de REST (Llamar a extremo de REST)	URL base del extremo: `https://mocktarget.apigee.net/echo` Método HTTP: `POST` Cuerpo de la solicitud: `sub_integration_input`		Realiza una llamada REST a https://mocktarget.apigee.net/echo.

Publica y prueba la integración de muestra

Para publicar la integración, haz clic en Publicar en la barra de herramientas del editor de integraciones.

Una vez que publiques tu integración de forma correcta, podrás ver e inspeccionar los registros de ejecución de la integración publicada. Para ver los registros, haz clic en Ver registros de ejecución de esta integración. Aparecerá la página Registros de ejecución.

Cómo realizar pruebas desde el editor de integración

Para probar la integración de muestra, haz lo siguiente:

Haz clic en Probar en la barra de herramientas del editor de integración y, luego, selecciona OrderProcessAPITrigger.
Aparecerá el panel Probar integración.

Se te solicitará que edites la variable de entrada orders_request. Para los fines de esta prueba, puedes actualizar el valor de quantity a 240. La variable de entrada de actualización orders_request debería ser similar a la siguiente:

    {
      "order_no": "12345",
      "buyer_id": "raambo",
      "line_items": [
        {
          "line": 1,
          "sku": "tr100",
          "vendor": "Internal",
          "quantity": 1,
          "price_per_unit": 10
        },
        {
          "line": 2,
          "sku": "tbz",
          "vendor": "External",
          "quantity": 240,
          "price_per_unit": 1
        }
      ]
    }

Haz clic en Probar integración.

Dado que la cantidad actualizada de orders_request es superior a 200, la integración de ejemplo envía un correo electrónico de solicitud de aprobación a la dirección de correo electrónico especificada en el campo Destinatarios de la tarea Aprobación. La operación del pedido de integración se completará correctamente una vez que se reciba la aprobación.

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

Para inspeccionar los registros de ejecución y ver el estado y la carga útil de la integración determinada, haz lo siguiente:

En el editor de integración, haz clic en Ver registros de ejecución para esta integración. Aparecerá la página Registros de ejecución.
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 la integración
- ID de activador
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.

Prueba con una llamada a la API de REST

Nota: En los siguientes casos de prueba, se usa curl, que suele estar preinstalado en los sistemas operativos Linux y macOS. Si no tienes curl, puedes descargarlo de la página de actualizaciones y descargas de curl.

Caso de prueba 1: Envía una solicitud con entradas predeterminadas

  curl -X POST -H "Content-Type: application/json" -d '{"trigger_id":"api_trigger/ecom-order-processing_API_1"}' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME:execute' -H "Authorization: Bearer $(gcloud auth print-access-token)"

Caso de prueba 2: Envía una solicitud con entradas personalizadas

  curl -X POST -H "Content-Type: application/json" -d '{ "triggerId": "api_trigger/ecom-order-processing_API_1", "inputParameters": { "orders_request": { "jsonValue": "{\n \"order_no\": \"12345\",\n \"buyer_id\": \"raambo\",\n \"line_items\": [{\n \"line\": 1.0,\n \"sku\": \"tr100\",\n \"vendor\": \"Internal\",\n \"quantity\": 1.0,\n \"price_per_unit\": 10.0\n }, {\n \"line\": 2.0,\n \"sku\": \"tbz\",\n \"vendor\": \"External\",\n \"quantity\": 24.0,\n \"price_per_unit\": 2.0\n }]\n}" } } }' 'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME:execute' -H "Authorization: Bearer $(gcloud auth print-access-token)"

Reemplaza lo siguiente:

PROJECT_ID: El ID del proyecto de Google Cloud.
LOCATION: Es la ubicación de la integración. Consulta Ubicaciones de Application Integration.
INTEGRATION_NAME: Nombre de la integración

Resultado de la prueba

La API muestra la respuesta de ejecución de integración que contiene todos los valores de las variables de salida de la integración.

Cuotas y límites

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