PartnerAlly Docs
Workflows

Workflow Builder

Manually create and customize workflows using the visual builder.

Workflow Builder

The Workflow Builder lets you create custom workflows from scratch. Use it when you need specific control over your remediation plans or when AI generation isn't suitable for your use case.

When to Use Manual Building

Choose manual building when:

  • You have a specific process to follow
  • AI generation doesn't fit your needs
  • Creating a template for reuse
  • Building complex or unique workflows
  • Combining multiple types of work

Starting a New Workflow

Open Workflow Builder

Navigate to Workflows and click "New Workflow" or "Create Workflow."

Enter Basic Information

  • Name your workflow
  • Add a description
  • Set priority
  • Choose target due date

Add Tasks

Begin adding the tasks that make up your workflow.

Set Dependencies

Connect tasks to define the workflow order.

Assign and Save

Set owners and save your workflow.

Workflow Properties

Required Fields

FieldDescription
NameClear, descriptive workflow title
DescriptionWhat this workflow accomplishes
PriorityCritical, High, Medium, or Low

Optional Fields

FieldDescription
Due DateTarget completion date
OwnerPrimary responsible person
Linked GapsCompliance gaps addressed
Linked RisksRisks being mitigated
TagsCustom labels for organization

Adding Tasks

Task Creation

For each task, provide:

FieldRequiredDescription
TitleYesWhat needs to be done
DescriptionNoAdditional details
AssigneeNoWho will do this
Due DateNoWhen it's due
PriorityNoTask priority
TypeNoTask type (action, review, approval)

Task Types

TypePurpose
ActionWork to be performed
ReviewPeer or team review
ApprovalManagement sign-off
DocumentationCreate/update documents
VerificationConfirm completion

Good task titles are specific and actionable: "Draft access control section 3.2" is better than "Work on access control."

Setting Dependencies

What Are Dependencies?

Dependencies define which tasks must complete before others can start:

  • Task B depends on Task A = Task A must finish first
  • Multiple dependencies = All must complete

Creating Dependencies

Select a Task

Click the task that depends on another.

Click "Add Dependency"

Opens the dependency selector.

Choose Predecessor

Select the task(s) that must complete first.

Confirm

Dependency is created and shown visually.

Visual Dependencies

On the canvas:

  • Lines connect dependent tasks
  • Arrows show direction (from predecessor to dependent)
  • Blocked tasks show their dependencies

Dependency Patterns

PatternWhen to Use
SequentialA → B → C (strict order)
ParallelA and B can happen simultaneously
ConvergingC depends on both A and B
DivergingA leads to both B and C

Building Effective Workflows

Start with Milestones

  1. Identify major phases or checkpoints
  2. Create milestone tasks
  3. Build detail tasks within each phase
  4. Connect phases with dependencies

Example Structure

Phase 1: Research
├── Task: Review current state
├── Task: Identify requirements
└── Milestone: Research complete

Phase 2: Development
├── Task: Draft solution
├── Task: Peer review
└── Milestone: Development complete

Phase 3: Implementation
├── Task: Deploy changes
├── Task: Verify success
└── Milestone: Implementation complete

Common Patterns

Policy Update Workflow

  1. Review current policy gaps
  2. Research best practices
  3. Draft updates
  4. Internal review
  5. Legal/compliance review
  6. Management approval
  7. Publish and communicate

Control Implementation

  1. Define requirements
  2. Design solution
  3. Develop/configure
  4. Test in non-production
  5. Security review
  6. Deploy to production
  7. Document evidence

Audit Preparation

  1. Identify scope
  2. Gather evidence
  3. Conduct self-assessment
  4. Address findings
  5. Final review
  6. Package for auditors

Using Templates

Accessing Templates

  1. In the Builder, click "Use Template"
  2. Browse available templates
  3. Select appropriate template
  4. Customize for your needs

Available Templates

TemplateUse Case
Policy UpdateRevising any policy document
Control ImplementationDeploying new controls
Vendor AssessmentThird-party security review
Incident ResponseHandling security incidents
Audit PrepPreparing for compliance audits

Creating Templates

Save your workflow as a template:

  1. Build and customize your workflow
  2. Click "Save as Template"
  3. Name and describe the template
  4. Template is available for future use

Templates save time on repetitive workflows. Create templates for processes you'll repeat.

Canvas Builder Tools

Adding Tasks

  • Click "Add Task" button
  • Or drag from task palette
  • Or right-click on canvas

Connecting Tasks

  • Drag from one task's edge to another
  • Or use "Add Dependency" from task menu
  • Lines appear showing connections

Moving Tasks

  • Drag tasks to reposition on canvas
  • Layout is visual only
  • Doesn't affect dependencies

Deleting Tasks

  • Select task and press Delete
  • Or right-click and choose "Delete"
  • Dependencies are removed

Auto Layout

Click "Auto Layout" to:

  • Organize tasks by dependencies
  • Align tasks in logical flow
  • Clean up messy layouts

Bulk Task Creation

Import from List

If you have tasks in a list:

  1. Click "Import Tasks"
  2. Paste or type task list (one per line)
  3. Tasks are created without dependencies
  4. Add dependencies manually

Copy from Another Workflow

  1. Open source workflow
  2. Select tasks to copy
  3. Click "Copy Tasks"
  4. Open target workflow
  5. Click "Paste Tasks"
  6. Adjust as needed

Validating Workflows

Before Saving

The builder checks for:

  • Circular dependencies (A → B → A)
  • Orphaned tasks (no path to completion)
  • Missing required fields
  • Logical issues

Warning Indicators

WarningMeaning
🔴 ErrorMust fix before saving
🟡 WarningShould review, can save
🔵 InfoSuggestion for improvement

Common Issues

IssueSolution
Circular dependencyBreak the cycle, reorganize flow
No start taskAdd a task with no predecessors
Orphaned taskConnect to the workflow
Unassigned tasksAssign owners or mark as pending

Saving and Activating

Save as Draft

Click "Save Draft" to:

  • Save your work
  • Continue editing later
  • Not start the workflow yet

Activate Workflow

Click "Save and Activate" to:

  • Save the workflow
  • Set status to Active
  • Notify assignees
  • Begin tracking progress

Editing Existing Workflows

Adding Tasks Later

You can add tasks to active workflows:

  1. Open the workflow
  2. Click "Edit"
  3. Add new tasks
  4. Set dependencies
  5. Save changes

Modifying Active Workflows

When editing active workflows:

  • Completed tasks cannot be uncompleted
  • Dependencies can be adjusted
  • New tasks integrate into flow
  • History tracks all changes

Significant changes to active workflows may confuse team members. Communicate changes clearly.

Common Questions

How many tasks should a workflow have?

General guidelines:

  • Minimum: 3-5 tasks (simpler is better)
  • Typical: 5-15 tasks
  • Maximum: 20-30 before splitting

If you have more tasks, consider splitting into multiple workflows.

Can I have tasks without dependencies?

Yes. Tasks without dependencies:

  • Can start immediately
  • Run in parallel
  • Are common at workflow start

What if I make a mistake?

  • Draft workflows can be deleted
  • Active workflows can be edited
  • Changes are logged in history
  • Critical workflows can be cancelled

Next Steps

On this page