Getting Started with Brightcove Video Connect for SharePoint

Product(s)
Video Cloud
Role(s)
Studio User
Topic(s)
CMS Integrations

This topic provides an overview of Brightcove Video Connect for SharePoint.

Introduction

Version Documentation Download Compatibility Notes
4.0.1.0 Coming soon! Plug-in and source *

SharePoint 2013/2016 On-premise, SharePoint 2016 Online (Office 365), Brightcove CMS & DI API's, Brightcove HTML5 Player

  • New AppPart available for embedding Brightcove videos, playlists, and In-page Experiences. Can be used to embed Brightcove players on Modern Experience pages in lieu of using native embed icon.
  • A Proxy server for Brightcove APIs is no longer required, simplifying setup process.
3.0.2.0 Skip to 4.0.x.x Release Plug-in and source *

SharePoint 2013/2016 On-premise, SharePoint 2016 Online (Office 365), Brightcove CMS & DI API's, Brightcove HTML5 Player

  • Supports publishing of In-page Experiences video portals
  • Uses Push-based Dynamic Ingest; now support upload of videos from SharePoint server behind a firewall
  • Uses default ingest profile in Brightcove instead of hard-coded profile
  • Improved UX
  • Simplified installation process
2.0.2.66 Training Doc Plug-in and source* SharePoint 2013/2016 On-premise, SharePoint 2016 Online (Office 365), Brightcove CMS & DI API's, Brightcove HTML5 Player
1.1.2.8 Training Doc EOL SharePoint 2013 On-premise Only, Brightcove Media API, Brightcove Legacy Flash SmartPlayer 

* Copyright 2016 Brightcove

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

For help with this connector, please fill out this worksheet and include it with a support ticket to Brightcove customer support.

Contents

Installing Brightcove Video Connect for SharePoint

Before you begin installation, review the following information about prerequisites and permissions:

  • Before a user can add an app for SharePoint, a member of the Farm Administrators group must configure the environment to support apps for SharePoint. For more information, see Configure an environment for apps for SharePoint 2013 or Configure an environment for apps for SharePoint 2016
  • A user must have the Manage Web site and Create Sub-sites permissions to add an app for SharePoint. By default, these permissions are available only to users who have the Full Control permission level or who are in the Site Owner's group.
  • When a user adds an app for SharePoint, the app requests permissions that it needs to function (for example, access to Search, or to create a list). Users who do not have those permissions are informed that they do not have sufficient permissions and the app cannot be added. The user can contact a Site or farm administrator to see if the administrator can add the app.
  • A user logged in to a Site as the system account cannot install an app. The system account cannot import app licenses because that could result in performance problems.

Adding the Brightcove Video Connect App to the App Catalog

Setting Up App Catalog

To install the Brightcove connector, the first step is to set up the App Catalog in SharePoint. Use the references below to complete this step.

Adding the Brightcove Video Connect App to the catalog

Once the App Catalog is setup, follow the steps listed below:

  1. Verify that the user account that is performing this procedure is a member of the Site Owners or Designers group for the App Catalog.
  2. On the App Catalog Site, click the Apps for SharePoint list.
  3. On the Apps for SharePoint page, click new item.
  4. In the Choose a file box, click Browse, and then locate the folder that contains the BrightcoveConnectorApp file.
  5. Select the App, and then click Open.
  6. Click OK to upload the App.
  7. In the Item details box, supply the Name, Title, Short Description, Icon URL, and other settings for the App. Be sure that the Enabled check box is selected so that users can see the App in their Sites. You can select the Featured check box to list the App in the Featured content view of the App Catalog.
  8. Click Save.

Installing the Brightcove Video Connect App in a Site

Follow the steps listed below to install the Brightcove connector in a Site:

  1. Verify that the user account that is performing this procedure is a member of the Site Owners group.
  2. The App can be added to a Site one of two ways:
    1. On any page, from the Settings menu select Add an app option.
    2. From Site Contents using the Add an app option.
  3. Next, click "From Your Organization" and then click on the BrightcoveConnector App
  4. In the Grant Permission dialog box, click "Trust it".
  5. At this point, the BrightcoveConnector App for SharePoint is added and appears in Apps section of your Site Contents list. It is now available for use in the Site.

Provisioning the Default Lists for the Brightcove Video Connect App

Before using the Brightcove connector, some required lists need to be provisioned by following the steps below:

  • When the App is first instantiated, or if the lists are not present in the local Site, then the user will be presented with up to 3 options to allow for the provisioning of lists inside the Site.

  • When clicked, each button will display a message to the effect:
  • When "Create Settings List" is clicked, in addition to creating the Brightcove Settings list, a prompt to edit this list is show to ensure that the proxy URL required for the Brightcove API support is configured.
  • Clicking on this link will open the Brightcove Settings list for immediate edit of the proxy server access information. Title must be set to "Proxy". The ProxyURL is specific to the location of the proxy server you will use to access the Brightcove API. See Use of Proxy Server for Brightcove API communication for more details on the use of the proxy server.
  • Completing the list provisioning will create the following lists in the Site:
    • Accounts - A custom list representing the Account objects.
    • Videos - A custom list representing the video objects.
    • Settings - List to store the proxy server details.

