Support Import

Structure of User Library Designer

The User Library Designer (ULD) consists of a Title Bar, a Menu Bar and a Tool Bar, along six panes that divide the contents of the window in a way designed to assist your development efforts.

Library_PR_2a1.PNG

1. The Actions Pane

In the Actions pane you will find all the predefined Actions available to you for the development of User Actions, organized in ‘Actions groups’ through a folder structure.

2. The Workspace

This pane displays the predefined Actions you have selected, in the order they will be executed.  

User Actions can contain only the predefined set of Actions that one can find by default in the Process Designer ‘s Action Pane and User Actions from the same User Library as this Action, but NOT User Actions from other Libraries.

The pane’s Horizontal Tab Menu allows you to switch your attention from Main to any of the Library’s User Actions.

Library_PR_2a2.PNG

An important difference between the Process Designer’s Workspace (PD) and the User Library Designer’s (ULD) Workspace is the way in which you can test/run/debug your User Action.  

Important! You can run/debug a User Action simply by running it as a Function in the Main Tab .

Step-by-step guide:

a) Left-click on Main in the Workspace’s horizontal Tab Menu

b) Drag and Drop in it theRun Function from the Actions pane’s Flow Control Folder

c) Set the name of the User Action you want to run/debug in the Run Function’s Properties Dialog Box using the drop down menu options

d) Use the Set Variable Action, as many times as it's necessary in order to provide the required input for the smooth execution of the User Action

e) Press the Start Button (or F10) in the Designer’s main Toolbar

Library_PR_2a3.PNG

In this diagram (from An Example on User Libraries), Read Data from Excel File is a User Action that 'compacts' four Actions used in a standard manner when we want to read a range of values from an Excel Spreadsheet.

What is needed as Input is the path leading to the xls of our choice and the index number denoting the Worksheet we wish to extract the data from.

We use the Set Variable Actions in order to set values into the variables that allow the User Action to interact with us:

Library_PR_2a4.PNG

Later on, when we are ready to take this User Action into Production, this step will be unnecessary as the User Action's Properties themselves will allow us to enter the necessary Input:

ua-interactive-nature.png

3. The User Actions Pane

The User Actions pane is probably the single most important difference between the User Library Designer and the Process Designer. For this reason is being analyzed as a separate child topic.

 4. The Functions Pane

The Functions pane in the User Library Designer is identical to that of Process Designer. If you are struggling to understand the differences between Functions and User Libraries, we invite you to check the User Actions and Functions topic of this guide.

Library_PR_2a5.PNG

 5. The Variables Pane

The Variables pane in the User Library Designer is identical to that of Process Designer .

 6. Controls Repository/Image Repository/Errors Pane

This tabular pane is identical to that of Process Designer .

A Note on the Layout:

It is worth noting here that ULD's structural layout is flexible: not only you are able to adjust the size of the panes according to the needs of your work flow but you can change the positioning of the panes using your mouse (drag and drop) or auto hide buttons by clicking the pin Icon on the right of any of the panes’ title.

Library_PR_2a6.PNG

All changes are instantly reversible simply by right-clicking View from the main Toolbar and then selecting Default Layout from the resulting drop down menu.

Library_PR_2a7.PNG

The structure of User Library Designer is very similar to that of Process Designer (PD) and that makes sense, since User Libraries are essentially Libraries of portable Functions that can work inside any Process, as custom-built predefined Actions.