This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Add forms

After you have created a process, you are then ready to add forms. This is the second step in building a process.

Build process steps

Create forms process

As you work on your process, you can save drafts. This allows you make changes and restore to earlier versions if needed - see Version History for more information.

Before you begin Process plan icon

When adding forms, refer back to your process plan to determine what forms you need and who will have access to these forms as an administrator. As an example, we will keep our Training Process requirements in mind as we go.

In this Training Process example, we will create two forms: Training Request Form and a Training Approval Form.

The video below highlights how Kianda Designer works and How to get started runs through how to create forms for a sample Training Process.

Kianda Designer introduction

How to get started

Once you have created a new process, you are automatically in Kianda Designer. This page allows you to: add and edit forms, add elements to those forms (like controls and rules), save, publish and preview forms, and view and edit form and field properties.

Kianda Designer has 3 key areas:

  1. Left-hand pane is used to add form elements like controls and rules. This pane also houses the Exit Designer Exit Save Save Preview Preview and Publish Publish buttons.
  2. Central form canvas displays the current form you are working on.
  3. Right-hand pane is used to view and edit process, form and field properties.

Kianda Designer

Form designer

Note: By default, a first form, “form1”, is added to any new process you create. Click on the Edit form button (Pen icon Pen button) to start editing this form to make it your own.

  1. Click on the Edit form button (Pen icon Pen button) to edit ‘form1’.
  2. Complete the details in the Edit form dialog box - that is Title, Name, and Default owner(s) (people who will be able to administrate this form - choose from Users or Groups). There are other options like Form theme which are colours that you can apply to the form tab. These options are explained in further details in Designer. Changes made are visible in real-time in the form canvas. Edit a form

Edit form

  1. Click on OK button OK button when complete.
  2. Click on the Add form button to add a second form. Repeat to add as many forms as needed.

Add form

  1. Once you have added one or more forms to your process, you are ready to Add controls and rules to your forms! In our example we have two forms: Training Request and Training Approval.
  2. Save your work as you go by clicking on the Save button.

Save button in Kianda Designer

Saving a process

What’s next Idea icon

The next steps are:

User tips Target icon

  1. You may have chosen to use predefined processes from the Kianda App Store. It is worth taking the time to check out how these processes are built to give you an initial idea of what is possible in Kianda.

    Use the Exit button Exit to return to the main process view and then click on a process of choice to see details.

    You can preview forms by clicking on the Preview button Preview - see Previewer for more details.

    There are many ways to then reuse elements within forms - for example, using the Group field and cloning. For more information, see the video Reusability of process and form components.

  2. There are many ways to manage who has access to a process, or form - see the video How to control user security access to forms and process.

  3. The key rules for working with forms are:

    • Forms are assignable - means that only a form assignee can edit a particular form. This can be a combination of users and groups.
    • Only form owners can edit a given form by default. Any other user with access to view the form will see it in read-only mode.
    • Multi-step processes use the concept of “current form”. Only the form matching the process status will be made editable.
    • In a multi-step process, other forms that are not “current form” can be configured to activate with the current form, meaning they might also be editable and will form a form group.

    These rules work together to determine if the form is in edit mode or display mode. Form designers have at their disposal business rules, such as assign form, go to form and submit rule, to dynamically control the ability of end-users to edit a particular form or a section of a form.

1 - Getting Started - Version history

The current or active version of a process is always visible in the right-hand pane, for example V0.8 for the process as shown below.

Process versionProcess version history

The first version of a process is 0.1 and will increment to 0.2 and so on, each time a process is saved. Once the process is published the version changes to 1.0 and increments with each publication. This makes it is easy to keep track of who made changes and when, and to restore an older version if needed.

The video below introduces version control and the section How to get started runs through how to view process versions and restore an older version.

Version control

How to get started

  1. To view the version history click on the Design version history button which may look like V0.1 or whatever the current version is for your process, for example View design version history or Version 0.8.

  2. A pop-up shows the version history details including when the version was created and who created it.

    In the example below, there are 8 versions of the process, all are drafts indicated by the 0 in front, such as 0.8.

    Version history

    Version history details

  3. Click on a particular version to see the version information, for example forms, fields and rules that were added, modified or removed.

    Version details

    Version details

  4. To restore an earlier version, click on the Restore button Restore button beside a particular version and then click on Ok to confirm that you want to restore to that version.

What’s next Idea icon

To learn more about adding different elements to your form go to Add controls and rules.

2 - Getting Started - Designer

Kianda low-code development platform - process designer

Kianda process Designer empowers you to easily start building forms and workflows for any business use case. Forms are an important component of any process. They might be used as a stage of a process and can be made active individually or at the same time (parallel forms).

