Return to main navigation Page
Auto-Forwarding enables you to set up collaborative transaction handling. Auto-forwarding rules should be set up for every workflow step, if you want to create a collaborative sales environment from the beginning of a transaction to the end. The benefit of setting up auto-forwarding is that it happens in the background and guarantees that documents become available to groups of users as soon as the document transition occurs.
Whenever a document moves from one step to another, the system can fire auto-forwarding rules and distribute transactions to one or more user groups or, to a specific user. Documents can be forwarded to specific groups, or to all groups that the current user belongs to. Any user or user in a group that receives a forwarded document can then work on the transaction. Individual access rights do not restrict users from accessing auto-forwarded transactions.
Before auto-forwarding rules are created, make sure you've created the necessary user groups.
Permissions to document attributes and actions for auto-forwarded documents are based profile view of the participant profile associated with the auto-forwarding rule. Updates made to auto-forwarded documents become visible to the user groups who received the auto-forwarded transaction.
Simple auto-forwarding rules are defined with an associated participant profile, one or more user groups or, a specified user.
In auto-forwarding rules, associated profiles set which view is used for forwarded transactions. Profile views designate whether actions and attributes are hidden or visible for the user groups that receive the forwarded document. In some cases, a user might have access to more than one profile. This can happen if a user is included in an auto-forwarding group and also has been granted specific user access rights to a different profile. When this happens, the system displays the view of the highest ranked profile. Profile ranking is based on the order of profiles in a given step.
In simple rules, associated user groups can be set to "All Groups", meaning all groups that the action performer belongs to, or "Selected Groups", meaning a hard-coded set of supplier groups which the supplier user may or may not belong to. For the "Selected Groups" option, transactions are only forwarded to the groups the supplier user belongs to.
Advanced auto-forwarding rules enable you to set up conditions for forwarding. Using advanced rules, you can instruct the system to forward documents to one group or another based on some condition of an order, such as the price, date, or any other document attribute.
There is a variable created specifically for auto-forwarding called "_system_user_groups". This variable contains the current user's groups, which can be assigned to a single participant profile in auto-forwarding scripts. The "_system_user_groups" variable works for both buyer user groups and supplier user groups.
Format of Return Value:
group~company~participantProfile [ |group~company~participantProfile ]*
Example of an Advanced Script:
* FORWARDING RULE
* company - represents the buy access company name
* group - set to a static value 'sales_rep'
* pp - represents participant profile also set to a static value
company = quote_sender;
group = "sales_rep";
pp = "Resellers_Sender_Submitter";
result = "";
if ( companyLoginName <> _system_supplier_company_name )
result = group + "~" + company + "~" + pp;
Please see Workflow Steps for information on how to create a forwarding rule.
Auto-Forwarding functionality uses groups to define who should have access to transactions. To demonstrate how simple auto-forwarding rules work, here are two sample groups and the result of three possible scenarios.
Western Agents Group
Members: SuperUser, Andy, Fred, Pete
Eastern Agents Group
Members: SuperUser, Andy, Gary, Tom
The following table shows which groups would have access to transactions whenever a document transitions into a step that has simple auto-forwarding rules set up to distribute documents to "All Groups", meaning all groups to which the current user belongs.
|Document Performer||Western Group||Eastern Group|
|SuperUser or Andy saves an order||x||x|
|Fred or Pete Saves an order||x|
|Gary or Tom saves an order||x|
All users in the groups that receive the forwarded documents have equal access to the transaction, regardless of user type. Access to forwarded transactions is based only on the profile associated with the forwarding rule.