The development audit utility tracks changes made to ServiceCenter records during the development phase of ServiceCenter implementation. Whether you are making a few changes or extensively customizing your system, it is critical you have a record of the changes (deltas) to ensure loading of the correct version when you move to production.
The Dev Audit utility tracks changes to the following files:
application format
formatctrl link
scripts Object
Process States
trigger code
eventregister eventmap
eventfilter datadict
dbdict displayscreen
displayoption
Development Auditor Menu and Functions
To access the Development Auditor Menu:
1 Select the Utilities tab of the system administrator’s home menu.
2 Click Development Auditing. The Development Auditor Menu is displayed.
3 Select a function from the Audit menu.
Turn Auditing On/Off
This function allows you to enable or disable file auditing. With auditing turned on, a separate audit file is created each time you make a change to a file and save that changed file to the database.
ServiceCenter is delivered with a default set of audited files in place to enable you to track development changes.
To access the Audit Control form:
1 Click Turn Auditing On/Off in the Development Auditor Menu.
The Audit Control record is displayed.
2 Update one or both of the following functions:
Do you want to audit development changes?—enable/disable auditing of development changes.
Do you want to keep backups of Changes?—enable/disable backups of development changes.
3 Click Save to save your changes.
The following message is displayed in the status bar: Record updated in the devauditcontrol file.
4 Click OK to return to the Development Auditor Menu.
View Audit History
From the Audit History form, you can search for a particular audit record by entering specific data about that audit, or you can view a record/QBE list of all audits stored in the database. It is important to look at this file before purging audit records or unloading a development change to production.
To access the Audit History form:
1 Click View Audit History.
Development Auditor Menu and Functions W 143 System Tailoring, Volume 3
A blank Audit History record is displayed.
2 Open an existing Audit record using one of the following procedures:
Enter any information you have from the record and click Search or press Enter.
—or—
Click Search or press Enter.
If more than one record matches the search criteria, the returned screen is split with a record list at the top and the first record in the list displayed below.
Note: There will be an entry for each time that a form or file was added or updated.
In the example above, the problem form is listed with Audit ID 1082514 (when the form was created) and again with Audit ID 1082516 (when it was updated). These entries were added automatically to the record/QBE list each time the form was added or saved.
Figure 8-1: Audit History Record
3 Click the entry you want to view.
Information for this record is entered into the Audit History form.
4 Click Delete to remove the current record from the audit list.
Audit History fields
Audit ID—an identification number added automatically when an audit record is created.
Filename—file type, e.g. format, formatctrl, or link.
Keys—name of a key that can be used to search for an audit record, e.g., the form name.
Event Type—type of action performed on a file when the audit record was created, e.g., add (when a new file is created) or update (when a file is modified).
Date—time and date when the audit record was created. The format is mm/dd/yy hh:mm:ss.
Operator—login name used when the audit record was created.
Development Auditor Menu and Functions W 145 System Tailoring, Volume 3
Unload an Audit Delta
If you wish to specify what the system will be unload, you must first view the audit history. You can remove records from the development audit list by selecting them and then deleting them. See View Audit History on page 142.
Important: Before unloading a change you have made during the
development phase, it is critical that you check the audit files for the correct date of this delta. See View Audit History on page 142.
You will need the date shown in the Audit History form to enter into the Unload form.
To move a change to production with the Unload function:
1 Click Unload an Audit Delta on the Development Auditor Menu.
The AuditUnload form is displayed.
The current date and time are automatically entered in the Unload delta since what date? field.
Figure 8-2: Audit Unload Form
2 Enter the beginning date for the unload (found in the View Audit History record/QBE list.
3 Enter the path and name of the file to which you want to send the unloaded data in the Send Data to Which File? field.
4 Click Proceed.
The Development Auditor Menu is displayed, with a message in the status bar indicating how many records were unloaded.
Purge Audit Records
To remove audit records that you no longer need:
1 Click on the Purge Audit Records button in the Development Auditor menu.
The Audit Purge form is displayed with the current date and time filled in.
2 Replace the date displayed with the beginning date for the range of records you wish to delete.
Figure 8-3: Audit Purge Form
Development Auditor Menu and Functions W 147 System Tailoring, Volume 3
Warning: Make sure that you carefully review the audit records in the Audit History record/QBE list before filling in this date. Purged files cannot be restored.
3 Click Proceed.
A confirmation prompt appears, telling you how many records have been purged.
4 Click OK to complete the process and return to the Development Auditor Menu.
Revision Control W 149