Linx Designer User Interface

layoutoflinxdesigner.

The Linx Designer panel layout can be customised by moving them around at will.

Each panel contains the following features, accessed by clicking on the respective icons that are positioned in the top-right corner of the panel:

  • Float Window – To open the panel in its own window which could be maximized for ease of use.

  • Dock Window – To dock an open or floating panel window to its original position.

  • Auto Hide – To “auto hide” a panel so that only a tab name will display. Click on the tab name to have the panel contents displayed. Click on the Auto Hide icon to revert back to the default panel display.

  • Hide – To hide or “close” a panel. (To have the panel displayed again in its default position, go to Windows on the top menu bar and select the checkbox of the relevant panel.)

Solution Explorer

The Solution Explorer panel displays the Projects, Processes, Services, Custom Types and Folders that are included in your Solution.

The details of each component listed in the Solution Explorer are maintained in the design canvas (center of interface) and in the Properties section. Click on the relevant component to access its properties and to view on the design canvas the Functions, Types or Processes that have been added to the component's process flow.

Plugins

The plugins that have been added to a Solution are listed in the Plugins panel.

plugins

Drag-and-drop the required plugin element (Function or Type) onto the design canvas, or in the case of a Service, onto the Solution Explorer panel.

Add a Plugin

Click the Add Plugins button, then click the Add button of the relevant plugin (see below).

addplugins

Maintain Plugins

Each Plugin will have relevant options available to:

  1. get more information on the plugin
  2. remove the plugin
  3. upgrade the plugin

These options are displayed next to each plugin name, as shown below:

pluginsicons

Note:

  • The upgrade option will only display when an upgrade is available for the plugin.

  • To access the options for removing a plugin or for getting more information, hover over the plugin name to display the option icons.

Update

Click the Update link.

update

Then click the UPDATE ALL button or the specific plugin's UPDATE button.

update

Find plugin references

You can locate where a function, type or service, e.g. the CommandLine function, is being used in your solution by making use of the "Find References" funcionality. Right-click on the relevant function, type or service, then click on Find References.

When executing this command, you will get a list of all the places in the solution where this function, type or service is being used. You can navigate to an usage instance by double-clicking on the search result.

reload

Design canvas

The design canvas, in the center of the interface, is where all the Processes, Functions and Types that form part of a Solution are placed. Once a component is placed on the canvas its properties can be set to determine the way in which it will function.

Properties

The details displayed in the Properties section are dependent on the associated component.

properties

A typical layout would include:

  • Heading, indicating the name of the Plugin in brackets
  • Name – enter a descriptive name, which has to be unique within the Project
  • Component-specific properties – enter or select relevant variables for the component to work as required
  • Property Help – click on the property name to have a brief description of that property displayed in the Property Help section at the bottom of the Properties panel.

Settings

Settings are values that are read-only at run-time. Settings can also be configured on Linx Application Server, either as additional settings to what was configured in Linx Application Designer, or to override those settings.

Settings are typically used for variables that are static, e.g. access credentials, file paths, email settings, etc.

Add a Setting

  1. Click Settings on the toolbar
  2. On the main canvas a Settings tab is created. Enter the details of the Settings by entering the setting's Name, select the Type (e.g. String, Integer, List, etc), and add an optional Value.
  3. Select the Secret checkbox to mask the value, if required.


Setting Example

Secret settings

When a Setting is marked as "secret" it ensures that any personal or sensitive data stored in that Setting will remain secure, e.g passwords, usernames, ID numbers, etc.

Important:

  • When a Setting is marked as "secret", Linx will not export the value of the setting from the Designer to the Server when the Solution is deployed. On the Server the Setting value will be blank.

  • For "secret" Settings, you must provide a value for the Setting on the Server before starting your Solution.


Using a Setting's value inside another Setting

To reference an existing Setting's value inside another Setting's value, add the existing value inside curly brackets to the new setting's value, e.g. {var1}xyz, as shown below:

Setting inside setting Example

In the above example, var2 resolves to a value of "abcxyz". Hover your cursor over the setting to view the resolved value in the displayed tooltip.

Using a Setting

Settings are available for use when setting up Properties and Expressions.

Properties

Custom Type Example

Expression Editor

Custom Type Example

Note:

When a Solution is deployed to Linx Application Server, the settings are available to be edited from within Linx Application Server. In this case there is no need to edit the settings within Linx Application Designer and to redeploy the Solution to Linx Application Server.

Custom Types

Custom Types enable you to create your own type in Linx by defining its structure. These are typically complex types, types that consist of a variety of other types and sub-types.

Add a Custom Type

  1. Click Custom Type on the toolbar
  2. From the Preoperties section, open the Properties Editor [...] to add the fields for the Custom Type.
  3. For each field, enter the field's Name, select the Type (e.g. String, Integer, List, etc), and add an optional Value.
  4. Click the Save button

Examples

A simple Custom Type

An example of a simple Custom Type is the one shown in the screenshot below, called 'Article'. It consists of various String-type fields (author, publish_date, summary, and title).

Custom Type Example

A complex Custom Type

An example of a complex Custom Type is shown below, called 'Article_List'. This Custom Type consists of one field ('Articles'), but this field is referencing another Custom Type (called 'Article', which is the one from the example above for a simple Custom Type) that contains a set of fields. The fields that are contained in the Custom Type that is being referenced ('Article'), now also becomes part of the complex Custom Type ('Article_List').

Custom Type Example

More examples

A custom type might be a 'Customer'. Such a customer would probably have properties like Name, Address and a list of purchases. When you create this type, you will want to specify that the type has a string field called 'Name', another string field with an address and a list of purchases. A purchase is also a type and you will need to create it first. It may consist of a purchase date, an amount and a product. So, you will also need to create a purchase type with a date type called 'purchase date', a decimal called 'purchase amount' and a string called 'Product Name'. You have now created a complex type for storing a customer and all related purchases.

When you point this type at a database query result that has the same fields, you can get Linx to automatically populate the complex type directly from your SQL query.

Output

output

When a specific function is selected, those variables for which output could be retrieved by the function are displayed in the Output section.