--- sourceDocument: Xanadu IT Service Management sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/it-service-management Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Xanadu IT Service Management ft:clusterId : - itsm bundleId : - itsm workflow : - Technology --- # Integrações criadas pelo usuário no Velocidade de mudança para DevOps # Integrações criadas pelo usuário no Velocidade de mudança para DevOps {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 7 min. de leitura As integrações criadas pelo usuário são para integrar ferramentas adicionais de planejamento, codificação e teste que não estão disponíveis por padrão na aplicação Velocidade de mudança para DevOps. A aplicação Velocidade de mudança para DevOps inclui definições de ferramentas para integrar alguns planejamentos comuns, codificação e [DevOps integração da ferramenta de teste](https://servicenow-prod.fluidtopics.net/upbNNCvaBNpHxxYusnh58Q "A integração da ferramenta de teste permite exibir resultados de testes em DevOps para Jenkins, Azure DevOps, GitHub, GitHub Enterprise, e GitLab testes de unidade, funcionais e de desempenho."), mas você também pode configurar integrações criadas pelo usuário para ferramentas adicionais em seu ambiente de DevOps. ## Objetos de integração {#dev-ops-tool-integration__section_mv2_ltw_zjb} DevOps A integração da ferramenta consiste nesses objetos. ## Ações de capacidade da ferramenta {#dev-ops-tool-integration__section_h44_1bx_zjb} * AçãoConectar : Ao se conectar, o subfluxo da ferramenta específica é chamado e o estado da conexão é atualizado. A mensagem de status da conexão é mostrada no formulário. Consulte [Subfluxo da capacidade de conexão](https://servicenow-prod.fluidtopics.net/rBU1WY66i91m9VtBzSYfpw#creating-dev-ops-subflows__section_tkj_jzf_1kb) para obter mais detalhes. * Ação dedescoberta : Ao descobrir, um registro de solicitação de importação é criado e o subfluxo da ferramenta específica é chamado (conforme definido no registro da capacidade de integração). Os camposDetalhe e Status no registro de Solicitação de importação são atualizados com o número de itens descobertos, atualizados e com falha. A carga transformada consiste em uma matriz de objetos como uma cadeia de caracteres JSON. Os elementos variam de acordo com o tipo de ferramenta. Consulte [Subfluxo de capacidade de descoberta](https://servicenow-prod.fluidtopics.net/rBU1WY66i91m9VtBzSYfpw#creating-dev-ops-subflows__section_sgn_lzf_1kb) para obter mais detalhes. * Ação deimportação : A ação de importação não é compatível com a funcionalidade de importação histórica. * Ação depesquisa : O fluxo principal de pesquisa é fornecido para oferecer suporte ao tipo de ferramenta de artefato em um subfluxo criado pelo desenvolvedor de integração. * Ação denotificação (webhook): A ferramenta de origem é configurada manualmente (pelo desenvolvedor de integração) para enviar dados brutos para a instância ServiceNow. A carga bruta é transformada em um objeto JSON padrão usando um subfluxo. Consulte o [Subfluxo da capacidade de notificação](https://servicenow-prod.fluidtopics.net/rBU1WY66i91m9VtBzSYfpw#creating-dev-ops-subflows__section_ep4_txg_w3b) e o [endpoint DevOps - POST /devops/tool/{capability}](https://www.servicenow.com/docs/access?context=devops-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) da [API DevOps](https://www.servicenow.com/docs/access?context=devops-api&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) para obter mais detalhes. Nota: Se um subfluxo não for especificado, ocorrerá o processamento padrão de notificações (a carga original será copiada automaticamente para a carga transformada). Este comportamento é útil quando os dados transacionais da ferramenta são compatíveis com ServiceNow DevOps como estão. Consulte as cargas padrão esperadas em [Subfluxo da capacidade de notificação](https://servicenow-prod.fluidtopics.net/rBU1WY66i91m9VtBzSYfpw#creating-dev-ops-subflows__section_ep4_txg_w3b) para obter mais detalhes. {#dev-ops-tool-integration__ul_y3d_sbx_zjb} ## DevOps visão geral da configuração de integração {#dev-ops-tool-integration__section_dq1_kk2_djb} A configuração de integração da ferramenta pode ser concluída pelo desenvolvedor de integração e pelo administrador DevOps. Desenvolvedor de integrações : * Crie um registro de integração de ferramenta em DevOps para definir a ferramenta que você está integrando (ferramenta de origem). * Crie um Workflow Studio [subfluxo](https://servicenow-prod.fluidtopics.net/rBU1WY66i91m9VtBzSYfpw "Para integrações criadas pelo usuário, crie um subfluxo DevOps Workflow Studio 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). * Crie um registro de mapeamento de capacidade da ferramenta em DevOps para mapear o registro de integração da ferramenta para a capacidade do tipo de ferramenta. Nota: O recurso Notificações (webhook) é compatível. As capacidades de conexão e descoberta também são compatíveis. * Crie um registro de capacidade de integração em DevOps para especificar a ação da capacidade do tipo de ferramenta. {#dev-ops-tool-integration__ul_bmc_ybx_zjb} Administrador da DevOps : * Crie um registro de ferramenta (planejamento, codificação ou teste) em DevOps para se conectar à ferramenta que você está integrando (ferramenta de origem). Nota: O registro de integração da ferramenta deve ser especificado no campo Ferramenta do registro da ferramenta. * Configure a ferramenta de origem com o webhook e as credenciais. {#dev-ops-tool-integration__ul_asn_bcx_zjb} ## Eventos de entrada {#dev-ops-tool-integration__section_r5w_vnf_2jb} Um evento de entrada serve como uma área de preparação para o fluxo de notificações que oferece suporte ao reprocessamento de cargas com falha. Ou seja, um registro em estado de erro de uma integração ou transformação com falha pode ser repetido. Se um registro de evento de entrada estiver no estado de erro, o fluxo não conseguiu inserir o registro nas tabelas principais DevOps. Erros comuns podem ser resolvidos com essas ações. {#dev-ops-tool-integration__table_xhy_k4f_2jb__entry__2} | Erro | Ação | |-|-| | Campos obrigatórios ausentes | A carga transformada não corresponde à carga padrão. Consulte as cargas padrão e JSON fornecidas. | | Repositório não marcado para acompanhamento | A confirmação não pode ser inserida. O administrador DevOps precisa rastrear o repositório. | | \[Subfluxo\] não foi publicado no escopo da aplicação \[app_scope\] | O subfluxo foi criado, mas ainda não foi publicado. | | Exceção de tempo limite | O subfluxo leva mais tempo do que o valor definido na propriedade: com.glide.hub.flow_api.default_execution_time Consulte [FlowAPI - executeSubflowQuick (nome da cadeia de caracteres, entradas do mapa, tempo limite do número)](https://www.servicenow.com/docs/access?context=ScriptableFlowAPI&version=xanadu&pubname=xanadu-api-reference&ft:locale=en-US) para obter mais detalhes. Nota: A execução do subfluxo excede o valor definido no campo Tempo limite no registro da Capacidade de integração. | | Não foi encontrado um subfluxo correspondente para a capacidade de notificação e a integração da ferramenta \[tool_integration_sys_id\] | O fluxo não conseguiu encontrar o subfluxo correspondente. Verifique o procedimento de configuração da integração. | | A carga não corresponde à capacidade esperada. | A carga original (carga que está sendo enviada) é um tipo de capacidade diferente da capacidade do tipo de ferramenta configurada no mapeamento de capacidade da ferramenta. O tipo de carga útil deve corresponder à capacidade do tipo de ferramenta configurada na integração da ferramenta. | [Tabela 1. Estados de erro de evento de entrada] {#dev-ops-tool-integration__table_xhy_k4f_2jb} Nota: Um registro de evento de entrada não é criado quando ocorre qualquer uma das seguintes condições: * A ferramenta de origem não passou o ID da ferramenta como um parâmetro de consulta. * A ferramenta de origem passou um ID de ferramenta, mas não há ID de ferramenta correspondente na instância. {#dev-ops-tool-integration__ul_fdd_tqf_2jb} ## Mapeamentos de ferramentas {#dev-ops-tool-integration__section_rsp_z1v_xnb} Uma ferramenta pode ser mapeada para vários recursos. {#dev-ops-tool-integration__table_w5z_p31_2jb__entry__3} | Integração da Ferramenta | Capacidade do tipo de ferramenta | Mapeamento de capacidade da ferramenta || |-|-|-|-| | * Agile Development 2.0 * Azure DevOps * Bitbucket * GitHub * GitHub Empresarial * GitLab * Jenkins * Jira * Rally {#dev-ops-tool-integration__ul_gbg_t1w_wkb} | * Plano * Código * Orquestração * Artefato * Teste {#dev-ops-tool-integration__ul_og4_ccw_wkb} | Plano * Agile Development 2.0 - Planejar * Azure DevOps - Plano * Jira - Plano * Rally - Plano {#dev-ops-tool-integration__ul_xj2_fcw_wkb} Código * Azure DevOps - Código * Bitbucket - Código * GitHub - Código * GitHub Empresa - Código * GitLab - Código {#dev-ops-tool-integration__ul_edc_32w_wkb} Orquestração * Azure DevOps - Orquestração * Jenkins - Orquestração * GitLab - Orquestração {#dev-ops-tool-integration__ul_jhb_p2w_wkb} Teste * Azure DevOps - Teste * Jenkins - Teste {#dev-ops-tool-integration__ul_kdr_hpl_vlb} || [ ] {#dev-ops-tool-integration__table_w5z_p31_2jb} Um mapeamento de capacidade da ferramenta pode ser mapeado para várias ações. {#dev-ops-tool-integration__table_ep4_qcw_wkb__entry__3} | Mapeamento de capacidade da ferramenta | Ação da Ferramenta | Capacidade de integração || |-|-|-|-| | * Agile Development 2.0 - Planejar * Azure DevOps - Plano * Azure DevOps - Código * Azure DevOps - Orquestração * Bitbucket - Código * GitHub - Código * GitHub Empresa - Código * GitLab - Código * GitLab - Orquestração * Jenkins - Orquestração * Jira - Plano * Rally - Plano {#dev-ops-tool-integration__ul_dns_qfw_wkb} | * Conectar * Descoberta * Importar * Pesquisar * Notificação {#dev-ops-tool-integration__ul_qlq_ycw_wkb} | Agile Development 2.0 * Agile Development 2.0 - Planejar - Conectar * Agile Development 2.0 - Planejar - Descobrir * Agile Development 2.0 - Planejar - Importar * Agile Development 2.0 - Planejar - Notificação {#dev-ops-tool-integration__ul_o3n_cfw_wkb} Azure DevOps * Azure DevOps - Planejar - Conectar * Azure DevOps - Planejar - Descobrir * Azure DevOps - Planejar - Notificação * Azure DevOps - Código - Descobrir * Azure DevOps - Código - Notificação * Azure DevOps - Orquestração - Descobrir * Azure DevOps - Orquestração - Notificação {#dev-ops-tool-integration__ul_x1r_1gw_wkb} Bitbucket * Bitbucket - Código - Conectar * Bitbucket - Código - Descobrir * Bitbucket - Código - Importar * Bitbucket - Código - Notificação {#dev-ops-tool-integration__ul_dgb_bgw_wkb} GitHub * GitHub - Código - Conectar * GitHub - Código - Descobrir * GitHub - Código - Importar * GitHub - Código - Notificação {#dev-ops-tool-integration__ul_wqw_dgw_wkb} GitHub Empresarial * GitHub - Código - Conectar * GitHub - Código - Descobrir * GitHub - Código - Importar * GitHub - Código - Notificação {#dev-ops-tool-integration__ul_opx_pmm_xkb} GitLab * GitLab - Código - Conectar * GitLab - Código - Descobrir * GitLab - Código - Notificação * GitLab - Orquestração - Notificação {#dev-ops-tool-integration__ul_vhf_nqb_gmb} Jenkins * Jenkins - Orquestração - Connect * Jenkins - Orquestração - Descobrir * Jenkins - Orquestração - Importar * Jenkins - Orquestração - Notificação {#dev-ops-tool-integration__ul_mz4_2gw_wkb} Jira * Jira - Planejar - Conectar * Jira - Planejar - Descobrir * Jira - Planejar - Importar * Jira - Planejar - Notificação {#dev-ops-tool-integration__ul_czf_dgw_wkb} Rally * Rally - Planejar - Descobrir * Rally - Planejar - Importar * Rally - Planejar - Notificação * Rally - Planejar - Conectar * Rally - Planejar - Validar {#dev-ops-tool-integration__ul_qgm_5mx_wvb} || [ ] {#dev-ops-tool-integration__table_ep4_qcw_wkb} Vários tipos de teste podem ser mapeados para cada integração de ferramenta. {#dev-ops-tool-integration__table_cc3_z5l_vlb__entry__3} | Tipo de Teste | Integração da Ferramenta | Mapeamento de tipo de teste | |-|-|-| | Unidade: JUnit, XUnit, NUnit, teste de unidade Funcional: * Integração * Regressão * Fumaça * Sistema * Aceitação do usuário {#dev-ops-tool-integration__ul_qz1_qvl_vlb} Desempenho: carregar | * Azure DevOps * Jenkins * GitLab * GitHub * GitHub Enterprise {#dev-ops-tool-integration__ul_rnq_kvl_vlb} | Azure DevOps * Azure DevOps - JUnit * Azure DevOps - Integração * Azure DevOps - Regressão * Azure DevOps - Fumaça * Azure DevOps - Sistema * Azure DevOps - Aceitação do usuário * Azure DevOps - Carregar {#dev-ops-tool-integration__ul_rb2_w5n_vlb} Jenkins * Jenkins - JUnit * Jenkins - Integração * Jenkins - Regressão * Jenkins - Fumaça * Jenkins - Sistema * Jenkins - Aceitação do usuário * Jenkins - Carregar {#dev-ops-tool-integration__ul_hfn_v5n_qnb} GitLab * GitLab - JUnit * GitLab - Integração * GitLab - Regressão * GitLab - Fumaça * GitLab - Sistema * GitLab - Aceitação do usuário * GitLab - Carregar {#dev-ops-tool-integration__ul_srs_wvr_21c} GitHub e GitHub Enterprise * GitHub - JUnit * GitHub - Integração * GitHub - Regressão * GitHub - Fumaça * GitHub - Sistema * GitHub - Aceitação do usuário * GitHub - Carregar {#dev-ops-tool-integration__ul_qvn_zvr_21c} | [ ] {#dev-ops-tool-integration__table_cc3_z5l_vlb} * **[DevOps integração da ferramenta de teste](https://servicenow-prod.fluidtopics.net/upbNNCvaBNpHxxYusnh58Q)** A integração da ferramenta de teste permite exibir resultados de testes em DevOps para Jenkins, Azure DevOps, GitHub, GitHub Enterprise, e GitLab testes de unidade, funcionais e de desempenho. * **[Integração da ferramenta de orquestração criada pelo usuário de DevOps](https://servicenow-prod.fluidtopics.net/gkR13WJ5Eaj6~zvgWLMB1w)** Integre Velocidade de mudança para DevOps a qualquer ferramenta de orquestração que não seja compatível com o sistema de base. * **[Criar uma integração da ferramenta DevOps](https://servicenow-prod.fluidtopics.net/ewHrnRGWobpf7cUbh1crTg)** Para criar uma integração de ferramenta de DevOps, o desenvolvedor de integração configura DevOps configurações de integração de ferramenta e um subfluxo Workflow Studio para coletar e transformar dados da ferramenta de origem. Em seguida, o administrador DevOps configura as conexões da ferramenta DevOps. * **[Criando DevOps subfluxos](https://servicenow-prod.fluidtopics.net/rBU1WY66i91m9VtBzSYfpw)** Para integrações criadas pelo usuário, crie um subfluxo DevOps Workflow Studio para coletar e transformar dados da ferramenta que você está integrando.