Registry Master Contract (sys-viewer-vmstrcntrct)


Set default values for Master Contract (PM Master Scheduler).

Testing Your Registry Entries
The system does not verify the validity of registry entries. Be sure to test your registry entries after completing them to verify that they are functioning correctly.

Setting Values are Uppercase-Lowercase Sensitive:
The Setting Value is case-sensitive: be sure that you enter the value exactly as specified in the documentation. If the documentation specifies a value of true, do NOT enter True or TRUE.

Related Registry Options:

See Default PM Billing GL Income and Accrual Accounts for a sys-ffv-global-settings option to default these accounts when Create PM Billing is run.

Registry to Disable Use of Equipment Service Task when Master Contract PM's are Created.

Important Fields:

Id:  sys-viewer-vmstrcntrct

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.


This optional field may be used to briefly describe the purpose of this registry entry.

Default Billing Item

Setting Key: DefaultSiteListBillingItem SettingValue: itemid
where itemid is replaced by the Job Cost / Billing Item Id that should default when you select a Job on the Site List tab. The default billing item id from this registry record is used to identify both the Billing Item and the Cost Code for the Job's PM Billing.  The selected cost code must reference the default billing item.

Setting PM Work Codes with Auto Populate

The options enable you to specify the default work code on a month-by-month basis when the Auto Populate button is clicked to generate or update the Schedule tab.

Setting Key: PMWorkCode-01 Setting Value: WorkCodeIdJanuary inspections
Setting Key: PMWorkCode-02 Setting Value: WorkCodeIdFebruary inspections
This entry takes precedence over the following "PMWorkCode" entry that applies to ALL months.

Setting Key: PMWorkCode  Setting Value: WorkCodeId

This option provides the default work code for all inspections when the Auto Populate button is clicked.

Note: Inspection Defaults field in the Master Contract Record
The Inspection Defaults: Work Code field in the Master Contract record enables you to select the default values that will be used to populate the Schedule tab when you click the Auto Populate button; this is true for both Monthly and Day of the Week inspections. These fields override the registry setting sys-viewer-vmstrcntrct options (if they exist) used to set the work code. If these fields are not completed, those specified in the registry will be used.

Setting GL Accounts with Auto Populate (Required)

Setting Key: GLCreditAccount Setting Value: GLAccountId for Revenue Recognition
Setting Key: GLDebitAccount Setting Value: GLAccountId for UNbilled Revenue

These options are REQUIRED if you intend to use the Auto-Populate feature. They provide  the GL accounts to be applied the Advanced Billing tab when the Auto Populate button is clicked. Note that the Debit account is accessed via the Magnify button.

Registry Entry to Remove Restrictions

By default, the system imposes the following restrictions on Master Contracts:

Users may not use the Renew button to adjust existing lines for the current date range.

Users are not allowed to manually adjust billing or inspection lines that have already been generated for the current date range.

Master Contracts must be specified for one calendar year.

These restrictions are imposed to prevent the users from generating extra copies of billings/pm work orders that have already been created. However, if the user wishes to adjust a contract, the default behavior may be too restrictive. This registry options allows you to remove the above restrictions in the viewer. WARNING: this registry option should be used with caution. If additional billings / pm’s are generated due to changes made to an existing schedule, it is the USER’S responsibility to reverse previously generated invoices and cancel previously pm work orders.

Setting Key: RemoveValidations  Setting Value: true

If this registry entry is in place, and the user presses the Renew button for the current date, the following message will be displayed: “Warning – This action will replace the existing schedule. Any previously generated invoices and work orders will still exist. Are you sure you want to continue?

If the user clicks Yes, the Schedule will be replaced. If Create PM Billing / Work Orders is rerun, it is possible that duplicate work orders / invoices may be created.

Control Display of WO Tabs

This registry option may be implement to determine which work orders appear on the Open and Other Work Order tabs by the use of a valid SQL expression.  

Setting Key: WorkOrderWhereClauseOpen  Setting Value: valid SQL expression

Setting Key: WorkOrderWhereClauseOther  Setting Value: valid SQL expression


Setting Key: WorkOrderWhereClauseOther  Setting Value: wrkordr_stts_ctgry not in ('Open','Archived')