--- title: Workflow XML Reference - Triggering Events and Parameters slug: rm/workflow-xml-reference-triggering-events-and-parameters docTags: createdAt: 2026-06-09T13:38:48.825Z --- The following lists the types of events that can trigger actions, and the properties that are used in the XML Workflow definition. In most cases, the property is a child element of the triggering event element. There are cases where the property requires its own block of child elements. # Triggering Event: Transition | **Event Properties (in required order)** | **Property Requirement** | **Notes** | | ---------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Required | - 24-character name maximum
- Maximum 10 Transitions per State
- Must be connected to two States | | Triggers | Optional | - The event's triggered actions
- Each action is represented by its own `` child-element block
- Maximum 10 Triggers per event | | FromState | Required | - Indicates the originating State | | ToState | Required | - Indicates the destination State | | PermissionGroups | Optional | - Restricts the Transition trigger to a specific set of users
- Contains the following child-element structure:
`` ``UserGroup1Name`` ``
`` ``UserGroup2Name`` ``  
`` ``UserGroupnName`` `` | | SkipPermissionChanges | Optional | - When included with a value of `true`, the aforementioned groups are not required to have the Transition trigger the action | # Triggering Event: PropertyChange | **Event Properties (in required order)** | **Property Requirement** | **Notes** | | ---------------------------------------- | ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Name | Optional | - Not required by the Workflow definition, but useful for XML readability | | Triggers | Required | - The event's triggered actions - maximum 10 Triggers per event | | PropertyName | Required | - The name of a standard artifact property
- When this property changes, the action is triggered | | StateCondition | Optional | - An optional condition placed on the above event parameter
- When the aforementioned artifact property changes, the action is triggered the artifact is in this State
- Contains the following child-element structure:
`` ``StateName`` `` | # Triggering Event: NewArtifact | **Event Properties (in required order)** | **Property Requirement** | **Notes** | | ---------------------------------------- | ------------------------ | ------------------------------------------------------------------------- | | Name | Optional | - Not required by the Workflow definition, but useful for XML readability | | Triggers | Required | - The event's triggered actions
- Maximum 10 Triggers per event |