---
sourceDocument: Yokohama Gestão de serviços de TI
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/it-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de serviços de TI

ft:clusterId :

    - itsm

bundleId :

    - itsm

workflow :

    - Technology


---

# Crie um DevOpsintegração da ferramenta

# Crie um DevOpsintegração da ferramenta {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 4 min. de leitura

Para criar uma integração de ferramenta DevOps, o desenvolvedor de integração configura DevOpsconfigurações de integração da ferramenta e a. Workflow Studiosubfluxo para coletar e transformar dados da ferramenta de origem. E, em seguida, seu DevOpso administrador configura seu DevOpsconexõ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
{#set-up-dev-ops-integrations__ul_ymj_m3g_fjb}

Função necessária: sn_devops.admin

## Por Que e Quando Desempenhar Esta Tarefa

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

* Seu desenvolvedor de integração cria um registro de integração de ferramenta em DevOps. Workflow Studio [subfluxo](https://servicenow-prod.fluidtopics.net/7Zsyhg3AdBod7730p6LLYA "Para integrações criadas pelo usuário, crie um DevOps Workflow Studiosubfluxo para coletar e transformar dados da ferramenta que você está integrando."), um mapeamento de capacidade da ferramenta e um registro de capacidade de integração em DevOpspara mapear as capacidades e ações juntas.  
  Nota:  
  As capacidades de notificação, conexão e descoberta são compatíveis.
* Seu DevOpso administrador configura conexões DevOps (ferramenta de planejamento ou codificação) e configura a ferramenta de origem com o webhook e as credenciais.
{#set-up-dev-ops-integrations__ul_ayp_j5f_jkb}

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

## Procedimento

1. Desenvolvedor de integração:  
   Configure as capacidades e ações de integração da ferramenta de origem e um subfluxo.
   1. Navegar até DevOpsIntegraçõesIntegraçõ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 o. DevOpsaplicação.

      |-|-|
      | 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 |
      [Tabela 1. Integração da ferramenta DevOps]

      {#set-up-dev-ops-integrations__table_ets_r12_v3b}
   2. Navegar até Flow DesignerDesigner e. [crie um subfluxo](https://servicenow-prod.fluidtopics.net/7Zsyhg3AdBod7730p6LLYA "Para integrações criadas pelo usuário, crie um DevOps Workflow Studiosubfluxo para coletar e transformar dados da ferramenta que você está integrando.")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.

      |-|-|
      | 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 app de integração |
      | Executar como | Usuário do Sistema |
      [Tabela 2. Propriedades do subfluxo de notificação]

      {#set-up-dev-ops-integrations__table_vxw_n4j_v3b}  
      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 de DevOps.
   3. Navegar até DevOpsIntegraçõesMapeamentos da capacidade da ferramenta e criar um registro para mapear o registro de integração da ferramenta para a capacidade de tipo de ferramenta.  

      |-|-|
      | Integração da ferramenta | Ferramenta de amostra |
      | Capacidade do tipo de ferramenta | Código |
      [Tabela 3. DevOps mapeamento de capacidade da ferramenta]

      {#set-up-dev-ops-integrations__table_egd_jyw_wkb}
   4. Navegar até DevOpsIntegraçõesCapacidades de integração e criar 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 o. DevOpsaplicaçã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 para o 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_integg.code_tool_notification O nome é prefixado pelo nome do escopo e um ponto (.) antes do nome real do subfluxo. Por exemplo, dado: * <kbd class="ph userinput">connect_code_tool </kbd>subfluxo * <kbd class="ph userinput">my_app_scope </kbd>escopo {#set-up-dev-ops-integrations__ul_jdy_zck_2jb}O valor deste campo é <kbd class="ph userinput">my_app_scope.connect_code_tool </kbd>. Nota: . Nome do subfluxo O campo é deixado em branco para uma capacidade de notificação, ocorre o tratamento padrão de notificações. Consulte [Ação de capacidade da ferramenta de notificação](https://servicenow-prod.fluidtopics.net/VrQD_fOJbL4m1OXsxwxINw#dev-ops-tool-integration__section_h44_1bx_zjb). |
      | Domínio | global |
      [Tabela 4. DevOps capacidade de integração]

      {#set-up-dev-ops-integrations__table_yly_xnc_djb}
   {#set-up-dev-ops-integrations__substeps_cgl_scf_djb}
2. DevOps administrador:  
   Configure a conexão de DevOpspara 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 (no Ferramenta campo)
      * Rótulo da ferramenta
      * Alias de conexão (conexão e credencial)
      {#set-up-dev-ops-integrations__ul_l1x_vph_2jb}
   2. Copie a notificação (webhook) criada no DevOpspara o gancho de serviço da ferramenta de origem do endpoint de notificação e defina as credenciais como devops.integration.user.

   {#set-up-dev-ops-integrations__substeps_y4z_4df_djb}  
   Você pode exibir o estado dos eventos de integração na lista de eventos de entrada (DevOpsAdministraçãoEventos de Entrada).

   O estado do registro do evento de entrada está definido como Processado Depois que o objeto tiver sido inserido na tabela principal do DevOps. 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. DevOpso 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 sistemaAcesso entre escopos da aplicação e crie registros de privilégios entre escopos de leitura e gravação para permitir que seu app acesse a tabela de eventos de entrada.{#set-up-dev-ops-integrations__table_ksn_x43_2jb__entry__3}

   | 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 ||
   [ ]

   {#set-up-dev-ops-integrations__table_ksn_x43_2jb}

## 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)

