JAI CRM
Home Documentation Assignment Write an assignment rule

Write an assignment rule

Every box on the form, what it does, and what breaks if you get it wrong.

A rule is a name and a few settings. The work is in its entries, and a rule with none does nothing at all — the form says so, in as many words, until you add one.

There are two forms involved, one inside the other. The outer one is the rule. The inner one is an entry. Take them in that order.

Step one — the rule

Press Create assignment rule on the Rules tab. The first thing it asks is the module, and until you answer it the rest of the form is not there.

The Create assignment rule panel, open and nearly empty. Under the heading it reads "Pick the module first — the conditions are built from its own fields." A single Module dropdown reads "Choose a module", and below it a dashed box says "Choose a module to carry on." The Create rule button is greyed out.
One question at a time. Nothing else can be asked yet, because the conditions on an entry are built from the chosen module’s own fields — and until it is chosen there are no fields to offer.

Once the module is chosen the rest appears.

The same panel with Leads chosen. It now shows Rule name filled in as "South India enquiries", an optional Description, an Apply it dropdown reading "When a record is created", an Active switch turned on, and a Rule entries section with an Add button and an amber box reading "No entries yet — a rule with none does nothing at all."
The rest of the form, and the amber warning that matters more than any other on this screen.
BoxWhat it doesWhat to put
Module (required)Which module the rule governs. Decides which fields the conditions can be built from.One of the thirty-nine. Choose it first — nothing else appears until you do.
Rule name (required)What the rule is called in the list, in the audit trail, and on the record when somebody asks why it came to them.Something you would say out loud. South India enquiries, not Rule 2. Somebody will read this in eight months with no memory of writing it.
DescriptionA line under the name in the list.Optional, and worth it for the rule whose name cannot quite carry the whole thought. Anything from a paid campaign.
Apply itWhen the rule is allowed to act — on create, on edit, or both.Leave it on When a record is created unless you have read when a rule runs and want one of the others.
On an editAppears only once Apply it is set to edit or both. Decides whether an edit re-applies the rule every time, or only when the record newly matches.The careful answer is Only a new match. The difference is large.
ActiveOn or off. Off keeps the rule and ignores it.On. Turn it off later when you want to stop a rule without losing it.
Rule entriesThe list of entries, with an Add button. This is the actual rule.At least one. See step two.

Change the module while writing and the entries are cleared, because conditions built from one module’s fields mean nothing against another’s. And once the rule is saved the module is settled — reopen it and where the dropdown was you will read For Leads. A rule stays with the module it was written for. If you picked the wrong one, write a new rule and delete the old.

Step two — the entries

Press Add under Rule entries. Each entry answers two questions and offers one extra.

A Rule entry dialog over the rule panel, headed "Rule entry" with "Leads" beneath. It holds an "Apply this entry to" dropdown reading "Every record", a FILTERS section with an Add filter button, an "Assign to" dropdown reading "Particular people" with the note "Where more than one person is named, they are given records in turn, and anybody at their threshold is skipped", a searchable list of people with tick boxes — Arjun Nair, Govind Dadhich, Kavya Iyer, Priya Sharma — and a Follow-up task dropdown reading None.
One entry. Which records it covers, who they go to, and whether a task is raised alongside.

Which records?

<b>Apply this entry to</b>What it meansWhen
Every recordNo conditions. This entry matches everything that reaches it.The catch-all at the bottom of a rule — everything else, shared round the team. Also fine as the only entry in a simple rule.
Records matching certain conditionsA Filters builder appears, offering the module’s own fields.Everything else. City, source, value, a custom field your trade sorts by.

The filter builder is the same one used for list filters and sharing rules, so the conditions you can write here are the conditions you can already write elsewhere: several of them, joined by and or or, on any field the module has.

Who gets them?

<b>Assign to</b>Who ends up in the rotationAs people come and go
Particular peopleExactly the people you tick. A search box narrows a long staff list.You edit the rule when somebody joins or leaves.
Everyone in a roleEverybody holding that role right now.Somebody given the role joins the rotation on their own. Nothing to remember.
Everyone in a circle or project groupEverybody in that circle or group right now.Managed by editing the group, not the rule.

