Skip to content

Step Actions

During instance execution, operators advance through procedure steps using a set of actions. Each action transitions a step to a new status and is recorded in the audit trail. This page covers every available step action, the completion status options, execution modes, and the auto-complete behavior for parent steps.


Steps in a template are configured with one of two execution modes, which determine how they relate to sibling steps at the same level.

Steps marked Sequential must be executed one at a time, in order. The next sequential step cannot be started until the previous one reaches a terminal state (Completed, Skipped, or Aborted).

In the execution view, sequential steps display a right-arrow icon next to their step number.

Steps marked Parallel can be started and worked on simultaneously. All parallel siblings at the same level become startable as soon as their parent step has been started.

In the execution view, parallel steps display a branching-arrow icon next to their step number.


Starting a step signals that work has begun. The step timer starts, and the step appears with a blue pulse animation in the execution view.

Prerequisites:

  • The instance must be in Running status
  • The step must be in Pending status
  • For sequential steps: all preceding sibling steps must be in a terminal state
  • For child steps: the parent step must already be started
  • You must have the Executor, Instance Head, or Deputy Head role
  1. Select the step in the step structure panel (left panel)
  2. Click the Start button in the step detail panel (middle panel)
  3. The step transitions to Running status and the timer begins

Completing a step records the work as done and captures a granular outcome. RAMP provides five completion statuses to accurately document what happened during execution.

Prerequisites:

  • The step must be in Running status
  • If the step has the Requires Evidence setting, at least one attachment must be uploaded before completion is allowed
  • If the step has children, child steps should be completed first (unless auto-complete handles the parent)
  1. Select the running step in the step structure panel
  2. Click the Complete button
  3. Choose a completion result from the five available options (see table below)
  4. The step transitions to Completed status
ResultDescriptionApproval Required?
SucceededStep completed with no issues whatsoeverNo
OK with ComplicationsStep completed but encountered complications that did not prevent successNo
OK with WarningsStep completed with warnings that can be acknowledged but do not affect the outcomeNo
OK with ErrorsStep completed but with errors that need reviewYes — requires Instance Head approval
FailedStep failed entirely; execution may be terminated depending on configurationN/A — step is marked as failed

Approval Workflow for “OK with Errors”

Section titled “Approval Workflow for “OK with Errors””

When an executor completes a step with the “OK with Errors” result:

  1. The step is marked as requiring approval
  2. The Instance Head (or Deputy Head) receives a notification
  3. The approver reviews the step and its attachments
  4. The approver either approves (with notes) or rejects the result
  5. Once approved, execution continues normally

Skipping allows operators to bypass a step that is not applicable to the current execution without blocking subsequent steps.

Prerequisites:

  • The step must be in Running status
  • The step must have the IsSkippable flag enabled in the template (or overridden at the instance level)
  • A reason is required when skipping
  1. Select the running step
  2. Click the Skip button (visible only on skippable steps)
  3. Enter a reason explaining why the step is being skipped
  4. Click Confirm
  5. The step transitions to Skipped status

Pausing suspends work on a step without completing or cancelling it. The step timer stops while paused.

Prerequisites:

  • The step must be in Running status
  1. Select the running step
  2. Click the Pause button
  3. The step transitions to Paused status
  4. The step timer stops; paused duration is tracked separately

Prerequisites:

  • The step must be in Paused status
  1. Select the paused step
  2. Click the Resume button
  3. The step returns to Running status
  4. The step timer resumes

Cancelling marks a step as terminated before completion.

Prerequisites:

  • The step must be in Running or Paused status
  1. Select the step
  2. Click the Cancel button
  3. Provide a reason for cancellation
  4. Click Confirm
  5. The step transitions to Cancelled status

Aborting marks a step as failed, signaling that the work was attempted but could not be completed successfully.

Prerequisites:

  • The step must be in Running status
  1. Select the running step
  2. Click the Abort button
  3. Provide a reason explaining the failure
  4. Click Confirm
  5. The step transitions to Aborted status

If a step displays a Blocked indicator, it cannot be started. Common reasons include:

  • Sequential dependency: A preceding sibling step has not yet reached a terminal state
  • Parent not started: The parent step must be started before child steps become available
  • Instance not running: The instance is in Draft, Planned, Paused, or a terminal status

Hover over the Blocked indicator to see the specific reason preventing the step from being started.


Parent steps (steps that have child steps) can be configured to auto-complete when all their children finish.

When Auto-Complete is enabled on a parent step:

  1. The system monitors the status of all child steps
  2. When every child step reaches a terminal state (Completed, Skipped, or Aborted), the parent automatically transitions to Completed
  3. A notification appears: “Step auto-completed: [Step Title]”
  4. If the parent’s own parent also has Auto-Complete enabled, the cascade continues upward (grandparent auto-completes when all its children, including the just-completed parent, are done)

Instance Heads and Deputy Heads can override the Auto-Complete setting for individual steps while the instance is in Draft status:

  • Disable auto-complete on a step that normally auto-completes, requiring manual completion (useful when the parent step needs its own review after children finish)
  • Enable auto-complete on a step that normally requires manual completion

Overrides apply only to the current instance and do not modify the template.


Each step can have several settings that affect execution behavior. These are configured in the template and displayed as colored indicator chips in the execution view.

SettingIndicatorDescription
Auto-CompleteBlue chipParent auto-completes when all children finish
SkippableOrange chipStep can be skipped during execution
Requires EvidenceRed chipAt least one attachment must be uploaded before the step can be completed

In Draft status, Instance Heads and Deputy Heads can override the following settings for individual steps:

SettingOverride Effect
Planned DurationCustom duration used for runtime comparison instead of template value
Is SkippableMake a non-skippable step skippable, or vice versa
Auto-CompleteEnable or disable auto-complete for a specific parent step

RAMP tracks detailed timing for every step during execution:

MetricDescription
Planned DurationExpected time from the template (or instance override)
Actual DurationWall-clock time from start to completion
Paused DurationTotal time the step spent in Paused status
Net RuntimeActual duration minus paused duration

Runtime comparison is displayed with color indicators:

  • Green: On time or ahead of schedule (at or below planned duration)
  • Yellow: Slightly over planned duration (up to 10% over)
  • Red: Significantly over planned duration (25% or more over)

Not all roles can perform all step actions. The table below summarizes which roles can perform which actions.

ActionInstance HeadDeputy HeadExecutorEditorObserver
Start stepYesYesYesNoNo
Complete stepYesYesYesNoNo
Skip stepYesYesYesNoNo
Pause stepYesYesYesNoNo
Resume stepYesYesYesNoNo
Cancel stepYesYesYesNoNo
Abort stepYesYesYesNoNo
Force actionsYesYesNoNoNo
Override settingsYesYesNoNoNo