Linx Designer User Interface

The default Linx Designer layout, in Light Mode, appears like this:

layoutoflinxdesigner

  1. Menu bar

  2. Solution Explorer panel

  3. Design canvas

  4. Plugins panel

  5. Properties panel

  6. Definition panel

The key elements of the user interface are described in the sections below.


Designer theme

To select your prefered Designer theme, i.e. Light or Dark mode, go to Files on the Menu bar, then select Configuration.

Panel layout

The Linx Designer panel layout can be customised by moving panels 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 Functions, 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 or Types that have been added to the component's logic 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" functionality. 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


videos icon Plugins Tutorial Video


Design canvas

The design canvas, in the center of the interface, is where all the 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
  • 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.


videos icon Settings Tutorial Video


Types

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 Type

  1. Click Type on the toolbar
  2. In the Properties section, open the Properties Editor [...] to add the fields for the 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

Import a Type

  1. Click Solution on the menu bar
  2. Click on Import Type
  3. In the Import Editor, either browse for a file or paste JSON, JSON schema, XML or XML schema data.
  4. Click the Create button

Examples

A simple Type

An example of a simple 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 Type

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

Custom Type Example

More examples

A 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.


videos icon Types Tutorial Video


Definition

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

Example:

output

Deploy a Solution to Linx Server

  1. Click Deploy on the toolbar.

  2. Select the server to deploy to, or if no server has been added yet, click Add a Server or click Get a Trial Server.

  3. Add a Server – provide the details of the server:

    • Server Configuration Name
    • Server URL
    • User
    • Password
  4. If a server has already been set up, a screen similar to the one below will display. From here, either select the server and click the Deploy & Open Server button or the Deploy button; or click Add Server to add the details of a different server to deploy to.

    Deploy from Designer