Crie um DevOps integração da ferramenta

Para criar uma integração de ferramenta DevOps, seu desenvolvedor de integração configura DevOps configurações de integração da ferramenta e um Workflow Studio subfluxo para coletar e transformar dados da ferramenta de origem. Em seguida, seu DevOps o administrador configura seu DevOps conexões da ferramenta.

Antes de Iniciar

Nota:

Ao criar uma integração como um app com escopo, o administrador do sistema deve atribuir essas funções ao desenvolvedor de integração para que o desenvolvedor de integração possa criar registros de capacidade de integração e integração da ferramenta para o escopo específico.

• Função de desenvolvedor para o app com escopo
• DevOps função de administrador

Função necessária: sn_devops.admin

Por Que e Quando Desempenhar Esta Tarefa

Criando um DevOps o procedimento de integração da ferramenta envolve a configuração pelo desenvolvedor de integração e pelo DevOps administrador.

• Seu desenvolvedor de integração cria um registro de integração de ferramenta no DevOps. Workflow Studio subfluxo , um mapeamento de capacidade de ferramenta e um registro de capacidade de integração em DevOps para mapear as capacidades e as ações juntas.
  Nota:

  Os recursos de notificação, conexão e descoberta são compatíveis.
• . DevOps o administrador configura conexões DevOps (ferramenta de planejamento ou codificação) e configura a ferramenta de origem com o webhook e as credenciais.

Este procedimento fornece etapas detalhadas para criar seu DevOps integração da ferramenta.

Procedimento

1. Desenvolvedor de integração:
   Configure os recursos e ações de integração da ferramenta de origem e um subfluxo.
   1. Navegar até DevOps > Integrações > Integrações de Ferramentas e criar um registro para definir a ferramenta que você está integrando (ferramenta de origem).
      Nota:

      Não edite os registros de integração da ferramenta fornecidos com DevOps aplicação.

      Tabela 1. Integração da ferramenta DevOps

      Rótulo da ferramenta	Ferramenta de código de amostra
      Tabela	Ferramenta de código [sn_devops_tool]
      Use integrações empacotáveis	Selecionado
      Versão de integração	1.0
      Ativo	Selecionado

   2. Navegar até Flow Designer > Designer e. crie um subfluxo para coletar e transformar dados da ferramenta que você está integrando (ferramenta de origem).
      Nota:

      . Executar como O campo deve ser definido como Usuário do sistema e Entradas o rótulo deve ser definido como a variável atual.

      Tabela 2. Propriedades do subfluxo de notificação

      Nome	Notificação da Ferramenta de código
      Aplicação	Aplicação de integração de amostra
      Acessível de	Todos os escopos de aplicação
      Descrição	Ferramenta de código para aplicativo de integração
      Executar como	Usuário do Sistema

      O subfluxo deve conter Obter mais dados por meio de chamadas de API e/ou transformar a carga original. Copie a carga transformada no registro de eventos de entrada.

      Nota:

      Não edite o fluxo principal do DevOps.
   3. Navegar até DevOps > Integrações > Mapeamentos da capacidade da ferramenta e criam um registro para mapear o registro de integração da ferramenta para a capacidade de tipo de ferramenta.

      Tabela 3. DevOps mapeamento de capacidade da ferramenta

      Integração da ferramenta	Ferramenta de amostra
      Capacidade do tipo de ferramenta	Código

   4. Navegar até DevOps > Integrações > Capacidades de integração e criam um registro para especificar a ação para o mapeamento de capacidade da ferramenta.
      Nota:

      Não edite os registros de capacidade de integração fornecidos com DevOps aplicação.

      Tabela 4. DevOps capacidade de integração

      Integração da ferramenta	Ferramenta de código de amostra
      Mapeamento da capacidade	Ferramenta de código de amostra - Código Nota: Não edite registros de capacidade do tipo de ferramenta.
      Ação	Notificação Nota: Não edite registros de ação da ferramenta.
      Ativo	Selecionado
      Tempos limites (ms)	Tempo limite do subfluxo correspondente. Se a execução do subfluxo exceder esse valor, ocorrerá uma exceção de tempo limite. O valor está em milissegundos (ms). O padrão é 45 000 (45 segundos).
      Nome do subfluxo	x_snc_sample_integ.code_tool_notification O nome é prefixado pelo nome do escopo e um ponto (.) antes do nome real do subfluxo. Por exemplo, fornecido: connect_code_tool subfluxo my_app_scope escopo O valor deste campo é my_app_scope.connect_code_tool . Nota: . Nome do subfluxo O campo é deixado em branco para um recurso de Notificação, ocorre o tratamento padrão de notificações. Consulte Ação de capacidade da ferramenta de notificação .
      Domínio	global

2. DevOps administrador:

   Configure a conexão de DevOps para a ferramenta de origem.

   1. O registro da ferramenta deve conter:
      • Referência ao registro de integração da ferramenta criado pelo desenvolvedor de integração (em Ferramenta )
      • Rótulo da ferramenta
      • Alias de conexão (conexão e credencial)
   2. Copie a notificação (webhook) criada no DevOps ferramenta de planejamento para o gancho de serviço da ferramenta de origem do endpoint de notificação e defina as credenciais como devops.integration.user.
   Você pode exibir o estado dos eventos de integração na lista de eventos de entrada (DevOps > Administração > Eventos de Entrada).

   O estado do registro de evento de entrada é definido como Processado Depois que o objeto tiver sido inserido na tabela DevOps Core. os estados de evento incluem Novo, Em andamento, Processado, Sem correspondência e Erro.

3. Se o registro de integração da ferramenta e o subfluxo forem criados em um escopo diferente, o. DevOps o administrador deve criar dois novos registros de privilégios de escopo cruzado para permitir que o app acesse a tabela de eventos de entrada.
   Navegar até Aplicações do sistema > Acesso entre escopos da aplicação e criam registros de privilégios de leitura e gravação entre escopos para permitir que seu app acesse a tabela de eventos de entrada.

   Campo	Leitura	Gravar
   Escopo de origem	Preenchido automaticamente com base na aplicação atual
   Escopo de destino	DevOps
   Nome de destino	sn_devops_inbound_event
   Tipo de destino	Tabela
   Operação	Leitura	Gravar
   Status	Permitido

Exemplo

Figura 1. DevOps integração da ferramenta

Figura 2. Workflow Studio propriedades do subfluxo

Figura 3. Workflow Studio subfluxo

Figura 4. Workflow Studio DevOps Integração - Fluxo de notificação

Figura 5. DevOps mapeamento de capacidade da ferramenta

Figura 6. Capacidade de integração

Figura 7. Ferramenta de planejamento

Figura 8. Registros de acesso entre escopos (leitura e gravação)