Difference between revisions of "Field Revision Annotations"

From SmartWiki
Jump to: navigation, search
Line 28: Line 28:
 
To use the Field Revision Annotation feature, an Annotation Type needs to be created.  The Annotation Type also allows users to define role based permissions.
 
To use the Field Revision Annotation feature, an Annotation Type needs to be created.  The Annotation Type also allows users to define role based permissions.
  
* Click on the '''Configuration''' menu, then select the '''[[Roles & Permissions]]''' option.<>
+
* Click on the '''Configuration''' menu, then select the '''[[Roles & Permissions]]''' option.
 
* The '''Annotation Type''' page is displayed.
 
* The '''Annotation Type''' page is displayed.
 
* To edit an existing Annotation Type click on the Annotation Type line on the left panel.  
 
* To edit an existing Annotation Type click on the Annotation Type line on the left panel.  
Line 38: Line 38:
 
===Configure Role based permissions against individual UTA Statuses===
 
===Configure Role based permissions against individual UTA Statuses===
  
* Edit the related Status setting to allow the annotations feature to be available for records in this status.
+
Edit the individual UTA Statuses to control who can view and edit the annotations, and who can modify fields in annotation mode.  
  
 
* From the related UTA, click on the '''Settings''' icon.
 
* From the related UTA, click on the '''Settings''' icon.
 
* Navigate to Level 1, 2, or 3 tab, and click on the '''Statuses''' hyperlink.
 
* Navigate to Level 1, 2, or 3 tab, and click on the '''Statuses''' hyperlink.
 
* Create a new status (click on the '''+ New Status''' icon) or edit an existing status (click on the edit status icon).
 
* Create a new status (click on the '''+ New Status''' icon) or edit an existing status (click on the edit status icon).
* Go to Permissions & Availability section .
+
* Go to Permissions & Availability section.
The following fields from the '''Edit Status''' form are related to Revision Annotations.
+
* The following fields from the '''Edit Status''' form are related to Revision Annotations.
 
+
::* '''View Annotation Role''' - those [[UTA role|UTA Role]] that can view annotations at the particular status
* '''View Annotation Role''' -  
+
::* '''View and Create Annotation Roles''' - those [[UTA role|UTA Role]] that can view and edit annotations at the particular status
* '''View and Create Annotation Roles''' -  
+
::* '''Edit Field in Annotation Mode Roles''' - those [[UTA role|UTA Role]] that can edit the field when it is locked
* '''Edit Field in Annotation Mode Roles''' -  
+
::* '''Open Record in Annotation Mode''' - those [[UTA role|UTA Role]] that will be able to access the entity in Annotation Mode, without the need to explicitly turn annotation on
* '''Open Record in Annotation Mode''' -  
 
  
 
==Notes==
 
==Notes==

Revision as of 07:05, 25 August 2016

Template:UnderConstruction



Feature Overview

Revision Annotations is feature that allows you to add annotations at the field level and allow edits to be made to specific fields while keeping the rest of the record locked.

Flexible Status based security allows you to configure role-based permissions to allow different users the ability to add annotations to fields while others the ability to edit the field value.

Illustrated

Annotation 2.pngSpacer.png Annotation 1a.png


Image 1. the Annotation Tab illustrated (above).
Image 2. Example annotations displayed on the Annotation Tab (above)

Configuring Field Revision Annotations

The first step in configuring the Field Revision Annotation is to create an Annotation Type and permission it based on Roles.

You can then go to a UTA and configure UTA Role based permissions against individual UTA Statuses to control who can view and edit the annotations, and who can modify fields in annotation mode.

Creating an Annotation Type

To use the Field Revision Annotation feature, an Annotation Type needs to be created. The Annotation Type also allows users to define role based permissions.

  • Click on the Configuration menu, then select the Roles & Permissions option.
  • The Annotation Type page is displayed.
  • To edit an existing Annotation Type click on the Annotation Type line on the left panel.
  • To create a new Annotation Type complete the field options listed under the New Annotation Type section. . .
  • View & Create: define those roles that can both view and create this Annotation type
  • View only: define those roles that are only able to view this Annotation type
  • Click Save.

Configure Role based permissions against individual UTA Statuses

Edit the individual UTA Statuses to control who can view and edit the annotations, and who can modify fields in annotation mode.

  • From the related UTA, click on the Settings icon.
  • Navigate to Level 1, 2, or 3 tab, and click on the Statuses hyperlink.
  • Create a new status (click on the + New Status icon) or edit an existing status (click on the edit status icon).
  • Go to Permissions & Availability section.
  • The following fields from the Edit Status form are related to Revision Annotations.
  • View Annotation Role - those UTA Role that can view annotations at the particular status
  • View and Create Annotation Roles - those UTA Role that can view and edit annotations at the particular status
  • Edit Field in Annotation Mode Roles - those UTA Role that can edit the field when it is locked
  • Open Record in Annotation Mode - those UTA Role that will be able to access the entity in Annotation Mode, without the need to explicitly turn annotation on

Notes

  • Notes Options - options are delimited by semi-colon.