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.

Aporte	Tipo	Descripción	Ejemplo
authToken	Cadena	Requerido. Cadena de `email:API_Token` codificada en Base64 para la autenticación básica. Se debe proporcionar como un secreto. Consulte Crear y administrar tokens de API .	`"${{ :secrets:jiraAuthToken }}"`
dominio	Cadena	Requerido. El dominio de la instancia de Jira Cloud (nombre de la empresa). Se utiliza para construir la URL base `your-domain.atlassian.net` .	`"mycompany"`
issueKey	Cadena	Requerido. La clave de la incidencia de Jira que desea recuperar.	`"PROJ-1234"`
parámetro	Mapa	Opcional. 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	Lista	Opcional. 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`

Producción	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