Low-code designer > Set up interfaces > Widget types > Other widgets / Object activity stream

Object activity stream

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 objectstasks 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_stream_01

  • Object*. By default, the field specifies the object you are working withan app item or a process task. The widget will display the associated activity stream.
    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.

  • Forbid users to send new messages. Hide the field for entering messages in the activity stream. You will still be able to comment on system alerts and messages from users that were left before the option was enabled.

The message entry field can be displayed depending on a certain value of a context variable. To do this, click the  clip0229 icon next to the option. Then specify a variable of the Yes/No switch type from the object context on whose form the activity stream is being configured. For more information on how to configure the widget visibility, see the System widget settings.

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.

object_as2

After the settings are saved, the loan request approval task will show the client's activity stream, for example, with comments of other employees.

object_as3

Please 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 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.

object_as4

Example 2

Let's see how to use the widget to display an object's activity stream from an Arbitrary app field.

Suppose we added an Arbitrary app field to the form of the Companies app, where 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 and go to 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 the created company will also display entries form the activity stream of the selected contract.

associaed_items_03