Difference between revisions of "Trigger a Workflow from a Custom Browser Script"
From SmartWiki
Line 1: | Line 1: | ||
− | [[Workflow|Workflows]] can be triggered based on a value in a [[Custom Fields|custom field]] on the object using a [[Browser|browser]] script. The [[Workflow|workflow]] id is passed to the system from the script. | + | [[Workflow|Workflows]] can be triggered based on a value in a [[Custom Fields|custom field]] on the object using a [[Browser|browser]] script. The [[Workflow|workflow]] id is passed to the system from the script. |
+ | |||
+ | ==Syntax== | ||
+ | :<font size="3">'''_triggerwf(''objectid'',''workflowid'',''[[Entity IDs|entityid]]'');''' </font> | ||
Line 21: | Line 24: | ||
− | '''NOTE''': | + | '''NOTE''': For [[Workflow|workflows]] triggered by a [[Browser Script]] within a [[UTA]] you must set '''Trigger When''' to '''--Deactivate--''' rather than selecting a [[Status]]. |
+ | |||
+ | ==See Also== | ||
+ | * [[Entity IDs]] | ||
[[Category:Workflows]][[Category:JavaScript]][[Category:Custom Fields]] | [[Category:Workflows]][[Category:JavaScript]][[Category:Custom Fields]] |
Revision as of 15:46, 3 December 2009
Workflows can be triggered based on a value in a custom field on the object using a browser script. The workflow id is passed to the system from the script.
Syntax
- _triggerwf(objectid,workflowid,entityid);
You must first create the workflow. Once it has been created you need to find the workflow ID (wfid) as follows:
- From the list view of Workflows right-click on the appropriate workflow and select Properties.
- The URL/Address displayed will have the wfid:
http://youraddress.smartsimple.com/WFE2/wf_viewworkflow.jsp?wfid=98765
For the above example the workflow ID is 98765
In the browser script you would use triggerwf with the following syntax:
Level 1: _triggerwf(@opportunityid@,workflowid);
- Example:
_triggerwf(@opportunityid@,98765);
Level 2: _triggerwf(@eventid@,workflowid,26);
- Example:
_triggerwf(@eventid@,98765,26);
(26 is the objecttype for Level 2 activities, and will be the same for all Level 2 workflows)
NOTE: For workflows triggered by a Browser Script within a UTA you must set Trigger When to --Deactivate-- rather than selecting a Status.