Last updated
Last updated
The routing script allows for the movement of samples from one workflow to another. The script can move sample individually or in bulk.
Individually — the script uses derived sample custom fields (analyte UDFs in v4.x)
In bulk — the script uses master step custom fields (step UDFs in v4.x).
To move samples, first define the workflow and the step to which the samples will be sent. The script can be modified in the automation command line.
This section discusses the Routing script - Normalize Libraries automation used in the Illumina Preset Protocols (IPP). The automation invokes the changeWorkflow script, which routes step outputs to the next protocol in the workflow according to the Sequencing Instrument field value of each sample.
Command Line
The default automation command line for the routing script is as follows.
The default command line includes one section, and will always send the samples to the same workflow. To offer multiple workflow and/or step choices, you must add multiple sections, as shown in the following examples.
To send samples into a QC Protocol, use the protocol name instead of the name of the step name.
Script Parameters
Next Step Configuration
For the routing script to be triggered, the Next Step value for all samples in the step must be set to Remove from workflow. You can set this value manually or automatically, using a script.
On the protocol configuration screen, in the Next Steps section, the method of assigning the next step must be set to Automatic.
Automation Trigger Configuration
By default, the routing script automation should be configured to be automatically triggered at the end of the step.
After the script has completed, a dialog box displays. This dialog box shows the number of samples routed to each step — or an error message if something went wrong.
Global Custom Fields / UDFs
The following table provides configuration details for the global custom field configured to support the routing script automation. This example is based on the Routing Script - Normalize Libraries automation.
The field is configured on Analyte in LIMS v4.2.x and Derived Sample in LIMS v5.x onwards.
You can modify the default configuration by removing / adding instruments.
The --FIELD_NAME and --FIELD_VALUE are only available for derived sample and master step custom fields.
If no custom field should be checked, provide "N/A" to FIELD_NAME and FIELD_VALUE.
If the --FIELD_VALUE parameter value passed to the script does not match the value in the --FIELD_NAME custom field, the routing script does not route the sample.
The routing script works with the Remove from workflow function in the Next Steps of any step. Make sure that the correct settings or permissions are in place to allow for this function. For details, see the preceding section.