Object Groups

How to Use

Create an Object Group

Defining the Object Group (in the example below we are going to create an Object Group that will display invoice lines).

1. Click the Relevant Process.
2. Click the Relevant Activity (form/screen) that you want to create the Object Group on.
3. Click the Properties tab.
4. Click the  next to Object Groups as indicated in the previous figure.
5. Click Add.
6. Click the New Object Group in the left-hand pane.
7. Provide the Property values of the Object Group in the right-hand pane as indicated below.
8. Ensure to follow naming conventions when providing values for the Description and Name properties.
9. Click OK.

Assign Objects on your Activity (screen/form) to the Object Group

1. Double-click on your Activity to open it in the work area.
2. Drag-and-drop the objects of choice (that you want to appear in your List) from your Toolbox to your work area (in order of display preference left to right).
3. Click on the first object (Invoice Line Description) as indicated in the following figure.

4. Click the  menu next to Object Group on the Properties tab.
5. Choose the Object Group that you defined in Step 1 of Creating an Object Group.
6. Click OK.
7. Do the same for all the other Objects you want to form part of this Object Group. In the example above the yellow highlighted objects.
8. On the ribbon, click the File tab, click Save or press CTRL+S to save your changes.

Object Group Content Definition

Object Groups can be populated with information from another system(s) or from a previous step in the process (form/screen). We recommend that you use the XMPro Integration Wizard for information retrieved from another system or from a database in XMPro OR the Object Fast Field Wizard if the information comes from a previous process step or screen.

Use values from the previous process step (scanned invoice) to populate the Object Group.
Refer to How to Use the XMPro Integration Wizard to learn how to populate an Object Group with information from a database or file.

1. Click on the relevant Activity in your work area.
2. Click the Properties tab.
3. Click the Object Groups Property  button. The Maintain Object Groups window will open.
4. Click your Object Group configured in Step 1 of Creating an Object Group.
5. Click on the Managed Object Group under Content Definition as indicated below. The Object Field Fast Field window will open.

6. Click the Previous Activity radio button as indicated below.
7. Click on the From Activity drop-down.
8. Click on the relevant Previous Activity.
9. Click on the From Object Group drop-down.
10. Click on the relevant Object Group. The Objects will be displayed in the left-hand pane.
11. Drag-and-drop each object in the left-hand pane to the corresponding Object in the right-hand pane as indicated below.

12. Click on Save.
13. Click CTRL+ S to save the Activity. The Object Group will be populated with information from the previous step during run-time.

Calculate Values in an Object Group

1. Click on the relevant Process Group.
2. Click on the relevant Process.
3. Double-click on the relevant Activity.
4. Click the Object that will contain the “calculated value” (Assuming that you have completed Step 1 and Step 2 of Creating an Object Group). In the previous figure, we are going to calculate “Total” (IA2070Total). The Total will be Unit * Qty.
5. Click the  button next to Managed Object under Content Definition. The Script Editor will open.
6. Add the following to the OnLoad and/or OnRefresh sections: fcLabel = aObjects(“IA2050Qty”) * aObjects(“IA2060Unit”)
7. Click Save.
8. Close the Scripting window.
9. Click CTRL+ S to save the Activity.

Calculate Values outside an Object Group using Values in the Object Group

Add all the IA2090Inclusive line values (in the Object Group) and display the total in the IA20150TotalCost Object (outside of the Object Group) as follows.

1. Click on the relevant Process Group.
2. Click on the relevant Process.
3. Double-click on the relevant Activity.
4. Click on the IA20150TotalCost object in your work area.
5. Click on the  button next to Managed Object under Content Definition in your Toolbox. The Script Editor window will open as indicated in the following figure.

6. Provide the code as indicated for the OnLoad and OnRefresh functions.
7. Click CTRL+ S to save the Activity. You will be returned to the work area.

Populate Object Groups from Object Groups used in a previous step in your process

1. Click on the relevant Activity.
2. Click on the Properties Tab.
3. Click on Object Group CollectionIs a virtual grouping of Stream Hosts.  All Stream Hosts in a collection are broadcasted the same instructions from the IoT Portal.  This way a Use Case can be mass deployed to all the Stream Hosts in a given Collection.  button. The Maintain Object Groups window will open.
4. Click on the Object Group that you want to populate with information.
5. Click on Managed Object Group (under Content Definition). The Object Field Fast Field window will open.
6. Click on the Previous Activity (Retrieve Data From) radio button if not selected.
7. Provide the detail as required for From Activity, From Object Group.
8. Provide the mapping detail.
9. Click on Save.
10. Click OK.
11. Click CTRL+ S to save the Activity.

Delete an Object Group

1. Click on the relevant process in the Server Explorer window.
2. Click on the Activity containing the Object Group.
3. Click on the Properties Tab.
4. Click on the  button next to Object Groups in the Properties window. The Maintain Object Groups window will open.
5. Click on the Object Group you would like to remove.
6. Click on the Remove button.
7. Click OK.
8. Click CTRL+ S to save the Activity.