There are 3 key principles to consider when working with forms:

  1. Form design - what a form looks like, what elements it contains, for example controls and rules, see Designer layout.
  2. Form interaction- how users can use forms depending on certain sequences happening, see Rules.
  3. Form management - who can edit and access forms is set when creating a new form, see New forms.

Designer layout

To access processes, go to the left-hand pane and Administration > Designer and click on a process that you have created or imported, see Design and build your process.

From the main process view, click on any process to add forms, for example Training process as seen below.

Main process view Clicking on a process

The designer window opens and is made up of 3 main parts.

Kianda Designer

Form designer

The key components of the designer are:

  1. Left-hand pane is used to add form elements like controls and rules. This pane also houses the Exit Designer Exit Save Save Preview Preview and Publish Publish buttons.
  2. Central form canvas displays the current form you are working on.
  3. Right-hand pane is used to view and edit process, form and field properties.

Note the name of the process you are working on is shown in the top menu bar, for example Training Process.

The video below demonstrates how to get started using Kianda Designer, and go to How to get started to follow through on different ways to import forms or start from scratch.

Introduction to Kianda Designer

How to get started

  1. How you get started with forms depends on:

    • if you have created a process using the App Store, see Predefined forms

    • if you have created a process from scratch or want to create a form from scratch, see New forms

    • if you import forms that have already been created, see Import forms

  2. Once your form is created, you are ready to start adding elements to your form, see Add controls and rules.

  3. In addition there are a number of settings you can change, see Settings and Properties.

Predefined forms

  1. If you have created a process using the App Store, then a number of forms will already be part of the process. For example the process Security Incident Management has 5 forms attached: Incident detail, Data breach, Malware outbreak, Root cause remedy and Caller review.

  2. To edit form details, simply click on a form and click on the Pen button Pen icon to edit the form. You can also click on the Add form button to add a new form. Edit options are shown under New forms.

New forms

  1. If you have created a process from scratch, an empty form is added to your process by default, called “form 1”. This is the first form. Click on this form and the Pen button Pen icon to customise it. You can also click on the Add form button to add a new form.

    Adding a form

    Edit form

  2. There are a number of edit options below.

    Editing a form

    Edit form options

    Note: as you change any of the options in the dialog box, the impact will be shown in real-time on the form in the background, for example a title, or colour form theme.

    1. Title - the form title, for example Employee Request Form

    2. Name - this is a unique name for the form

    3. Default owner(s) - by default the form creator is an owner. You can remove this owner by clicking on x and add other owners by clicking on the arrow and choose from Users, Groups or Partners.

      • Users - allows you to choose individual owners
      • Groups - allows you to choose from defined groups for example HR Team or Management Team
      • Partners - allows you to choose predefined partner organisations that you want to share with or provide permissions
    4. Activate with - will decide when the form will be active. If you have several forms attached to a process, then select from a dropdown list the form you want to activate with the current form. If you leave the field blank, the new form will be activated sequentially after the first form is submitted.

    5. Submit mode - options are a) Only this form (the current form) or b) All forms in edit mode

    6. Form icon - click on the arrow to choose from hundreds of icons to attach to your form.

    7. Form theme - choose from Navy, Green, Blue, Amber, Red or White Colours for your form.

    8. Enable quick actions - if you tick the checkbox, you can select from the options a) Enable re-assign b) Enable edit and c) Enable custom action. Click on Ellipsis button Ellipsis button to further modify the action settings.

      • If you click on Enable re-assign, you can reassign action settings to particular Users, Groups or Partners. Click on Allow form owners if you want form owners to be able to reassign actions.

      • If you click on Enable edit, you can allow certain Users, Groups or Partners to edit the form, along with form owners by clicking on Allow form owners.

        Other options include a checkbox for When editing auto hide form footer buttons and Trigger rules on save.

        • If you check Trigger rules on save then click into the Save action field to choose from an action trigger as to when the form is saved, for example Submit, Save or Close. These can be other actions depending on what you have defined.

          Edit action settings

        Edit action settings

      • If you click on Enable custom action, you can allow certain Users, Groups or Partners to edit the form, along with form owners by clicking on Allow form owners.

        Other options include Action label, Target action field and Action display mode, for example Read-only mode, Edit mode or Both.

        Custom action settings

        Custom action settings

    As a form designer you can set up actions dependent on certain conditions, for example an Action label that targets a certain button appearing for example Close button, only when a certain display mode is chosen, for example Read-only mode. If Edit mode is chosen, then the button will only appear when the form is being edited. In this way you can create dynamic forms that suit user interactions.

  3. Click on the OK button when you are finished editing to save your changes or click on Close to exit the dialog box without saving.

  4. To save your changes to the form, click on the Save button Save button.

  5. You are now ready to start adding Controls and rules to your form. You can also implement additional settings see Process Settings.

