How to use tokens in workflows(ocm)

Question

i want to know how to use tokens in workflows .

Answer 1

What do you want to know?
Tokens are variables that eventually map to either individual user names or aliases (groups of users).
The token is defined and then included in the workflow step in addition to or in place of a user or alias.
A token is a piece of idoc script that ends like this <$wfAddUser("Name", "type")$>. Name, like i mentioned above, is a user name or an alias name. Type is a string identifier; either "user" or "alias".
Because it's Idoc Script, the token can evaluate anything available in the databinder as well as execute other functions.
A very easy way of using tokens is to map a metadata field that you know will contain a user name to the "Name" parameter. The dDocAuthor field will always contain a user name. So the token might look like this: <$wfAddUser(dDocAuthor, "user")$>. When set as a workflow user, this token will route the item to the person listed as the author.
Because tokens are evaluated in workflow after the entry event (read the docco if you don't know what step events are), you can do some complex caluclations in the entry event and then pull the results into the token. For example, you might want to auto-escalate workflow content to my manger. If we presume that my manager's user name is part of my user profile, (say in a user metadata field called uManager), we can figure out who my manager is in the entry event, set my managers name into the companion file (read the docco if you don't know what this is), then pull it out in the token when the token is evaluated.
this might look something like:
--- ENTRY EVENT CODE ---
<$me=dUser$> <!-- this sets the current user to the idoc variable "me"-->
<$myManager=getValueForSpecifiedUser(me,'uManager')$> <!--this grabs the value of the uManager field for me-->
<$wfSet("manager", myManager)$><!--this creates a variable in the companion file called "manager" and sets its value to the value of the myManager variable-->
----Token Code---
<$wfAddUser(wfGet("manager"),"user")$> <!--this pulls the value of the "manager" variable out of the companion file and sets it as the token user.-->
This is only the tip of the iceberg. One token can have multiple <$wfAddUser...$> declarations. They can be conditional: <$if ..some condition$><$wfAddUser...$><$else$><$wfAddUser...$><$endif$>
Check out the workflow reference guide that is in the documentation library for more ideas.