How to create a Basic Solution

High-level process for building a basic Solution

This is a quick start guide to building a basic solution on Linx.

Prerequisite: - Foundational knowledge of Linx terminology and the Linx Application Designer user interface.

Steps:

  1. Open Linx Designer
  2. Create a new Solution
  3. Add Plugins
  4. Create a new Process
  5. Add Functions to the Process
  6. Debug the Process
  7. Add a Service
  8. Call the Process from the Service Event
  9. Deploy the Solution to a Linx Server

Example

Text File Read and Write

Read process:

  1. From the File plugin, drag and drop TextFileRead onto the main canvas

  2. Set these Properties:

    • Name
    • File Path (enter the path and file name, or browse to the file by clicking the Select File icon)
    • Codepage (options: Default / various others including ASCII, UTF8, etc)
    • Read type (options: Complete / Line by Line / List of Lines)
  3. Debug, Deploy and Automate

Write process:

  1. From the File plugin, drag and drop TextFileWrite onto the main canvas

  2. Set these Properties:

    • Name
    • File Path (enter the path and file name to which the contents will be written)
    • Contents (specify the contents to be written to the file by entering the exact text content or by selecting variables whose values will be written to the file)
    • Destination codepage (options: Default / various others including ASCII, UTF8, etc)
    • File does not exist (options: Create file / Throw exception)
    • File exists (options: Append data / Increment file name / Overwrite file / Throw exception)
  3. Debug, Deploy and Automate


Adding a Service

Add a Timer:

  1. From the Utilities plugin, drag and drop the Timer service onto the main canvas

  2. Click on the Timer in the Solution Explorer section to set the timer Properties. (These will determine when the Timer Event should be triggered to execute your process.)

timer

  • Include days - Select the days on which the automated process (timer) should be run
  • Exclude days - Select the days on which the automated process (timer) must not run, e.g. a specific date, or a specific weekday.
  • Mode - Select either ‘Interval’ or ‘Specific times’. When selecting ‘Interval’, also set the following property values: Run every, Starting time, and Run for. When selecting ‘Specific times’, also set the following property value: Run at.
  • Run every - Enter the time interval between each run. The value format is: HH:mm:ss (i.e. hours, minutes and seconds). E.g. 00:30:00 will trigger the timer event to run every 30 minutes.
  • Starting time - Enter the time of day from which the timer will run. The value format is: HH:mm:ss (i.e. hour, minutes and seconds), utilizing the 24 hour cycle where 2pm is 14:00:00.
  • Run for - Duration of time for which the timer will run as per the selected intervals. The value format is HH:mm:ss (i.e. hour, minutes and seconds). E.g. 05:00:00 will cause the timer event to run for 5 hours after the selected Starting time, and at the selected intervals.
  • Run at - Enter the time of day that the trigger will run on the selected days. The value format is: HH:mm:ss (i.e. hour, minutes and seconds), utilizing the 24 hour cycle where 9pm is 21:00:00.

  3. Click on the Timer Event (in the Solutions Explorer section) to add specific Functions or Processes for the Event to execute:

  • to add a Function, drag it from the relevant Plugin onto the main canvas
  • to add a Process, drag it from the Solution Explorer panel onto the main canvas

  4. Debug, Deploy and Automate

Note: Please refer to the Plugins documentation section for more specific descriptions of the Properties of these plugins.

Demo Videos

Create a Solution


Add Plugins to a Solution


Add a Function to a Process


Add a Service



Debug a Process


Add a Server


Deploy a Solution



Also see

Linx Application Server: Quick Start

Creating a Controller Process

Working with Services