Setting up SharePoint Permissions

A benefit of integrating the Connector into SharePoint directly is the ability to leverage its permission model. The SharePoint Admin can control which users have access to the various functions of the Connector. The following is the default set of groups which are used by the Connector to control access to the sections of the Connector.

  BCAdmin BCVideoAdd User in Neither Group
Home X X X
Account Management X    
Add / Edit Video X X  
Manage Videos X X X
Manage Playlists X X X

NOTE

  • Groups need to be setup by the SharePoint administrator and are not automatically created by the Connector during installation.
  • Users must have at least visitor access to the Site on which the Connector is installed in order to access the App. With access to the Site the App is installed in, users can see the Home, Manage Videos and Manage Playlists sections of the Connector.
  • In addition to the groups below, each Account is setup with an Author and View Group explained later.

Installing Player Solution Package for SharePoint Online

The Brightcove Player Solution Package included in the Brightcove Video Connect package allows the user to embed Brightcove video players on SharePoint Site pages. The Brightcove Player Solution Package uses out of the box SharePoint controls which are compatible with both SharePoint Online and SharePoint Server and can thus be used with both. A Player Web Part sandbox solution for embedding video is also available in the Brightcove Video Connect package but can only be used with SharePoint Server on-premise as SharePoint Online and SharePoint Server hosted by Microsoft have security restrictions prohibiting sandbox solutions; this solution is described in the next section.

To embed a Brightcove player in SharePoint Online, the solution package described here allows the user to choose a video or playlist player and then player embed code is generated for the user to copy/paste into the SharePoint Embed Code dialog box.

NOTE - This section requires the BrightcovePlayer.wsp solution file.

  1. In the root Site of the Site collection, where the Brightcove App is installed, navigate to Site Settings -> Site Collection Administrations -> HTML Field Security.
  2. Add players.brightcove.net as an allowed iframe domain
  3. In the root Site of the Site collection, where the Brightcove App is installed, navigate to Site Settings -> Web Designer Galleries -> Solutions.
  4. Upload the "BrightcovePlayer.wsp" file into the Solutions Gallery and activate the file.
  5. Navigate to Site Settings -> Site Actions -> Manage Site Features.
  6. Activate the "Brightcove Player" feature.
  7. Verify that the BrightcoveConnectorResources Document Library was created during installation.
  8. If not, create a new Document Library called BrightcoveConnectorResources
  9. and upload BrightcovePlayer.css and BrightcovePlayer.js to that Document Library.

Installing Player Web Part For SharePoint On-Premise

If you are using the Connector with SharePoint Server installed on-premise, you may install the Player Solution Package as described in the previous section or you can install the Player Web Part Sandbox Solution described in this section.  This sandbox solution will not work with SharePoint Online or SharePoint Server hosted by Microsoft due to security restrictions.  The Player Web Part offers a slightly more streamlined way to add players to a SharePoint Site as it does not require the user to copy/paste embed code.

NOTE - This section requires the BrightcoveVideoCloudPlayer.wsp solution file.

  1. Add the Solution to SharePoint from the command line by entering:
            stsadm -o addsolution -filename BrightcoveVideoCloudPlayer.wsp
  2. Deploy the solution by navigating with your browser to "Central Administration -> System Settings -> Farm Management -> Manage farm solutions":
  3. You should now see the BrightcoveVideoCloudPlayer.wsp in the farm's solution store. Click on "BrightcoveVideoCloudPlayer.wsp" and then click "Deploy Solution" to deploy the solution:

  4. Proceed to activate the feature by clicking on "Site Actions/Site Settings -> Site Collection Administration -> Site collection features":

  5. Activate the "AE Some Web Part" feature:

< class="bcls-section">

Installing Proxy Server for the Brightcove API communication

Since the Connector is a client side JavaScript application, a proxy server is required to broker authenticated communication to the Brightcove API. More information can be found in the Brightcove API document.

A .net proxy App is provided in the Brightcove Video Connect package. The proxy server should be deployed in a web accessible location such as on Microsoft Azure. For security reasons, the proxy is designed to only allow connections from websites included in the web.config file that is installed with the proxy. The brightcove:origins key in the web.config file should include the SharePoint website URL for the BrightcoveConnector App as well as the website URL for the Site on which the BrightcovePlayer component will execute. See the example below:

<add key="brightcove:origins" value="https://brightcovecms-a3da847a1c9e33.sharepoint.com, https://brightcovecms.sharepoint.com" />

Multiple Sites can be listed as a comma separated string.

Launching Brightcove Video Connect for SharePoint

To launch the application, the user can click on the BrightcoveConnector App within the Site Contents listing, or click on a menu link if so configured by the SharePoint administrator.

In either case, the user will be brought to the Home Page of the Connector App. This page could be further configured by the client to include additional company specific messaging, additional links, etc. As described in the installation section, depending on the group membership of the user, they may or may not see the Account Management and Add Videos tabs.

The main navigation in the left column of the Connector is always present and allows the user to navigate all of the sections they have access to (see the section above regarding permissions). Below is a brief description of the purpose of each component of the Connector:

  • Home - The landing page when first entering the Connector.
  • Account Management - Provides the interface for entering the Brightcove Video Cloud account(s) information into SharePoint.
  • Add Videos - Upload new videos into Video Cloud. A video object is also created in SharePoint (except for the actual video file).
  • Manage Videos - Browse and edit existing videos as well as import videos from Video Cloud into SharePoint.
  • Manage Playlists - Create new playlists as well as browse and manage existing playlists.

There are also Add Video From Brightcove and Edit Video components that will be displayed in the main navigation when performing those operations.

Linking to Video Cloud Accounts

The Account Management section of Connector is used to enter the information for each of the linked Brightcove Video Cloud accounts that will be accessed in the Site. Brightcove accounts cannot be created from SharePoint, they must be created in Video Cloud first. The Brightcove account information must be entered into SharePoint as it is used when accessing the Brightcove API to communicate with Video Cloud. It also provides the means to assign access permissions specific to an account. For multi-account enterprise clients, it provides control over which users can access each account, and whether they can just browse or upload videos.

Account Management Landing Page

The Account Management Landing Page displays the current list of configured accounts, along with the assigned groups for Authors and Viewers.

  1. Account Title - Accounts currently configured (or at least created).
  2. AuthorsGroup - SharePoint group assigned "Author" rights for the account.
  3. ViewersGroup - SharePoint group assigned "Viewer" rights for the account.
  4. Add new account - Open the account creation screen to setup a new account.

Creating/Editing an Account

Whether creating a new account, or editing an existing account, the process and the options are the same. All of the account properties (except for the Author and Viewers groups) needs to be obtained from the Video Cloud account first. The following are the properties required for each account.

  1. Account Name - Name of the account. This name is only used in SharePoint so does not need to be the same as in Video Cloud.
  2. DefaultVideoPlayerId - Sets the default player for videos.
  3. DefaultPlaylistPlayerId - Sets the default playlist player.
  4. Account ID - The Brightcove Account ID from Video Cloud.
  5. ClientID - The Brightcove API Authentication Client ID.
  6. Client Secret - The Brightcove API Authentication Client Secret.
  7. Temporary Storage Location - The temporary storage location to be used during the uploading of videos and text track to Video Cloud. Drop down allows for the selection of either Amazon Web Services (AWS) or Dropbox.
  8. AWS Access Key ID - If using AWS, the Access Key ID is entered here.
  9. AWS Secret Access Key - If using AWS, the Secret Access Key is entered here.
  10. AWS Bucket Name - If using AWS, the AWS Bucket Name is entered here.
  11. Dropbox Account ID - If using Dropbox, the Dropbox Account ID is entered here.
  12. Dropbox Access Token - If using Dropbox, the Dropbox Access Token is entered here.
  13. Custom Fields - Used to map the custom fields created in Video Cloud for this account. See section Custom Field Mapping for more information.
  14. Author's Group, Viewer's Group - SharePoint side permissions definition groups for the account.
    1. Members of the Author's Group (in this case the SharePoint "Owners" Group) have the ability to perform functions in the account that require a write token such as adding a video, editing and updating an existing video, creating/editing a playlist, etc. They can also do all read type functions such as browsing and searching for videos and playlists.
    2. Members of the Viewer's Group (in this case the SharePoint "Visitors" Group) are only authorized for read type functions such as browsing and searching for videos and playlists.

To edit any of the properties in the above account list, the user can either click on the property name or its value (if present) to open the property popup dialog box:

Enter Account Credentials from Brightcove into SharePoint

In order for SharePoint to connect to Brightcove Video Cloud, the account credentials from Brightcove must be added to SharePoint. This section describes how to locate the account credentials in Brightcove. The following section describes how to add those credentials to the SharePoint connector.

  1. Log into Brightcove Video Cloud. Note the Publisher ID value.
  2. Navigate to Admin.
  3. Navigate to API Authentication.
  4. Register a new application.
  5. Name the application, set account access, and enable APIs.
  6. Note the Client ID and the Client Secret. You will need to enter them into SharePoint in the following section.

To set the Brightcove Account ID, select "Account ID" button and enter the Brightcove Publisher ID that you saved from the previous step on the following modal:

To set the Brightcove Client ID, select "Client ID" button and enter the Client ID that you saved from the previous step on the following modal:

To set the Brightcove Client Secret, select "Client Secret" button and enter the Client Secret that you saved from the previous step on the following modal:

  1. Value - Enter the value for the property. The value can be entered using cut and paste from the Video Cloud data, if available.
  2. Close - Close the property dialog box without making any changes.
  3. OK - Record the value in the property list and close the dialog.

Defining Video Cloud Players

To set the Player ID that should be used as the default single-video player in SharePoint, select the "DefaultVideoPlayerId" button enter the Player ID from Brightcove on the following modal:

  1. Value - Enter the value for the property. The value can be entered using cut and paste from the Video Cloud data if available.
  2. Close - Close the property dialog box without making any changes.
  3. OK - Record the value in the property list and close the dialog.

To set the Player ID that should be used as the default playlist video player in SharePoint, select the "DefaultPlaylistPlayerId" button and enter the Player ID from Brightcove.

Defining Custom Fields

When setting up an account in the Brightcove connector, Custom Fields that have been created in Video Cloud can be added to the account profile in the Connector so that they will appear in the Add Videos and Manage Videos areas, as well as have their values stored in SharePoint for search. When Custom Fields are mapped, they will be listed in the Custom Fields section of the Account Management screen, along with whether or not they are required fields:

To add, delete or edit custom fields, select the "Edit Custom Fields" button. The following modal window is displayed which lists ALL of the custom fields available for the account. NOTE - This list will ONLY be available once the new account is saved for the first time.

  1. Video Cloud Custom Field - Names of ALL the custom fields defined in Video Cloud for the selected account.
  2. Type - The type of custom field (Text or List).
  3. Required - Indicates whether the custom field is required. This definition is set in Video Cloud and cannot be changed from within the connector.
  4. Include - Make the custom field part of the account in the Connector so that it is displayed when Adding, Editing or Managing videos.

Linking to Dropbox or AWS S3 for Temporary Upload Storage

The Brightcove API requires that any files (video files, text track files) to be processed by Video Cloud must be uploaded to an intermediate location accessible by both the Brightcove connector as well as Video Cloud. AWS S3 and Dropbox are two recommended services that are available in the Brightcove connector.

Guidance on configuring these services to generate the information required in the Account setup section of the Brightcove connector can be found using the following links:

NOTE - Files uploaded to AWS S3 or Dropbox are not automatically deleted. It is recommended to set up policies on these services to automatically delete files after a period of time.

Temporary Storage Location Popup

To set the temporary storage location that should be used upload files, select the "Temporary Storage Location" button and select one of the storage options from the pulldown.

  1. Value - Select either Amazon Web Services or Dropbox for the temporary storage location.
  2. OK - Record the value in the property list and close the dialog.

Depending on your choice of storage location, select the "AWS Access Key ID", "AWS Secret Access Key", and "AWS Bucket Name" buttons to enter necessary configuration data for AWS S3 or select the "Dropbox Account Id" and "Dropbox Access Token" buttons to enter necessary configuration data for Dropbox.

Setting SharePoint Permissions

To set the SharePoint group that should be authorized as the Author's group, select the "Author's Group" button and select a group from the pulldown as demonstrated in the following modal.

Group Property Popup

  1. Select a group - Display all of the SharePoint groups that are available in the Site in which the Connector is installed.
  2. OK - Record the value in the property list and close the dialog.

To set the SharePoint group that should be authorized as the Viewer's group, select the "Viewer's Group" button and select a group from the pulldown.

IMPORTANT - The values for an account are not saved until the account "Save" button is clicked. Entering values in the property dialog boxes does not immediately save them in the account.

  1. Save Account - Commits all of the values set on the account properties into SharePoint.
  2. Delete Account - Removes the account from SharePoint. Warning - when this action is taken, all videos that have been imported to SharePoint under the account will no longer be accessible in SharePoint. It does not, however, delete the videos from Video Cloud.
  3. Cancel - Closes the account setup window without recording any of the changes.

Adding, Importing, and Deleting Videos

The SharePoint Connector allows a content author to upload videos from his local machine and edit metadata for the videos.

Add Videos

The Add Videos section of the Connector is used to upload new videos into Video Cloud. All of the data that is uploaded to Video Cloud with the exception of the video file itself is also stored in SharePoint, which makes it available for the Connector functions as well as for SharePoint search results. It also provides the SharePoint admin and users native access to the data without having to login to Video Cloud.

Add Videos supports both a single video as well as multiple videos (batch upload). When a user accesses Add Videos (if they have permission to do so) they are presented with the following fields which enable them to enter the metadata that will be sent to Video Cloud:

"Add Single Video " Landing Page

  1. Select Account (required) - This dropdown list will be populated with all accounts that the user is authorized to add videos to; this is enabled through the Account Groups assignment. The user must select an account to enable upload.
  2. Name (required) - Name of the uploaded video.
  3. Short Description - Short description for the video.
  4. Long Description - Long description for the video.
  5. Is Active (required) - Options for his dropdown are: Active, Inactive, Pending, Deleted. NOTE - If a video is uploaded with a state of Inactive, Pending or Deleted SharePoint will no longer be able to access the video information for any future edits. This is a function of the Brightcove API.
  6. Related Link URL, Related Link Text - The associated hyperlink and text displayed in the player for the video.
  7. Start Availability Date, End Availability Date - Define the dates of availability for the video. If defined, the video will not play outside of this date range.
  8. Economics - Options are Free and Ad Supported.
  9. Brightcove tags - Data tags that will be saved in the Video Cloud tag information in addition to being saved in SharePoint. These are separate and distinct from SharePoint Metadata tags which some clients will want to add to this interface, and which would only be saved in SharePoint (not transferred to Video Cloud).
  10. Custom Fields - The custom fields that have been added to the Connector for the selected account are displayed. Any description text defined in Video Cloud for the custom field is displayed below the field.
  11. Text Track files - Text tracks can be added to each uploaded video, either on first upload or on subsequent updates. See Adding Text Tracks.
  12. Image Details - The thumbnail and still images for the video will be generated in Video Cloud and returned through the API to the SharePoint connector. They will be viewable when the video is accessed via Manage Videos.
  13. Video File (required) - Clicking on the "Browse " button will open the local file system explorer to select the video file for upload.

Once the user clicks on the "Save" button, a validation check is run to verify all required fields are complete and the data is in the correct format. If the validation fails, the user will be prompted to complete the required fields or correct the invalid data. For example:

If there are no validation errors, the upload begins. During the upload, the following status modal is displayed to provide feedback on the upload progress:

Once the process completes, the user can "close" the status dialog and the following message is displayed in the Site:

The data is transferred to Video Cloud and also saved in SharePoint under the specified account and video name. A unique ID is also generated in SharePoint for each video uploaded. This ID (called the Reference ID) is transferred with the video into Video Cloud as an additional tag on the video.

"Add Multiple Video" Landing Page

By selecting the "Add Multiple Videos" option, the user can upload more than one video at a time. When this is selected, only the fields that would be shared amongst all the videos are displayed. Note that for multiple video upload, Video Cloud automatically assigns the video file name as the name of the video.

  1. Select Account (required) - This dropdown list will be populated with all accounts that the user is authorized to add videos to; this is enabled through the Account Groups assignment. The user must select an account to enable upload.
  2. Related Link URL, Related Link Text - The associated hyperlink and text displayed in the player for the video
  3. Start Availability Date, End Availability Date - Define the dates of availability for the video.
  4. Economics - Options are Free and Ad Supported.
  5. Brightcove tags - Data tags that will be saved in the Video Cloud tag information in addition to being saved in SharePoint. These are separate and distinct from SharePoint Metadata tags which some clients will want to add to this interface, and which would only be saved in SharePoint (not transferred to Video Cloud).
  6. Custom Fields - Custom fields that have been added to the Connector for the selected account are displayed. Any description text defined in Video Cloud for the custom field is displayed below the field.
  7. Video File(s) (required) - Clicking on the "Choose File" button will open the local file system explorer to select the video file for upload. To add multiple files, click on the "Add another file" button which adds another file selection option. To remove a selected file from the list, click the "Remove" button under that file, or select another file to replace it. Clicking "Save" begins the upload and displays the upload dialog box to provide status. Once upload is complete, the dialog can be closed and the success message is displayed.

Clicking "Save" begins the upload and displays the upload dialog box to provide status. Once upload is complete, the dialog can be closed and the success message is displayed.

Adding Text Tracks

Text tracks can be added to any video either on first upload or on subsequent updates. A video can have one or more text tracks associated with it. The user can select the type of text track to be added to the video (File Upload, URL Upload or Remote URL). If "None" is selected, the section will not display any of the fields.

IMPORTANT: A single video will NOT support a mix of File Uploads, URL Uploads or Remote URLs. Only one type of text track can be associated with each video.

File Upload

When "File Upload" is selected for Text Track Files, the following fields are displayed:

  1. Select Type of Text Track - Allows for the selection of File Upload, URL Upload or Remote URL.
  2. File Chooser - Selection of the text track file.
  3. Text Track properties - Set properties associated with the text track. Clicking "Add" adds the text track to the video data on next upload/update.
    1. Language - The two-letter code (valid BCP 47 language tag) for the language of the text track, for example "en" for English.
    2. Label - The label for the track that will be visible to the user, such as in a menu that lists the different languages available for subtitles.
    3. Kind - One of the five supported track types listed
  4. List of added/queued text tracks - Displays the list of existing text tracks and new text tracks that are queued to upload on the next save. A text track can be deleted by clicking the "Remove" link and Saving the video.

URL Upload, Remote URL Upload

Selecting one of these options replaces the "File Upload " upload with a text field in which to put the fully qualified URL path to the text track file.

  • URL Upload - Enter the public URL where the text track file resides and then click Upload. The file will be uploaded to Video Cloud.
  • Remote URL - Enter the public URL where the text track file resides. The URL must be less than 250 characters. Captions will be loaded from the remote URL.
  1. Select Type of Text Track - Allows for the selection of File Upload, URL Upload or Remote URL.
  2. Add URL - Field to enter the fully qualified URL path to the text track file.
  3. Text Track properties - Allows the setting of the properties associated with the text track. Clicking "Add" adds the text track to the video data on next upload/update.
    1. Language - The two-letter code (valid BCP 47 language tag) for the language of the text track, for example "en" for English.
    2. Label - The label for the track that will be shown to the user, such as in a menu that list the different languages available for subtitles.
    3. Kind - One of the five supported track types listed.
  4. List of added/queued text tracks - Displays the list of existing text tracks and new text tracks that are queued to upload on the next save. A text track can be deleted by clicking the "Remove" link and Saving the video.

Manage Videos

The Manage Videos section of the Connector is used to browse and manage existing videos. This includes editing and updating of existing videos as needed. The search functionality is used to find videos by search name, description and tag information.

Manage Videos Landing Page

The Manage Videos Landing Page displays the list of the fields that can be used to browse or search for videos in the available accounts:

  1. Select Account - This dropdown list will be populated with all accounts that the user is authorized to access; this is enabled through the Account Groups assignment. The user must select an account to view any video listings.
  2. Search - Filter the video results to those containing the term. Name, tags and description information along with SharePoint metadata fields, if defined, are searched. It is only possible to search in one account at a time; cross account searching is not supported.
  3. Display SharePoint only or Video Cloud only - Filter the videos to only those that are recorded in SharePoint, or those that are only resident in Video Cloud and have never had their data imported into SharePoint.
  4. Sort/order filters - Used to sort and order any results by the parameters listed to help find videos more quickly.

Viewing a Video Listing in an Account

Once an account is selected, the list of available videos for that account is displayed:

  1. Select Account - This dropdown list will be populated with all accounts that the user is authorized to access;t his is enabled through the Account Groups assignment. The user must select an account to view any video listings.
  2. Display SharePoint only or Video Cloud only - The purpose of this option is to filter the videos to only those that are recorded in SharePoint, or those that are only resident in Video Cloud and have never had their data imported into SharePoint.
  3. Sort/order filters - Used to sort and order any results by the parameters listed to help find videos more quickly.
  4. Paging controls - Each page will display up to 5 video listings. When more than 5 are present, the paging controls will appear.
  5. Video listing - Each video listing contains the following:
    1. Video Name - Clicking on the name will open the video for editing of its data.
    2. Short Description
    3. List of the tags associated with the video (does not list the Reference ID even though it is saved in Video Cloud as a tag).
    4. The "Edit Video" link. This link (or clicking on the Name) is used to open the video for edit if the current user has permission.
    5. Video ID: This is the Video Cloud video ID. This ID will be listed once the video is edited (even with no changes) and saved for the first time after upload.

Importing a Video Cloud Only Video into SharePoint

If there is a video that was uploaded directly into Video Cloud and not through the Connector, it is possible to "import" data for that video into SharePoint so that it can be managed in SharePoint moving forward. To do this, first find the video using the "Video Cloud only" listing option (1):

Then click on either the video name or Edit Video link to open the video in edit mode as described in the following sections. Once the video is saved in the edit mode, the data will also be stored in SharePoint and the video will appear in the "SharePoint Only " section.

IMPORTANT - The SharePoint connector only syncs data from SharePoint to Video Cloud and not Video Cloud to SharePoint. This means once you import a video from Video Cloud to SharePoint, any changes to meta data need to be made in SharePoint and any changes to meta data made in Video Cloud will not be updated in SharePoint and will get overwritten the next time that video is edited in SharePoint.

Editing Existing Videos in an Account

To edit existing videos in order to update their data fields, the user can click on either the name (1) or the Edit Video link (2) in the video listing:

The Edit Video screen will appear, with the data for the selected video displayed for edit:

  1. Note that "Edit Video" is displayed in the left main navigation where Add Videos is usually displayed. This is because it uses the same page form, just in a different mode since it is an existing video. This also lets the user easily navigate back to the Manage Videos section if needed.
  2. There are certain fields that are not available for edit/update during this process:
    • The Account the video is associated with cannot be changed as videos cannot be transferred between Video Cloud accounts.
    • The Reference ID (the Video Cloud video ID) cannot be changed.
    • The SharePoint ID cannot be changed.

All other displayed fields, excluding images which are autogenerated by Video Cloud, are available for update just like the first time the video was uploaded. Once the changes are made, the user clicks the "Save" button to commit the changes. The same validation that runs on Add Videos upload is also performed here.

Deleting Videos

Deleting videos from SharePoint is performed outside of the connector. To delete a video in SharePoint, navigate to Site Contents->Videos where you can find and delete the video.

IMPORTANT - Deleting the video recorded in SharePoint does not delete the video in Video Cloud and leaves the video in Video Cloud with some tags that were used to link the video to SharePoint. If you want to import the video into SharePoint again in the future, the tags beginning with "bcsp-" need to be removed.

Under Manage Videos, the user can enter a search term to find videos in the selected account that have a name, description, or tag information that matches the search term. Once the results list is displayed, all of the sorting and order filters can be applied.

  1. Search field - The user can enter the search term(s) here and click the magnifying glass (or hit return) to execute the search.
  2. Display SharePoint only or Video Cloud only - Filter the videos to only those that are recorded in SharePoint, or those that are only resident in Video Cloud and have never had their data imported into SharePoint.
  3. Sort/order filters - Used to sort and order any results by the parameters listed to help find videos more quickly.

Adding, Importing and Deleting Playlists

The Manage Playlists section of the Connector is used to create new playlists as well as browse and manage existing playlists, including editing and updating. Unlike videos, playlist information is not stored in SharePoint, but rather retrieved from Video Cloud each time an account is browsed in this section. For this reason, there are some delays inherent in the availability of playlist data through the API which will be called out in the following sections.

Manage Playlists Landing Page

The Manage Playlists Landing Page displays the list of the fields that can be used to browse for playlists or create new ones in the available accounts:

  1. Select Account - This dropdown list will be populated with all accounts that the user is authorized to access; this is enabled through the Account Groups assignment. The user must select an account to view any playlist listings.
  2. Playlist display columns - Playlist data will be displayed in these columns. The results can be sorted by any column by clicking on the column heading.
  3. Add New Playlist - Click this button to create a new playlist in the selected account.

Once an account is selected, all the playlists for that account are displayed.

  1. Select Account - This dropdown list will be populated with all accounts that the user is authorized to access; this is enabled through the Account Groups assignment. The user must select an account to view any playlist listings.
  2. Playlist display columns - The listings can be sorted by any column by clicking on the column heading. This can help find a playlist if the listing get long.
  3. Playlist listing - Each playlist listing contains the following:
    1. Playlist Name - Clicking on the name will open the playlist for editing of its data.
    2. A list of video IDs that are active in the playlist.
    3. Short Description.
    4. Type of playlist - Manual or Smart Playlist.
    5. The ID of the playlist (Video Cloud playlist ID).
    6. The "Edit Playlist " link. This link (or clicking on the Name) is used to open the playlist for edit or to view its details.
  4. Add New Playlist - Click this button to create a new playlist in the selected account.

Adding a New Playlist

To add a new playlist into an account, the user clicks on the "Add New Playlist" button. This opens the Add Playlist form:

 

Note that videos can be moved up and down in the playlist by selecting the video to move, and enabling the "Move Video" option to use the Up/Down buttons. Multiple videos can be moved at a time.

  1. Name - The name of the new playlist.
  2. Description - A brief description for the playlist.
  3. Type - The type of playlist - Manual or Smart. This example shows a Manual Playlist. The example in the "Editing a Playlist" section shows the options for a Smart Playlist.
  4. Available Videos - In the case of a Manual Playlist, display the search box and the list of videos available in the account. This allows the user to narrow the video choices to add to the playlist.
  5. Available videos listing - List available videos in the account or filter based on the search term. One or more videos can be selected by clicking on the videos. Selected videos are highlighted in green. To deselect a video, the user clicks on it again. This allows multiple videos to be moved into the playlist in one action.
  6. Action Arrows - Move selected videos in and out of the playlist.
  7. Videos in this Playlist - The current videos in the playlist are displayed here.
  8. Save - Commit the changes and start the process of creating the new playlist in Video Cloud. NOTE - Playlists are not saved in SharePoint.

Editing an Existing Playlist

Editing an existing playlist is started by clicking either on the name or on the "Edit" link in the playlist listing. This opens the following view to edit the playlist options. This example shows the options for a Smart Playlist. When editing any of the fields, with the exception of the Playlist ID and Account, can be modified:

  1. Name - The name of the playlist.
  2. Description - A brief description for the playlist.
  3. Type - The type of playlist - Manual or Smart. This example covers the options for a Smart Playlist.
  4. Tags - In the case of a Smart Playlist, this field allows the user to specify criteria and the tag(s) to use to identify the videos to be dynamically included in the playlist.
    • Criteria dropdown includes "Contain one or more" or "Contain all".
  5. Order - This allows the user to specify how the order of the matching videos is set. The selections include the following:
    • Alphabetical
    • Activated Date (newest first)
    • Activated Date (oldest first)
    • Total Plays
    • Trailing Week Plays
    • Start Date (oldest first)
    • Start Date (newest first)
  6. Limit to - Sets the maximum number of videos that will be included in the playlist based on the selected criteria.
  7. Preview - List videos which match the criteria and display them in the "Videos in this Playlist" window.
  8. Save - Commit the changes and start the process of updating the playlist in Video Cloud. NOTE - Playlists are not saved in SharePoint.
  9. Delete Playlist - This option will mark the playlist as deleted in Video Cloud. The playlist will no longer appear in the Connector playlist listing.