Circles and project groups are different things, and the dropdown keeps them apart under two headings. A circle is colleagues named once so you can share a folder with them or route an approval to them — staff only. A project group is a project’s roster, and it can hold a customer contact as well as your own people. Assignment only ever gives records to active staff, so a project group that is mostly customer contacts yields far fewer candidates than its size suggests — and one holding no staff at all yields none, and the entry quietly does nothing. For routing work, a circle or a role is nearly always the one you want.

Where an entry names more than one person, they are given records in turn — first to one, then the next, then back round. The rotation is remembered against the rule itself, so it carries on correctly after an update or a restart rather than starting again at the top of the list and burying the first name.

Somebody who has left, or whose login has been switched off, is skipped automatically — the rotation moves to the next person rather than assigning to a name nobody is behind. You still want to tidy the rule, but a departure does not break it on the day.

The follow-up task

<b>Follow-up task</b>What happens
NoneJust the assignment.
Raise one when it is assignedTwo more boxes appear: Task — what it says, such as Call the new lead — and Due in (days). The task is raised against the new owner at the moment the record is assigned.

Worth switching on for leads. A lead arriving with a name against it is better than one arriving with nobody; a lead arriving with Call the new lead, due tomorrow against it is better again, because it shows up on somebody’s list of things to do rather than only in a column they may not be looking at.

Order matters, and it is the usual mistake

Put the specific entries above the catch-all. An entry for Every record sitting first will match everything, and the four carefully written entries underneath it will never fire. Nothing warns you, because a first entry that matches everything is also a perfectly legitimate rule — it is exactly what you want at the bottom.

A worked rule

A business with a south team, an ads desk and everybody else. One rule on Leads, three entries:

OrderApply this entry toAssign toFollow-up task
1City is Chennai, Bengaluru or CoimbatoreThe South sales circle, in turnCall the new lead, due in 1 day
2Source is IndiaMARTPriya and Arjun, in turnCall the new lead, due in 1 day
3Every recordThe Sales executive role, in turnNone

Follow that through with four enquiries:

The enquiryEntry that decides itWhy
Chennai, from IndiaMART1Entry 1 matches first, and the first match wins. Entry 2 also matched, and is never reached — which is why the more specific entry sits above the broader one.
Mumbai, from IndiaMART2Entry 1 did not match; entry 2 did.
Mumbai, walk-in3Nothing specific matched, so the catch-all took it.
Chennai, walk-in, owner set to Kavya on the formNoneSomebody chose an owner. No rule overrides that.

Swap entries 1 and 3 and every one of those four lands on the Sales executive role, because a catch-all at the top matches everything. The rule would look correct in the list, report three entries, and be wrong.

People, a role, or a group?

Prefer a role or a circle for the same reason you prefer them when sharing a folder: you are recording a rule rather than a snapshot of who happened to be here the week you wrote it. A rule naming three people is a rule that quietly stops being right.

SituationPoint it at
Every sales executive should take a turnThe role. New joiners are covered without anybody remembering.
A regional desk of four, who are not a whole roleA circle.
Two named seniors who handle large enquiriesParticular people. It really is those two, and naming them is honest.
The team on one projectA project group — but check who is actually in it first.

Conditions worth reaching for

  • City or state — a regional desk.
  • Source — IndiaMART, website, referral, exhibition.
  • Value — larger enquiries to somebody senior.
  • Product or category — where the sale needs somebody who knows the thing being sold.
  • Whatever custom field your trade actually sorts by. If your team says “that is a retrofit job” twenty times a day, that is the field to route on.

What goes wrong

SymptomCauseFix
The rule does nothingIt has no entries. The list shows 0 in the Entries column and the form shows an amber box.Add an entry.
Only one entry ever firesA catch-all sits above the specific entries.Move it to the bottom.
One entry never firesIts conditions cannot both be true — City is Chennai and City is Mumbai is nobody.Read the conditions aloud. If the sentence is impossible, it is.
Everything goes to the first person namedRare, and worth reporting. The rotation is stored against the rule, so it should survive restarts.Check the record’s own assignment note first — it usually shows the others were skipped at their cap.
An entry pointed at a group assigns nobodyThe group holds no active staff — commonly a project group of customer contacts.Point it at a circle or a role.
The people you want are not in the listThey are outside your part of the organisation, or they are portal logins rather than staff.Who you may assign to.

Where to go next

Something missing or wrong here? Tell us. A question that needed asking usually means a page that needed writing.