Page Comparison

To configure and manage dynamic field display:

1. Go to System Admin Image Removed > Advanced > Manage Field Display.
   The Field Display Rule Search list is displayed.

2. It is a good idea to filter the presented list for the dataform to which you will add field display so that you can better understand the existing field display logic and determine if this will affect the changes you wish to make.  When you are ready to begin, click Add.

3. The field display rule configuration page provides a number of configuration options, allowing you to customize how your field display will work.
   Image Removed Image Removed

   (1): Table Name – Select the dataform table for which you would like to configure field display - this selection will affect several other choices on this form.

   (2): Field Source – Allows you to either choose a field from the dataform (This Table) as the trigger or a field from a Field Display Proc (Field Display Proc 1 or 2) that has been configured for your company by PrismHR development.  A Field Display Proc is a custom SQL stored procedure that allows you to aggregate information from other dataforms in the system.  This would allow you to say, disable all of the fields on a workspaces Employee and Employment forms if the Client Status on the Client Master page is ‘Terminated’.* 

   (3): Pipeline – The pipeline field denotes the business object pipeline used to apply this display configuration (effectively what part of the application to which this configuration applies). This defaults to ‘Default’ (standard dataform) – it is recommended to leave this value at ‘Default’ unless you have worked with your PrismHR account manager to set up custom business logic and understand how this works.

   (4): Type – The Type field determines whether this will be a Field display change that affects State or Styling.

             State: Visibility / Read-Only attributes

             Style:  Sets CSS Styling changes to the File label based on specific triggering condition (see image above)

   (5): When this field – Presents a series of fields based on your choice of Table Name and Field Source. Whatever is selected in this field will act as the trigger for your field display action.

   (6): equals this value – This is the triggering value and should be set to something appropriate for the triggering field selected to the left.  For example, a checkbox selected as the triggering value should equal either ‘True’ or 1 if you want to trigger your field display off the checked state. The value of a Lookup trigger field should equal the code value of either one of the lookup options, or a comma-separated list of such code values.  OR statements can be built in this way using a comma-separated list of values in this field for distinct value fields such as lookups or parent form fields.  Say you have a lookup field to store the days of the week - you could trigger field display for weekend days by using equals this value: Saturday,Sunday (this equates to 'where value equals 'Saturday' OR 'Sunday').

   Info
   Note – Hiding a fieldset hides all fields within the fieldset, masking any required field actions for those fields.

   (7): This field - This is the field (or fieldset) upon which you will perform the field display action. 

   (8): will – Choose a field display action of either:

   1. Enable – Opens field for edits, allows changes to the field to be saved.
   2. Disable – Marks the field read-only and not editable.
   3. Hide – Hides the field from display
   4. Display – Shows the field on the dataform.  

   The Clear Field on Disable/Hide does exactly that, removes any information previously stored in this field when it is hidden or disabled. This is a hard delete from the system, so exercise careful planning when choosing this option.

4. After you have configured all of the field display options, click Save to save your changes. 

To configure and manage dynamic field display:

1. Go to System Admin  > Advanced > Manage Field Display.

2. It is a good idea to filter the presented list for the dataform to which you will add field display so that you can better understand the existing field display logic and determine if this will affect the changes you wish to make.
   The following example shows a filter using Form Test in the Search field. 
   Image Modified
3. When ready, click Add.
   The Field Display Rule Detail form opens. This form provides a number of configuration options to customize how your field display will work.

4. Complete the form.
   
   
   
   

   Panel
   title Form fields
   Dataform - (required) Select the dataform table for which you would like to configure field display - this selection will affect several other choices on this form. Field Source – (required) Choose a field from the dataform (This Table) as the trigger or a field from a Field Display Proc (Field Display Proc 1 or 2) that has been configured for your company by PrismHR development. A Field Display Proc is a custom SQL stored procedure that allows you to aggregate information from other dataforms in the system. This would allow you to say, disable all of the fields on a workspaces Employee and Employment forms if the Client Status on the Client Master page is ‘Terminated’.*  Type – (required) Determines whether this will be a Field display change that affects State or Styling: State: Visibility / Read-Only attributes (default) Style: Sets CSS Styling changes to the field label based on specific triggering condition (see adjacent image). To set Style, click Settings. the Settings dialog opens. When this field – (required) Presents a series of fields based on your choice of Table Name and Field Source. Whatever is selected in this field will act as the trigger for your field display action. equals this value – (required) This is the triggering value and should be set to something appropriate for the triggering field selected to the left.  For example, a checkbox selected as the triggering value should equal either True or 1 if you want to trigger your field display off the checked state. The value of a Lookup trigger field should equal the code value of either one of the lookup options, or a comma-separated list of such code values.  OR statements can be built in this way using a comma-separated list of values in this field for distinct value fields such as lookups, text, or parent form fields. Say you have a lookup field to store the days of the week - you could trigger field display for weekend days by using equals this value: Saturday, Sunday (this equates to 'where value equals 'Saturday' OR 'Sunday'). Info title Note Hiding a fieldset hides all fields within the fieldset, masking any required field actions for those fields.  This field - (required) This is the field (or fieldset) upon which you will perform the field display action. will – (required)  Choose a field display action of either: Enable – Opens field for edits, allows changes to the field to be saved. Disable – Marks the field read-only and not editable. Hide – Hides the field from display Display – Shows the field on the dataform. The Clear Field on Disable/Hide does exactly that, it removes any information previously stored in this field when it is hidden or disabled. This is a hard delete from the system, so exercise careful planning when choosing this option.

   
   

5. After you have configured all of the field display options, click Save.

6.