Dynamic Field Visibility Control

From SmartWiki
Revision as of 13:58, 10 July 2017 by Ciaran Donnelly (talk | contribs) (Define the branch dependent custom field)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

The Dynamic Field Visibility Control feature is used to create sets of fields that are displayed or hidden dependent on the value selected from another custom field.

The feature is similar to the functionality currently offered by the Display Only – Web Page View, but is designed for scenarios where the required logic is more complex than the dynamic control field allows. This includes . . .

  • Multiple levels of field branching logic
  • Dependent fields that are not displayed directly under the controlling field


Configuration

The feature uses tree settings to add fields and branches. The actual steps for configuring the Dynamic Field Visibility Control feature are summarized below:

  • Create new Dynamic Field Visibility Control
  • Define the Primary field
  • Define the branching
  • Define the branch dependent custom field

Additional steps that may need to be used include . . .

  • Deleting branching or branch dependent custom field
  • Copying branch dependent custom field to a second branch


Create new Dynamic Field Visibility Control

The Dynamic Field Visibility Control feature can be created against level 1s, level 2s, level 3s, users and Organizations.


  • Click on the Dynamic Field Visibility Control link for the entity that you wish to create the feature against.

Dynamic Field Visibility 1.png



  • A list view of previously configured logic is displayed. Click on the New Dynamic Field Visibility Control button.

Dynamic Field Visibility 2.png



  • The New Dynamic Field Visibility Control is displayed. Populate the Name and, if necessary, the description field and click Save.

New Dynamic Field Visibility.png



  • When the page refreshes then the Primary field icon is exposed. This is used to define the Primary field.

Dynamic Field Visibility Created.PNG



  • It is also possible to limit the Dynamic Field Visibility Control to a particular Template type.

Dynamic Field Visibility - Template type.PNG

Define the Primary field

The Primary field, and indeed all controlling custom fields, must be either a Select Many – Check Box or a Select One – Combo Box as these are the only ones with finite number of pre-defined options.


  • Click on the Primary field icon. This exposed the Edit Field option, which includes a drop-down showing all Check Box and Combo Box custom fields available for the current entity.

Dynamic Field Visibility 5.png


  • Select the relevant custom field and click on the Apply button. The field name will now appear instead of the Primary Field text.

Dynamic Field Visibility 6.png



Define the branching

Once the Primary field is selected then the next step is to define the path through which other fields will be displayed. The first step here is to create branches based on the options available against the Primary field.


  • Click on the plus sign, inside the green circle, adjacent to the Primary field. This exposes the Add New Branch screen.


  • Click on the text field within the Add New Branch screen to expose and select one of the Primary field options.

Dynamic Field Visibility 7.png


  • Click on the Apply button. You will be taken back to the Dynamic Field Visibility Control screen, which will show all branches created under the Primary field. The screen shot below shows 2 branches, one for the English option associated with the Available in field, and one for the French option associated with the Available in field.

DynamicFieldVisibility8.png

Define the branch dependent custom field

The final step in the process is to define the fields that should be exposed based on the branches created. You can have multiple fields dependent on the one branch, but each field must be added individually using the steps below.

  • Click on the plus sign, inside the green circle, adjacent to the appropriate branch. This exposes the Add New Field screen.
  • Click on the text field within the Add New Field screen to expose and select a custom field. All available custom field types will be listed, not just the combo and check box options.

DynamicFieldVisibility9.png


  • Click on the Apply button. You will be taken back to the Dynamic Field Visibility Control screen, which will show the branches created under the Primary field as well as the custom field under the relevant branch.

NOTE: If you select a Select Many – Check Box or a Select One – Combo Box field as the branch dependent custom field then you can add another level of field branching logic. If the field is not one of these 2 types then no further branching is permitted.

DynamicFieldVisibility10.png

Deleting branching or branch dependent custom field

All elements of the Dynamic Field Visibility Control (i.e. Primary field, branches, dependent fields) will appear with a minus sign, inside a red circle.

If you click on this against a branch or dependent field then you will asked to confirm that you wish to remove the selected option and all of the sub-branches. Clicking OK will remove them.



Copying branch dependent custom fields to a second branch

Users can copy all dependent fields and sub-branches from one branch to a new branch using the Copy feature. This will save them having to reconfigure custom fields and sub-branches for those branches that share the same path.

  • Click on one of the existing branching options. This exposes the Add New Branch screen, which includes a Copy button.
  • Click on the text field within the Add New Branch screen to expose and select one of the Primary field options that currently does not have a branch.

NOTE: You will not be permitted to copy to a Primary field options that currently has a configured branch.

Dynamic Field Visibility 11.png

  • Click on the Copy button and click OK in any subsequent pop-ups. You will be taken back to the Dynamic Field Visibility Control screen, which will show the original branch and the new branch, both appearing with the same custom fields and sub-branches underneath.

See Also

Custom Fields