Atualizar um problema do Jira

Atualiza um problema existente do Jira.

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 do item do Jira a ser atualizado.	`"PROJ-123"`
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.	`{"notifyUsers": "false", "returnIssue": "true", "expand": "changelog,renderedFields"}`
campos	Opcional	Mapa	Um mapa dos campos da tela do item a serem atualizados, especificando o subcampo e o seu valor. Isto deve ser utilizado para atualizações diretas de um único subcampo. Os campos incluídos aqui não podem ser incluídos também em `update` . Para obter todos os campos com valores permitidos, deve-se utilizar `GET /rest/api/3/issue/{issueKey}/editmeta` .	`{"priority": {"name": "High"}, "labels": ["bug", "production"]}`
atualizar	Opcional	Mapa	Um mapa de nomes de campos e uma lista de operações a serem executadas no campo da tela de ocorrências. Isto deve ser utilizado quando vários subcampos ou outras operações forem necessários. Os campos incluídos aqui não podem ser incluídos também em `fields` .	`{"labels": [{"add": "critical"}, {"remove": "minor"}], "components": [{"set": [{"name": "Backend"}]}]}`
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
notifyUsers	Boleano	Se um e-mail de notificação sobre a atualização do problema é enviado a todos os observadores. Para desativar as notificações, são necessárias as permissões Administer Jira ou Administer project . Se o usuário não tiver a permissão necessária, isso será ignorado.	`true`
overrideScreenSecurity	Boleano	Se a segurança da tela é ignorada para permitir que campos ocultos sejam editados. Disponível para usuários dos aplicativos Connect e Forge com a permissão global Administer Jira .	`false`
overrideEditableFlag	Boleano	Se a segurança da tela é substituída para permitir que campos não editáveis sejam editados. Disponível para usuários dos aplicativos Connect e Forge com a permissão global Administer Jira .	`false`
returnIssue	Boleano	Se a resposta deve conter o problema com os campos editados nesta solicitação, formatados como na API Get issue.	`false`
expandir	Corda	O parâmetro expand da API Get issue a ser usado na resposta se `returnIssue` for `true` .

Campo de saída	Tipo	Exemplo
response	Objeto	Uma atualização bem-sucedida retorna um corpo vazio com o status 204.
success	Boleano	`success: true \| false`
errorMessage	Corda	`{ "errorMessages": ["Can not update issue with invalid data"], "errors": { "summary": "Summary is required" } }`

Exemplo de fluxo de trabalho
name: update-jira-issues description: 'Updates a ticket summary and adds a new label.' steps: - name: set_summary type: action action: jira.issue.update version: 1 inputs: authToken: ${{ :secrets:jiraAuthToken }} domain: mycompany issueKey: "PROJ-123" fields: summary: "Updated: Critical production error resolved" description: type: "doc" version: 1 content: - type: "paragraph" content: - type: "text" text: "Root cause identified and fix deployed to production" update: labels: - add: "resolved" - add: "production" parameters: returnIssue: "true" next: end

Exemplo de fluxo de trabalho

name: update-jira-issues
description: 'Updates a ticket summary and adds a new label.'
steps:
  - name: set_summary
    type: action
    action: jira.issue.update
    version: 1
    inputs:
      authToken: ${{ :secrets:jiraAuthToken }}
      domain: mycompany
      issueKey: "PROJ-123"
      fields:
        summary: "Updated: Critical production error resolved"
        description:
          type: "doc"
          version: 1
          content:
            - type: "paragraph"
              content:
                - type: "text"
                  text: "Root cause identified and fix deployed to production"
      update:
        labels:
          - add: "resolved"
          - add: "production"
      parameters:
        returnIssue: "true"
    next: end

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

Referência de parâmetros