# Redlines

In a fast-paced manufacturing environment, work instructions and test procedures will need to be updated to handle changing engineering requirements, and non-conformances, or to simply create faster and higher quality processes. Redlines allow Runs to be edited with full traceability and sign-off processes. Many times, redlines are even used to build out entire procedures in a build-as-you-fly manner.

{% hint style="info" %}
Users must have a role with the *createRedline* and *updateRedline* to redline a run!
{% endhint %}

## Starting a redline

Click the three dots indicator on the action bar to redline an existing step. Alternatively, use the redlines button in the run header to select a position where a new step can be added.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F6Ll7uRCiIyLBXxbZHBCd%2Fimage.png?alt=media&#x26;token=dc5c3b05-d5f3-48e2-a6b0-a5b38f425fe1" alt="" width="532"><figcaption><p>Redline existing step</p></figcaption></figure>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FMBWXnvo5m5hGxy1gKviJ%2Fimage.png?alt=media&#x26;token=639e9d57-aab0-4f2f-8fe0-b06c783be108" alt="" width="393"><figcaption><p>Add a new step via redline, or view previous redlines</p></figcaption></figure>

When adding a new step via redline, you can choose to link it directly to an issue. The issue persists when clicking ***Save and Add Another Step***, allowing you to create a series of redlines related to an issue in quick succession. You can then find a step to add via the search and filters to narrow results to find the exact step you care about. For example, you can create a standard rework procedure that you can pull steps from in rapid succession to create many redlined steps that then get approved all at once using the [new approval process](#approving-redline-changes).

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FfDDrEtq1nFWluEw2omCz%2Fimage.png?alt=media&#x26;token=f416d049-2034-4dad-b215-9b456d389e6f" alt="" width="477"><figcaption><p>Filter a step you are adding via Redline via many options and add the redline directly to an issue when creating it</p></figcaption></figure>

If you choose not to select a step from the results menu, a new step will be created with the selected step type. As mentioned above, you can create entire runs from scratch without needing a procedure in a Build-as-You-Fly manner. These can then be saved back to a procedure later via the [merging process. ](#merging-redlines-to-a-procedure-or-to-a-run)

In addition, you can select the precise position of the step to be added. If not selected, the step will be added to the end of the run.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2Fdnz4WRGgw0LHT1AHY2jn%2Fimage.png?alt=media&#x26;token=81a4afa2-450d-491f-80cd-17d364b687b0" alt="" width="484"><figcaption><p>Adding a new step details</p></figcaption></figure>

## Editing a step in redline

Steps in redlined states are indicated with a warning at the top of the step and a red pencil icon on the step queue on the left. When a step is in the redline state, the step content, fields, datagrid rows/columns, and values all may be edited, added, duplicated, or removed. Redline steps cannot be completed or failed. The redline may be canceled at any time to return the step to it's previous actionable condition.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F6oxC1lpMSCWs0cYyxkT1%2Fimage.png?alt=media&#x26;token=7aaf9d34-6ac8-435f-8ea1-c195ac7c4557" alt=""><figcaption><p>Warning and indicator that a step is in redline</p></figcaption></figure>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FFCjevfQGGujIZGuBSqIR%2Fimage.png?alt=media&#x26;token=bd915b30-3a25-4a4d-bf2f-f12300126dcd" alt="" width="293"><figcaption><p>Duplicate a field</p></figcaption></figure>

If a step is in redline, the dependencies attached to the step can be deleted. Both steps need to be in redline to add a dependency between them.

![Redlined steps are shown in red and editable dependencies are shown with red dotted outlines](https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FQirbGj5aUpqQ6xzektpE%2FScreen%20Shot%202021-12-13%20at%205.31.07%20PM.png?alt=media\&token=3db23241-0a2b-4f0c-a1f8-79eb439f8c8e)

## Redlining a standard step

Redlining a standard step works the same as redlining a step. Click the ellipsis next to the step title and  click "Redline Step"

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FUVu5YdrW6966ADyxrDqi%2Fimage.png?alt=media&#x26;token=2ac827ea-977b-4b35-a9c5-adc351387593" alt=""><figcaption><p>Putting a standard step into redline</p></figcaption></figure>

## Approving redline changes

Add reviewers through the multi-select user dropdown on the *Review Redlines* screen, and then add them as reviewers to the appropriate redlines.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FiDXoBS2PbzTgSl901q9d%2Fimage.png?alt=media&#x26;token=132604a0-12a2-444e-85f4-8f64ec4eb178" alt="" width="563"><figcaption><p>Add reviewers in bulk</p></figcaption></figure>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FWitqzKDjQ2OWaLE8cNdU%2Fimage.png?alt=media&#x26;token=a5ace6e5-d52f-4807-a267-11b13022c519" alt="" width="563"><figcaption><p>Select redlines per reviewer to approve</p></figcaption></figure>

If you have been assigned as a reviewer, run steps that are in redline show up in the run header and can be viewed and approved in the *Review Redlines* pop up. In addition, check the *Review Center* in the top right next to your avatar to see all redlines waiting your approval.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FWfkmJwyZexMRJMKgBvMt%2Fimage.png?alt=media&#x26;token=ca55f6d2-736f-490a-93be-1b15342d694f" alt="" width="269"><figcaption><p>Notification icon next to your avatar takes you to the <em>review center</em></p></figcaption></figure>

Each redline in the *Review Redlines* and *Review Center* will give you a live diff of the changes made to the redline as seen below, making it simpler to approve changes by just clicking "Expand Diff"!

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FqFrRPhnjFa0pC1j33diz%2Fimage.png?alt=media&#x26;token=ec303ce7-c4b7-41e4-bd52-44bf538de799" alt="" width="563"><figcaption><p>Live Diff of changes made during the redline process</p></figcaption></figure>

Once you have reviewed all of the redline updates, you can approve them, reject them, or simply add feedback for the original editor to use to update the redlines further.&#x20;

1. When assigned as a reviewer for multiple redlines, you may approve an individual redline on a run step or approve all redlines assigned to you to review in a single run. For example, if you are set to review five redlines in a run, you have the opportunity to review and approve them all at once at the bottom of the *Review Redlines* screen. We know our customers often create a sequence of redlines that are connected, and should be reviewed together before being approved collectively via this screen!<br>

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FTiNFr2REYMYX7jfL6AzC%2Fimage.png?alt=media&#x26;token=49c7c2a9-ee5c-4932-ac3a-e82e026da291" alt="" width="563"><figcaption><p>Redline reviews allow you to review and approve many redlines on a single run at once</p></figcaption></figure>
2. After you've approved your redlines, you will need to submit them. A redline can be submitted on the steps using the submit button below.&#x20;

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FFDYP1ypMlqCKbdobX71w%2Fimage.png?alt=media&#x26;token=acc640ab-59ce-4933-a4d9-6b2e8b631829" alt=""><figcaption><p>Submit button for Redlines</p></figcaption></figure>

3. If you'd like to have redlines always automatically submitted, there is a check-box on your organizational settings like in the photo below:

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F4GPbGZrSrPoYWXCqb0zr%2Fimage.png?alt=media&#x26;token=1065e651-ce3e-43bc-9e23-555cef646ed2" alt=""><figcaption></figcaption></figure>

3. If you have been assigned as a reviewer for [merged redlines](#merging-redlines-to-a-procedure-or-to-a-run), approve all of the run steps that have merged redlines at once from the *Review Center*. This is for when you have merged a redline to dozens of other runs to ensure all of the changes get propagated to similar runs.<br>

   <figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F6tCJfvfAvWWaLq5OG0Ey%2Fimage.png?alt=media&#x26;token=d5a159ab-f1e0-48aa-981f-a19782fd7247" alt="" width="563"><figcaption><p><em>Review Center</em> where you can see redline merges and redlines assigned to you to review</p></figcaption></figure>

See all of the comments and feedback for a given redline from the *History and Merge* screen. This screen shows all completed redlines and their complete history of changes and feedback that have been made to the step via the redline process as seen below.&#x20;

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FCsF5G0femPcgzaMKoO0I%2Fimage.png?alt=media&#x26;token=d89c0d43-d8a7-489b-893b-5ec2319f8469" alt="" width="484"><figcaption></figcaption></figure>

## Merging Redlines to a Procedure or to a Run

If you make a redline improvement to work instructions on a run, merging allows those improvements to be duplicated quickly into other similar runs and procedures. Imagine having 20 other runs that utilize the same set of instructions, merging allows you to bring them all up to date in one push. Run Steps and Procedure Steps you choose to merge to will automatically update to be identical to the source step when accepting the merge.&#x20;

1. A redline must be submitted before it can be merged from the redline *History and Merge* screen.

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FPkucT9ur7pOHGOEq2v4t%2Fimage.png?alt=media&#x26;token=8094fd69-17ef-4527-b784-e7d4951cc8e2" alt="" width="563"><figcaption><p>Merge submitted Redlines to other run steps or procedure steps</p></figcaption></figure>

2. Here you have multiple options to merge. If you chose to merge to a procedure, you have the option to merge to an existing step or merge to a new step at the end of procedure. If the procedure is not in a draft state, than a draft of that procedure will automatically be creating when merging to any step in that procedure.<br>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2F2lN2lVyJnywEI6f8Bt4D%2Fimage.png?alt=media&#x26;token=2eff89c7-907f-4d2c-a9a0-c78943b9e9dd" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FZYuFYWIJJERzjDo8L4lL%2Fimage.png?alt=media&#x26;token=cfc1b685-2b92-4194-8077-8acee0fb0e30" alt="" width="563"><figcaption><p>Warning when merging to a released procedure</p></figcaption></figure>

{% hint style="info" %}
If the procedure chosen is not in draft, the merge feature will automatically create a new draft version to merge into.
{% endhint %}

3. When merging to a run, you can select many different runs and steps to merge to. Before merging, you will have the opportunity to assign a reviewer to the merge which will allow that reviewer to approve all of the merges at once instead of approving each merged redline independently. Once the merge is complete, each destination run step will be placed in redline and mirror the source step. As with any redline, you will still have to approve and submit them, so we recommend selecting a reviewer before merging in order to have the option to approve them all at once as seen in the [approval section](#approving-redline-changes) above.<br>

<figure><img src="https://3615148728-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LkRqYp6lJhwxjYdzYG8%2Fuploads%2FyH4QApsGMhczv5CdL1YS%2Fimage.png?alt=media&#x26;token=b0136f92-6a7a-41f6-995c-3072467b85b2" alt="" width="563"><figcaption><p>Select an approve before merging</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manual.firstresonance.io/features/runs/redlining.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