Import forms

  1. You can import a previously designed form by clicking on the Import button Import button.

  2. Click on the arrow to select from the drop down list to Select a process design.

  3. Click on a process of interest and then click on the forms to import. Forms are indicated by a + symbol and can be expanded to show elements within a form for example a panel containing different fields such as lists and text boxes. This means you can import a whole form, or just elements of a form. In this way you can very quickly reuse some or all parts of an existing form.

    Importing from another process

    Import from another process

  4. Click on the OK button when you are finished editing to save your changes or click on Close to exit the dialog box without saving.

Adding form elements

If you have added a new form during the form creation process, then a blank canvas with 3 default buttons are available to you: Submit, Save and Close.

Default form buttons

Form button edit

  1. Go to Add controls and rules to find out more about adding form elements.
  2. Move elements by clicking on the Drag Handle Drag handle beside the item and dragging it to where you want to place it.
  3. Edit elements by clicking on each item and clicking on the Pen button Pen icon see Settings and properties.

Settings and Properties

In addition to the edits above, there are a number other actions and settings that you can implement to your process and forms.

Settings and properties

Process and form properties

Settings are available from the right-hand pane and give you the ability to:

  • Import processes

  • View Version history

  • Change Process settings Settings button

  • Edit form information by selecting a form and clicking on the Pen button Pen icon.

  • Change a field to another field by clicking on Change field.

  • Create a duplicate form by selecting a form, clicking on the Clone button Clone button and then click on Ok. A version called ‘Form Name Copy’ is created and available to edit on the canvas. The Clone button can also be used to clone form elements like controls or buttons.

  • Delete a form by selecting a form, clicking on the Bin/Trash button Bin icon and then click on Ok after you have reviewed the form title and you are sure this is what you want to delete. Click on Cancel if you wish to cancel the deletion.

  • View and edit Form properties and rules.

Process settings

You can edit process settings by clicking on the Settings button Settings button in the right-hand pane.

Choose from the settings:

  1. Process id settings - choose from a) Default or b) Custom and use a combination of [ProcessName]-[UniqueNumber]-[FieldName]

  2. Enable process security - if you tick the checkbox, can allow certain Users, Groups or Partners to have certain privileges related to the radio button options to create, assign and view as shown below.

    Enable process security

    Process security

    The default setting is Security users can create, assign to can update, everyone else can view.

  3. On load rules execution mode - options are a) Always b) When in edit mode or c) When open new. The default setting is Always.

  4. Hide form tabs - gives you the ability to hide form tabs, options are a) Yes or b) No

  5. Hide left nav - gives you the ability to hide navigation elements, options are a) Yes or b) No

  6. Enable anonymous sharing of forms - gives you the ability to share forms with people outside your organisation for example a feedback form or GDPR subject access request. Options are a) Yes or b) No. If you click on Yes there are various options that you can add:

    • Message to display after anonymous submission - to add a display message

      Enabling anonymous sharing

    Link for external users

    • Hide form topbar - checkbox to hide the form topbar.
    • Force log out - options are a) Yes or b) No to force user logout once the form is submitted
    • Click on New link to generate a new anonymous form link to share with users and click on Edit to change the link.
  7. Enable mobile bottom navigation - options are a) Yes or b) No

  8. Instance delete settings - options are a) Any user can delete b) Creator can delete c) “Current form owner” can delete d) “Security users” can delete e) “Admins only” can delete. The default setting is Creator can delete.

  9. Enable form assignment notification - options are a) Yes or b) No

  10. Prevent closing instance with unsaved data - options are a) Yes or b) No

  11. Selected tab theme - choose from Navy, Green, Blue, Amber, Red or White as a colour when a form is selected.

  12. Completed tab theme - choose from Navy, Green, Blue, Amber, Red or White as a colour when a form is completed.

  13. Click on the OK button OK button when you are finished editing to save your changes or click on Close to exit the dialog box without saving.

  14. Click on the Exit button Exit process to go back to the process list, the Save button Save button to save your work, the Preview button Preview to preview what you have created and the Publish button Publish button to publish your work.

What’s next Idea icon

  • To learn more about rules and controls that can be applied to forms go to Controls and Rules.
  • To learn more about properties, go to Field properties.

User tips Target icon

  1. There are many ways to then reuse elements within forms, see the video Reusability.
  2. There are many ways to manage who has access to a process, or form, see the video User management.