General Help Series 4- Workflow Maps/Instances

Livelink Workflows for the impatient

Livelink comes up with a extremely powerful Workflow Engine .At the minimum if you have only installed Livelink OOB you get a decent workflow features.This involves a “business user” to design a logical map that may involve “players” or “roles”.The only criterion is the process needs to be repeatable or it can be plotted in visio or such like.Note Livelink WF came before the wf consortium came up with open standards but it will have almost everything one sees in the standard.

Some key terms-

  1. A WF Map.This is a dtree object identified by a dataid
  2. WF Manager-By default the person who created the original map.Best practices dictate that you assign a proper livelink group as the ‘Master Manager‘.Not to be confused as the livelink team’s manager or a organizational manager.In theory this manager can re-assign steps and repaint the map.One of the few places where the sysadmin profile or the ‘admin’ user won’t cut it so due diligence thinking that at some point a higher up user may be asked to assist.Please do not run maps with <Initiator /> as the Master Manager.It is quite possible these users know only to click and when something breaks nobody can intervene.You can make them do only the “See Details” which is more than enough in many cases.
  3. WF Instance- The process logic that is set in motion when a WF Map is set in motion a.k.a initiated .This is easily identifiable by a clickable link in the WF managers assignments and it will show in GREEN the step and useful info.
  4. Steps-The series of steps that can be assigned to processes and users.This is what apparently the business user can be trained to paint..there are a myriad of steps that OT puts on the palette.
  5. Role Based or Map Based-If you create a map OOB then livelink gives you a map where the forward steps can be done by business programming,like if WF attribute is green then my user is this group.If you change the map to “ROLE” based before initiation the Initiator will have to fill all the people in the workflow.People who use the Transmittals product of livelink can see this in action very clearly.
  6. Attachments Volume- By default the attachments package is permissioned Full Control to “Public Access” very bad idea as when a casual user does search he will see unwanted or secretive results..Always put a good permission bit there.If you do not give participants Add Items up to Delete in that volume you will get crude messages from livelink . Note that the Truth Table implementation is observed by livelink on any kind of Object Creation so to get around problems in workflow OT assigns default full control to PA. Just observe what OT gives and change that to a good group and add all the people in the workflow to that group.
  7. WF Attributes– Helper attributes modelled after category metadata .It allows the business user to route the map.
  8. Forms-Optional Package see NEXT post.
  9. Loop Back– Be extremely careful about this as you can create a infinite wf instance.
  10. Item Reference– You can point to existing object subtypes in livelink like folders /documents etc so in conjunction with Item Handlers you can perform “auto magic”

It is quite possible that a good business user or a livelink user can be trained over a day to understand the process flow/swim lanes.I usually design my maps on a paper.I have a cheat sheet of sorts I maintain and many of the things in this article is based on that. Always check “Verify Map Definition” to understand any problems this may have.

The Item Handler is a predictive step modeled by some placeholder logic( Design Book 3) although which it appear useful it could look frustrating as very little process automation can be done just by it.The workarounds or “auto magic”  is usually a human at a prior step.If you use it with XML WF Extensions a lot of “auto magic” can be done with it.

The “XML WF EXtensions”  is a optional module that   uses the capability of livelink objects to have a XML representation(everybody probably has heard of XML Export/XML Import)

the XML WF Ext uses XML representations of livelink objects and manipulation of those objects by a SAX(or DOM not sure I know LL has both in it ) parser. Usually people get bitten by load balancers and file system permissions.

Like wise -XML Work Flow Interchange.Can send /call Web Services of other systems.

ESign – A specialized workflow that can do electronic signatures prevalent in 21 CFR11 operations.

Perfectly suited for livelink organizations who will not invest in Oscript coding /scared by OT sales/marketing in not writing Oscript understanding of this remarkable product.It was very expensive when I started livelink programming so it is a personal bias as well since I like to look at the map and many times I can get a 1-1 representation to the process.

OT Workflow Design 1 and Design 2 is a must read if you are doing anything with also has decent interface methods for web services  as well


5 thoughts on “General Help Series 4- Workflow Maps/Instances

  1. Hi Appu,

    I am fairly new to working with workflows and general call back scripts. Will it be possible on your behalf to provide me with some guides or tutorials as to how to work with general call back scripts in workflows, how to setup categories and its values via general call back scripts. ??


    Nemish Nigam

    1. in an earlier post I have put source code.If you are new to oscript then the only way you can study is

    2. You need a fully configured livelinkserver with builder or cside
    3. You need the ability to create a custom module,install it unisntall it and generally comfortable
    4. My code shows how to access the form data structure.Form data structure,workflow data structures and categories and attributes are similar.An example exists which forms the basis of how everybody updates values.You will find that example in the KB.
    5. OT stresses that customers use XMWFextensions or Webreports which have easier looking api’s although you will pay more for those.
    6. Oscript gets a little bit of getting used to.It is a much superior language and I would encourage you to dwelve into this only if you or your employer has the wherwithal. In most cases if it is just do a simple requirement in hand and move on I would not advise you to use this.
    7. Start small and play with small eventscripts and when you get stuck we will help 🙂
  2. Thanks Appu,
    I’ll try going through your post and see what all can I learn. I was able to find a documentation on Knowledge Center too. I’ll try going through that.In case you have some other documentation, please provide it to me. Let’s see how much I can learn. Also a colleague of mine (Madhuker Kampe) happens to have worked with you. He likes your work a lot. 🙂

    Thank You.

  3. Let me know what Livelink server and version you are going to practice.I currently have moved to CSIDE but the oscript in my builder module should all work but newer people may not know how to get it going.In my spare time I will look at porting this to CS16.If I am not mistaken I have included a generic script that will update attributes as well. Madhu is a great friend.

  4. I’d be practicing now on Livelink 9.7.1 version, but my work is mostly on 10.5 . So if you have workflow and event scripts documentation for both 9.7.1 and 10.5 or any sort of guide, that’ll be a great help sir.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

This site uses Akismet to reduce spam. Learn how your comment data is processed.