How do you get ROID/task id?

[Anon Anon]

I just recently upgraded PAM to 4.0. I saw in the documents that you can now link directly to process/task etc...

This is great new since now I can't send out email and user can goes directly to there task.

But how do you get the ROID?

[Server URL]?ROID=<runtime_object_ID>&tasklist=ALL_TASK_FILTER &page=replytask

This is how my process is layout.

I would send out the email and then assign a user interaction form. How would I get the ROID if when you assign a task, the process wait until the task is completed before doing anything.

Any advice would greatly appreciated.

[Scott Owens]

You may be able to do this by using an AND operator off of your UIF AND to your email notification. You might need a delay operator before the email
notification to give the user interaction time to be assigned a ROID.

This would allow the ROID to be assigned in the UIF operator.

[Anon Anon]

What is the script to get the ROID?

I've tried:
Process.ROID = Process[Approval_Form].ROID;
and
Process.ROID = Process[Approval_Form].RuntimeROID;

Approval_Form is the operator name of the user interaction form.

[Anon Anon]

Unfortunately, there's no variable that represents the ROID for a task in PAM 4.0. We have addressed this issue and will make this available in the upcoming service pack 1 update.

Basically, the Assign User Task operator will populate a variable called TaskID. The challenge is that the Assign User Task operator remains in a waiting state until the assigned user responds to a task.
As Scott explained, you'd have to use an Or to create a parallel branch and preceed a Send Email operator with a small delay to ensure that the Assign User Task operator has populated the variable. Then use an And to merge back into a single branch to continue (see attached mockup).

To complete your use case (to send email notification with a URL for directly accessing a task), 4.0 SP1 will also have a new function that returns the PAM server URL: getOrchestratorURL(). To build the URL to access the task directly you'd have to put this in the email body:

getOrchestratorURL() + "?ROID=" + Process.Assign_User_Task_1.TaskID + "&page=replytask"

[Legacy User]

Kaj.Wierda:

Unfortunately, there's no variable that represents the ROID for a task in PAM 4.0. We have addressed this issue and will make this available in the upcoming service pack 1 update. Basically, the Assign User Task operator will populate a variable called TaskID. The challenge is that the Assign User Task operator remains in a waiting state until the assigned user responds to a task. As Scott explained, you'd have to use an Or to create a parallel branch and preceed a Send Email operator with a small delay to ensure that the Assign User Task operator has populated the variable. Then use an And to merge back into a single branch to continue (see attached mockup). To complete your use case (to send email notification with a URL for directly accessing a task), 4.0 SP1 will also have a new function that returns the PAM server URL: getOrchestratorURL(). To build the URL to access the task directly you'd have to put this in the email body: getOrchestratorURL() + "?ROID=" + Process.Assign_User_Task_1.TaskID + "&page=replytask"

Kaj,

 

Thank you for this. I have a client with this exact requirement, so I found this very helpful. One thing I noticed and i'm not sure if this is by design, but the getOrchestratorURL() function returns the URL correctly, except for the fact it leaves out itpam at the end (in 4.1). Without this, we get to a JBOSS page.

[Anon Anon]

PAM 4.1 SP1 comes with an example in the Out-of-the-Box content. It's under /PAM_PredefinedContent/User Interaction Forms/01 Send Task URL in the Library.

In the example, you will find the correct format for the URL that is sent as part of the Send Email operator, Message field. The correct format for the URL is formed like

getOrchestratorURL() + 'itpam?ROID=' + Process.Assign_User_Task_1.TaskID + '&page=replytask'

[Legacy User]

Thanks Kaj! I never imported that so I will go ahead and take a look.

[Legacy User]

Kaj,

One more question (I think). I'm trying to mask the url behind text (using HTML a href tags). Here is the format I am using:

<a href="http://SDESKDVVAPP03.vbschools.com:8080/itpam?ROID=11358&page=replytask">Please click here to access the form</a>

Is there any issues with what I have here? Or have you seen issues in doing this? I took a look at the example you provided above and that is what they were doing in the Email Description.

Thank you,

Clinton