TEMPLATE CHANGE HISTORY INQUIRY

Use this screen to view asset change history data stored in the FA_TMPLT_AUDIT_LOG table. 

To store change data in the FA_TMPLT_AUDIT_LOG table, you must first run the Asset/Template Change Settings screen. You must also access the Asset/ Template Field/Column Names subtask from that screen to select checkboxes on a field-by-field basis for Asset Template records. Each checkbox that you select signifies that you want to capture data for that field for an Asset Template record each time you make a change to that data, regardless of the screen in which the change was made.

The FA_TMPLT_AUDIT_LOG table holds audit history data that is created when you make changes in any of the following screens:

In the header of this inquiry screen, you can select a general subset of records to view, including the template/revision number, entry date, entry user ID, English column name, and user-defined label name. 

Data displays in the table window when you select the Execute button on the toolbar. Once data displays in the table window, the Match button on the toolbar is enabled. If you select the Match button and then select the Execute button, the fields from the first row automatically display in the screen header fields. Alternately, if you highlight a specific row in the table window, select the Match button, and then select the Execute button, the fields from the highlighted row will automatically display in the screen header fields, and the columns will not be visible in the table window.

Use Subquery to choose more specific selection criteria or enter selection criteria in the screen fields. Data in the table window is non-editable.

You can view template change history data at any time in this screen once the template change history data has been written to the FA_TMPLT_AUDIT_LOG.

Header Fields

Select general parameters using the fields in the header of this screen, or use Subquery to select a more specific subset. If you use Subquery, you will not need to enter any data in the header fields in this screen as selection criteria.

If you do not enter data in this field or in any other header field in this screen, and you do not use Subquery, all available data from the FA_TMPLT_AUDIT_LOG will display in the table window.

The following describes how the English Column Name and User-Defined Label fields function in the header of this screen:

  1. You can specify a single database column name in either data field either by data entry or by using Lookup (to S_FA_DB_COL_DEF.ENGL_COL_NAME). 

  2. If you leave both fields blank, all database column data will automatically display in the table window (excluding user-defined data and within the confines of your other selection criteria).

  3. If you leave the User-Defined Label field blank and you specify a column name (other than "User-Defined Text," "User-Defined Date," "User-Defined Numeric," or "User-Defined Validated Text") in the English Column Name field, data for the specified column will display in the table window.

  4. If you select or enter "User-Defined Text," "User-Defined Date," "User-Defined Numeric," or "User-Defined Validated Text" in the English Column Name field, these "columns" will also be included as selections during the Lookup to S_FA_DB_COL_DEF.ENGL_COL_NAME.

If you do not enter a specific user-defined label in the User-Defined Label field, all data for the user-defined field type will automatically be selected (within the confines of your other selection criteria).

  1. To print user-defined data for a specific user-defined label, you must select or enter "User-Defined Text," "User-Defined Date," "User-Defined Numeric," or "User-Defined Validated Text" in the English Column Name field (these "columns" will also be included as selections during the Lookup).

You must also specify the label in the User-Defined Label data field.

  1. The User-Defined Label field is disabled if the data entered in the English Column Name field is NOT one of the following: "User-Defined Text," "User-Defined Date," "User-Defined Numeric," or "User-Defined Validated Text."

Template

Enter or use Lookup to select the desired template number of the data you want to view. 

This field is optional. If you leave this field blank and you do not use Subquery, all template numbers from the Asset Audit Log table, within the confines of your other selection parameters, will display in the table window.

Because this is a standard Lookup to the FA_TEMPLATE table, you may find that you have selected template/revision numbers for which change history data does not exist or does not meet your other selection criteria.  In this event, the data you expect to retrieve from the FA_TMPLT_AUDIT_LOG table may not be selected.

Note:  The Template field is one of several key fields in the Template Audit Log table. If you have entered data in this field and you select the Execute button in the toolbar, the Template column will not display in the table window.

Rev No

Enter or use Lookup to select the desired revision number of the data you want to view. 

This field is optional. If you leave this field blank and you do not use Subquery, all revision numbers from the Template Audit Log table, within the confines of your other selection parameters, will display in the table window.

