Skip to content

Working with the Contract Log

The Contract Log provides a complete audit trail of all important changes made to contracts. It automatically records contract creation, updates to both the Contract Header and Contract Lines, and changes to key responsible roles — giving users full visibility into who changed what, when, and where.

Purpose

  • Maintain a transparent and auditable change history for contracts.
  • Allow users to easily trace modifications by comparing old and new values.
  • Automatically log contract creation, field updates, and responsible person changes.

Logged Events

Area Event
Contract Header Contract created
Contract Header Start Date changed
Contract Header End Date changed
Contract Header Criticality Level changed
Contract Header Contract Volume changed
Contract Header Responsible Person changed
Contract Line Unit Cost changed
Contract Line Quantity changed

What is recorded

Each log entry includes:

  • Contract number (and line number for line changes)
  • User ID who made the change (first 50 characters)
  • Old and new values in clear, readable format
  • Timestamp of the logged change
  • Record ID with drill-down functionality – clicking it opens the corresponding contract record

Only meaningful changes (where the previous value was not empty or zero) are logged to avoid unnecessary entries.

Example Log Messages

Log messages follow consistent patterns based on the type of event:

  • Contract creation: Contract 2149 created.

  • Header changes: Contract 2149: Start Date changed from 09/01/25 to 10/01/25. Contract 2149: End Date changed from 09/30/25 to 10/30/25. Contract 2149: Criticality changed from Medium to High. Contract 2149: Contract Volume changed from 10,000 to 12,000. Contract 2149: Responsible Person changed from John Smith to Emily Brown.

  • Line changes: Contract 2149, Line 10000: Unit Cost changed from 500 to 700. Contract 2149, Line 10000: Quantity changed from 5 to 54.

Dates and numbers are shown in the system’s standard format (e.g., MM/DD/YY).

Accessing the Contract Log

There are two ways to open the Contract Log:

  1. Admin Role Center Cue

    • The Contract Log Cue in the Admin Role Center displays the total number of log entries.
    • Clicking the cue opens the Contract Log page directly.

  2. Search Functionality

    • All users can access the Contract Log by using the Search (Tell Me) feature and opening the page manually.

Behavior Details

  • Log entries are automatically created by event subscribers on the SIM_CM Contract Header and SIM_CM Contract Line tables.
  • Contract creation and field modifications are recorded when a record is inserted or modified (non-temporary).
  • Tracked header fields: Start Date, End Date, Criticality Level, Contract Volume, and Responsible Person.
  • Tracked line fields: Unit Cost and Quantity.
  • Log entries are created via the SIM_CM Log Management codeunit and linked to the corresponding record through Record ID, which supports direct drill-down navigation.

Summary

The Contract Log ensures that every significant contract change is automatically tracked and accessible. Users and administrators can monitor updates such as:

  • Contract 2149 created.
  • Contract 2149: Responsible Person changed from John Smith to Emily Brown.
  • Contract 2149: End Date changed from 09/30/25 to 10/30/25.
  • Contract 2149, Line 10000: Quantity changed from 5 to 54.

Administrators can also view the number of log entries directly from their Admin Role Center Cue, ensuring complete transparency and control over all contract activities.