Configuration Management Event Categories
An event is a defined point in configuration management operation. The four categories of events connected with configuration management operations are:
• member
• configuration management project
• revision
• server
By default, the global.events definition file is contained in the following directory:
installdir/data/triggers/events
where installdir is the path to the directory where you installed the PTC RV&S server.
 |
If the events directory contains more than one global.events definition file, all files are loaded. If the files contain identical events, the values in the last read file are used.
|
You can change the directory by editing the following property under > > in the PTC RV&S Administration Client:
mksis.si.triggers.events
The syntax for an event is:
<Category of event>.<event name>.<pre or post>
for example:
Member.freeze.pre
Project.importSubproject.post
Project.importSubproject.post
The following tables list the events in each category:
|
Project Events
|
|
|---|---|
|
checkpoint.pre
|
checkpoint.post
|
|
restore.pre
|
restore.post
|
|
addMember.pre
|
addMember.post
|
|
dropMember.pre
|
dropMember.post
|
|
moveMember.pre
|
moveMember.post
|
|
newSubproject.pre
|
newSubproject.post
|
|
importSubproject.pre
|
importSubproject.post
|
|
configureSubproject.pre
|
configureSubproject.post
|
|
dropSubproject.pre
|
dropSubproject.post
|
|
moveSubproject.pre
|
moveSubproject.post
|
|
newVariant.pre
|
newVariant.post
|
|
deleteVariant.pre
|
deleteVariant.post
|
|
deactivateVariant.pre
|
deactivateVariant.post
|
|
activateVariant.pre
|
activateVariant.post
|
|
setDescription.pre
|
setDescription.post
|
|
dropProjectAttribute.pre
|
dropProjectAttribute.post
|
|
setProjectAttribute.pre
|
setProjectAttribute.post
|
|
Revision Events
|
|
|---|---|
|
promoteTo.pre
|
promoteTo.post
|
|
demoteTo.pre
|
demoteTo.post
|
|
addLabel.pre
|
addLabel.post
|
|
deleteLabel.pre
|
deleteLabel.post
|
|
appendToDescription.pre
|
appendToDescription.post
|
|
Server Events
|
|
|---|---|
|
newProject.pre
|
newProject.post
|
|
dropProject.pre
|
dropProject.post
|
|
submitChangePackage.pre
|
submitChangePackage.post
|
|
acceptChangePackage.pre
|
acceptChangePackage.post
|
|
rejectChangePackage.pre
|
rejectChangePackage.post
|
|
closeChangePackage.pre
|
closeChangePackage.post
|
|
commitChangePackage.pre
|
commitChangePackage.fail
commitChangePackage.post
|
|
discardChangePackage.pre
|
discardChangePackage.post
|
|
discardChangePackageEntry.pre
|
discardChangePackageEntry.post
|
|
moveChangePackageEntry.pre
|
moveChangePackageEntry.post
|
|
Server.archivemetric.manual
|
|
|
Server.projectmetric.manual
|
|
|
Server.setarchivemetric.manual
|
|
|
Server.setprojectmetric.manual
|
|
|
Member Events
|
|
|---|---|
|
freeze.pre
|
freeze.post
|
|
thaw.pre
|
thaw.post
|
|
setAttribute.pre
|
setAttribute.post
|
|
dropAttribute.pre
|
dropAttribute.post
|
|
lockRevision.pre
|
lockRevision.post
|
|
unlockRevision.pre
|
unlockRevision.post
|
|
checkIn.pre
|
checkIn.post
|
|
checkOut.pre
|
checkOut.post
|
|
setMemberRevision.pre
|
setMemberRevision.post
|
|
rename.pre
|
rename.post
|
|
setrule.pre
|
setrule.post
|
|
clearrule.pre
|
clearrule.post
|
Configuration Management Commands
The following tables list the available configuration management commands and their associated event identifiers under the four categories of events:
|
Member Command
|
Member Event Identifier
|
|---|---|
|
si freeze
|
Member.freeze
|
|
si thaw
|
Member.thaw
|
|
si addmemberattr
|
Member.setAttribute
|
|
si dropmemberattr
|
Member.dropAttribute
|
|
si lock
|
Member.lockRevision
|
|
si unlock
|
Member.unlockRevision
|
|
si ci
|
Member.checkIn
|
|
si co
|
Member.checkOut
|
|
si updaterevision
|
Member.setMemberRevision
|
|
si rename
|
Member.rename
|
|
si setmemberrule
|
Member.setruleMember.clearrule
|
|
Project Command
|
Project Event Identifier
|
|---|---|
|
si checkpoint
|
Project.checkpoint
|
|
si restore
|
Project.restore
|
|
si add
|
Project.addMember
|
|
si drop
|
Project.dropMember
|
|
si move
|
Project.moveMember
|
|
si createsubproject
|
Project.newSubproject
|
|
si createsubproject
|
Project.importSubproject
|
|
si movesubproject
|
Project.moveSubproject
|
|
si drop
|
Project.dropSubproject
|
|
si createdevpath
|
Project.newVariant
|
|
si dropdevpath
|
Project.deleteVariant
|
|
si deactivatedevpath
|
Project.deactivateVariant
|
|
si activatedevpath
|
Project.activateVariant
|
|
si setprojectdescription
|
Project.setDescription
|
|
si dropprojectattr
|
Project.dropProjectAttribute
|
|
si setprojectattr
|
Project.setProjectAttribute
|
|
si applycp
|
various identifiers, depending on the required operations
|
|
Revision Command
|
Revision Event Identifier
|
|---|---|
|
si promote --state=<specific state>
|
Revision.promoteTo
|
|
si promote (no state specified)
|
Revision.promoteFrom
|
|
si demote --state=<specific state>
|
Revision.demoteTo
|
|
si demote (no state specified)
|
Revision.demoteFrom
|
|
si addlabel
|
Revision.addLabel
|
|
si deletelabel
|
Revision.deleteLabel
|
|
si appendrevdesc
|
Revision.appendToDescription
|
|
Server Command
|
Server Event Identifier
|
|---|---|
|
si createproject
|
Server.newProject
|
|
si droppproject
|
Server.dropProject
|
|
si submitcp
|
Server.submitChangePackage
|
|
si acceptcp
|
Server.acceptChangePackage
|
|
si rejectcp
|
Server.rejectChangePackage
|
|
si closecp
|
Server.closeChangePackage
|
|
si discardcp
|
Server.discardChangePackage
|
|
Discard Change Package Entry
|
Server.discardChangePackageEntry
|
|
Move Change Package Entry
|
Server.moveChangePackageEntry
|