"PRM ANI Utility Service" Business service is widely used by EAI developers in creating empty SiebelMessage using the "CreateEmptyPropSet" method, Set a Property value in the SiebelMessage using the "SetProperty" method and to get a value of a property from the SiebelMessage using the "GetProperty" method. For information on the "Query Business Component" Method, click here.
Let us discuss in detail with an example using the vanilla Integration Object -- "Account_EMR"
"Account_EMR" Integration object has 4 Integration components--
Parent Integration component -- "Account" and 3 child Integration components -- "Related Contact", "Related Opportunity" and "Related Service Request"
CreateEmptyPropSet
Navigate to Administration - Business service>Simulator view and then simulate the "PRM ANI Utility Service" Business service -- "CreateEmptyPropSet" method.
Input Arguments:
Property Name = Hierarchy Name
Property Value = Account_EMR
The output xml will look like below:
This is an empty SiebelMessage.
SetProperty
We can now use the "SetProperty" method of the "PRM ANI Utility Service" Business Service to set values.
Move the SiebelMessage from the Output Arguments applet to Input Arguments applet by clicking the "Move to Input" button.
Business Service Name = PRM ANI Utility Service
Method = SetProperty
Input Arguments:
"Hierarchy Path:" Input argument takes the values of = "<Parent IC>.<Child IC>.<Grandchild IC>"
Hierarchy Path: = Account
Property Name = Alias
Property Value = Test Alias
The Output xml will look like below:
If we want to set a Property value in the child IC, then:
Hierarchy Path: = Account.Related Contact
Property Name = First Name
Property Value = Test Contact
The resulting xml will look like below:
GetProperty
We can use the "GetProperty" to get a value of a property in the SiebelMessage same like the "SetProperty" method.
Move the xml from the output arguments applet from the previous step to input arguments applet by clicking the "Move to Input" button.
Business Service Name = PRM ANI Utility Service
Method = GetProperty
Input arguments:
Hierarchy Path: = Account.Related Contact
Property Name = First Name
the resulting output arguments will look like below:
Let us discuss in detail with an example using the vanilla Integration Object -- "Account_EMR"
"Account_EMR" Integration object has 4 Integration components--
Parent Integration component -- "Account" and 3 child Integration components -- "Related Contact", "Related Opportunity" and "Related Service Request"
CreateEmptyPropSet
Navigate to Administration - Business service>Simulator view and then simulate the "PRM ANI Utility Service" Business service -- "CreateEmptyPropSet" method.
Input Arguments:
Property Name = Hierarchy Name
Property Value = Account_EMR
The output xml will look like below:
This is an empty SiebelMessage.
SetProperty
We can now use the "SetProperty" method of the "PRM ANI Utility Service" Business Service to set values.
Move the SiebelMessage from the Output Arguments applet to Input Arguments applet by clicking the "Move to Input" button.
Business Service Name = PRM ANI Utility Service
Method = SetProperty
Input Arguments:
"Hierarchy Path:" Input argument takes the values of = "<Parent IC>.<Child IC>.<Grandchild IC>"
Hierarchy Path: = Account
Property Name = Alias
Property Value = Test Alias
The Output xml will look like below:
If we want to set a Property value in the child IC, then:
Hierarchy Path: = Account.Related Contact
Property Name = First Name
Property Value = Test Contact
GetProperty
We can use the "GetProperty" to get a value of a property in the SiebelMessage same like the "SetProperty" method.
Move the xml from the output arguments applet from the previous step to input arguments applet by clicking the "Move to Input" button.
Business Service Name = PRM ANI Utility Service
Method = GetProperty
Input arguments:
Hierarchy Path: = Account.Related Contact
Property Name = First Name
the resulting output arguments will look like below:
Limitations:
- "GetProperty" will throw error message ("Error Running Method 'Execute'.(SBL-PRM-00104)") when you are trying to get a value from the child IC and if there are more than 1 instances of records in the input SiebelMessage.
- The error message can be suppressed by using an additional input argument: ReturnBlankIfNull = Y
- "HierarchyPath:" can be of max 255 chars
- You can get the value of only 1 property at a time. We can get values of multiple properties at a time using the "Workflow Utilities" Business service which will be discussed later.
