Linear Integration

Objective: To walk Duronauts through the process of setting up your integration with Linear. 

Difficulty: Easy

In this article:

1. 1. Overview
   2. How to connect your Linear tickets to Duro Change Orders
      • Enable the integration for Linear within Prismatic
      • Create a new ticket in Linear
      • Create a new Change Order in Duro
      • Reopen Linear to check the Change Order status

Duro's integration with Linear prioritizes simplicity, control, and choice for customers. The ability to establish connections quickly and expand options beyond industry standards reflects a commitment to enhancing product functionality. 

---

Overview

Duro's integration with Linear enables users to connect their project management tools with Duro, centralizing workflows and improving communication and collaboration. Directly connect Change Orders within Duro to Linear to ensure that your team is on the same page and that projects can progress smoothly. The integrations are easy to set up and use, with no coding required, making them accessible to users of all technical backgrounds. Additionally, Duro's integrations are designed to prevent unnecessary steps and expedite the setup process, empowering you to get up and running in just a few clicks.

Administrators can configure Linear integrations. This process involves granting Prismatic access through OAuth to ensure a secure setup.

For more information on the value that our integrations have to offer, please refer to our blog, Duro’s Innovative Approach to Product Integrations.

How to connect your Linear tickets to Duro Change Orders

The workflow for connecting your Linear tickets to Duro Change Orders should be completed in the phases outlined below:

1. Enable the integration for Linear within Prismatic
2. Create a new ticket in Linear
3. Create a new Change Order in Duro
4. Reopen Linear to check the Change Order status

Enable the integration for Linear within Prismatic

Follow the steps below to enable the integration for Linear within Prismatic:

1. Contact a Duro support specialist to obtain your login credentials for Prismatic.
2. Create your account and set your password.
3. Login to Prismatic.
4. Click on Marketplace in the left navigation.
5. Click the Linear tile. 
6. Click Configure.
7. In the Initial Configuration window, click Next.
8. In the Configuration window, click Connect in the "Linear Connection" box.
9. Follow the authentication prompts through Linear, including signing in and accepting authentication policies.
10. Once completed, close the tab and return to Prismatic.
11. In the Configuration window, click Next.
12. Enter your API key in the Duro Config window. A shortcut to your API key is available via the hyperlink above the text field, or you can access it through the Integrations table in Duro. Then, click Next.
13. In the Duro Config window, click Finish.

Create a new ticket in Linear

It's important to take note that if Linear is not currently installed on your device, the setup instructions for integrating Duro may differ. We encourage you to visit the Linear website to obtain the most recent and accurate installation instructions for their software before proceeding with our integration process.

At this stage in the workflow, you will need to create a new ticket in Linear or use an existing ticket which will be connected to Duro in the next section. This ticket will serve as the central repository for all communication and documentation related to this task.

Once created or selected, note the ticket ID (e.g., DUR-8549, PLM-097, CS-23).

For detailed instructions on creating tickets in Linear, please refer to existing documentation and support resources available:

• Creating an issue in Linear

Create a new Change Order in Duro

Follow the steps below to create a new Change Order in Duro:

1. Login to Duro. 
2. Click Change Orders in the left navigation. 
3. Click on New. 
4. Incorporate the ticket ID into the name of the Change Order (e.g., PLM-6642 ECO, INT-567 Assembly Change) by pasting it into the Name field.*
5. Optional: Enter a description of the Change Order
6. Add products or components to your Change Order. Update the lifecycle status and revision values of attached items as needed. 
7. Click Submit for Approval.

Note: The Change Order name can be entirely dedicated to the ticket ID, or you can opt for a more descriptive title that elaborates on the specified changes.

For more information on creating a new Change Order, please see our article on Change Orders. 

Reopen Linear to check the Change Order status

Now, relaunch Linear to check the status of your Change Order. Upon submitting the Change Order in Duro, Linear automatically retrieves and updates the Change Order data within their respective interfaces. Naming your Duro Change Order to match the ticket ID will automatically link Linear to the Change Order in Duro. A hyperlink to the Change Order will also be displayed in Linear's integration link section. Additionally, Linear will display the real-time status of the Change Order in Duro (Approved, Rejected, or Unresolved).