Because this is a standard lookup to the FA_TEMPLATE table, you may find that you have selected template/revision numbers from the lookup for which change history data does not exist or does not meet your other selection criteria.  In this event, the data you expect to retrieve from the FA_TMPLT_AUDIT_LOG table may not be selected.

Note:  The Rev No field is one of several key fields in the Template Audit Log table. If you have entered data in this field and you select the Execute button in the toolbar, the Rev No column will not display in the table window.

Entry Date

Enter the desired change history entry date for the data you want to view in this optional field. Lookup is not available at this field.

If you leave this field blank and you do not use Subquery, all change history entry dates, within the confines of your other selection parameters, will display in the table window. 

Note:  The Entry Date field is one of several key fields in the table. If you enter data in this field and you select the Execute button on the toolbar, the Entry Date column will not display.

Entry User ID

Enter or use Lookup to select the desired user ID for the data you want to view. 

This field is optional. If you leave this field blank and you do not use Subquery, all entry user IDs from the Template Audit Log table, within the confines of your other selection parameters, will display in the table window.

Lookup at this field is to the Template Audit Log table, and will therefore display only entry user IDs for which change history data has been written to the Template Audit Log table (FA_TMPLT_AUDIT_LOG). If no data exists in the table, the system displays this message, "Nothing found in Lookup."

Note:  The Entry User ID field is one of several key fields in the Template Audit Log table. If you have entered data in this field and you select the Execute button in the toolbar, the Entry User ID column will not display in the table window.

English Column Name

Enter or use Lookup to select the desired English column name of the data you want to view.

This field is optional. If you leave this field blank and you do not use Subquery, all English column names from the Template Audit Log table, within the confines of your other selection parameters, will display in the table window.

Lookup at this field is to the Template Audit Log table and will therefore only display English column names for which change history data has been written to the Template Audit Log table (FA_TMPLT_AUDIT_LOG). If no data exists in the table, the system displays this message, "Nothing found in Lookup."

Note:  The English Column Name is one of several key fields in the Template Audit Log table. If you have entered data in this field and you select the Execute button in the toolbar, the English Column Name column will not display in the table window.

Use the rules outlined in the Header Fields documentation section to make your desired selection in this field.

User- Defined Label

Enter or use Lookup to select the desired user-defined label of the data you want to view.

This field is optional. If you leave this field blank and you do not use Subquery, all user-defined labels from the Template Audit Log table, within the confines of your other selection parameters, will display in the table window.

Lookup at this field is to the Template Audit Log table, and will therefore display only user-defined labels for which change history data has been written to the Template Audit Log table (FA_TMPLT_AUDIT_LOG).  If no data exists in the table, the system displays this message, "Nothing found in Lookup."

Note:  The User-Defined Label field is one of several key fields in the Template Audit Log table. If you have entered data in this field and you select the Execute button in the toolbar, the User-Defined Label column will not display in the table window.

Use the rules outlined in the Header Fields documentation section to make your desired selection in this field.

Table Window

Please refer to the preceding documentation regarding the relationship between column data displayed in the table window and field data displayed in the screen header. The columns in the table window are non-editable.

Note:  Technically, in this version of Costpoint, you can use the standard Windows Find and Replace functionalities in most child table window screens. Because this is an inquiry screen that cannot be edited, the Replace function has been disabled. You can, however, safely use Find in this screen because its sole purpose is to help you locate specified data within the table window. For more information about the Find and Replace functionalities, please see the Basic Functions documentation.

Template

This column, as applicable, displays the template number for the change history data that you have selected to view.

Rev No

This column, as applicable, displays the revision number for the change history data that you have selected to view

Entry Date

This column, as applicable, displays the change history entry date for the change history data that you have selected to view

Entry User ID

This column, as applicable, displays the change history entry user ID for the change history data that you have selected to view

English Column Name

This column, as applicable, displays the English column name for the change history data that you have selected to view

User-Defined Label

This column, as applicable, displays the user-defined label for the change history data that you have selected to view

Orig Col Value

This column displays the original (old) data from before the change for the records you have selected to view

New Col Value

This column displays the revised (new) data after the change for the records you have selected to view.

Tables Information

Data viewed in this screen is stored in the Template Audit Log table (FA_TMPLT_AUDIT_LOG). You can print the data from this table by running the Print Change History report.

Lookups, as applicable, access the following tables: