Difference between revisions of "Trigger a Workflow from a Custom Browser Script"

From SmartWiki
Jump to: navigation, search
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''':  If you are using a script initiated by a [[Workflow|workflow]] in a [[UTA]] you must ensure that the status is not used by any other [[Workflow|workflow]]. This is because you can only have one [[Workflow|workflow]] per status.  
+
'''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.


See Also