Skip to main content
Skip table of contents

Frontends

Frontends allow individual actions to collect more information from a user depending on which one is selected.

Frontends:

Attachment selection

The attachment selection frontend allows the user to select one or multiple attachments that are contained within the bundle.

Example use cases:

  • Select a specific attachment which can be appended/prepended to the subject file in the bundle using a Merge Attachments stage.

Capture metadata

The capture metadata frontend allows you to configure certain fields to prompt the user for.

Example use cases:

  • For a user to enter some comments

  • Prompt a user for an email address, subject or email body text.

  • Allow the user to do a database lookup to find a value that can then be used in a processing stage.

This front end returns all metadata from the configured fields.

Use the following placeholder to access the field metadata:

CODE
{{frontend["frontend-alias"]|property("field-id")}}

Where “frontend-alias” is the alias of the capture metadata frontend and “field-id” is the field id of a field that has been configured on that front end.

For an example lets say you have configured a front end with a field for users to enter data.

To access the value from the Comments field you would use the following placeholder in a processing stage:

CODE
{{frontend["comments"]|property("comments")}}

If you want to see this in action then try a creating an action from the Route template and see how the front end is used to collect comments from the user and then those comments are used in the route to queue stage to populate the comments.

Confirmation dialog

The confirmation dialog is a prebuilt front end that can optionally require the user to click a textbox to acknowledge the message.

An example confirmation dialog

This front end returns the following metadata:

Property

Description

Example Placeholder

accepted

Returns “True” if the user ticked the checkbox.

Returns “False” if the user did not tick the checkbox.

CODE
{{frontend["frontend-alias"]|property("accepted")}}

Queue selection

The queue selection frontend allows a user to select a target page and queue.

An example queue selection frontend

Queue selection frontends have the following settings:

Setting

Description

Name

Name for the front end, the end user doesn’t see this.

Alias

This is the value that gets used in placeholders.

Description

Description for the front end, the end user doesn’t see this.

Required

If enabled then the user will be forced to select a target queue in order to submit the frontend.

Show personal queue display names

When listing personal queues in the modal the users display name will be used instead of email address if possible.

Page Restrictions

  • This Page

    • Only lets users select queues on the current page.

  • Select pages

    • Specify a selection of pages that will then be exposed to the end user to select from.

  • Pages in current pages group

    • This will let users select any other indexing pages that are in the current pages group.

  • Pages the user can access

    • This will let the user select from any of the other indexing pages the user has access to.

This front end returns the following metadata:

Property

Description

Example Placeholder

queueId

The id of the selected queue.

CODE
{{frontend["frontend-alias"]|property("queueId")}}

queueName

The name of the selected queue.

CODE
{{frontend["frontend-alias"]|property("queueName")}} 

queueTypeId

The queue type id of the selected queue.

CODE
{{frontend["frontend-alias"]|property("queueTypeId")}} 

queueTypeName

The queue type name of the selected queue.

CODE
{{frontend["frontend-alias"]|property("queueTypeName")}} 

pageId

The id of the selected page.

CODE
{{frontend["frontend-alias"]|property("pageId")}} 

pageName

The name of the selected page.

NONE
{{frontend["frontend-alias"]|property("pageName")}} 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.