Build Test Scenarios with Workflow Wizard

The Workflow Wizard is a Pro feature, available in the Post desktop app and the CLI with a Post Pro entitlement.

Testing a single ADT message doesn’t prove your interface works. Real go-lives need admit → lab order → result → discharge sequences — and you need to run them repeatedly as you iterate. Define the scenario once in YAML, run it as many times as you need.

Interactive wizard

Launch the interactive wizard to build a scenario step by step:

pidgeon workflow wizard

The wizard guides you through:

Naming your scenario
Adding message steps (type, delay, dependencies)
Configuring vendor profiles per step
Setting validation checkpoints
Saving as a reusable YAML file

YAML scenario files

Define scenarios as YAML for version control and CI/CD integration:

name: Emergency Department Visit
description: Complete ED workflow from admission to discharge
vendor: epic_er
steps:
  - type: ADT^A01
    description: Patient arrives at ED
    delay: 0

  - type: ORM^O01
    description: Stat lab order
    delay: 5m

  - type: ORU^R01
    description: Lab results returned
    delay: 45m

  - type: RDE^O11
    description: Medication dispensed
    delay: 1h

  - type: ADT^A03
    description: Patient discharged
    delay: 4h

Run a scenario

Execute a scenario file and save the generated messages:

pidgeon workflow run ed-visit.yaml --output ./test-results

This generates each message in sequence with the specified delays and saves them to the output directory. Timestamps are coherent across all messages — the lab order timestamp is after admission, results after the order, and so on.

Validation checkpoints

Add validation rules to verify each step:

name: Lab Order to Result
steps:
  - type: ORM^O01
    description: Lab order
    delay: 0
    validate:
      - segment: OBR
        field: OBR.4
        contains: "CBC"

  - type: ORU^R01
    description: Lab result
    delay: 30m
    validate:
      - segment: OBX
        field: OBX.3
        contains: "WBC"
      - segment: OBX
        field: OBX.5
        not_empty: true

Common scenario templates

Scenario	Steps	Use Case
ED Visit	ADT^A01 → ORM → ORU → ADT^A03	Emergency department flow
Inpatient Stay	ADT^A01 → ORM → ORU → RDE → DFT → ADT^A03	Full hospital stay
Lab Only	ORM^O01 → ORU^R01	Lab order-to-result
Transfer	ADT^A01 → ADT^A02 → ADT^A03	Patient transfer between units
Pharmacy	ORM^O01 → RDE^O11	Prescription order to dispense

Run in Post

The Post desktop app’s Workflow Wizard provides a visual builder where you can:

Drag and drop message steps
Set delays with a timeline view
Preview generated messages at each step
Export the workflow as a YAML file for CLI use

Install Post and sign in with a Post Pro entitlement to try the visual builder.

Next steps

Generate test data for individual message types
Monitor your interfaces with Loft while running scenarios
Compare environments using diff to verify test results

Getting Started

Install

Desktop Apps

Post (Testing Tool)

Flock (Population Engine)

Loft (Observability)

Guides & Tutorials

Support

Build Test Scenarios with Workflow Wizard

Interactive wizard

YAML scenario files

Run a scenario

Validation checkpoints

Common scenario templates

Run in Post

Next steps

​Interactive wizard

​YAML scenario files

​Run a scenario

​Validation checkpoints

​Common scenario templates

​Run in Post

​Next steps

Interactive wizard

YAML scenario files

Run a scenario

Validation checkpoints

Common scenario templates

Run in Post

Next steps