For the complete documentation index, see llms.txt. This page is also available as Markdown.

Document Assignment & User Cards

Document Assignment & User Cards - Complete Guide

Covers: 13 assignment and user-related cards


The cards on this page go in the Then group of the Workflow Builder — the actions that run once the When/And conditions match:

Workflow Builder canvas with When, And and Then card groups
Assignment and user cards are added to the Then group via Add Card.

📌 Version Information

Multi-Version Cards: DOC_USER_ASSIGN (v2 latest, v3 deprecated), DOC_GROUP_ASSIGN (v2 latest, v3 deprecated), OC_ASSIGN_DOC (v2)

Important: v3 versions added decision tree support but are now deprecated Recommendation: Use v2 for both DOC_USER_ASSIGN and DOC_GROUP_ASSIGN

📖 Complete Version History | Card Version Database


Basic Document Assignment

Card: DOC_USER_ASSIGN / Assign Document to User

Purpose

Assigns document to a specific person for their action

When to Use

  • Document needs specific person's review

  • Handoff to individual team member

  • Accountability tracking

  • Assign work to named person

How It Works

Example

Parameters

Note

Assigning means:

  • Document shows as "assigned to me" for that person

  • That person is responsible

  • Others can still see document (but not as assigned to them)

  • One assignment at a time per document


Card: DOC_GROUP_ASSIGN / Assign Document to Group

Purpose

Assigns document to a group (all members see it as assigned to them)

When to Use

  • Document for team, not individual

  • Multiple people can handle

  • Shared responsibility

  • Team workload distribution

How It Works

Example

Parameters

Difference


Card: ACTION_ASSIGN_DOC_BASED_ON_DECISION_TABLE

Purpose

Assigns document based on decision table logic

When to Use

  • Different suppliers need different handlers

  • Assignment based on amount

  • Complex routing logic

  • Multiple conditions for assignment

How It Works

Example: Amount-Based Assignment

Example: Supplier-Based Assignment

Parameters


Card: ACTION_ASSIGN_DOC_DECISION_TABLE_SEQUENTIAL

Purpose

Assigns document sequentially based on decision table with priorities

When to Use

  • Multiple sequential approvals

  • Different people at different levels

  • Approval chain based on amount

  • Escalation path

How It Works

Priority System

Example: Multi-Level Approval

Parameters


Card: ACTION_ASSIGN_DOC_TO_USER_SEQUENTIAL

Purpose

Assigns document to user with sequential priority

When to Use

  • Document needs specific person

  • Clear sequential processing

  • Single assignment with order

How It Works

Example


Card: ACTION_ASSIGN_DOC_TO_GROUP_SEQUENTIAL

Purpose

Assigns document sequentially to groups

When to Use

  • Multiple group approvals

  • Different departments at each stage

  • Team-based sequential processing

How It Works

Example


Card: ACTION_ASSIGN_DOC_TO_FACILITY_GROUP

Purpose

Assigns document to specific facility group

When to Use

  • Document for specific warehouse/facility

  • Facility-based operations

  • Location-specific processing

Example


Card: ACTION_ASSIGN_DOC_TO_FACILITY_GROUP_SEQUENTIAL

Purpose

Assigns sequentially across facilities

When to Use

  • Multi-location processing

  • Shipment passes through facilities

  • Location-based workflow

Example


Card: ACTION_ASSIGN_DOC_TO_PROCUREMENT_GROUP

Purpose

Assigns document to procurement department

When to Use

  • Procurement team handling

  • Supplier-related work

  • Purchase order related

Example


Card: ACTION_ASSIGN_DOC_TO_PROCUREMENT_GROUP_SEQUENTIAL

Purpose

Sequential assignment within procurement

When to Use

  • Multi-step procurement process

  • Approval chain in procurement

Example


Card: ACTION_CHANGE_DOC_SUBORG / Change Document Sub-Organization

Purpose

Assigns document to different sub-organization

When to Use

  • Wrong organization selected

  • Need to move to correct department

  • Organizational restructuring

How It Works

Example


