Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Description

Smartforms Forms can be made externally available via the properties so that instances can be started from by external users. This feature makes it easier to integrate the suppliers or the customers in without user accounts into your Workflows. In order to configure this feature, you need to navigate to the Workflow Repository and open the specific Workflow.

...

...

Select the specific Workflow in the ‘Active workflows’ list

...

In order to make changes to a workflow, you need to first restore copy the published version and then edit it.

...

...

Reference

Attribute

Description

Status
colourRed
title1

Copy

The ‘copy’ button, allows user to create a new editable version of the current workflow.

Status
colourRed
title2

Edit

The ‘edit’ button, enables users to create a new, editable version of the current workflow process model

Status
colourRed
title3

Workflow Properties

The ‘workflow properties’ button, opens a modal that provides access to the webform start configuration and toggle buttons.

Now you can make the desired changes according to your needs. In the section PropertiesWebform, three features are available which are Webform start, Topbar and Documents.

...

External access for the Smartform/Webform

In order to allow an external instance start of the Workflow ‘Access Rights Request’, you need to activate the checkbox ‘Webform start’. The link to the Smartform will be available and can be copied via ‘Copy webform link’ after publishing.

...

show topbar and enable documents.

...

Reference

Attribute

Description

Status
colourRed
title1

Webform

The webform tab offers the toggle buttons for the webform start configuration.

Status
colourRed
title2

Toggle buttons

The toggle buttons should be enabled for the configuration.

  1. Enable webform start:
    Needs be active in order to allow starting the process from an external webform.

  2. Show topbar:
    If active, the topbar is shown which contains the logo and headline.

  3. Enable documents tab:
    If active, documents tab is shown which allows users to upload files.

Status
colourRed
title3

Save

Click on ‘save’ button to save the changes that were made by enabling the toggle buttons.

Status
colourRed
title4

Publish

You need to publish the new version to make your changes available.

...

Within the 'Active workflows' list, you can copy the webform link so that it can be shared with externals.

...

Reference

Attribute

Description

Status
colourRed
title1

Ellipsis button

Ellipsis button of the workflow opens a dropdown that offers the webform link

Status
colourRed
title2

Copy Webform Link

The user can view the external form of a task by navigating to the copied link of the webform

...

External access for the Form/Webform

The form is now accessible via for external users without any authentication or user information by navigating to the copied link of the webform.

...

By pressing the 'Submit form' button, a new process instance will be started.

...

...

Element Control for the Webform Start

In order to configure the Element Control settings for the external webform view of the smartformForm, you need to open the element control dropdown list and choose the 'Status: Webform start'. This allows you to make changes on your smartform Form specifically for the webform view on top of your current settings.

Info

See the page for element control settings: https://tim-doc.atlassian.net/wiki/spaces/eng/pages/227739993/Smartform+Designer#Element-control.1

...

Form Designer | Element Control

...

Now you can make changes to your external webform view via the element control panel.

...

...

Updating your Webform

First, you need to restore your version. You need to activate the checkbox ‘Topbar’ in the Properties to add it to your Webform.

...

Publish your new save changes and then you can publish your version to make your changes visible.

...

The link to your Webform will stay the same. You can see that your Webform now has a topbar with the tenant logo and the language section.

...

been updated and all the fields are required.

...

...

Adding an attachments section to your Webform

For specific Workflows, it is necessary that the users can upload documents on instance start. This is also possible for Webforms, you can activate this feature by clicking on the checkbox ‘Documents’ in the Properties section.

...

You need to publish your version again to make your changes visible.

...

You can see that now your Webform has a new ‘Attachments’ tab which external users can use to upload documents.

...

A new instance will be created in the product for your workflow after the smartform Form successfully submitted by the external user.

...

In our example, we can now see a task of instance '336517541356' appearing in the open onboarding tasks list:

...