History
RAMP maintains a comprehensive audit trail for every template and version. The history view lets you see who changed what, when it happened, and view a read-only snapshot of the version at any point in time.
Accessing version history
Section titled “Accessing version history”- Open a template version in the version editor.
- Click the History tab.
- The history panel shows a chronological list of all changes.
You can also access history from the template detail page by clicking the History icon on a specific version.
Audit entries
Section titled “Audit entries”Every significant change to a template version is recorded as an audit entry. Each entry includes:
| Field | Description |
|---|---|
| Timestamp | When the change occurred |
| User | Who made the change |
| Action | The type of change (create, update, delete, publish, etc.) |
| Details | Specific information about what changed |
Types of tracked changes
Section titled “Types of tracked changes”The audit trail captures:
- Step created — A new step was added.
- Step updated — Step content, title, or settings were modified.
- Step deleted — A step was removed.
- Step reordered — Steps were rearranged via drag and drop.
- Variable created — A new variable was added.
- Variable updated — Variable properties were modified.
- Variable deleted — A variable was removed.
- Version published — The draft was published with a version number.
- Version approved — The published version was approved.
- Team member added — A user or group was added to the version team.
- Team member removed — A user or group was removed from the version team.
- Notes and comments — Changes to version-level and step-level notes and comments.
Cumulative history view
Section titled “Cumulative history view”The Cumulative History view aggregates audit entries across all versions of a template, providing a single timeline of the template’s complete evolution.
To access the cumulative history:
- Navigate to the template detail page.
- Click the History button (with the clock icon).
- The cumulative view shows all changes across all versions in chronological order.
This is useful for understanding the full lifecycle of a template, from initial creation through multiple published versions.
Point-in-time historic view
Section titled “Point-in-time historic view”The most powerful history feature is the ability to view a version exactly as it existed at any point in the past.
Opening a historic view
Section titled “Opening a historic view”- Navigate to the version history (History tab in the version editor).
- Find the audit entry for the point in time you want to view.
- Click the View at this point link on the audit entry.
- A read-only historic view opens showing the version state at that timestamp.
What the historic view shows
Section titled “What the historic view shows”The historic view displays:
- Step tree — All steps as they existed at the selected timestamp, with full hierarchy and ordering.
- Step content — Rich text content, titles, and notes for each step.
- Variables — All variables with their names, types, default values, and required status.
- Team members — Who was assigned to the version at that time.
- Notes and comments — Version-level and step-level notes and comments as they existed.
- Version metadata — Version string, status, draft title, and other properties.
Interactive features
Section titled “Interactive features”Even though the historic view is read-only, it provides:
- Step selection — Click any step to see its details in a side panel with full content, notes, responsibility configuration, and comments.
- Variable values toggle — Show or hide variable default values in step content.
- Virtual steps toggle — Preview how virtual steps would be generated from iteration variables.
- Resizable panels — Adjust the step tree and details panels as needed.
Template-level audit
Section titled “Template-level audit”In addition to version-level history, RAMP also tracks template-level changes:
- Template title changes.
- Category reassignment.
- System association changes.
- Template deprecation and undeprecation.
- Template deletion (soft delete).
These are available through the template audit API and appear in the admin audit log.
Use cases
Section titled “Use cases”Investigating changes
Section titled “Investigating changes”When a procedure needs to be reviewed after an incident:
- Identify the template version used during the incident.
- Open the version history.
- Find audit entries around the time the version was published.
- Use the point-in-time view to see exactly what the procedure looked like.
- Compare with earlier versions to identify what changed.
Restoring content
Section titled “Restoring content”If content was accidentally deleted or incorrectly modified:
- Open the version history.
- Navigate to a point-in-time view before the unwanted change.
- Copy the content from the historic view.
- Paste it into the current draft version.
Compliance auditing
Section titled “Compliance auditing”For regulatory compliance, the history view provides evidence of:
- Who created and modified each procedure step.
- When changes were made.
- Who approved the version for use.
- The exact content of procedures at any given date.