Media Auto Collaboration - Admin Guide

About

This guide explains how to enable and configure the Mediaautocollaboration module in the Configuration Management console. This module lets video portal admins set up automatic assignment of groups of collaborators based on a predefined role of Faculty Assistants working with Faculty Staff members. Once configured, whenever faculty staff adds new media, the group is automatically added as collaborators to the new media.

Prerequisite

The HTTP notification must be configured on the target video portal account before proceeding with the steps in this guide. To do this, you can follow the steps below.

Configure the HTPP Notification

In the admin console, add an HTTP event notification of type "Entry Status Equals" when the entry status equals to 1 (pre-convert).   

• URL: http://<your_site_host>/notificationhandler
• Data type: API Object
• Object: event
• Object type: baseEntry   
• Format: JSON 

Configure

1. Log into the Configuration Management console by going to your KMS URL and adding /admin at the end. 
2. Enter your Kaltura user ID and password.
3. Click Sign In.
   The Configuration Management console displays.

   

Enable the Notificationhandler module

1. In the list of configurable items on the left of your screen, locate and click on notificationhandler. (The item will be crossed out because it's disabled by default.)
   The notificationhandler window displays.

   

   The Module Info box displays the module name, a description of the module (what enabling this module allows users to do), and a version number. 
2. enabled - Set to 'Yes' to enable the notificationhandler module. 
3. Click Save.

Configure the Mediaautocollaboration module

1. In the list of configurable items on the left of your screen, locate and click on mediaautocollaboration. (The item will be crossed out because it's disabled by default.)

2. If this module is not in your KMS application, please get in touch with your Kaltura representative to inquire about adding it.

The mediaautocollaboration window displays.

3. 

4. The Module Info box displays the module name, description (what enabling this module allows users to do), and version number.

5. Configure the following:

6. enabled - Set to Yes to enable the module.

   +Add "faculties" - Click to display the faculties section.

   

   Here you can define a list of faculties and their assistants:

   userID - Click Select Users and enter the user ID or name, then click Submit.

   assistants -To add assistants, click Select Users below, enter the  user ID or name, then click Submit.

7. Click Save.
   You receive a notice that your configuration for mediaautocollaboration was saved and the cache was cleared.

Known limitations

• The module should be enabled and configured only in one KMS/KAF instance per partner. The module will handle all entries (created in any KMS/KAF instance or outside of KMS/KAF).
• Only regular video and audio entries are supported.
• Only up to 500 configured media owners are supported.
• There are no strict limitations for the number of collaborators, but having more than 2,000 may cause slowness in the module configuration page. Large changes in the configuration page are not recommended because they may cause slowness or failure of the configuration save process.
• When large configuration changes are planned, it's recommended to split them into batches of ~50 users+collaborators.
• The collaborators group will appear in the "Manage Groups" page after removing the relevant user ID from the configuration.