This registry uses the viewer's 'sys-viewer-' registry entry (e.g. 'sys-viewer-vclntste') to disable fields on a viewer by viewer basis. Note that disabled fields appear on the screen but appear as display-only fields. This registry may also be used to disable a viewer's buttons on the parent or child tabs or the sidebar.
Fields / buttons may also be defined as disabled in New Call via the sys-start-snwcll registry.
See the Standard Registry section in Registry Viewer for additional Registry Id formats to allow entries for specific Users, Branches, Security, or User Groups to override the main entry.
SAMPro provides multiple registry line support to the RequiredFieldsParent, RequiredFieldschild, DisabledFieldsParent, and DisabledFieldschild Setting Keys. This allows users to tag enough as many fields as needed, without encountering limitations due to long field names and the character limit of the Setting Value.
Example: Job
Id: sys-viewer-job
Setting Key: RequiredFieldsParent Setting Value: jb.lcl: txathrty.id,rteschdle.id
Setting Key: RequiredFieldsParent Setting Value: jb.gl-ar: glaccnt.id
…. And additional lines as needed
Setting Key: disabledFieldsParent Setting Value: fieldname1, fieldname2 ….
The contents of the line can be a field name or a series of field names separated by commas. When you place the mouse pointer over the field, the database field name will appear in the extreme left at the bottom of the screen. The internal field name appears just to its right – this is the name that we need. Do not include the leading group name but intermediate subgroup names must be included.
Example:
In the following illustration, the mouse cursor is over the Hourly Burden field.
To disable the Hourly Burden field, the following registry entry would be created:
sys-viewer-jbcstcde
Setting Key: disabledFieldsParent Setting Value: jbcstcde.hrly-lbr-brdn-rte
Setting Key: disabledFieldsXXXX Setting Value: fieldname1, fieldname2 ….
where 'XXXX' is the form name of the appropriate child pane. Remember that to identify the form name of a child tab, position the mouse pointer to the extreme upper left corner of the child window and the form will appear in the status pane at the bottom of the screen.
To determine the database field names, position the mouse pointer over the field. and its will appear in the extreme left: the internal field name appears just to its right – this is the name that we need. The contents of the line can be a field name or a series of field names separated by commas. Do not include the leading group name but intermediate subgroup names must be included.
Example:
In sys-viewer-vwrkordr, deny users the ability to set or clear the quote flag in the Work Order Other tab:
Setting Key: disabledFieldschild2 Setting Value: wrkordrothr.qte
To identify the name of a child, position the mouse pointer to the extreme upper left corner of the child window and the Form Name will appear in the Status line – we can see that this is child2:
To see the name of the field itself, position the mouse pointer over the field. The database field name will appear in the extreme left: the internal field name appears just to its right – this is the name that we need.
Tip:
If you want to let one person access denied fields in the above example, you would clone the registry entry sys-viewer-vwrkordr to sys-viewer-vwrkordr--userid and delete the disabled fields registry options.
Example: Disable Budget Tab fields on PM Workbench
ID: sys-viewer-vjbpm
Setting Key: DisabledFieldschildBudget
Setting Value: jbbdgt.hrs,jbbdgt.qntty,invntryitm.id,jbcstcde.id,jbcstctgry.id,jbbllngitm.id,jbbdgt.unt-cst,jbbdgt.amnt-cst,bllngrtetype.id,jbbdgt.rvne-rte,jbbdgt.amnt-rvne
The button's field name must be referenced in the registry - it is displayed to the right in the status pane when you position the mouse cursor at the extreme upper left corner of the button. Typically, it will begin with push-
Important:
When a button is disabled, it will still be displayed normally but clicking it will not have any effect.
The following examples may be of use:
Registry to Disable the "Copy Site Address" button on the Job Viewer Invoicing Tab
Id: sys-viewer-vjb
Setting Key: disabledFieldsParent Setting Value: push-copySiteBillingAddress
Registry to Disable "Add Taxes" button on AP Journal Viewer
Id: sys-viewer-vapjrnl
Setting Key: disabledFieldsParent Setting Value: push-addTaxAuth
Registry to Disable the CreateSubPo and TechFinder buttons on the Work Order Technician Tab
Id: sys-viewer-vwrkordr
Setting Key: disabledfieldschild6 Setting Value: push-createSubPO,push-startTechFinderForWO
Registry to Disable the Work Order Viewer's Sidebar Create PO and Call Script Buttons
Setting Key: disabledFieldssidebar
Setting Value: push-addCallScript,push-createWorkOrderPO
Registry to Disable the New Site (Flashlight) Button in New Call
Id: sys-start-snwcll
Setting Key: disabledFieldssidebar
Setting Value: push-switchToNewClientSite
The standard view of the Check viewer was changed to simplify initial data entry in case 3814, making it desirable to disable all fields in this viewer via registry so that group ‘All’ users would not accidentally make changes to this record. To disable all Check fields:
Id: sys-viewer-vchcklst
Setting Key: DisabledFieldsParent
Setting Value: gl-bnk: glaccnt.id,glentty.id,chck.nmbr,chck.amnt,chck.rfrnce-nme,chck.dte-chck,chck.type,chck.dscrptn
Setting Key: disabledFieldschild
Setting Value: chcklst.amnt-grss
Id: sys-viewer-vchcklstpr
Setting Key: DisabledFieldsParent
Setting Value: gl-bnk: glaccnt.id,glentty.id,chck.nmbr,chck.amnt,chck.rfrnce-nme,chck.dte-chck,chck.type,chck.dscrptn
Setting Key: disabledFieldschild
Setting Value: chcklst.amnt-grss