Skip to main content

Writing specifications for workflow automation solutions

The key outputs of the design process are:

  1. Functional Workflow diagram
  2. Technical Workflow diagram
  3. Solution Architecture Diagram
  4. Data element mapping specifications

Given these, you’ll be ready to finalize your workflow specifications and hand off to developers for job-writing!

Each “task” or “step” in the OpenFn swimlane of your technical diagram can be implemented as a distinct operation in your workflow configuration. In the example diagram below, you might implement 1 job with 3 chained operations, or 3 jobs with 1 operation each.

workflow

The workflow specifications should link to all of the design artifacts and highlight the following:

  1. The required number of OpenFn jobs and the function of each
  2. Links to sample input/output and API documentation
  3. Unique identifiers
  4. Expected data volumes
  5. Authentication requirements