Azure DevOps
Consultar e alterar work items usando ferramentas do agente. Confira os campos necessários, a obtenção das credenciais e o funcionamento na Zild.
Consultar e alterar work items usando ferramentas do agente.
Onde configurar
Abra Zild Admin → Integrações → Conectores, localize o provedor e use Configurar ou Editar. Informe os dados deste guia, habilite o conector para o fluxo e salve.
Campos necessários
Os requisitos abaixo são os dados necessários ao fluxo que utiliza o conector. O cadastro genérico pode aceitar campos vazios que serão exigidos somente ao executar uma operação. O botão Salvar não confirma que a credencial funciona no provedor.
| Campo | Requisito para o fluxo |
|---|---|
Url | URL da organização, como https://dev.azure.com/ORGANIZATION. |
ApiKey | Personal Access Token (PAT) da organização. |
CustomProperties.Project | Nome/identificador do projeto utilizado pelas ferramentas. |
Como obter as credenciais
- Abra a organização no Azure DevOps e selecione User settings → Personal access tokens → New Token.
- Escolha a organização, a validade e os escopos de Work Items necessários (leitura e, para alterações, escrita).
- Crie o PAT, copie-o para ApiKey e preencha Url e Project no conector.
Como funciona na Zild
O formulário e o executor exigem Url, ApiKey e Project. CustomProperties.ApiVersion é opcional e assume 7.1 se estiver vazio. Selecione o conector ativo na ferramenta do agente.
Como conferir a configuração
Depois de salvar, use o fluxo correspondente (consulta, agente, chamada ou processamento) para verificar o acesso. Se houver erro, confira credencial, permissões e recurso escolhido no provedor. Para tipos limitados ou legados, confirme a disponibilidade com a administração antes de tentar usar.
Na edição, a Zild mostra credenciais protegidas como asteriscos. Preserve o valor mascarado para manter a credencial atual ou cole uma nova credencial para substituí-la.