Create an Instance
Creating an instance starts the lifecycle of a procedure execution. The creation wizard guides you through selecting a template, choosing a version, and configuring the instance.
Prerequisites
Section titled “Prerequisites”- You must have the Create Instance permission in your current tenant.
- At least one template with a published or approved version must exist.
Creation wizard
Section titled “Creation wizard”The instance creation wizard follows a four-step process:
Step 1: Select a template
Section titled “Step 1: Select a template”- Click Create Instance from the instance list or from a template’s version menu.
- Browse the available templates.
- Click on a template to select it.
The template list shows all templates you have access to, including their title and version information.
Step 2: Select a version
Section titled “Step 2: Select a version”- Review the available versions for the selected template.
- Select a published or approved version.
- Alternatively, check Create as ghost instance to create an instance without assigning a version yet.
Step 3: Configure the instance
Section titled “Step 3: Configure the instance”Fill in the instance details:
| Field | Required | Description |
|---|---|---|
| Title | Yes | A descriptive name for this execution (e.g., “Q4 Production Deployment”) |
| Owner | Yes | The user responsible for this instance. Click the search icon to find and select a user. |
| Coordinator | No | An optional coordinator who assists with planning and scheduling |
| System | No | The managed system this instance applies to. Required when transitioning to Planned. |
| Stage | No | The system stage (e.g., Production, Staging). Required when transitioning to Planned. |
Step 4: Review and create
Section titled “Step 4: Review and create”- Review the summary showing your selected template, version, and configuration.
- Click Create to finalize.
- You will be redirected to the new instance’s detail page.
What happens after creation
Section titled “What happens after creation”When an instance is created:
- The instance is created in Draft status.
- Steps are copied from the template version into the instance (if a version was selected).
- Variables are copied with their default values. You can edit variable values on the instance detail page.
- Team members from the template version are seeded into the instance team.
- Notes from the template and template version are inherited by the instance.
Creating from a template version
Section titled “Creating from a template version”You can bypass the first two wizard steps by creating an instance directly from a template version:
- Navigate to the template detail page or version editor.
- Click the Create Instance button on the approved version.
- The wizard opens at Step 3 (Configure) with the template and version pre-selected.
Creating from the same version
Section titled “Creating from the same version”From the instance list, you can create a new instance using the same template version as an existing instance:
- Right-click on an instance (or use the three-dot menu).
- Select Create from Same Version.
- The wizard opens with the template and version pre-selected.
Cloning an instance
Section titled “Cloning an instance”Cloning creates a copy of an existing instance:
- Right-click on an instance (or use the three-dot menu).
- Select Clone.
- A new instance is created as a copy, including variable values and team assignments.
- You are redirected to the new instance.
Ghost instances
Section titled “Ghost instances”Ghost instances allow early planning when the template version is not yet ready:
- Create without selecting a version.
- Configure title, owner, coordinator, and scheduling information.
- Later, assign a version using the Assign Version action from the instance list or detail page.
Once a version is assigned, the instance receives steps and can proceed through the normal lifecycle.
Post-creation workflow
Section titled “Post-creation workflow”After creating an instance, the typical workflow is:
- Set variable values — Navigate to the Variables tab on the instance detail page and fill in actual values for all template variables.
- Configure the team — Review and adjust team assignments on the Team tab.
- Set dates and mark as Planned — When ready, use the Mark as Planned action to set the start date, due date, and planned execution window.
- Start execution — When the planned time arrives, start the instance to begin executing steps.