PML Customization Support for Revision Control Snapshot Capability
- Last UpdatedMar 02, 2026
- 2 minute read
The PmlRevisionControl object provides access to creating snapshots for revisions and graphically displaying or comparing revisions. Like with the DRAW Graphical User Interface, the snapshots are created and stored as an ARCHIV element beneath the REVI.
Note:
The PmlRevisionControl object only operates on the Sheet that is currently active
and displayed in the canvas.
Note:
The PmlRevisionControl object can be used in TTY mode, but only the methods HasSnapshot
and CreateSnapshot are available. Before PmlRevisionControl can be used in TTY, the
current sheet must first be loaded using the PmlLoadSheet object. See Load Sheet to
Memory in TTY Mode for further information. In graphical mode, the sheet loaded by
PmlLoadSheet will take precedence over the current canvas sheet.
import ‘Aveva.Pdms.SDInteraction.UI’
using namespace ‘Aveva.Pdms.SDInteraction.UI.Gui.RevisionControl’
!revisions = object PmlRevisionControl()
|
Name |
Arguments |
Result Type |
Purpose |
|
HasSnapshot(STRING) |
The revision number (Rvsnumber) or REVI element name |
BOOLEAN |
Returns true if this revision has a (valid) snapshot or false otherwise. |
|
HasSnapshot(DBREF) |
The REVI element DBREF element |
BOOLEAN |
Returns true if this revision has a (valid) snapshot or false otherwise. |
|
CreateSnapshot(STRING) |
The revision number (Rvsnumber) or the REVI element name |
none |
Creates or updates a snapshot for the specified revision, which must be the latest one. It is not possible to create or update a snapshot for an earlier revision. |
|
CreateSnapshot(DBREF) |
The REVI element DBREF object |
none |
Creates or updates a snapshot for the specified revision, which must be the latest one. It is not possible to create or update for an earlier version. |
|
DisplayRevision(STRING) |
The revision number (Rvsnumber) or the REVI element name |
none |
Displays the snapshot for the specified revision in the Revision Viewer control. Print and Pdf export are available from here. |
|
DisplayRevision(DBREF) |
The REVI element DBREF object |
none |
Displays the snapshot for the specified revision in the Revision Viewer control. Print and Pdf export are available from here. |
|
CompareRevisions(STRING,STRING) |
The revision munbers (Rvsnumber) or the REVI element names |
none |
Invokes the compare operation for the two revisions provided. The current working copy is represented by an empty string. |
|
CompareRevisions(DBREF,DBREF) |
The REVI element DBREF objects |
none |
Invokes the compare operation for the two revisions provided. The current working copy is represented by an empty DBREF object. |