Crear una subintegración (LaunchA360Bot.json)

Al construir una subintegración, asegúrese de que el bot que está tratando de implementar ya está disponible en el Control Room.

Nota: Los ejemplos y gráficos proporcionados en esta página son meramente ilustrativos y es posible que no reflejen con precisión su caso específico. No nos hacemos responsables de su mantenimiento ni de su exactitud.

Realice los siguientes pasos para construir una subintegración:

  1. Vaya a Interfaz de usuario de Apigee e inicie sesión.
  2. Seleccione su organización utilizando el menú desplegable en la esquina superior izquierda de la interfaz de usuario.
  3. Para ver la lista de integraciones disponibles, haga clic en Desarrollar > Integraciones.
  4. Seleccione una integración existente o haga clic en CREAR NUEVA.
  5. Escriba la siguiente información:
    • Nombre de la integración: Ingrese un nombre, por ejemplo, launch-bot.
    • (Opcional) Descripción: Proporcione una descripción, por ejemplo, "Despliega un Automation 360 bot para procesar archivos".
    • Región: Seleccione una región de la lista, por ejemplo, Estados Unidos.
  6. Haga clic en Crear.

    Aparece el Editor de integración.

  7. En el Editor de integración, agregue un activador al diseñador realizando las siguientes acciones:
    • Haga clic en + Agregar una tarea/activador.
    • Seleccione Activadores > Activador de API
    • Coloque el activador en el diseñador haciendo clic en donde corresponda.
      El ID del activador se genera automáticamente en función del nombre de la integración. El activador de API permite a los autores de la integración probarla mediante una llamada a la API. Este activador es útil cuando quiere probar la integración desde el código de la aplicación.
      Apigee - Agregar un activador
  8. En el Editor de integración, agregue una tarea de Asignación de datos al diseñador realizando las siguientes acciones:
    • Haga clic en + Agregar una tarea/activador.
    • Seleccione Tareas > Asignación de datos.
    • Coloque la asignación de datos en el diseñador haciendo clic en donde corresponda.
  9. Haga clic en el elemento Asignación de datos en el diseñador para abrir el panel de configuración Asignación de datos.
  10. Haga clic en Abrir el editor de la asignación de datos.
    El Editor de la asignación de datos le permite asignar variables en su integración. Las variables pueden ser de integración o de tarea. La tarea Asignación de datos le permite a los autores de la integración transformar y asignar datos a las variables entre las tareas de una integración. Las variables se crean con la opción VAR de la paleta.
    Apigee - Editor de asignación de datos
  11. Cree las variables de entrada y salida en función de la siguiente lista. Las variables de entrada son variables que se pasan a los ejecutores de integración. Especifique un valor literal o seleccione una variable de referencia. Para agregar una variable de entrada a la asignación de datos, haga clic y arrastre una variable de la lista de variables disponibles en la columna adyacente Variables. Haga clic en Agregar + para configurar una nueva variable.
    Para este ejemplo, cree siete variables de entrada de tipo de datos de cadena como entradas para la integración:
    • input-ControlRoomUrl
    • input-Username
    • input-ApiKey
    • input-BotId
    • input-RunAsUserId
    • input-PoolId
    • input-BotInputVariables
    Cree una variable de salida como resultado de la integración:
    • output-deploymentId
    Algunas variables locales que sólo existen en el ámbito de esta integración son las siguientes: accessToken, authAPIUrl, deployBotAPIUrl, authRequestBody y deployRequestBody. Además de éstas, Apigee genera automáticamente algunas variables locales con el fin de estacionar y transformar los datos.

    Una vez creadas las variables, cierre el editor de asignación de datos.

  12. En el diseñador de integración, agregue un elemento para realizar una llamada a la API de autenticación de Automation 360 Control Roomrealizando las siguientes acciones:
    • Haga clic en + Agregar una tarea/activador.
    • Seleccione Tareas > Llamar endpoint rest
    • Coloque la asignación de datos en el diseñador haciendo clic en donde corresponda para ver el panel de configuración de la tarea Llamar a endpoint REST.
    • Asigne los siguientes campos a las variables definidas en el paso anterior.
      • Asigne el campo URL base de endpoint a la variable authAPIUrl.
      • Asigne el campo Cuerpo de la solicitud a la variable authRequestBody .
        Apigee - Asignar el campo con la variable
  13. Agregue una tarea de asignación de datos al diseñador para extraer el token del paso anterior. Realice las operaciones de conversión de JSON a cadena como se muestra y lo guárdelas en una variable.
    Apigee - Token de extracción
  14. Llame a la API de implementación de bot de Automation 360 Control Room.
    Agregue una nueva tarea Llamar endpoint rest al diseñador y configure la dirección URL del endpoint y el método http POST en el panel de la derecha. Actualice también el cuerpo de la solicitud con la credencial correcta.
    Apigee - Extremo de la implementación de la llamada
  15. Agregue una tarea de asignación de datos para extraer la ID de implementación de bot del paso anterior. Extraiga la ID de implementación y guárdelo en una variable.
    Una integración completa se verá de la siguiente manera:
    Apigee - Extraer ID de implementación