Assignment Rule
How to use Assignment Rule in Workflow & Automation: access, working steps, fields, related records and troubleshooting.
Purpose and access
Configure workflow states, transitions, assignments and notifications against the correct record type. Define which role may act at each step and test the complete lifecycle in staging.
This page is a record page in System Admin → Workflow & Automation. Use the link above to open the configured destination; permissions are checked by the destination service.
Before you start
Prepare the required information: Document Type, Description, Assign Condition, Assignment Days, Rule.
Confirm the company, party, dates, units and source references that apply. Select existing links carefully and check for an existing record before creating a duplicate.
Working steps
- Open Assignment Rule from System Admin → Workflow & Automation, or use ERP Search.
- Filter the list and open the relevant record. To add a record, use Add/New when your role provides that action.
- Complete the editable fields described below. Required fields and validation conditions must be satisfied; read-only values are set by the system or their source records.
- Add the required child rows. Review each row’s identifiers, linked records and values, using the child-table field reference below.
- Save the record and address validation messages. Reload and verify the saved values and relationships.
- Use any additional workflow actions only when the record and your role provide them. Saving this record does not automatically complete a related transaction or external action.
Field reference
These fields come from the installed ERP definition. Hidden fields and password inputs are omitted. Additional conditions, custom scripts and workflow rules can make a field required or read-only in a particular context.
| Field | Type / behavior | How to use it |
|---|---|---|
Document Typedocument_type | Link Required | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: DocType |
Due Date Based Ondue_date_based_on | Select Optional | Value from this field will be set as the due date in the ToDo |
Prioritypriority | Int Optional | Higher priority rule will be applied first |
Disableddisabled | Check Optional | Enable or disable the named option only when it matches the intended record behavior. |
Descriptiondescription | Small Text Required | Example: {{ subject }} |
Assign Conditionassign_condition | Code Required | Simple Python Expression, Example: status == 'Open' and issue_type == 'Bug' |
Assign Condition JSONassign_condition_json | Code Optional | Autogenerated field by Helpdesk App |
Unassign Conditionunassign_condition | Code Optional | Simple Python Expression, Example: status in ("Closed", "Cancelled") |
Unassign Condition JSONunassign_condition_json | Code Optional | Autogenerated field by Helpdesk App |
Close Conditionclose_condition | Code Optional | Simple Python Expression, Example: status == "Invalid" |
Assignment Daysassignment_days | Table Required | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: Assignment Rule Day |
Rulerule | Select Required | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Fieldfield | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow. |
Usersusers | Table MultiSelect Optional | Select the permitted linked entries; the stored rows associate those records with this document. Linked record: Assignment Rule User |
Usersweighted_users | Table Optional | Add the relevant child rows and review required columns, quantities and references before saving. Linked record: Assignment Rule User |
Last Userlast_user | Link Optional · Read-only | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: User |
Current Indexcurrent_index | Int Optional · Read-only | Enter a whole-number value. |
Child tables
Assignment Days — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Dayday | Select Optional | Choose one of the configured list values. Status fields may be controlled by the record workflow.Available choices
|
Users — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Useruser | Link Required | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: User |
Weightweight | Int Optional | Enter a whole-number value. |
Users — child-row fields
| Field | Type / behavior | How to use it |
|---|---|---|
Useruser | Link Required | Choose an existing linked record. Check its company and ownership; typing a label alone does not create a new relationship. Linked record: User |
Weightweight | Int Optional | Enter a whole-number value. |
Troubleshooting
- Not permitted: verify the account, role and source-document permission. Do not share an administrator login.
- Missing record or address: inspect the relevant Link or Dynamic Link fields; a matching title alone does not establish a relationship.
- Cannot save or change status: review required fields, read-only values, document status and the configured approval transition.
- Unexpected report or portal result: review company/date filters, source-document submission and the approved party or Employee link.