Card: ACTION_CHANGE_DOC_SUBORG_BY_FIELD_TEXT

Purpose

Changes sub-organization based on document field value

When to Use

  • Sub-organization stored in field

  • Match document location with field

  • Automatic org assignment

How It Works

Example


Card: ACTION_ASSIGN_USER_FROM_FIELD_WITH_FALLBACK

Purpose

Assigns document to user from field, with fallback if user not found

When to Use

  • User name stored in document field

  • May not exist in system

  • Need backup if user unavailable

How It Works

Parameters

Example


Card: ACTION_ASSIGN_USER_TO_SUPPLIER

Purpose

Assigns document to user who manages that supplier

When to Use

  • User linked to supplier

  • Supplier account manager

  • Supplier relationship owner

How It Works


Assignment Decision Trees

Decision Table Example 1: Amount-Based

Decision Table Example 2: Supplier-Based

Decision Table Example 3: Document Type-Based


Assignment Workflow Examples

Example 1: Simple Routing

Example 2: Sequential Approval

Example 3: Amount-Based Routing

Example 4: Facility-Based


Assignment Best Practices

Do:

  • Keep decision tables simple

  • Test routing logic with samples

  • Ensure all paths lead somewhere

  • Have fallback for missing users

  • Document routing decisions

Don't:

  • Create circular assignments (A→B→A)

  • Assign to non-existent users (without fallback)

  • Make routing too complex

  • Forget to test routing

  • Assign to unavailable people


Troubleshooting Assignment

"Document not assigned"

Cause: Condition not met or user doesn't exist

Solution:

  • Check condition is true

  • Verify user exists in system

  • Check fallback settings

  • Review decision table logic

"Wrong person assigned"

Cause: Decision table or routing logic incorrect

Solution:

  • Test decision table

  • Check conditions

  • Verify user mapping

  • Review field values

"Assignment seems to skip someone"

Cause: Sequential order incorrect

Solution:

  • Check priority numbers

  • Verify sequence is correct

  • Test with sample

  • Review decision table ordering


Assignment Cards Comparison

Card
Assigns To
Route Type
Use Case

DOC_USER_ASSIGN

Individual

Direct

Simple assignment

DOC_GROUP_ASSIGN

Group

Direct

Team assignment

ACTION_ASSIGN_DOC_BASED_ON_DECISION_TABLE

Decision Result

Conditional

Complex routing

ACTION_ASSIGN_DOC_DECISION_TABLE_SEQUENTIAL

Multiple (Sequential)

Conditional

Approval chain

ACTION_ASSIGN_DOC_TO_USER_SEQUENTIAL

User (Sequential)

Ordered

Sequential user steps

ACTION_ASSIGN_DOC_TO_GROUP_SEQUENTIAL

Groups (Sequential)

Ordered

Sequential group steps

ACTION_ASSIGN_DOC_TO_FACILITY_GROUP

Facility Group

Direct

Facility-specific

ACTION_ASSIGN_DOC_TO_FACILITY_GROUP_SEQUENTIAL

Facilities (Sequential)

Ordered

Multi-facility

ACTION_ASSIGN_DOC_TO_PROCUREMENT_GROUP

Procurement

Direct

Procurement workflow

ACTION_ASSIGN_DOC_TO_PROCUREMENT_GROUP_SEQUENTIAL

Procurement (Sequential)

Ordered

Procurement approval chain

ACTION_CHANGE_DOC_SUBORG

Sub-Organization

Direct

Department change

ACTION_CHANGE_DOC_SUBORG_BY_FIELD_TEXT

Sub-Org by Field

Conditional

Field-based assignment

ACTION_ASSIGN_USER_FROM_FIELD_WITH_FALLBACK

Field/Fallback

Conditional

Dynamic user assignment


  • ACTION_CREATE_TASK_FOR_USER - Assign task to same person

  • ACTION_SEND_EMAIL - Notify assigned person

  • CONDITION_USER_IS_ISNOT - Check if correct person assigned

  • CONDITION_GROUP_IS_ISNOT - Check if correct group assigned

Last updated

Was this helpful?