Field Permission Matrix

From SmartWiki
Revision as of 16:33, 13 June 2013 by Arthur Lathrop (talk | contribs) (Configuration)

Jump to: navigation, search

The Field Permission Matrix allows a System Administrator to define a set of rules governing view and edit permissions. These rules are based on a combination of user role and record status. This set of rules, known as the Permission Matrix, can then be applied to multiple fields.

Raison d'être

The Field Permission Matrix exists for two reasons:

  • in order to make it easier for System Administrators to apply visibility conditions to a set of fields; and
  • to increase server efficiency (rather than validating potentially hundreds of visibility conditions, when the Field Permission Matrix is used, validation takes place once and is then applied to all affected fields).

Examples of situations in which a System Administrator may want to utilize the Field Permission Matrix are:

  • when there are a series of fields that should be visible to a given group of roles in one status and to another group of roles in another;
  • when there are a series of fields that should be editable in a certain status and not in others; or
  • any combination of the above.

Configuration

The Field Permission Matrix is configured on the main Settings page of a UTA:
FPM1.jpg

  • After clicking on the "Field Permission Matrix" hyperlink on the main Settings page, the following blank page is displayed.
  • Click on the "New" button to create a new Matrix.

FPM2.jpg

  • Type in a name for your new Field Permission Matrix
  • Select a "Type" (whether the Matrix will be used on Level 1, Level 2 or Level 3 custom fields.)
  • The Description field is optional.
  • Hit Save.

FPM3.jpg

  • Note that the full set of options is now visible: The Custom Fields, Status and Permission Matrix sections have appeared on the page.
    • The Custom Fields section will populate when you have applied your Field Permission Matrix to your custom fields. (This happens later on, you can disregard the Custom Fields section for now.)
    • The Status dropdown will display a list of the statuses available in your UTA.
    • The Permission Matrix section is where you will set your rules for the currently-selected Status.


  • An example is below:

FPM6.jpg

Application to Custom Fields

FPM7.jpg

FPM8.jpg

FPM9.jpg

See Also

Visibility of Custom Fields can also be controlled using: