When you create a sequence of commands to send to a device, you build up a matrix of script nodes. You can add nodes, into your script, from the Script Nodes docked window or from the Predefined CDBs docked window.

After a script node completes its operation, the script needs to determine which node it should move to next. For example, if an executed CDB completes successfully, you may want the script to branch to a different node than it would if the CDB completed with some failure. That is where Node Links are used. When a script node completes, depending on which conditions are met, the script will take a Node Link to determine which node to branch to next as the script continues to execute.

When you double-click on a script node (in the script matrix window), you click on the Node Links tab to view the node links configured for the selected script node. In this screenshot, the Display Message script node has been configured with two Node Links. One to branch on if the user chooses OK, the other to branch on if the user chooses Cancel.

You can click on the color indicator (with the drop arrow to its right) to change the color you would like to use to mark the node link. The following toolbar buttons are available to help you adjust the Node Links.

Select this option to add another node link to this script node. The first three available links you will see are common to all script node types.

Branch Unconditionally	The script will always branch to on this node link.
Branch on Device Type	The script will branch on this node link only if the script is running against the selected device type.
Branch on Device Vendor ID / Product ID	The script will branch on this node link only if the script is running against a device that matches the required Vendor ID and/or Product ID.

Depending on the type of script node it is, additional menu options will appear that are specific to the type of script node selected.

Choose this option to edit a previously set node link.

Choose this option to remove a node link.

Choose this option to move the node link higher in priority. Node links are analyzed top to bottom. You can also drag and drop the node links within the window to adjust their priority.

Choose this option to move the node link lower in priority. Node links are analyzed top to bottom. You can also drag and drop the node links within the window to adjust their priority.

Advanced Link Editor

Choose this option to edit the node links using our Advanced Link Editor.

In addition to using the toolbar, you may prefer to right click on the node links to view the same options.

In the screenshot we see above, we added a Branch on "OK" Selected (green color indicator) and a Branch on "Cancel" Selected (red color indicator) node link. When you select OK and view the script matrix, you will see that the Display Message script node now has two node link indicators at the very bottom of the script node graphic.

To let the script know which script node the link should branch to, move the mouse over the node link indicator and drag and drop it onto the script node you want it to link with. For example, this next screenshot shows that we configured the script to branch to a Test Unit Ready CDB if the user clicked on OK, and an Inquiry CDB if the user clicked on Cancel.

As you float the mouse over the node link indicator, a tooltip will appear letting you know what the link is as well as animating the link path. You can also right click on the node link indicator to view additional options.

See Also: