Introduction
VIDIZMO offers seamless content ingestion from Kaltura. Kaltura, renowned for its enterprise video solutions tailored for educational environments, is a platform for hosting and sharing video and audio content across various channels. With this new capability, users can effortlessly import content from Kaltura to VIDIZMO while preserving essential elements such as metadata, category hierarchies, sub-hierarchies, and content metadata files. Furthermore, users can leverage transcoding features while configuring the Kaltura app for ingestion, providing options to create renditions based on either VIDIZMO or Kaltura encoding profiles.
This article will guide you through effectively ingesting Kaltura's content into VIDIZMO, ensuring a seamless experience.
Prerequisites
Ensure that you have administrative or manager access to your VIDIZMO Portal.
Active Kaltura Account.
VIDIZMO Portal Configuration
From the Portal's Homepage
1. Click on the menu icon on the top left-hand corner of the screen to bring up the left navigation pane.
2. Then click on the down arrow to expand the admin section.
3. Select the Portal Settings from the navigation panel.
On the Portal Settings navigation pane
4. Click on the Apps to expand the list of application services you can integrate.
5. Select Content Ingestion, where you can set up KALTURA App.
6. Access the Settings icon for the KALTURA App to Establish Integration with VIDIZMO for Content Ingestion.
Kaltura App – Settings
Configuration requires the following details:
7. Kaltura Instance URL: Enter the URL of the Kaltura website.
8. Partner ID: Enter the identification number of the Kaltura account from which content will be ingested.
9. Secret Type: Choose between Administrator Type or User Type based on the role of the Kaltura account. User Secret is for general API access, while Administrator Secret grants full administrative control for portal-level access. Keep these keys secure for content management in Kaltura.
10. Secret Key: Choose between Administrator Secret or User Secret based on the selected secret type. The secret serves as the API private key for authentication token generation during API sessions with Kaltura servers.
11. User Email: Enter the email associated with the Kaltura account from which content is being ingested. Ensure that you enter the email based on the selected secret type, whether it is User or Administrator, as this account is where content will be ingested.
12. Time Interval: Specify the duration, in seconds, before the system enters a state of rest with no active tasks or operations. After this time interval, the system will resume ingesting content.
13. Custom Attribute Name: Assign a custom user-defined attribute in VIDIZMO with the desired name to store the source system's ID from Kaltura during content ingestion and ensure proper mapping of the Kaltura ID to this attribute, enabling efficient searching within VIDIZMO.
14. Import Transcoded Files: Enable the check to transcode ingested files, generating renditions according to the Kaltura transcoding profile. Disable the use of the VIDIZMO-configured encoding profile for transcoding.
Transcoding option: When enabling transcoding during configuration, renditions are generated according to VIDIZMO's encoding profile. If disabled, the ingested content adopts the transcoding profile specified by Kaltura. The published date remains unchanged when importing files, similar to Kaltura's behavior when the "Import Transcoded files" option is activated.
15. Publish As Kaltura User: Ensure smooth author name import when ingesting content from Kaltura to VIDIZMO by selecting the "Publish As a Kaltura User" checkbox in VIDIZMO. This aligns the terminology with Kaltura, where the media file uploader is called "creator," ensuring consistent and accurate metadata during content ingestion.
16. Content Moderation Status: To successfully ingest content from Kaltura to VIDIZMO, choose the desired moderation status from the dropdown menu. VIDIZMO exclusively ingests content with the selected moderation statuses, ensuring a seamless and controlled content moderation process.
- Pending Moderation: When users select the moderation status of "Pending Moderation," it indicates that the content is awaiting review by a moderator before being published or made public. Content with this status will be placed in the "Review" tab within VIDIZMO after ingestion.
- Approved: Selecting the "Approved" moderation status signifies that the content has been reviewed and accepted for publication or public access. Content with this status will be organized in the "Publish" tab within VIDIZMO.
- Rejected: If content is deemed unsuitable or in violation of guidelines, users can set the moderation status to "Rejected." Content with this status will be directed to the "Review" tab in VIDIZMO but will be clearly marked as rejected.
- Flagged for Review: When users choose the "Flagged for Review" moderation status, it indicates that the content requires further examination due to potential issues, and a final decision has not been made. Content with this status will be placed in the "Review" tab within VIDIZMO.
- Auto Approved: Opting for the "Auto Approved" moderation status means that the content has undergone an automated approval process and is considered suitable for publication without manual moderation. Content with this status will be found in the "Publish" tab within VIDIZMO.
Note: Please ensure the "Allow Content Moderation Status" checkbox is activated within your VIDIZMO portal settings, specifically under Portal Settings > Library > Upload Settings. Enabling this option is crucial for moderating content within the portal, allowing you to conveniently access and review content in the "Review" tab. Failure to enable this setting may result in the content not being displayed in the portal after ingestion.
17. Click Save Changes to configure the app.
From the Content Ingestion screen
18. You can now see that the toggle button against the Kaltura App enables that toggle button to start ingesting content from Kaltura to VIDIZMO. A notification will be displayed indicating that the app settings have been successfully updated.
19. Click on the progress option to view the status of content ingestion.
The application operates in three distinct states:
- Iteration Start: This initial state indicates that the ingestion process has commenced, transferring content from Kaltura to VIDIZMO.
- Importing Content: In this phase, the modal displays information on the ingested content, including the count of files currently being ingested and the total content count, representing the overall number of files.
- Iteration End: The final state signifies the completion of content ingestion from Kaltura to VIDIZMO.
The publishing date of ingested content in VIDIZMO aligns with the original date from Kaltura following the content ingestion process. Additionally, when ingesting content that belongs to a category existing in Kaltura, the corresponding category in VIDIZMO will be updated, including its description, mirroring the information present in Kaltura. This ensures consistency and accuracy in metadata representation during the ingestion process.
Searching Ingested Content in VIDIZMO
As previously mentioned in the document section above, we have already configured the Kaltura App in VIDIZMO for content ingestion and assigned a custom attribute name to ingested content using the source system's ID from Kaltura as its value.
- To view ingested content, access the media file settings from the overflow menu. Navigate to the "Settings" option and go to the "Custom Attributes" tab.
- In the "Custom Attributes" tab, locate the custom attribute named, for example, "Kaltura_ID," which represents the source system's ID from Kaltura for that specific media file.
3. To search for ingested content based on the custom attribute, go to the media library and click on the "Advanced Search" option located in the search tab.
4. In the advanced search modal, choose the field corresponding to the custom attribute name used in the Kaltura app (e.g., "Kaltura_ID").
5. Select the value for the chosen custom attribute field, which can be found in the media file settings under "Custom Attributes," as described in step 2.
6. Click "Apply" to execute the search. The system will display a list of ingested content that matches the specified value of the custom attribute.
Learn how to manage custom attributes in VIDIZMO by referring to our article titled "How to Manage Custom Attributes".
7. VIDIZMO will display the ingested content that has been searched using the Kaltura ID. This enables users to search for ingested content from the Kaltura ID in VIDIZMO by utilizing the advanced search feature.
To learn more, refer to our article "Ingesting Content from Kaltura in VIDIZMO."