Introduction 

The VidiCore Admin Tool is an application that facilitates the management of entity data in VidiCore systems. The application visually expresses all VidiCore API endpoints within a consistent user experience, while also granting users a means to view lists or entities, forms that allow entry of any possible value within the schema, and actions to create/update/remove entities.

The key features of the application are centered on granting the user the ability to view and edit API endpoint data and entities, such as configuration parameters, user data et cetera, in a consistent user interface.

At its core, the Vidicore Admin Tool is a lightweight application requiring minimal configuration. The only prerequisite is a live instance of VidiCore.

Using the Application  

For this guide, we assume that you have a VidiCore instance running. This can be running either inside VidiNet or as a standalone local instance.

VidiCore Version Compatibility

Your VidiCore system needs to be version 4.17 or later in order to use this theme application.

Accessing the Application

The VidiCore Admin Tool runs as a serverless one-page application. The latest compiled version can be found here: https://vidispine.github.io/admin-tool . This version can be run towards any VidiCore system.

If you want to pull and run the Admin Tool as a Docker container, there are images readily available on Dockerhub: https://hub.docker.com/repository/docker/vidispine/admin-tool

Prerequisite: Add CORS Configuration to VidiCore  

In order to use the Github-hosted application towards your VidiCore system, the following CORS configuration must be added in VidiCore. This can be done in the console of your choice or via Postman. 
PUT /API/configuration/cors

<CORSConfigurationDocument xmlns="http://xml.vidispine.com/schema/vidispine">
 <entry>
  <request>
   <origin>https://vidispine.github.io/admin-tool</origin>
  </request>
  <response>
   <allowOrigin>https://vidispine.github.io/admin-tool</allowOrigin>
   <allowMethods>OPTIONS,GET,HEAD,POST,PUT,DELETE</allowMethods>
   <allowHeaders>accept,content-type,authorization,index,size,runas</allowHeaders>
   <allowMaxAge>600</allowMaxAge>
 </response>
</entry>
CODE

Erroneous or missing CORS configuration will render an error in the application login screen

Defining the VidiCore API Endpoint 

Enter the API endpoint URI of your VidiCore system in the application’s login screen. Log in to the application using the username and password of a user account in your VidiCore system.

Directing the application towards a VidiCore API endpoint in the login screen

Accessing the Source Code 

The VidiCore Admin Tool source code can be found on GitHub: https://github.com/vidispine/admin-tool

Access Denied or no GitHub account?
Create an account here https://github.com/join and then send your GitHub username to info@vidispine.com with a request to obtain access to the Theme for VidiCore from the Vidispine Repository.

With access to the repository in GitHub you will be able to modify and run the application locally. Remember to adjust your CORS settings for the application to run correctly.

Using the Application 

The Main View

Immediately after the login the content pane is completely empty. Use the function menu in the top left to display a categorized sorting of API endpoints available in this application. You can also use the search-window to find the API endpoint you want to work with.

View and Edit Endpoint Entities

Endpoint data can be edited by toggling the EDIT button.

Note: all changes will be saved to your VidiCore instance regardless if the data entered is technically correct or not.