search string side menu

Low-code designer > Set up interfaces > Widget types > Other widgets / Sign app item

Sign app item

This widget is used to sign app items using a qualified signature. It appears on the top panel of a document’s form as the sign-button button. It is displayed only when:

Widget settings

To configure the widget, open the interface designer, select the Sign app item widget, and click the gear icon.

Main tab

app-signature-1

  • App item*. The value is assigned automatically based on the app you are working with.
  • Signature type. Specify what the user will sign (the app’s attributes or the file) when clicking the Sign button by checking the boxes.
    • Choosing Attributes or File or enabling both. The option you check will be required. The user won’t be able to change the signature type on the app item’s page, only to select the digital signature provider and the certificate.
    • Disabling both options. The user will be able to choose the signature type on the app item’s page.

Link the field with a context variable. The signature type will depend on the value of the variable you select. The user won’t be able to change it. To link the field with a variable, click the link-icon icon, then click the <Undefined> link and select a Category type variable from the list. The variable needs to have two values: Attributes (code: attributes) and File (code: file). Read more about configuring the variable below.

Configuring the context variable

In this example, we’ll link the signature type with a context variable.

Let’s say there is an app storing sign-off sheets and memos. These types of documents require different signature types (Attributes and File), so the user has to specify it when creating an app item.

To make this possible in the app, you need to do the following:

  1. Open the form settings of a Document type app and switch to the advanced mode.
  2. On the Context tab, create a Category type variable.
  3. Enable multiple choice and add the following values to the list: Attributes (code: attributes) and File (code: file). You have to use these codes for the values of this variable. This will allow the user to select these types of signature in the Sign app item widget.

app-signature-2

  1. Save the variable by clicking Create.
  2. Go to the Create tab and add the variable you created to the form.
  3. Go to the View tab and open the interface designer. Open the Sign app item widget’s settings.
  4. In the window that opens, on the Main tab link the Signature type field with the Category type variable you created.
  5. Save the changes.

Now the Category type field with the values you set up is displayed on the app creation form. The user uploads a document and selects the signature type needed for it.

app-signature-3

Thanks to the codes of the values in the Category type variable, the selected signature type will be set in the Sign app item widget. It will be displayed on the app item’s page, and it won’t be editable. The user will only have to choose the provider and the certificate.

app-signature-4

System tab

System settings are similar for all widgets. They allow you to set the widget’s visibility and access permissions, configure the widget’s behavior when the user hovers over it, etc. Read more about these settings in the System widget settings article.

To finish configuring the widget, click Save and then Publish on the interface designer toolbar.

Delete the widget

To delete the widget from the form, open its Settings, click the recycle bin icon, and confirm deletion.

You can add a deleted widget back to the form. To do that, drag it from the side panel of the interface designer to the canvas or use the +Widget button. Read more in the Form templates article.

item_subscribe-widget.html task_completion_widget.html

Found a typo? Highlight the text, press ctrl + enter and notify us