Ouvrir l'app

DocumentationWorkflowsHTTP et outils de développement

Linear node

Crée, liste et mets à jour des issues Linear directement depuis ton workflow, via l'API GraphQL officielle de Linear (un seul endpoint pour tout). Découvrez sa configuration, les entrées et sorties, le test et la résolution des erreurs.

8 min de lectureMis à jour le

Fonction du node

Crée, liste et mets à jour des issues Linear directement depuis ton workflow, via l'API GraphQL officielle de Linear (un seul endpoint pour tout).

Utilisez Linear comme étape clairement définie dans un workflow anymize.

  • Traite 1 entrée.
  • Fournit 1 sortie aux étapes suivantes.
  • S'exécute comme une étape normale du workflow.

Configurer le node

  1. 01Ouvrez un workflow et ajoutez Linear depuis le catalogue.
  2. 02Renseignez les champs requis et associez les valeurs des étapes précédentes.
  3. 03Testez le node avec un petit jeu de données et vérifiez sa sortie.
  4. 04Reliez la sortie réussie et activez le workflow après un test complet.

Actions et modes

Choisissez la fonction voulue dans Action. Le panneau affiche ensuite les paramètres utiles.

  • Créer une issue
  • Lister les issues
  • Mettre à jour une issue

Paramètres

ChampSignificationZone
Clé API LinearRéférence uniquement le nom du secret du workflow, la clé elle-même est résolue en toute sécurité au moment de l'exécution. Crée la clé dans Linear → Réglages → Security & access → Personal API keys.Protégé
ActionChoix: Créer une issue, Lister les issues, Mettre à jour une issueStandard
ID d'équipeL'ID d'équipe Linear (UUID). Filtre optionnel pour « Lister les issues », obligatoire pour « Créer une issue ».Standard
TitreTitre de l'issue.Standard
DescriptionDescription optionnelle (Markdown pris en charge).Standard
Nombre maxCombien d'issues charger au maximum (par défaut 50, max 250).Standard
ID de l'issueL'ID ou l'identifiant (ex. ENG-123) de l'issue à mettre à jour.Standard
TitreTitre de l'issue.Standard
DescriptionDescription optionnelle (Markdown pris en charge).Standard
ID du statutOptionnel, l'ID du nouveau statut de l'issue (workflow state). Laisse le statut inchangé si vide.Standard
Exécuter une fois par élémentDésactivé (par défaut) : le node s'exécute une fois pour tout l'input. Activé : s'il reçoit plusieurs éléments (par ex. de « Séparer la liste »), il s'exécute une fois PAR élément, et {{ $json }} correspond alors à cet élément. C'est ainsi que tu traites une liste de fichiers entrée par entrée.Standard
Si un élément échoue« Ignorer » écrit un champ `error` pour l'élément en échec et poursuit avec les autres, au lieu de perdre toute l'exécution à cause d'un seul fichier illisible.Standard
Pause entre les éléments (millisecondes)Attente avant chaque exécution sauf la première. 1000 = 1 seconde par élément. Utile si le service distant te limite. Maximum 300000 (5 minutes).Standard

Entrées et sorties

EntréeSignificationType
StandardReçoit le résultat complet de l'étape précédente.JSON
SortieSignificationType
StandardMet le résultat à disposition de l'étape suivante au format JSON.JSON

Ce node peut traiter les listes élément par élément. La gestion des erreurs et la pause se trouvent dans les paramètres avancés.

Exemple et test

Créer un rapport de bug comme issue Linear: commencez avec un petit jeu de données reconnaissable. Vérifiez la sortie et utilisez uniquement les champs présents.

Exemple de test

{
  "action": "create_issue",
  "team_id": "team-eng",
  "title": "Checkout wirft 500 bei Rabattcode",
  "description": "Reproduziert mit Code SUMMER10 im Staging. Stacktrace im Anhang."
}

Accès et sécurité

Avant l'activation, vérifiez les données reçues par cette étape et le contenu de sa sortie.

Stockez les clés et identifiants dans le gestionnaire protégé. Ne les insérez jamais dans les champs, données de test ou descriptions.

Résoudre les erreurs

  • Aucune sortie: vérifiez la dernière exécution et les champs fournis par le node précédent.
  • Variable vide: ouvrez la sortie précédente et utilisez un nom de champ réellement présent.
  • Liste traitée une seule fois: activez l'exécution par élément.

Articles liés