Use Case 7: Decide Voting Path Based on Parent Property

Published By on

In this section, we will see how to set different voting path based on the property value from Parent Item.

Use Case: "Based on property value from Parent item, Voting Path should be decided"

Assumptions

1. Below workflow is created in system and parent item has property Critical Value



2. Get Controlled Item method already exist in ARAS Instance

Explanation

In this Auto Router activity will check the property "Critical Value" from parent item. If critical value is Yes, then it should go to Compliance Review and if the value is No, then it should go to CE Evaluation

Steps to be followed are:

Step 1: Create below server method (C#) in ARAS Instance

Innovator innovator = this.getInnovator();
string activityId = this.getID();
Item controlledItem = this.apply("Get Controlled Item");
string criticalValue = controlledItem.getProperty("a_criticalvalue");
string pathName = "Approve1";
if (criticalValue == "Yes")
{
 pathName = "Approve2";
}
var autoActivity = innovator.newItem("Activity", "edit");
autoActivity.setProperty("is_auto", "1");
autoActivity.setAttribute("id", activityId);
autoActivity.setAttribute("doGetItem", "0");
autoActivity = autoActivity.apply();
if(autoActivity.isError())
{
    return innovator.newError(autoActivity.getErrorString());
}
Item fetchPaths = this.newItem("Workflow Process Path", "get");
fetchPaths.setProperty("source_id", activityId);
fetchPaths.setProperty("select", "id");
fetchPaths=fetchPaths.apply();
if(fetchPaths.isError())
{
    return(innovator.newError("Could not get Paths for automatic SignOff"));
}
Item path = fetchPaths.getItemsByXPath("//Item[@type='Workflow Process Path'][name='"+pathName+"']").getItemByIndex(0);
path.setProperty("is_default", "1");
path.setAction("edit");
path = path.apply();
if(path.isError())
{
    return innovator.newError(autoActivity.getErrorString());
}
return this;


Step 2: Add this method in Pre Activity of Approve Path (Activity Highlighted below)



Step 3: (Skip if this method already exist) Create below server method (VB) in ARAS Instance (Method Name should be Get Controlled Item)

' Find the Controlled Item for a Workflow Process or Activity
Dim inn As Innovator = Me.newInnovator()
If Me.getAttribute("type","") = "Method" And Not Me.node.selectSingleNode("Item") Is Nothing Then 
 Me.node = Me.node.selectSingleNode("Item") 'Handle the case where this method is called from ApplyMethod
End If
Dim qry1 As Item = Me.newItem()
Dim qry2 As Item = Me.newItem()
Dim qry3 As Item = Me.newItem()
Dim wflProcId As String
' Get the Workflow Process
Select Case Me.GetType()
 Case "Workflow Process"
  wflProcId = Me.getID()
 Case "Activity"
  Dim activityId As String = Me.getID()
  If activityId.Length <> 32 Then
   Return inn.newError("Get Controlled Item: Invalid Activity id")
  End If
  qry1 = Me.newItem("Workflow Process","get")
  qry1.setAttribute("select","id")
  qry2 = qry1.createRelationship("Workflow Process Activity","get")
  qry2.setAttribute("select","id,related_id")
  qry3 = qry2.createRelatedItem("Activity","get")
  qry3.setAttribute("select","id")
  qry3.setID(activityId)
  Dim wflProc = qry1.apply()
  If wflProc.getItemCount() <> 1 Then
   Return inn.newError("Get Controlled Item: Error getting Workflow Process: " & wflProc.getErrorDetail())
  End If
  wflProcId = wflProc.getID()
 Case Else
  Return inn.newError("Get Controlled Item: Type must be Workflow Process or Activity")
End Select
If wflProcId.Length <> 32 Then
 Return inn.newError("Get Controlled Item: Invalid Workflow Process id")
End If
' Get the Workflow relationship
qry1 = Me.newItem("Workflow","get")
qry1.setAttribute("select","id,related_id,source_id,source_type")
qry2 = qry1.createRelatedItem("Workflow Process","get")
qry2.setAttribute("select","id")
qry2.setID(wflProcId)
Dim wfl As Item = qry1.apply()
If wfl.getItemCount() <> 1 Then
 Return inn.newError("Get Controlled Item: Error retriving the Workflow relationship: "&wfl.getErrorDetail())
End If
Dim controlledId As String = wfl.getProperty("source_id","")
If controlledId.Length <> 32 Then
 Return inn.newError("Get Controlled Item: Invalid Controlled Item id")
End If
' Get the controlled item
qry3 = Me.newItem()
qry3.setAction("get")
qry3.setAttribute("typeId",wfl.getProperty("source_type",""))
qry3.setID(controlledId)
Dim controlledItem As Item = qry3.apply()
Return controlledItem






LinkedIn: https://www.linkedin.com/in/gobikrishnanraja/

Comments

Post a Comment

Popular Posts

Use Case 6: Use the System Event Logs for Logging Method Failure

Published By on
In this section, we will see how to log any method failure error message in ARAS OOTB System Event Logs. Use Case: "As an administrator, want to see the end user method execution failed error in system to debug and identify the root cause of the error" Steps to be followed are: Add New Event Type in List Step 1: Navigate to Administration > Lists > SystemEventType Step 2: Add Event type you want to log (Example : OnAfterAdd) Add New System Event Step 3: Navigate to Administration  > System Events   > System Events Step 4: Create New  > Add New System Events > Select Event Type and Save Add New System Event Log Descriptor Step 5: Navigate to Administration > System Events  > System Event Log Descriptor Step 6: Create New > Add New System Event Log Descriptor > Select Event Type and Save Create Story_FailedMethod_SystemLog Method Step 7: Create new Server Side method  (Method Name: Story_FailedMethod_SystemLog) Innovator inn = this.getInnovator();
Read More »

Use Case 4: Instantiate Dynamic Workflow Using Action

Published By on
  In this Demo, We will see how to instantiate the workflow dynamically using custom action on any item type. "Use Case: User wants to instantiate workflow dynamically based on some condition" Action Name: Instantiate Workflow Pre-requisites: Multiple workflows should be created and added to item type under allowed workflows Example: I have created 3 Workflow and added to Story Change Items item type.  LinkedIn :  https://www.linkedin.com/in/gobikrishnanraja/
Read More »

Technical Tip 2: Open item in Edit Mode through custom Method

Published By on
    In this section, we will see how to open an item in edit mode using custom method in ARAS V12 version. Use Case: "Open any item in edit mode using custom method to avoid user from locking / claiming the item" You can use below code snippet to open any item in edit mode aras.uiShowItem("Part",getItem.getID()).then(function() { var itemEdit = aras.uiFindWindowEx(getItem.getID()); itemEdit.onEditCommand(); }); Note: getItem.getID() is Item ID of a previous apply() Example: var innovator = new Innovator(); var getItem = innovator.newItem("Part", "get"); getItem.setAttribute("select", "id"); getItem.setAttribute("maxRecords", "1"); getItem = getItem.apply(); aras.uiShowItem("Part",getItem.getID()).then(function() {      var itemEdit = aras.uiFindWindowEx(getItem.getID()); itemEdit.onEditCommand(); }); LinkedIn: https://www.linkedin.com/in/gobikrishnanraja/
Read More »