Working with Activity Stream Manager Sub-Pages (release 5.0 and above) - Akumina Community

Working with Activity Stream Manager Sub-Pages (release 5.0 and above)

You are here:

Activity Stream Manager Sub-Pages

The Activity Stream Manager Sub-Pages are accessed from the Activity Stream Manager management app. On the Activity Stream Manager screen, hover over Sub-Pages to view the drop down menu to access features to build out subscription cards, provide troubleshooting capabilities by viewing subscription properties and history, provide a list of Cosmos Database failures, log entries, and preferences. Click here for additional details on Activity Stream Manager Management App.

  • The Sub-Pages drop down menu will display as follows if a subscription row is not selected.

  • When a subscription row is highlighted, the Sub-Pages drop down menu also displays properties and history features.

Activity Types 

On the Activity Stream Manager screen, hover over the ‘Sub-Pages’ button and click ‘Activity Types’. 

Three Activity Types come defaulted with the system; Note, Document, and Event. In addition, an Authorized user/administrator has the ability to build custom Activity Types.  

Custom Activity Types provide the ability for the Akumina engine to allow custom properties, from a 3rd party system, to be inserted into the stream and then exposed to the front end. This is done through a combination of Custom activity types on the back end, custom activity cards on the front end, and a push subscription, which allows customers to submit data to Akumina from third party systems. This gives the ability to extend the actual stream activity object itself to hold these new properties. 

The Activity Types drive the view of what is displayed in the activity stream on the front end via the activity stream subscription card. 

Understanding Activity Stream Card Views

  • To manage the Activity Types that are in the system, click Activity Types in the Sub-Pages dropdown menu.

 

  • This will open the Activity Types Screen where a dropdown list displays the current Activity Types. 

  • Clicking on an activity type, i.e. Note, will bring up that Activity Type details screen and display its properties. Defaults are provided for these properties, brought in from the default columns in the SharePoint lists. 
Activity Stream Actor/Object Model 

 

SharePoint Column or Literal Entry Model 
Actor Type  Type of actor that changed the data; e.g. “Person” or “System”
Actor:  Id  Email Address or User principle (unique way to identify the actor) of the actor that made the change. 
Actor:  Name  This is the name of column in the SharePoint list that holds the person’s name that made that changeRecommended to leave this defaulted.
Object:  Type  This denotes the type of model used to capture the action taken on the Sharepoint List Item. i.e. Note, Document, Event.

This is set to the selected Activity Type .

Object:  Id  This is a Unique ID of an item in the stream 

This field cannot be changed in SharePoint. 

Object:  Name  The name of the column in SharePoint used to populate the “Name” field of the back-end modelFor SharePoint this is defaulted to Title. 
Object:  Url  The name of the column in SharePoint that contains the Url that takes the user back to the SharePoint list item. This must be an absolute Url. Recommended to leave this defaulted. 

If a company has their own URL system, that can be used. 

Object:  Content  Main textual content to display for an item. 
Object:  MediaType  i.e. If object content is plain text, then the entry would be “text/plain. Otherwise leave the default to “text/html”. 
Object:  Language Id  If multilingual is usedprovide the default Akumina language column name. Recommended to leave this defaulted. 

 

Cosmos Failures 

 The Cosmos Failures section will show retry failures from the cosmos triggering engine and their details. From this screen, it is also possible to do the following: 

  • Jump into the Log Entries details screen to help troubleshoot failures that occur 
  • Search containers to filter down the Cosmos failures 
  • Search Item ID’s to filter down the Cosmos failures 

To view Cosmos Failures in the system, click Cosmos Failures in the Sub-Pages dropdown menu.  

Date  Date and time the failure occurred 
Container  The container where the failure occurred  
Item ID  ID of the Item that failed 
Message  Failure message 

Log Entries 

The Log Entries screen provides an in-house troubleshooting tool for developers to build and query the App Insights tables in the system.  For more details please refer to Akumina Developer Documentation.


Preferences
 

The Preferences screen will display the Activity Stream’s URL structure.  To view Activity Stream Preferences in the system, click Preferences in the Sub-Pages dropdown menu. 

  • The Activity Stream Preferences page displays the default URL template and multilingual labels used when displaying the “Posts” event subscription on the front-end.
  • Each newly created stream activity is assigned an Akumina URL.  This URL is built using the URL template defined on this page.  Typically the URL is set to the customer’s activity stream page.
    • In the ‘Stream Activity’s Akumina URL Template’ or the ‘Stream Activity’s Email Template’ clicking the + on one of the tokens will append that token to the end of the Akumina URL Template.  
      • These tokens will be replaced with stream activity data when building the Akumina URL 
  • The “Posts” event subscription is implicit and is not explicitly created on the Activity Stream Subscription page.  If your site is multilingual, create a translated label for each supported language. 

History 

The Subscription History screen will display the historical events that have taken place for that Event Subscription. When a subscription row is highlighted, the Sub-Pages drop down menu displays the history option.

  • Clicking on the History option in the Sub-Pages dropdown menu opens the Subscription History screen. 

  • The Subscription History screen displays the following historical information about the subscription. 

Action  The last action that took place for the subscription 
Date  The date the last action took place 
Status  Status of the last action 
Message  Description of what the last action was 
Processing Time  How long the last action took to run 
Actor  Who or where the action came from 

Properties 

The Properties screen will display the Event subscription’s properties When a subscription row is highlighted, the Sub-Pages drop down menu displays the properties option.  You can also click on the “Subscription Name” link to go to the Properties page.

  • Clicking on the properties in the Sub-Pages dropdown menu opens the Subscription Properties screen.  If the Event subscription is activated, most properties will be read-only.

Views: 24
//]]>