GetBOValue
This function is only used with the Insert Multi Child workflow block. This function is executed by the Insert Object quick action during run time and returns the value of a field within an instance of a business object.
Use this function with caution. Because it connects with the database, using this function too often can affect the application performance.
Syntax
GetBOValue(recId, boRecId, boRef, boField)
Enabled For
For a description of the business object categories, see Notes on "Enabled For".
Business Object Category | Yes/No |
---|---|
Business Rules: Before-Save Rules | Yes |
Business Rules: Calculation Rules (After Save, with or without Also Recalculate on Load) | Yes |
Business Rules: Calculation Rules (Before Save or Always, without Also Recalculate On Load) | Yes |
Business Rules: Calculation Rules (Before Save or Always, with Recalculate On Load) | Yes |
Business Rules: Editing Rules | Yes1 |
Business Rules: Initialization Rules | Yes |
Business Rules: Read Only Rules | No |
Business Rules: Required Rules | Yes1 |
Business Rules: Validation Rules | Yes |
Client Expressions | No |
Object Permissions | No |
Services | Yes |
LDAP | Yes |
Mobile | Yes |
Quick Actions (except UI Quick Actions) | Yes |
UI Quick Actions | No |
Reports | Yes |
Search/Dashboard without field references | Yes |
Search/Dashboard with field references | No |
1. Except when this field appears on a form or is triggered by such a field. |
Parameters
Parameter | Description |
---|---|
recId | The RecID of the context business object. |
boRecId | The RecID of the related business object instance. |
boRef | The name of the business object, such as Profile#Employee. |
boField | The field of the business object instance (boRecId) for which to get the value. |
Return Value
The same type as the boField parameter type. For example, if the boField parameter is a DateTime value, this function returns a DateTime value.
Example
Task#Assignment.Details = $(GetBOValue(RecId, 'boRecId', 'Journal#', 'Subject'))
In this example, there are the following values:
• RecId is the RecID of an incident
• boRecId is the RecID of the journal
• boRef is Journal#
• boField is 'Subject'
If the Journal.Subject value is "Incident 10945 is assigned to you", then the Task#Assignment has in its Details field the following: "Incident# 10945 is assigned to you".