APM Components and Properties
  • 17 Jul 2021
  • 3 Minutes to read
  • Contributors
  • Dark
    Light

APM Components and Properties

  • Dark
    Light

The components can be drag-n-dropped on to the Canvas to perform their function. They are connected with appropriate arrows to form logical steps of a fully functioning app.

NOTE

When components are dragged and dropped into the canvas, they appear with a default name, Eg: Task_1, BOS_1, etc. They can be given a different name by double clicking and editing the default name.

The components with their properties are explained below:

  1. TASK
    It refers to a user task that can either represent a single task or group of functionalities within the canvas. Once dragged and dropped into the canvas, it is given an appropriate name.
    Clicking the three vertical dots(ellipses) provides the option to copy or delete the particular task.
    user task.png

When multiple functionalities are grouped within a single task, double-clicking the task opens a new page where the grouped items can be viewed. A Path is displayed on the top-left of the canvas.
new task within task.png

  1. BOS
  • BOS is designed and developed to fetch or modify data in-n-out of source systems. In simpler terms, it is used to call a particular service from the backend to fetch data from the database tables.
  • Similar to Task, it is given an appropriate name once dragged and dropped.
  • Double clicking the BOS redirects the user to the Integration Builder.
  • The Integration Builder can also be opened in a new tab or on the same tab. These options are displayed when the user clicks the 3 vertical dots (ellipses) available in the BOS block.
  • Similar to tasks, they also have copy and delete options.
  • BOS can be a separate block or can be associated with a particular page alone.
    bos.png
NOTE

The BOS "FetchInventory" is for representation purpose only.

  1. PAGE
  • Page refers to the UI screen that is displayed to the user.
  • The UI screen is designed using the App designer. Double clicking the screen redirects the user to the App designer.
  • The screen has a delete option by clicking the 3 vertical dots on selection.
  • Below diagram shows how the screens are connected with their task and BOS.
    page example.png
  1. ANNOTATIONS
  • Annotations are nothing but instructions/messages that help users add notes at specific points in the canvas.
  • Annotations help retain information and makes it easy to collaborate with different users.
  • They can be expanded in size based on the data it displays. The 3 vertical dots provide copy and delete actions to the annotations.
    annotation.png
  1. CONDITION -
  • Conditions are used to direct flow of logic in a Business Function based on the comparisons of variables defined in the system.
  • Once a conditional block is clicked, it prompts the user to pick variables from a list of variables in the variable section.
  • Based on the required conditions (YES/NO), the variables are redirected to respective screens based on the type of variables.
  • In the example given below depending on the Condition flow will go the next page or back to ‘Req Scr’.
    conditions.png
NOTE

All the components in the canvas, on selection, comply to undo, redo, and delete actions.

Variables and their Properties

Variables are mainly used in the conditional block to predefine the flow of a particular function.

The flow of data throughout the Project is governed by the variables and these variables form the core of executing the business logic for a particular App.

These variables are available across the Project and can be fetched in the App Designer as well as the Integration builder depending on screen flow and logic.

Steps to create a new variable

To create a variable, user must

  • click the +Add Variable button
  • give an appropriate name to the new variable.
  • choose the Type of variable value or table.
  • If it is a Value, select Data Type (string, number, date, decimal) from the dropdown.
  • If it is a Table, define table keys with column names and their types.
    add variable value.png

A table can have multiple composite key value pairs. This can be done by clicking the + button under the column name.
add variable table.png

Once added, the variables are displayed in the variables section.
The variables can be edited or deleted by clicking the three vertical dots next to the variable.
variable edit.png

Users can choose variables for different conditions by double clicking the condition block.
variable for conditions.png

NOTE

$Length is a default parameter for all tables that records the length of the table. It is used to show the count or list of entries in the table.


Was this article helpful?