Actualizar una incidencia de Jira

Actualiza una incidencia de Jira existente.

Para la configuración de la autenticación, consulte las acciones de incidencias de Jira.

Campo de entrada	Opcionalidad	Tipo	Descripción	Ejemplo
authToken	Requerido	Cadena	Cadena codificada en Base64 de `email:API_Token` para autenticación básica. Se debe proporcionar como un secreto. Consulte Crear y administrar tokens de API .	`"${{ :secrets:jiraAuthToken }}"`
dominio	Requerido	Cadena	El dominio de su instancia de Jira Cloud (nombre de la empresa). Se utiliza para construir la URL base `your-domain.atlassian.net` .	`"mycompany"`
issueKey	Requerido	Cadena	La clave de la incidencia de Jira a actualizar.	`"PROJ-123"`
parámetro	Opcional	Mapa	Parámetros de consulta de URL opcionales para la solicitud de la API de Jira. Consulte la tabla de referencia de parámetros a continuación.	`{"notifyUsers": "false", "returnIssue": "true", "expand": "changelog,renderedFields"}`
campos	Opcional	Mapa	Un mapa de los campos de la pantalla de problemas para actualizar, especificando el subcampo y su valor. Use esto para actualizaciones sencillas de un solo subcampo. Los campos incluidos aquí no se pueden incluir también en `update` . Para obtener todos los campos con valores permitidos, use `GET /rest/api/3/issue/{issueKey}/editmeta` .	`{"priority": {"name": "High"}, "labels": ["bug", "production"]}`
actualizar	Opcional	Mapa	Un mapa de nombres de campos y una lista de operaciones para realizar en el campo de la pantalla de la incidencia. Utilice esto cuando se requieran múltiples subcampos u otras operaciones. Los campos incluidos aquí no pueden incluirse también en `fields` .	`{"labels": [{"add": "critical"}, {"remove": "minor"}], "components": [{"set": [{"name": "Backend"}]}]}`
selectors	Opcional	Lista	Una lista de expresiones con nombre para extraer valores específicos de la respuesta.	`[{"name": "summary", "expression": ".responseBody.result.summary"}]`

Referencia de parámetros

Parámetro	Tipo	Descripción	Por defecto
notifyUsers	Booleano	Si se envía un correo electrónico de notificación sobre la actualización del problema a todos los observadores. Para desactivar la notificación, se requieren los permisos Administrar Jira o Administrar proyecto . Si el usuario no tiene el permiso necesario, esto se ignora.	`true`
overrideScreenSecurity	Booleano	Si se anula la seguridad de la pantalla para permitir la edición de campos ocultos. Disponible para los usuarios de las aplicaciones Connect y Forge con el permiso global Administer Jira .	`false`
overrideEditableFlag	Booleano	Si se anula la seguridad de la pantalla para permitir que se editen los campos no editables. Disponible para los usuarios de las aplicaciones Connect y Forge con el permiso global Administer Jira .	`false`
returnIssue	Booleano	Si la respuesta debe contener el problema con los campos editados en esta solicitud, con el formato de la API Get issue.	`false`
expandir	Cadena	El parámetro expand de la API Get issue para usar en la respuesta si `returnIssue` es `true` .

Campo de salida	Tipo	Ejemplo
response	Objeto	Una actualización exitosa devuelve un cuerpo vacío con el estado 204.
success	Booleano	`success: true \| false`
errorMessage	Cadena	`{ "errorMessages": ["Can not update issue with invalid data"], "errors": { "summary": "Summary is required" } }`

Ejemplo de flujo de trabajo
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

Ejemplo de flujo de trabajo

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

Te ofrecemos esta traducción automática para facilitar la lectura.

Referencia de parámetros