Norsk

Compose is equipped with functionality to display different views of the same form/workflow. By defining different perspectives, you can customize the respondent view for the same workflow for different gadgets, say PC, iPad, Mobile, PDF etc. This user guide is a continuation of the Views - Different views of the same form user guide for creating different views of a form. In this user guide, we’ll implement different form views into different perspectives (which is the view equivalent for workflows).

Head to the Settings section in the workflow builder of a workflow in which you’d like to have multiple perspectives. In the Perspectives section of the workflow properties panel, click Create to add another perspective.

Open

Enter a name for the perspective and click OK. The new perspective will appear in the list of perspectives. Repeat this process if you’d like more perspectives.

Open

Navigate to the Builder. Before we connect the perspectives to views in the form activity, we need to set a matching mechanism in the start point. This mechanism triggers the correct perspective for the correct gadget. In this example we’ll demonstrate how to set up a mobile view. Start by selecting the start point. In the start point properties you’ll see that you can change the default perspective settings. Leave it for now.

Open

Under Alternative View Settings click Add perspective. Select a perspective from the list and click OK.

Open

Select the newly added perspective from the list to reveal the User Agent Pattern and Layout/Skin property. In the User Agent Pattern window we enter a script for the aforementioned matching mechanism. For cellphones the script reads (see the bottom of the page for more scripts):

Change the Layout/Skin if you want a specific skin design for the perspective.

Open

Now we can select the form activity (which is connected to a form with multiple views, see the Views - Different views of the same form user guide). Head to the Alternative View Settings in the form properties and click Add Perspective.

Open

Select the perspective you want to add as an alternative view and click OK.

Open

Select the newly added perspective to reveal the View and Layout/Skin properties for the perspective. The View dropdown lists all the form views. Select the desired form view.

Open

Specify the skin and layout of the form view in the Layout/Skin dropdown.

Open

Remember to save the draft and create a version to set the perspectives into effect.

User Agent Pattern Scripts

User agent pattern scripts must be specified for an alternative perspective of a workflow entry point to match the desired user agent (browser, tablet, mobile etc.). If the script returns true, then that alternative perspective is selected. Returning any other value or a failure of the script will result in that alternative perspective not being selected.

Following are the properties available to a user agent detection script.

Sample user agent string sent from the browser:

The user agent string is broken down into a list of items and exposed via the agent variable inside scripts. agent.items would return these items inside the scripts. An item can either be a product or a comment.

Product and comment Objects expose properties to easily work with user agent string components.

Given below are some example scripts:

Test if the browser belongs to the Firefox family of browsers and its version is 11.0:

Test if the browser type Mozilla is of a version greater than 3: (Note that IE also sends the user agent as Mozilla)

Tests whether WOW64 is contained as a comment:

Tests whether Windows is contained as a comment (which determines that the user came from a Windows platform):

Without operating on comments/products, it tests if the browser is IE: