Criar uma subintegração (LaunchA360Bot.json)

Ao construir uma subintegração, assegure-se de que o bot que você está tentando implantar já está disponível no Control Room.

Nota: Os exemplos e gráficos apresentados nesta página são apenas para fins de representação e podem não refletir com precisão a instância específica. Não assumimos responsabilidade pela manutenção ou precisão deles.

Execute os seguintes passos para construir uma subintegração:

  1. Vá para IU da Apigee e se inscreva.
  2. Selecione sua organização usando o menu suspenso no canto superior esquerdo da interface do usuário.
  3. Para ver uma lista das integrações disponíveis, clique em Desenvolver > Integrações.
  4. Selecione uma integração existente ou clique em CRIAR NOVO.
  5. Forneça as seguintes informações:
    • Nome da integração: Digite um nome, por exemplo, lançar-bot.
    • Descrição(Opcional): Forneça uma descrição, por exemplo, "Implanta um Automation 360 bot para processar arquivos.
    • Região: Selecione uma região da lista, por exemplo, os EUA.
  6. Clique em Create (Criar).

    O Editor de integração aparece.

  7. No Editor de integração, acrescente um acionador ao projetista, executando as seguintes ações:
    • Clique em + Adicionar uma tarefa/acionador.
    • Selecione Acionadores > Acionador de API
    • Coloque o acionador no designer clicando em um local apropriado.
      A ID do acionador é gerado automaticamente com base no nome da integração. O acionador de API permite que os autores de integração testem uma integração por meio de uma chamada de API. Esse acionador é útil quando você deseja testar sua integração a partir de seu código de aplicação.
      Apigee - Adicionar um acionador
  8. No Editor de integração, acrescente uma tarefa de Mapeamento de dados para o projetista, executando as seguintes ações:
    • Clique em + Adicionar uma tarefa/acionador.
    • Selecione Tarefas > Mapeamento de dados.
    • Coloque o mapeamento de dados no projetista clicando em um local apropriado.
  9. Clique no elemento Mapeamento de dados no projetista para abrir o painel de configuração Mapeamento de dados.
  10. Clique em Abrir editor de mapeamento de dados.
    O Editor de Mapeamento de Dados permite realizar tarefas variáveis em sua integração. As variáveis podem ser variáveis de integração ou variáveis de tarefa. O Mapeamento de dados permite aos autores da integração transformar e atribuir dados a variáveis entre tarefas em uma integração. As variáveis são criadas usando a opção VAR na paleta.
    Apigee - Editor de mapeamento de dados
  11. Crie variáveis de entrada e saída com base na seguinte lista. As variáveis de entrada são variáveis passadas para os corredores de integração. Especifique um valor literal ou selecione uma variável de referência. Para adicionar uma variável de entrada ao mapeamento de dados, clique e arraste uma variável da lista de variáveis disponíveis na coluna Variáveis. Clique em Adicionar + para configurar uma nova variável.
    Para esta amostra, crie sete variáveis de entrada do tipo de dados string como entradas para integração:
    • input-ControlRoomUrl
    • input-Username
    • input-ApiKey
    • input-BotId
    • input-RunAsUserId
    • input-PoolId
    • input-BotInputVariables
    Criar uma variável de saída como saída da integração:
    • output-deploymentId
    Algumas variáveis locais que existem apenas dentro do escopo desta integração são as seguintes: accessToken, authAPIUrl, deployBotAPIUrl, authRequestBody e deployRequestBody. Além destas, a Apigee auto-gera algumas variáveis locais para fins de estacionamento e transformação de dados.

    Depois de criar as variáveis, feche o editor de mapeamento de dados.

  12. No designer da integração, acrescente um elemento para fazer uma chamada para a autenticação de API Automation 360 Control Room, executando as seguintes ações:
    • Clique em + Adicionar uma tarefa/acionador.
    • Selecione Tarefas > Endpoint de descanso de chamada
    • Coloque o mapeamento de dados no projetista, clicando em um local apropriado para visualizar o painel de configuração de tarefas Endpoint de DESCANSO de chamada.
    • Mapeie os seguintes campos com as variáveis definidas no passo anterior.
      • Mapeie o campo Campo de URL base do endpoint para a variável authAPIUrl.
      • Mapeie o campo Corpo da solicitação para a variável authRequestBody.
        Apigee - Mapear o campo com a variável
  13. Adicione uma tarefa de mapeamento de dados ao projetista para extrair o token da etapa anterior. Execute o JSON para operações de cordas como mostrado e salvá-lo em uma variável.
    Apigee - Extrato do token
  14. Faça a chamada para a API de implantação do bot Automation 360 Control Room.
    Adicione uma nova tarefa Chamar endpoint de descanso ao projetista e configure a URL do ponto final e o método http POST no painel do lado direito. Atualize também o órgão de solicitação com a credencial correta.
    Apigee - Chamar endpoint de descanso
  15. Adicione uma tarefa de mapeamento de dados para extrair a ID de implantação bot da etapa anterior. Extraia a identificação de implantação e salvá-la em uma variável.
    Uma integração concluída tem a seguinte aparência:
    Apigee - ID de implantação de extração