Utilisation des actions Linear dans les workflows d’actions

Linear est un outil de suivi des problèmes et de gestion de projets conçu pour les équipes logicielles. Avec le connecteur Linear pour le créateur d’actions, vous pouvez créer et gérer des problèmes, des projets et des commentaires, rechercher des problèmes et des utilisateurs, et organiser le travail de votre équipe directement dans vos workflows d’actions Zendesk.

Mon édition

Suite, toutes les versions

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support

Team, Professional ou Enterprise

Résumé ◀▼

Vous pouvez connecter vos workflows d’actions avec Linear pour créer, mettre à jour et gérer les problèmes, les projets et les commentaires directement au sein de vos workflows. Cette intégration prend en charge la recherche de problèmes et d’utilisateurs, l’affectation des problèmes et l’organisation des projets, ce qui vous aide à simplifier la gestion de projets et le suivi des problèmes sans changer de plateforme. Utilisez un compte de service dédié pour des actions externes sécurisées et attribuées.

En connectant le créateur d’actions à des systèmes externes, comme Linear, les administrateurs peuvent intégrer Zendesk à des systèmes externes dans des workflows automatisés, ce qui améliore la collaboration et permet d’assurer une expérience fluide et cohérente sur plusieurs plateformes.

Remarque – Les étapes associées aux systèmes externes dans des workflows d’actions sont appelées collectivement des actions externes.

Linear est un outil de suivi des problèmes et de gestion de projets conçu pour les équipes logicielles. Avec le connecteur Linear pour le créateur d’actions, vous pouvez créer et gérer des problèmes, des projets et des commentaires, rechercher des problèmes et des utilisateurs, et organiser le travail de votre équipe directement dans vos workflows d’actions Zendesk.

Cet article aborde les sujets suivants :

• Connexion de Linear au créateur d’actions
• Utilisation des actions Linear dans les workflows d’actions

Connexion de Linear au créateur d’actions

Avant de pouvoir inclure des actions externes dans vos workflows d’actions, vous devez connecter le créateur d’actions au système externe.

Quand vous vous connectez à des systèmes externes pour les utiliser dans des workflows d’actions, nous vous conseillons de suivre ces meilleures pratiques :

• Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.
• Toutes les intégrations demandent l’accès aux portées obligatoires. Cependant, il est important d’examiner et de valider les portées avant d’autoriser l’accès au système externe.
• Quand vous gérez les identifiants pour les outils basés sur des clés API, comme OpenAI, nous vous conseillons de stocker les clés dans un gestionnaire d’identifiants ou un coffre-fort sécurisé.

Pour connecter le créateur d’actions à Linear

1. Dans le Centre d’administration, cliquez sur Applications et intégrations () dans la barre latérale, puis sélectionnez Actions > Workflows d’actions.
2. Créez ou modifiez un workflow d’actions.
3. Ouvrez la barre latérale.
4. Sous Actions externes, cliquez sur Linear.
5. Cliquez sur Connexion.
6. Suivez les invites de Linear pour vous authentifier et terminer la connexion.

   La connexion Linear utiliser OAuth 2.0 avec le type d’octroi Code d’autorisation. Quand vous autorisez la connexion, vous êtes redirigé vers Linear pour accorder les permissions pour votre compte Zendesk.

   Remarque – Toutes les actions externes effectuées par un workflow d’actions sont attribuées à l’utilisateur qui a connecté le système externe. Il est donc recommandé d’utiliser un compte de service dédié plutôt que des identifiants personnels quand vous vous connectez à chaque système externe.

Une fois que vous vous êtes connecté au système, vous verrez un indicateur de connexion et des détails sur l’instance à laquelle vous êtes connecté, ainsi que les actions disponibles pour Linear.

Utilisation des actions Linear dans les workflows d’actions

Vous pouvez utiliser les étapes d’actions Linear pour rechercher des formulaires et des réponses aux enquêtes.

Les actions Linear suivantes sont disponibles :

• Créer un problème
• Mettre le problème à jour
• Rechercher un problème
• Rechercher des problèmes
• Ajouter un commentaire au problème
• Rechercher un utilisateur
• Rechercher des utilisateurs
• Créer un projet
• Mettre le projet à jour
• Ajouter un problème au projet
• Affecter le problème à un membre

Création d’un problème

