Related Topics
Business Value Operations
Business Values enables you to perform sophisticated data retrieval via the use of parameters, and mathematical aggregation.
Parameters #
An even more powerful way of using Business Values is to use parameters to return values dynamically in your processes. Previously, instead of a Business Value, you'd need to create a Custom Task activity in your Process Timeline, or use a Custom Task in a Form, to return data values to fill fields. As a result, you might have several Custom Tasks, spread out among several applications, each of which would use the same configuration. Any change to the database schema, would require making changes to every single one of those Custom Tasks, making updates tedious and costly in terms of time and effort. While there are certainly times that a database Custom Task will still be needed, the Business Value can replace a Custom Task in nearly all use cases.
Let's take a look at a hypothetical case. We'll assume that we have a database table that stores customer information. We can create a Business Value to provide that information. Let's look at how such a Business Value might be configured.
The SQL Command for this Business Value retrieves records for active customers. If no "CustomerID" parameter is supplied, the command will simply pull every customer record. If the "CustomerID" parameter is supplied, Business Value will return only a single record. In other words, the same Business Value can return a single or scalar value based on the parameter.
Next, the Business Value uses the database columns to create three properties: the Name, ID, and Type properties will all contain values extracted from the database, In addition, since the Business Value automatically knows how many records have been returned by the SQL Command, the fourth property, Count, will contain the number of records returned.
When a Business Value Property returns no data from a SQL command, it can still be used in a condition, because the value will be set to an empty string, allowing comparisons in the conditions to work correctly.
Once we have created the Business Value, it's accessible by all other objects in Process Director. None of your business users or other implementers need to know anything about how the data is configured to use the it, because the Business Value properties are available through the Condition Builder dropdowns. They merely need to select the properties they want, which means that, in most cases, implementers no longer need to create a Custom Task to retrieve the data. They no longer need to know or care about the database schema or the SQL syntax to retrieve the data they want. This functionality greatly reduces the level of technical knowledge that business users and implementers need to conduct relatively sophisticated data retrieval operations. With Business Values, technical details about the data, and how to acquire it, is largely irrelevant to implementers. The only person who needs to have any sort of technical knowledge about the database is the creator of the Business Value itself.
Combined with the scheduling and process initiation available in the Goals feature, Process Director is a powerful process automation system, enabling automatic process initialization based on data from external systems.
Mathematical Operations #
Another function available for Business Values is the ability to perform mathematical operations on a Knowledge View column. When retrieving any numeric column data, Process Director can perform the following calculations on the values:
- Sum: Returns the sum of all the values in the column.
- Average: Returns an average of all the values in the column.
- Min: Returns the lowest value in the column.
- Max: Returns the highest value in the column.
- Average (ignore 0 values): After eliminating the rows that contain a value of 0 or null, returns an average of all the remaining values in the column.
- First: Returns the first row from the Knowledge View.
- Last: Returns the last row from the Knowledge View.
- Distinct: Returns only unique rows from the Knowledge View, in a manner similar to a SQL Server DISTINCT operator.
Other Usages #
Once a Business Value has been created, it can be selected as a content type from the Content Picker control when creating Forms.
Business Values can also be accessed through a System Variable. For an example of using a system variable with a parameter, take a look at the following Business Value configuration for a notional Business Value named "CustomerInfo":
So, in this example, let's say we want to return the Name property for the customer whose Customer ID is "123" via a system variable. In that case, we could use the following syntax:
{BUSINESS_VALUE:CustomerInfo.Name, $CustomerID=123}
Please see the documentation on Business Value System Variables for more information.
Related Topics
Business Values: Additional capabilities of Business Values.
Creating Business Values: Instructions on Business Value configuration.
Documentation Feedback and Questions
If you notice some way that this document can be improved, we're happy to hear your suggestions. Similarly, if you can't find an answer you're looking for, ask it via feedback. Simply click on the button below to provide us with your feedback or ask a question. Please remember, though, that not every issue can be addressed through documentation. So, if you have a specific technical issue with Process Director, please open a support ticket.