Workflow n8n
Automatisation n8n : synchronisation de projets Linear avec Productboard
Ce workflow n8n a pour objectif de synchroniser les statuts et les dates de fin des projets Linear avec les fonctionnalités de Productboard. Dans un contexte où les équipes de développement doivent suivre efficacement l'avancement de leurs projets, cette automatisation permet d'éliminer les tâches manuelles et d'assurer que les informations restent à jour sur les deux plateformes. Les cas d'usage incluent la mise à jour automatique des statuts de projet, ce qui facilite la communication entre les équipes et améliore la visibilité des projets en cours. Le workflow débute avec un déclencheur Linear qui active le processus lorsque des modifications sont apportées à un projet. Ensuite, il utilise plusieurs nœuds HTTP pour récupérer l'identifiant de la fonctionnalité Productboard correspondante, puis met à jour le statut et le calendrier de cette fonctionnalité. Des nœuds de fusion et de séparation sont utilisés pour gérer les données, tandis que des conditions permettent de s'assurer que seules les informations pertinentes sont traitées. En intégrant des notifications via Slack, ce workflow garantit que toutes les parties prenantes sont informées des mises à jour en temps réel. Les bénéfices business incluent une réduction significative des erreurs humaines, une meilleure collaboration entre les équipes et un gain de temps considérable dans la gestion des projets. Cette automatisation n8n représente une véritable valeur ajoutée pour les entreprises cherchant à optimiser leur processus de développement produit.
Tags clés :automatisationn8nProductboardLinearsynchronisation
Catégorie: Webhook · Tags: automatisation, n8n, Productboard, Linear, synchronisation❤ 0
Workflow n8n Productboard, Linear, synchronisation : vue d'ensemble
Schéma des nœuds et connexions de ce workflow n8n, généré à partir du JSON n8n.
Workflow n8n Productboard, Linear, synchronisation : détail des nœuds
Inscris-toi pour voir l'intégralité du workflow
Inscription gratuite
S'inscrire gratuitementBesoin d'aide ?{
"meta": {
"instanceId": "21b41c2deb1c9e3f543253a0aa6a6e2c7bd7ef6bab90ffd478aa947c17d3b352",
"templateCredsSetupCompleted": true
},
"name": "Linear Project Status and End Date to Productboard feature Sync",
"tags": [
{
"id": "6Ek7V8f4xbM9vWLj",
"name": "linear",
"createdAt": "2024-11-08T12:12:15.330Z",
"updatedAt": "2024-11-08T12:12:15.330Z"
},
{
"id": "XpcIJ8IHNenz3bWz",
"name": "productboard",
"createdAt": "2024-11-08T12:12:17.249Z",
"updatedAt": "2024-11-08T12:12:17.249Z"
}
],
"nodes": [
{
"id": "5cf79e5e-6a69-49b5-865f-6ca8009dbf75",
"name": "linear project id",
"type": "n8n-nodes-base.set",
"position": [
3180,
220
],
"parameters": {
"fields": {
"values": [
{
"name": "linear_project_url",
"stringValue": "={{ $json.url }}"
},
{
"name": "linear_project_id",
"stringValue": "={{ $json.url.split('https://linear.app/<your company>/project/')[1] }}"
},
{
"name": "linear_project_status",
"stringValue": "={{ $json.data.status.name }}"
},
{
"name": "startDate",
"stringValue": "={{ $json.data.startDate }}"
},
{
"name": "targetDate",
"stringValue": "={{ $json.data.targetDate }}"
}
]
},
"include": "none",
"options": {}
},
"typeVersion": 3.2
},
{
"id": "642e73fc-8904-4631-9e97-1ccff6dbb559",
"name": "get productboard feature id",
"type": "n8n-nodes-base.httpRequest",
"position": [
3180,
400
],
"parameters": {
"url": "https://api.productboard.com/hierarchy-entities/custom-fields-values",
"options": {},
"sendQuery": true,
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"queryParameters": {
"parameters": [
{
"name": "customField.id",
"value": "<productboard_customfield_uuid>"
}
]
},
"headerParameters": {
"parameters": [
{
"name": "Content-Type",
"value": "application/json"
},
{
"name": "X-Version",
"value": "1"
}
]
}
},
"stickyNote": "Fetches the Productboard feature ID using a custom field value.",
"credentials": {
"httpHeaderAuth": {
"id": "Z0ptr85smbBZBIYx",
"name": "Product Board"
}
},
"notesInFlow": false,
"typeVersion": 4.1
},
{
"id": "3c328300-ff68-4958-8ac3-5b8fca122bbd",
"name": "update productboard status & timeframe",
"type": "n8n-nodes-base.httpRequest",
"position": [
5560,
380
],
"parameters": {
"url": "=https://api.productboard.com/features/{{ $json.feature_id }}",
"method": "PATCH",
"options": {
"batching": {
"batch": {
"batchSize": 1,
"batchInterval": 2000
}
}
},
"jsonBody": "={\n \"data\": {\n \"status\": {\n \"name\": \"{{ $json[\"productboard_status\"] }}\"\n },\n \"timeframe\": {\n {{ $json[\"targetDate\"] ? '\"granularity\": \"month\",': '\"granularity\": \"none\",'}}\n {{ $json[\"targetDate\"] ? '\"startDate\": \"' + $json['targetDate'].substring(0, 7) + '-01' +'\",': '\"startDate\": \"none\",'}}\n {{ $json[\"targetDate\"] \n ? (() => {\n const date = new Date($json['targetDate']);\n const year = date.getFullYear();\n const month = date.getMonth() + 1;\n const lastDay = new Date(year, month, 0).getDate();\n return `\"endDate\": \"${year}-${month.toString().padStart(2, '0')}-${lastDay}\"`;\n })() \n : '\"endDate\": \"none\"'}}\n }\n }\n}",
"sendBody": true,
"sendHeaders": true,
"specifyBody": "json",
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"headerParameters": {
"parameters": [
{
"name": "X-Version",
"value": "1"
},
{
"name": "accept",
"value": "application/json"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "Z0ptr85smbBZBIYx",
"name": "Product Board"
}
},
"typeVersion": 4.1
},
{
"id": "ec57bdeb-413b-4f71-b8c4-82b966fd4caf",
"name": "map linear to productboard status",
"type": "n8n-nodes-base.set",
"position": [
4300,
280
],
"parameters": {
"fields": {
"values": [
{
"name": "linear_status",
"stringValue": "={{ $json.linear_project_status }}"
}
]
},
"options": {}
},
"typeVersion": 3.2
},
{
"id": "052dcbb4-c113-4e1a-8469-e460a9bfefaf",
"name": "mapping",
"type": "n8n-nodes-base.code",
"position": [
4560,
280
],
"parameters": {
"mode": "runOnceForEachItem",
"jsCode": "const linearStatus = $json.linear_status;\nlet productboardStatus;\n\nswitch(linearStatus) {\n case 'Backlog':\n productboardStatus = 'Candidate';\n break;\n case 'Planned':\n productboardStatus = 'Planned';\n break;\n case 'Paused':\n productboardStatus = 'Planned';\n break;\n case 'In Progress':\n productboardStatus = 'In progress';\n break;\n case 'Completed':\n productboardStatus = 'Released';\n break;\n case 'Canceled':\n productboardStatus = 'Won\\'t do';\n break;\n default:\n productboardStatus = 'Candidate'; // Default or handle unknown status\n}\n\nreturn { productboard_status: productboardStatus };\n"
},
"typeVersion": 2
},
{
"id": "4fee2a41-4e20-4642-badd-164c6d0b1232",
"name": "Merge",
"type": "n8n-nodes-base.merge",
"position": [
4780,
300
],
"parameters": {
"mode": "combine",
"options": {},
"combinationMode": "mergeByPosition"
},
"typeVersion": 2.1
},
{
"id": "49289417-ca21-4b03-b558-61a04b6eb7dd",
"name": "Split Out",
"type": "n8n-nodes-base.splitOut",
"position": [
3400,
400
],
"parameters": {
"options": {},
"fieldToSplitOut": "data"
},
"typeVersion": 1
},
{
"id": "b89135b5-3c72-44a9-9d8e-b0190385cf65",
"name": "Merge1",
"type": "n8n-nodes-base.merge",
"position": [
3920,
280
],
"parameters": {
"mode": "combine",
"options": {},
"mergeByFields": {
"values": [
{
"field1": "linear_project_url",
"field2": "linear_url_productboard"
}
]
}
},
"typeVersion": 2.1
},
{
"id": "cf533225-7507-471e-9d45-4a490b30a01d",
"name": "Edit Fields",
"type": "n8n-nodes-base.set",
"position": [
3740,
400
],
"parameters": {
"fields": {
"values": [
{
"name": "linear_url_productboard",
"stringValue": "={{ $json['value'].match('^(https:\\/\\/linear\\.app\\/[^\\/]+\\/project\\/[^\\/]+)')[0] }}"
},
{
"name": "feature_id",
"stringValue": "={{ $json['hierarchyEntity'].id }}"
}
]
},
"include": "none",
"options": {}
},
"typeVersion": 3.2
},
{
"id": "ee7f8ef5-f5a9-4a39-9621-ccf908036eeb",
"name": "Slack",
"type": "n8n-nodes-base.slack",
"position": [
5820,
380
],
"parameters": {
"text": "=:linear: {{ $json.data.name }} with status {{ $json.data.status.name }} and dates {{ $json.data.timeframe.startDate }} - {{ $json.data.timeframe.endDate }} updated :productboard: {{ $json.data.links.html }}.",
"select": "channel",
"blocksUi": "={\n \"blocks\": [\n {\n \"type\": \"section\",\n \"text\": {\n \"type\": \"mrkdwn\",\n \"text\": \":linear: to :productboard: update\\n\\n*{{ $json.data.name }}*\\n\\n*Status:* {{ $json.data.status.name }}\\n*:dart: date:* {{ $json[\"data\"][\"timeframe\"][\"endDate\"] && $json[\"data\"][\"timeframe\"][\"endDate\"] !== \"none\" ? new Date($json[\"data\"][\"timeframe\"][\"endDate\"]).toLocaleDateString(\"en-US\", { month: \"long\", year: \"numeric\" }) : \"none\" }}\"\n }\n },\n {\n \"type\": \"divider\"\n },\n {\n \"type\": \"section\",\n \"text\": {\n \"type\": \"mrkdwn\",\n \"text\": \"You can view the update in Productboard using the link below:\"\n },\n \"accessory\": {\n \"type\": \"button\",\n \"text\": {\n \"type\": \"plain_text\",\n \"text\": \"Open Productboard\"\n },\n \"url\": \"{{ $json.data.links.html }}\"\n }\n }\n ]\n}\n",
"channelId": {
"__rl": true,
"mode": "name",
"value": "#product-notifications"
},
"messageType": "block",
"otherOptions": {}
},
"credentials": {
"slackApi": {
"id": "SG3oDwwLGpxwoJSO",
"name": "Slack"
}
},
"typeVersion": 2.1
},
{
"id": "4ab5c298-5947-47d1-ac10-db502a0b4b60",
"name": "If",
"type": "n8n-nodes-base.if",
"position": [
5280,
400
],
"parameters": {
"options": {
"looseTypeValidation": true
},
"conditions": {
"options": {
"leftValue": "",
"caseSensitive": true,
"typeValidation": "loose"
},
"combinator": "or",
"conditions": [
{
"id": "f53c6eb9-61cc-4cf9-bbb6-03cc9f78b6b1",
"operator": {
"type": "string",
"operation": "notEquals"
},
"leftValue": "={{ $json.productboard_status }}",
"rightValue": "={{ $json.data.status.name }}"
},
{
"id": "a61b4bca-47b0-48bb-b93f-ba9a419740d0",
"operator": {
"type": "string",
"operation": "notEquals"
},
"leftValue": "={{ $json[\"targetDate\"] \n ? (() => {\n const date = new Date($json['targetDate']);\n const year = date.getFullYear();\n const month = date.getMonth() + 1;\n const lastDay = new Date(year, month, 0).getDate();\n return `${year}-${month.toString().padStart(2, '0')}-${lastDay}`;\n })() \n : '\"endDate\": \"none\"'}}",
"rightValue": "={{ $json.data.timeframe.endDate }}"
}
]
}
},
"typeVersion": 2
},
{
"id": "3efe9d27-7983-419d-8ac1-9efde3751952",
"name": "get productboard feature details",
"type": "n8n-nodes-base.httpRequest",
"position": [
4300,
540
],
"parameters": {
"url": "=https://api.productboard.com/features/{{ $json.feature_id }}",
"options": {},
"sendHeaders": true,
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"headerParameters": {
"parameters": [
{
"name": "Content-Type",
"value": "application/json"
},
{
"name": "X-Version",
"value": "1"
}
]
}
},
"credentials": {
"httpHeaderAuth": {
"id": "Z0ptr85smbBZBIYx",
"name": "Product Board"
}
},
"typeVersion": 4.1
},
{
"id": "265b3359-c63d-4188-ad1b-a33ce5e081f5",
"name": "Merge2",
"type": "n8n-nodes-base.merge",
"position": [
5040,
400
],
"parameters": {
"mode": "combine",
"options": {},
"joinMode": "keepEverything",
"mergeByFields": {
"values": [
{
"field1": "feature_id",
"field2": "data.id"
}
]
}
},
"typeVersion": 2.1
},
{
"id": "5dc1c2f5-a92d-49f4-acb9-8084bf878b05",
"name": "Your Linear Project 2",
"type": "n8n-nodes-base.linearTrigger",
"position": [
2840,
260
],
"webhookId": "180ebe54-3ab2-439f-b44b-40be97a62b87",
"parameters": {
"teamId": "8434c5f8-1ce0-4733-949d-ef6a095c27fd",
"resources": [
"project"
]
},
"credentials": {
"linearApi": {
"id": "hhmsOxH2jUEvGbvN",
"name": "Linear"
}
},
"typeVersion": 1
},
{
"id": "6f70d103-cf98-4ab8-9550-a5749a40f7e3",
"name": "Your Linear Project 1",
"type": "n8n-nodes-base.linearTrigger",
"position": [
2840,
60
],
"webhookId": "5b10cdb4-85a6-41de-a0de-ce50c75dcc6f",
"parameters": {
"teamId": "e7c75e79-fbcf-45cc-95bd-110efb6cb555",
"resources": [
"project"
]
},
"credentials": {
"linearApi": {
"id": "hhmsOxH2jUEvGbvN",
"name": "Linear"
}
},
"typeVersion": 1
},
{
"id": "65abdb10-dba2-4535-a155-957106ae6cdd",
"name": "Sticky Note",
"type": "n8n-nodes-base.stickyNote",
"position": [
2960,
680
],
"parameters": {
"width": 487.89456119016046,
"height": 156.00544089827184,
"content": "## Tips\n- Avoid copying and pasting the Linear node; instead, add a new one from the menu.\n- Remember to configure the custom Productboard field in the \"Get Productboard Feature ID\" node."
},
"typeVersion": 1
},
{
"id": "adcb71e4-880b-4c19-acbb-0708ae4af95f",
"name": "Sticky Note1",
"type": "n8n-nodes-base.stickyNote",
"position": [
5500,
620
],
"parameters": {
"color": 5,
"width": 492.6340257353018,
"height": 182.8624066540728,
"content": "## Preview Slack Message\n:linear: to :productboard: update\nMy awesome feature name\nStatus: Candidate\n:dart: date: Decembre 2024\nYou can view the update in Productboard using the link below:\n<link productboard feature>"
},
"typeVersion": 1
}
],
"active": false,
"pinData": {},
"settings": {
"executionOrder": "v1"
},
"versionId": "",
"connections": {
"If": {
"main": [
[
{
"node": "update productboard status & timeframe",
"type": "main",
"index": 0
}
]
]
},
"Merge": {
"main": [
[
{
"node": "Merge2",
"type": "main",
"index": 0
}
]
]
},
"Merge1": {
"main": [
[
{
"node": "map linear to productboard status",
"type": "main",
"index": 0
},
{
"node": "get productboard feature details",
"type": "main",
"index": 0
}
]
]
},
"Merge2": {
"main": [
[
{
"node": "If",
"type": "main",
"index": 0
}
]
]
},
"mapping": {
"main": [
[
{
"node": "Merge",
"type": "main",
"index": 0
}
]
]
},
"Split Out": {
"main": [
[
{
"node": "Edit Fields",
"type": "main",
"index": 0
}
]
]
},
"Edit Fields": {
"main": [
[
{
"node": "Merge1",
"type": "main",
"index": 1
}
]
]
},
"linear project id": {
"main": [
[
{
"node": "Merge1",
"type": "main",
"index": 0
}
]
]
},
"Your Linear Project 1": {
"main": [
[
{
"node": "get productboard feature id",
"type": "main",
"index": 0
},
{
"node": "linear project id",
"type": "main",
"index": 0
}
]
]
},
"Your Linear Project 2": {
"main": [
[
{
"node": "linear project id",
"type": "main",
"index": 0
},
{
"node": "get productboard feature id",
"type": "main",
"index": 0
}
]
]
},
"get productboard feature id": {
"main": [
[
{
"node": "Split Out",
"type": "main",
"index": 0
}
]
]
},
"get productboard feature details": {
"main": [
[
{
"node": "Merge2",
"type": "main",
"index": 1
}
]
]
},
"map linear to productboard status": {
"main": [
[
{
"node": "mapping",
"type": "main",
"index": 0
},
{
"node": "Merge",
"type": "main",
"index": 1
}
]
]
},
"update productboard status & timeframe": {
"main": [
[
{
"node": "Slack",
"type": "main",
"index": 0
}
]
]
}
}
}Workflow n8n Productboard, Linear, synchronisation : pour qui est ce workflow ?
Ce workflow s'adresse aux équipes de développement et aux chefs de projet travaillant avec Linear et Productboard. Il est idéal pour les entreprises de taille moyenne à grande qui cherchent à automatiser leurs processus de gestion de projet. Un niveau technique intermédiaire est recommandé pour la personnalisation et la mise en œuvre.
Workflow n8n Productboard, Linear, synchronisation : problème résolu
Ce workflow résout le problème de la synchronisation manuelle des statuts de projet entre Linear et Productboard, qui peut entraîner des incohérences et des pertes de temps. En automatisant ce processus, les utilisateurs éliminent les erreurs humaines et garantissent que les informations sont toujours à jour. Cela permet également d'améliorer la communication entre les équipes et d'assurer une meilleure visibilité sur l'avancement des projets, ce qui conduit à une prise de décision plus rapide et éclairée.
Workflow n8n Productboard, Linear, synchronisation : étapes du workflow
Étape 1 : Le workflow est déclenché par un événement dans Linear.
- Étape 1 : Il récupère l'identifiant de la fonctionnalité correspondante dans Productboard via une requête HTTP.
- Étape 2 : Les statuts et les délais sont mis à jour dans Productboard en fonction des informations de Linear.
- Étape 3 : Les données sont fusionnées et filtrées pour ne conserver que les informations pertinentes.
- Étape 4 : Une notification est envoyée sur Slack pour informer les équipes des mises à jour.
- Étape 5 : Le processus se termine par une vérification des conditions pour s'assurer que toutes les mises à jour ont été effectuées correctement.
Workflow n8n Productboard, Linear, synchronisation : guide de personnalisation
Pour personnaliser ce workflow, vous pouvez modifier l'URL du webhook pour l'adapter à votre instance Linear. Assurez-vous également de configurer les identifiants d'authentification pour les requêtes HTTP vers Productboard. Vous pouvez ajuster les paramètres des nœuds de fusion et de séparation pour mieux répondre à vos besoins spécifiques en matière de données. Enfin, n'hésitez pas à adapter le message envoyé sur Slack pour qu'il corresponde à votre style de communication interne.