Adding Video to a SharePoint Site

The SharePoint connector allows content authors to insert media into their Sites in a variety of ways. This chapter covers the options that are available.

Brightcove Player Web Part for SharePoint On-Premise

The Brightcove Player Web Part Sandbox Solution generates a web part that is placed on a Site page in the internal or external website and plays the Brightcove video. SharePoint online restricts the ability of users to add in custom Web Parts so this mechanism for inserting videos is only available for on-premise SharePoint installations.

The Web Part has also been augmented with some of the same features in the management console including Account Selection and advanced search with sorting and ordering to find videos and playlists faster.

To view the Player Web Part options, the SharePoint page needs to be in "Edit" mode (1) which will expose the option to edit the Web Part (2). The Web Part specific options are found in the "Brightcove Configuration" section (3) of the Web Part editor.

Expanding the Brightcove Configuration section reveals the updated features of the Player Web Part Sandbox Solution.

Selecting a Video to Play in the Web Part

  1. Brightcove Configuration - This section of the Web Part editor provides access to the parameters for configuring the Web Part and selecting the videos/playlists to be played.
  2. Player Width, Player Height - Set the dimensions of the player.
  3. Player ID - Specify the ID of the player to be used. It is important that the player selected is from the same account as the selected video if it is a multi-account environment. There is no "chooser" for the player, so the ID from Video Cloud must be entered in manually.
  4. Video ID - The Video ID field is populated using a video chooser. If the user clicks on the ellipses box to the right of the field, the Chooser window is displayed.
  5. Chooser Window
    • Select Account - Display the accounts that the current user has permission to access.
    • Available Videos - Filter the video results to those containing the term. Name, tags and description information along with SharePoint metadata fields, if defined, are searched. It is only possible to search in one account at a time; cross account searching is not supported.
    • Sort by and Order by
    • Video listing window - Clicking on a video will select it for playing. The listing is limited to displaying 30 videos, so not all videos in the account may display when first selecting an account. Using the search functionality allows for refining the list to find the desired video.
    • OK button - Commit the selection and populate the Video ID field with the appropriate ID value.

Once the Player ID and the Video ID are set, the Web Part is configured and ready to play!

Selecting a Playlist to Play in the Web Part

The process to select a Playlist to be played is almost identical to selecting a video.

  1. Brightcove Configuration - This section of the Web Part editor provides access to the parameters for configuring the Web Part and selecting the videos/playlists to be played.
  2. Player Width, Player Height - Set the dimensions of the player.
  3. Player ID - Specify the ID of the playlist player to be used. It is important that the player selected is from the same account as the selected video if it is a multi-account environment and that it is configured to display a playlist. There is no "chooser" for the player, so the ID from Video Cloud must be entered in manually.
  4. Playlist ID - The Video ID is populated using a video chooser. If the user clicks on the ellipses box to the right of the field, the Chooser window is displayed.
  5. Chooser Window
    • Select Account - Display the accounts that the current user has permission to access.
    • Sort by and Order by
    • Playlist listing window - Clicking on a playlist will select it for playing. The listing is limited to displaying 30 playlists, so not all playlists in the account may display when first selecting an account. Using the search functionality allows for refining the list to find the desired playlist.
    • OK button - Commit the selection and populate the Playlist ID field with the appropriate ID value.

Once the Playlist ID and the Video ID are set, the Web Part is configured and ready to play!

Brightcove Player Solution Package for SharePoint Online or SharePoint On-premise

The Brightcove Player Solution Package generates embed for a player for Brightcove video that is embedded onto a page copying/pasting the embed code into the Embed Code dialog box. This package can be used for both SharePoint Online or SharePoint On-premise.

Usage

SharePoint Buttons

When editing a SharePoint Site page, the "Brightcove" action group will be displayed on the ribbon:

Select either the Brightcove Video or Brightcove Playlist option.

Selection Dialog

The selection dialog will allow the user to select a Video or Playlist (depending on what option was selected in the ribbon). The dialog allows you to search Video Cloud videos and playlists and displays the results in a grid:

Upon selection of a video or playlist, the user can optionally change the player, height and width. After clicking "Ok", the script for the brightcove player will be generated and placed in the textarea at the bottom of the dialog.

This script can then be added to the SharePoint page in 2 different ways:

  • Directly into a publishing zone
  • By way of a Script editor Web Part, on pages that only allow Web Parts

NOTE - This script is automatically copied to the user’s clipboard.

Adding the script to a SharePoint page

Note: The procedure described below is for a publishing zone; for a page that allows only Web Parts, once a script editor Web Part is on the page, the procedure is the same.

To add the script to the page, after obtaining the generated script from the selection dialog, click into a publishing zone. From the "Insert" tab, look for the "Embed Code" button.

In the resulting dialog, paste in the player embed script. Click "Ok". This will insert a script editor onto the page:

After the page is saved, that script editor will render as the Brightcove player:


Comments or suggestions?