Resources

The workflow field kit

Bring one real workflow to your next decision

A product demo is easier to assess when you bring a request that can go wrong. These three editable worksheets connect a service brief to acceptance checks and an integration handoff. Start with the filled equipment-request example, then replace its assumptions with your own.

CSV downloads · Filled examples · No signup

01 / Workflow brief

A laptop request is also an ownership problem

The requester needs equipment. The service desk needs a complete request, the manager makes a decision and the asset team needs authority to allocate a device. A status change alone does not tell the next person what to do.

This fictional example defines requirements for a pilot. Adjust the roles and waiting rules to your organization, then verify the behavior in your chosen configuration.

  1. RequestedService desk checks the required data.
  2. Awaiting approvalLine manager records a decision.
  3. Ready for allocationAsset team assigns equipment.
  4. Handed overRecipient acknowledgment closes the work.

Declined and Canceled are separate end states. An overdue approval stays unapproved until an authorized person makes the decision.

Outcome

What observable result closes the request?

A laptop is assigned and acknowledged, or the request ends with a recorded reason.

Boundary

Where does this workflow start and stop?

Start when the employee submits a request. Stop at acknowledged handover, rejection or cancellation.

People

Who owns the next action at each handoff?

The service desk checks the request, the line manager approves and the asset team allocates equipment.

Required data

Which missing values prevent a useful decision?

Request ID, requester ID, customer ID, device type and required-by date.

States

Which transitions are allowed, including terminal states?

Requested to Awaiting approval to Ready for allocation to Handed over. Declined and Canceled are alternative end states.

Authority

Who may approve, allocate or cancel?

The line manager approves before the asset team allocates. A requester may cancel before allocation.

Waiting rule

Who acts when the expected response does not arrive?

After one business day awaiting approval, the service desk follows up with a named substitute approver. Silence does not authorize allocation.

Completion evidence

What record proves the work reached an end state?

Keep the asset serial and recipient acknowledgment for handover, or the reason for rejection or cancellation.

Exception owner

Who handles work that cannot follow the normal path?

The service desk owns requests with unavailable equipment and records the next action instead of leaving an unassigned queue item.

The download adds a blank Your workflow column beside this example. Fill it with one process before mapping a second. For the product concepts behind the brief, see workflow automation and CMDB records.

02 / Demo evidence sheet

Run the awkward path before calling the pilot ready

Use the same sample request throughout the demo. Agree on the expected result before testing, then record what actually happened. Keep the result as Not tested until someone observes it; use Pass, Fail or Blocked afterward. A blocked test still needs an owner.

Eight acceptance scenarios for the example workflow
Try thisRequired resultKeep as evidence
D01Submit a complete requestThe request has an owner and awaits approval before any equipment is allocated.Request ID, initial state and assigned owner.
D02Omit a required customer identifierThe request is held for correction before allocation. The missing value is identified.Validation response and unchanged allocation record.
D03Use another customer's request IDAn identity without permission cannot read or change the other customer's request.Read and update results from both test identities.
D04Deliver the same request twiceThe agreed duplicate policy prevents a second allocation for the same business operation.Both attempt IDs, the shared operation key and the allocation count.
D05Reassign a request awaiting approvalThe new owner sees the pending action. Reassignment preserves the approval state and prior history.Before-and-after owner, state and event history.
D06Cancel before allocationThe workflow records cancellation and does not allocate equipment afterward.Cancellation event and a later allocation check.
D07Leave the approver unavailableThe agreed waiting rule gives a named person the follow-up. It does not silently approve the request.Configured waiting rule, follow-up owner and approval state.
D08Lose the allocation responseThe operator can establish whether allocation happened before deciding to retry.Operation key, status lookup or stored result, and the retry decision.

Set the blockers before the meeting

Mark the checks that must pass before a pilot can proceed. For example, a successful handover does not compensate for a failed customer-access check. The CSV has separate columns for observed behavior, evidence location, result, owner and follow-up.

Build the access scenarios with test identities and records you control. OWASP's authorization guidance explains why permission checks must cover each request, including direct API calls.

03 / Integration contract

Agree on meaning before mapping field names

Connecting a service request to an asset system introduces another handoff. A shared field name is not enough: both sides need to agree on identity, authority and what happens when the result is uncertain. Use this sheet with the actual endpoint documentation.

Six decisions for the request-to-allocation boundary
DecisionQuestion to resolveEquipment-request example
Business identityWhich key identifies one operation across deliveries?Use the customer ID with the source request ID. Keep that identity on a retry; a new key means a new operation.
Customer authorityWhere is customer scope verified?Compare the requested customer with the authenticated integration identity's permitted scope before reading or writing.
Field ownershipWhich system is allowed to change each value?The service workflow owns approval state. The asset system owns the allocated serial. Name the writer for every shared field.
Value mappingWhat do field values mean at each end?Write down how device types and dates map. Keep requested, allocated and handed-over states distinct instead of collapsing them into done.
Uncertain resultHow will a caller resolve a timeout after a possible write?Agree on a status lookup or replayable result before retrying allocation. A missing response alone does not establish that nothing happened.
Operator handoffWhat happens when automatic processing stops?Route the request ID, failure reason and next action to a named owner. Set a condition for resuming work after correction.

The CSV adds fields for your agreement, its owner and supporting evidence. For retry behavior, check HTTP's idempotency rules alongside the service's own contract. Dreamtsoft's REST integration overview provides the route into platform-specific documentation.

If shared field meanings change, test old and new readers against the changed event schema. The compatibility example includes replaying an older payload after a reader update.

Follow the evidence

When a worksheet exposes a harder question

Could a retry allocate twice?

Run the SQLite example to distinguish a lost response from an operation that never committed.

Explore six retry cases

Does customer isolation hold?

Turn the access check into an explicit matrix of identities, resources and allowed actions.

Build a permission matrix

What if the work outlives the request?

Define a durable job's states and the status a caller can inspect after the initial response.

Examine the async job contract

Bring your workflow brief to a conversation

Tell us which request you need to manage, who owns its next action and where the current handoff breaks down. Use your worksheet to frame the conversation and identify what you need to verify in a demo.

Request a free in-depth consultation

Contact details
Spam protection verification
Spam protection loads when you begin the form.

Dreamtsoft uses the information you submit to respond to your request. See our Privacy Policy.