Obter um problema do Jira

Recupera os detalhes de um problema específico do Jira usando a respectiva chave.

Para a configuração de autenticação, consulte as ações de issue do Jira.

Campo de entrada	Opcionalidade	Tipo	Descrição	Exemplo
authToken	Obrigatório	Corda	String codificada em Base64 de `email:API_Token` para autenticação básica. Deve ser fornecido como um segredo. Consulte Criar e gerenciar token de API .	`"${{ :secrets:jiraAuthToken }}"`
domínio	Obrigatório	Corda	O domínio da instância do Jira Cloud (nome da empresa). Usado para construir o URL base `your-domain.atlassian.net` .	`"mycompany"`
issueKey	Obrigatório	Corda	A chave da issue do Jira a ser recuperada.	`"PROJ-1234"`
parâmetro	Opcional	Mapa	Parâmetros de consulta de URL opcionais para a requisição da API do Jira. Consulte a tabela de referência de parâmetros abaixo.	`{"fields": "summary,status", "expand": "transitions"}`
selectors	Opcional	Lista	Uma lista de expressões nomeadas para extrair valores específicos da resposta.	`[{"name": "summary", "expression": ".responseBody.result.summary"}]`

Referência de parâmetros

Parâmetro	Tipo	Descrição	Padrão
campos	array<string>	Uma lista de campos separados por vírgula a serem retornados para o problema. Deve-se usar `all` para todos os campos, `navigable` para campos navegáveis ou adicionar o prefixo `-` a um nome de campo para excluí-lo. Exemplos: `summary,comment` , `-description` , `*navigable,-comment` .	Todos os campos
fieldsByKeys	Boleano	Se os campos em `fields` são referenciados por chaves em vez de IDs. Útil para conectar campos de aplicativo.	`false`
expandir	Corda	Lista separada por vírgulas de informações adicionais a serem incluídas. Opções: `renderedFields` , `names` , `schema` , `transitions` , `editmeta` , `changelog` , `versionedRepresentations` .
propriedades	array<string>	Uma lista separada por vírgulas de propriedades de problemas a serem retornadas. Utilize `*all` para todas as propriedades ou adicione o prefixo `-` a uma chave de propriedade para excluí-la.
updateHistory	Boleano	Se o projeto do problema deve ser adicionado à lista de projetos visualizados recentemente do usuário no Jira. Também preenche o campo `lastViewed` na pesquisa JQL.	`false`
failFast	Boleano	Quando `true` , a solicitação falha imediatamente se algum campo não puder ser carregado. Quando `false` , a resposta é retornada com valores vazios para os campos que falharam.	`false`

Campo de saída	Tipo	Exemplo
response	Objeto	`{ "id": "10001", "key": "PROJ-1234", "fields": { "summary": "Test Ticket 1", ... } }`
success	Boleano	`success: true \| false`
errorMessage	Corda	`{ "errorMessages": ["Issue does not exist or you do not have permission to see it."], "errors": {} }`

Exemplo de fluxo de trabalho
`name: get-jira-issue-details description: 'Retrieves the summary and status of a specific Jira issue.' steps: - name: get_issue type: action action: jira.issue.get version: 1 inputs: authToken: ${{ :secrets:jiraAuthToken }} domain: mycompany issueKey: PROJ-567 parameters: fields: "summary,status,issuetype" next: end`

Exemplo de fluxo de trabalho

name: get-jira-issue-details
description: 'Retrieves the summary and status of a specific Jira issue.'
steps:
  - name: get_issue
    type: action
    action: jira.issue.get
    version: 1
    inputs:
      authToken: ${{ :secrets:jiraAuthToken }}
      domain: mycompany
      issueKey: PROJ-567
      parameters:
        fields: "summary,status,issuetype"
    next: end

Esta tradução de máquina é fornecida para sua comodidade.

Referência de parâmetros