Obtenir un ticket Jira

Récupère les détails d’un ticket Jira spécifique à l’aide de sa clé.

Pour la configuration de l’authentification, consultez les actions de ticket Jira.

Saisir	Type	Description	Exemple
authToken	Chaîne	Obligatoire. Chaîne de `email:API_Token` encodée en Base64 pour l’authentification Basic. Doit être fourni en tant que secret. Voir Créer et gérer les jetons d’API .	`"${{ :secrets:jiraAuthToken }}"`
domain	Chaîne	Obligatoire. Le domaine de votre instance Jira Cloud (nom de l'entreprise). Utilisé pour construire l'URL de base `your-domain.atlassian.net` .	`"mycompany"`
issueKey	Chaîne	Obligatoire. La clé du ticket Jira à récupérer.	`"PROJ-1234"`
paramètres	Carte	Facultatif. Paramètres de requête d'URL facultatifs pour la requête d'API Jira. Consultez le tableau de référence des paramètres ci-dessous.	`{"fields": "summary,status", "expand": "transitions"}`
selectors	List	Facultatif. Une liste d'expressions nommées pour extraire des valeurs spécifiques de la réponse.	`[{"name": "summary", "expression": ".responseBody.result.summary"}]`

Référence des paramètres

paramètres	Type	Description	Défaut
champs	array<string>	Une liste séparée par des virgules de champs à renvoyer pour le ticket. Utilisez `all` pour tous les champs, `navigable` pour les champs navigables, ou préfixez un nom de champ avec `-` pour l’exclure. Exemples : `summary,comment` , `-description` , `*navigable,-comment` .	Tous les champs
fieldsByKeys	Booléen	Si les champs dans `fields` sont référencés par des clés plutôt que par des ID. Utile pour les champs d’application de connexion.	`false`
développer	Chaîne	Liste, séparée par des virgules, des informations supplémentaires à inclure. Options : `renderedFields` , `names` , `schema` , `transitions` , `editmeta` , `changelog` , `versionedRepresentations` .
propriétés	array<string>	Une liste de propriétés de ticket séparées par des virgules à renvoyer. Utilisez `*all` pour toutes les propriétés, ou préfixez une clé de propriété avec `-` pour l’exclure.
updateHistory	Booléen	S’il faut ajouter le projet du ticket à la liste des projets récemment consultés par l’utilisateur dans Jira. Remplit également le champ `lastViewed` dans la recherche JQL.	`false`
failFast	Booléen	Lorsque `true` , la requête échoue immédiatement si un champ ne peut pas être chargé. Lorsque `false` , la réponse est renvoyée avec des valeurs vides pour les champs ayant échoué.	`false`

Sortir	Type	Exemple
response	Objet	`{ "id": "10001", "key": "PROJ-1234", "fields": { "summary": "Test Ticket 1", ... } }`
success	Booléen	`success: true \| false`
errorMessage	Chaîne	`{ "errorMessages": ["Issue does not exist or you do not have permission to see it."], "errors": {} }`

Exemple de workflow
`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`

Exemple de workflow

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

Cette traduction automatique est fournie pour votre commodité.

Référence des paramètres