Utilisez l’action Créer un problème pour créer un nouveau problème dans Linear avec les détails spécifiés.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Titre, Équipe Facultatives : Description, Projet, E-mail de l'assigné, Statut, Priorité, Date d'échéance, Estimation Remarque – La date d’échéance doit être au format AAAA-MM-JJ et basée sur le fuseau horaire de votre compte Linear. Les options de priorité incluent : Aucune priorité, Urgente, Élevée, Moyenne et Basse.
Sortie	Détails du problème, notamment l’ID, l’identifiant, le titre, la description, l’URL, les informations du projet, les informations de l’assigné, les informations de statut, la priorité, la date d’échéance, l’estimation et les horodatages

Mise à jour d’un problème

Utilisez l’action Mettre à jour le problème pour mettre à jour les propriétés d’un problème existant dans Linear.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Problème Facultatives : Titre, Description, E-mail de l’assigné, Projet, Statut, Priorité, Date d'échéance, Estimation Remarque – La date d’échéance doit être au format AAAA-MM-JJ et basée sur le fuseau horaire de votre compte Linear.
Sortie	Détails du problème mis à jour, notamment l’ID, l’identifiant, le titre, la description, l’URL, les informations de l’assigné, les informations de statut, la priorité, la date d’échéance, l’estimation et l’horodatage de mise à jour

Recherche d’un problème

Utilisez l’action Rechercher un problème pour récupérer des informations détaillées au sujet d’un problème spécifique.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : ID du problème
Sortie	Détails du problème, notamment l’ID, l’identifiant, le titre, la description, l’URL, les informations du projet, les informations de l’assigné, les informations de statut, la priorité, la date d’échéance, l’estimation et les horodatages

Recherche de problèmes

Utilisez l’action Rechercher des problèmes pour trouver des problèmes en fonction de divers critères.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Facultatives : Équipe, Projet, E-mail de l’assigné, Statut, Trier par, Limite, Curseur
Sortie	Tableau des problèmes, avec l’ID, l’identifiant, le titre, l’URL, les informations de statut, les informations d’assigné, la priorité et l’horodatage de création ; inclut aussi les informations de pagination (hasNextPage, endCursor)

Ajout d’un commentaire à un problème

Utilisez l’action Ajouter un commentaire au problème pour ajouter un commentaire à un problème existant.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Problème, Corps
Sortie	Détails du commentaire, notamment l’ID, le texte du corps, les informations sur l’auteur (ID et non) et l’horodatage de création

Recherche d’un utilisateur

Utilisez l’action Rechercher un utilisateur pour récupérer des informations sur un utilisateur par e-mail ou nom d’affichage.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Rechercher par, Valeur
Sortie	Détails de l’utilisateur, notamment l’ID, le nom, le nom d’affichage, l’e-mail, l’URL de l’avatar et l’URL du profil

Recherches d’utilisateurs

Utilisez l’action Rechercher des utilisateurs pour trouver des utilisateurs correspondant à une requête de recherche.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Requête Facultatives : Limite, Curseur
Sortie	Tableau des utilisateurs avec l’ID, le nom, le nom d’affichage, l’adresse e-mail, et l’URL de l’avatar ; inclut aussi les informations de pagination (hasNextPage, endCursor)

Création d’un projet

Utilisez l’action Créer un projet pour créer un nouveau projet dans Linear.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Nom, Équipe Facultatives : Description, Date de début, Date de fin Remarque – Les dates de début et de fin doivent être au format AAAA-MM-JJ et basées sur le fuseau horaire de votre compte Linear.
Sortie	Détails du projet, notamment l’ID, le nom, la description, l’URL, les informations de l’équipe (ID et nom), la date de début, la date de fin et l’horodatage de création

Mise à jour d’un projet

Utilisez l’action Mettre le projet à jour pour mettre à jour les propriétés d’un projet existant.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Projet Facultatives : Nom, Description, Date de début, Date de fin Remarque – Les dates de début et de fin doivent être au format AAAA-MM-JJ et basées sur le fuseau horaire de votre compte Linear.
Sortie	Détails du projet mis à jour, notamment l’ID, le nom, la description, l’URL, la date de début, la date de fin et l’horodatage de mise à jour

Ajout d’un problème au projet

Utilisez l’action Ajouter un problème au projet pour affecter un problème existant à un projet.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Problème, Projet
Sortie	Détails du problème, notamment l’ID, l’identifiant, le titre, l’URL et les informations du projet (ID et nom)

Affectation d’un problème à un membre

Utilisez l’action Affecter le problème à un membre pour affecter un problème à un membre de l’équipe par e-mail.

Cette action a les entrées et les sorties suivantes :

	Variables
Entrées	Obligatoires : Problème, E-mail de l’assigné
Sortie	Détails du problème, notamment l’ID, l’identifiant, le titre, l’URL et les informations de l’assigné (ID et nom)