Obtener una incidencia de Jira

Recupera los detalles de una incidencia específica de Jira mediante su clave.

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 que desea recuperar.	`"PROJ-1234"`
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.	`{"fields": "summary,status", "expand": "transitions"}`
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
campos	array<string>	Una lista de campos separados por comas para devolver para el problema. Utilice `all` para todos los campos, `navigable` para los campos navegables, o agregue el prefijo `-` a un nombre de campo para excluirlo. Ejemplos: `summary,comment` , `-description` , `*navigable,-comment` .	Todos los campos
fieldsByKeys	Booleano	Si los campos en `fields` están referenciados por claves en lugar de ID. Útil para campos de aplicaciones de Connect.	`false`
expandir	Cadena	Lista separada por comas de información adicional para incluir. Opciones: `renderedFields` , `names` , `schema` , `transitions` , `editmeta` , `changelog` , `versionedRepresentations` .
propiedades	array<string>	Una lista separada por comas de las propiedades de la incidencia que se devolverán. Use `*all` para todas las propiedades, o agregue el prefijo `-` a una clave de propiedad para excluirla.
updateHistory	Booleano	Si se debe agregar el proyecto de la incidencia a la lista de proyectos vistos recientemente del usuario en Jira. También completa el campo `lastViewed` en la búsqueda JQL.	`false`
failFast	Booleano	Cuando `true` , la solicitud falla de inmediato si no se puede cargar algún campo. Cuando `false` , la respuesta se devuelve con valores vacíos para los campos que fallaron.	`false`

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

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

Ejemplo de flujo de trabajo

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

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

Referencia de parámetros