Build and Maintain Kapplets

This section provides information about Creating Workspaces, Creating Templates, Creating Kapplets, and Running Kapplets.

Create Workspaces

Workspaces can be created by administrators and global administrators.

A Workspace is a logical group that combines Kapplets and Templates in one place by meaning and by department needs.

To create a workspace, navigate to the Workspaces tab on the side menu and perform the following steps:

  1. Click the Create new workspace button on the toolbar.

  2. In the Create new workspace window, configure the following.

    • Name: Type the workspace name.

    • Description: Type a short description to add more information about the workspace.

    • Icon: Add an icon to make the workspace unique and easy to distinguish. Either select an image from the Gallery or upload a new one. Tag the uploaded image to make it easy to find among other images.

      Important The image Gallery supports only .png and .jpeg files.
  3. Click Save in the lower right corner of the window for the changes to take effect.

A user can see the list of the available workspaces on the Settings pane of the visible tabs. For example, users with local privileges can see their list of workspaces on the Settings pane of the Kapplets tab.

Note that Templates and Kapplets can be added to a workspace only on the Templates and Kapplets tabs.

Create Templates

Every Kapplet is based on a template, which functions as a main base object forthe Kapplet. A Kapplet can be considered as a "copy" of its template. When a Template is changed, the Kapplet remains unchanged.

Templates can be created by developers, administrators, and global administrators.

To create a template, navigate to the Templates tab on the side menu and perform the following:

  1. Click the Add button on the toolbar to open the General step window.

  2. On the General step window, configure the following information.

    • Name: Type the Template name.

    • Workspace: Select the workspace from the drop-down list of available workspaces.

    • Description: Type a short description to add more information about the template.

    • Icon: Add an icon to make the template unique and easy to distinguish. Either select an image from the Gallery or upload a new one. Tag the uploaded image to make it easy to find among the other images.

      Important The image Gallery supports only .png and .jpeg files.
  3. Click Next in the lower right corner of the window to proceed to the next step.

  4. On the Robots step window, add robots to the template.

    The selected robots are shown on the Selected robots pane on the left of the window. To open the pane, click the Selected robots pane button on the toolbar. The number of selected robots is reflected on the button. On the Selected robots pane, use the Run sequentially button to define the robots execution order.

    You can also filter robots by a Management Console project on the Settings pane.

    Click Next to proceed to the next step.

  5. On the Input step window, configure input parameters for the selected robots.

    Note The Input step is added to the procedure if one of the selected robots contains input parameters.
    • Click a robot to see its variables (variable types).

    • On the window with robot variables, click a variable to configure its attributes.

    • All of the attributes are listed on the window next to the variables window.



    On the attribute pane, fill in the Field label and Field hint for display on the Start page.

    Use the Required and Hidden check boxes to configure how the fields are reflected on the Start page.

    Configure attribute individual parameters. The set of parameters depends on each individual attribute and may vary.

    Click Next to proceed to the next step.

  6. The Pages step window includes the following configuration.

    • On the Start page, edit the page title and type a description for the page in the Page text field. Drag an item on the Fields order list to change its order.

    • On the Status page, edit the page title.

    • To see the execution result in a table, add a Table page by clicking the corresponding icon on the toolbar. On the Table page, edit the page title and description. Select a robot on the drop-down list to configure its parameters. All of the parameters are listed below the robot. Click a parameter to define its fields for the table.
    • To see the execution result in a chart, add a Chart page by clicking the corresponding icon on the toolbar. On the Chart page, edit the page title and description. Select a robot on the drop-down list to configure the parameters to display on the chart. Select the following parameters:

      • Chart type

      • Color scheme

      • Label axis

      • Data axis

      Additionally, configure other chart parameters.

      Preview the chart image by clicking the Preview button.

  7. Click Save to save the Template.

A template entity looks similar to the following.



To edit or remove a template, click the Open context menu button.

Create Kapplets

Kapplets can be created by developers, administrators, and global administrators.

To create a Kapplet from a Template, perform the following steps:

  1. Click the Create new Kapplet button on the Template.

  2. The fields on the Create new Kapplet window inherit their values from the Template. Either edit them or proceed with saving the Kapplet. To save the Kapplet, click Save in the lower right corner of the window.

A Kapplet entity looks similar to the following.



To perform more actions on the Kapplet, click the Open context menu button.



Alternatively, when one or more Templates already exist, you can create a Kapplet on the Kapplets tab.

To create a new Kapplet on the Kapplets tab, perform the following steps:

  1. Click the Add button on the toolbar to open the Create new Kapplet window.

  2. In the Create new Kapplet window, configure the following information.

    • Name: Type the Kapplet name.

    • Template name: Select the Template from the drop-down list of available Templates.

    • Workspace: A workspace of the selected Template.

    • Description: Type a short description to add more information about the Kapplet.

    • Icon: Add an icon to make the Kapplet unique and easy to distinguish. Either select an image from the Gallery or upload a new one. Tag the uploaded image to make it easy to find among other images.

      Important The image Gallery supports only .png and .jpeg files.
  3. Click Save in the lower right corner of the window for the changes to take effect.

Important A Kapplet becomes disabled if a robot in this Kapplet is removed or changed. The following notification is thrown:

To enable the Kapplet, update the Template with a changed or removed robot and then update the Kapplet.

Run Kapplets

To run a Kapplet, perform the following steps:

  • Click the Run Kapplet button on the Kapplet to open the Start page. On the Start page, configure the input parameters (if present) and click Run in the lower right corner of the window.

  • After the Kapplet is executed, the History tab opens. See the execution information on the Result History tab. Here you can also see the information on the Status page, Table page, and Chart page.