The Object activity stream widget adds an associated activity stream to the form and displays user conversations related to a task, app item or business process.
The widget can also display activity streams of other objects—tasks or apps—as well save their entire action history.
To configure the widget, drag it to the canvas from the right pane of the interface designer or click +Widget. Fill out the settings in the pop-up.
- Object*. This option is defined automatically in accordance with the object you are working with. The widget will display the associated activity stream of the current object: app, task or business process.
If the object's context contains a property of the Arbitrary app type, you can display the activity streams of the items specified in that property. To do that, click on the Current object value and select the app from the list. - Merge with activity streams of the items specified in the field. To display the activity stream of a different object, click <Not defined> and select the app from the list.
You can combine activity streams only of associated objects. To associate one object with another, add an App type field to the context of the current app or business process. To learn more, see Create an app item on the page of another app.
Events and System tabs
The Events and System tabs are for system settings that are the same for all the widgets. They allow you to configure a widget’s visibility and access to its data, define what happens, when the user moves or hovers the pointer over the widget, etc. Find out more in System widget settings.
To complete the settings, click Save. To make the changes available to users, click Save and Publish in the top toolbar.
Use cases
Display app item activity stream in a business process task
Let's say you need to implement the following logic: the associated stream of the Approve request task that belongs to the Loan request process displays information from the activity stream of the Company app item that stores the client's info.
To bind these activity streams, go to the form template of the business process task. Open the settings of the Object activity stream widget and select the Company app in the Merge with activity streams of the items specified in the field field.
After the settings are saved, the loan request approval task will show the client's activity stream, for example, with comments of other employees.
Note that in process settings, on the Associated activity stream tab, you can enable the Associated activity stream of an app or file option. If it is enabled, the activity stream of the app item stored in the selected variable will be displayed on all the process tasks. To learn more see Settings tab. If you have specified another app on the form template of a certain task, the activity streams of both apps will be combined on the task's page.
Display activity stream of one app item on the page of another app item
You can also bind the associated streams of two different apps.
Example 1
Let's display the activity stream of the Deals app on the page of a Company app item it is bound to.
Open form settings of the Companies app and open the view form in interface designer. In the settings of the Object activity stream widget, in Merge with activity streams of the items specified in the field select the Deals app.
After saving the settings, the company's activity stream will display the activity streams of all the deals bound to this company.
Example 2
Let's see how to use the widget to display an object's activity stream from an Arbitrary app field.
Let's say that we added an Arbitrary app field to the form of the Companies app. When an item of this arbitrary app is created, users specify a contract from the Files workspace. Let's display the information from the activity stream of the selected contract on the page of a company.
Open the Companies app form settings. Open the view form in interface designer. In the settings of the Object activity stream widget, in the Current object field specify the Arbitrary app variable.
Save the changes. Now, the activity stream of a company will also display entries form the activity stream of the contract selected when creating the company.
Found a typo? Highlight the text, press ctrl + enter and notify us