Versions Compared

Old Version 2

changes.mady.by.user Former user

Saved on

compared with

New Version Current

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Section
Column

Many work flows often involve a number of people filling out different sections of a single form. So when you're designing this type of flow, you're most likely dragging the same form into the flow designer repeatedly to create the different steps or activities in the flow.

Another way to create this type of flow is to use the Linked Forms feature of the flow designer. In this method, you create a linked version of a form for each activity or step you want in your flow. One great advantage of this method is that if you need to make changes to the form after you've created your flow, you only have to edit the "parent" form — the editing changes are automatically propagated to its linked forms in the flow. Conversely, if you drag multiple copies of the same form into a flow to create activities, you'd have to make any changes to each copy of the form in each activity.

Column

On This Page:

Table of Contents
maxLevel1

One circumstance in which you might not want to use linked forms is a flow in which each user is filling out a different form, or you want to show or hide different parts of a form depending on which user is filling it out (although you can do this to some extent with linked forms using the Security tab or Rules in the Form Designer when you create your form).

  1. To create linked forms in a flow, first drag a form into the flow designer.
  2. Click on the form, and then

...

  1. click Image Modified to create a linked form.
  2. Continue

...

  1. clicking Image Modified to create as many of the linked forms as you want.
Column
width240px

On This Page:

Table of Contents
maxLevel2

The example below shows the parent Lodging-Meal Selections form and its two linked forms. Notice that the parent form and its linked forms initially all have the same name, but the linked forms are outlined by dashed lines rather than solid lines. Note also that the form displays three icons when you click on it, while the linked forms display only the remove icon.

* Click  to create a linked form.
* Click  to open a form in the Form Designer to edit it.
* Click  to remove a form or a linked form.

===

Linked Forms and Activities

...

Because the parent forms and its linked forms represent activities, you'll want to give them unique names. The parent form in this example has three tabs used for hotel check in, dinner selection, and hotel check out.

[[Image:linked-forms_SourceForm.gif]]Image Added

To rename the form and its linked forms, click on them and then use the '''Name''' setting Name setting in the Properties panel as shown below.

[[Image:linked-forms_RenameForm.png]]Image Added

As with other forms you use to create activities, you can assign a linked-form activity to a [[V4_Designing_Flows#Role_List | Role]],so that the activity is performed by someone with that role, or even by a specific [[V4_Designing_Flows#User | user]]. In this example, we rename all three activities and assign each to a different role.* '''CheckIn''' is

  • CheckIn is assigned to the

...

  • Reservations

...

  •  role.

...

  • DiningRoom is assigned to the

...

  • MaitreDHotel

...

  •  role.

...

  • CheckOut is assigned to the

...

  • Billing

...

  •  role.

You may also want only certain sections of the form to be visible in an specific activity so that only users in a certain role see those sections. For example, in this flow, perhaps only the dining room staff needs to see the form's Guest Information tab.

To do this, you can edit the the form via the Flow Designer and use the Security Tab in the Forms Designer to assign a role to sections of the form. Click the form, and then click [[Image:pencil.gif]] to Image Added to open the form in the Form Designer.

In this example, we assign the ''Guest Information'' tab  tab to the ''MaitreDHotel'' role role.

[[Image:linked-forms_FormSecuritygif.gif]]Image Added

When the flow runs, the first activity, ''CheckIn'', is performed by a user with the ''Reservations'' role role, so that user does not see the form's Guest Information tab, which is only visible to a user with the ''MaitreDHotel'' MaitreDHotel role.

[[Image:linked-forms_HiddenTabInActivity.gif]]Image Added

The next activity in the flow, ''DiningRoom'', is assigned to the ''MaitreDHotel'' role role, so that user sees the Guest Information tab.[[Image:linked-forms_VisibleTabInActivity.gif]]

You can also use rules to show or hide parts of a form in an activity. For example you could use the rule below to show the Guest Information tab only when a MaitreDHotel role is using the form.

This rule is useful in a workflow where you want to make a the tab named Review visible only for the workflow activity named Manager Review.<pre>

Code Block
if (form.load) {

...


   if (_data.getParameter('flow.activity.name') == 'MaitreDHotel')

...

 {
     GuestInformation.visible = true;

...


   } 
}

</pre>For more information about using rules this way, see the [[Rules_Examples#Security_Subject_Information | Security Subject]] topic  topic in the Rules Examples section.