Skip to main content
Skip table of contents

Preparing settings.json

Starting with version 3.x, ContentManager is an independent, standalone web application that can be hosted in any web server and on any platform.

It is not part of the DPE setup anymore, which previously installed web frontends and web services as one monolithic application inside Microsoft IIS.

Therefore you need to tell ContentManager how to connect to the DPE Services backend. This is done in the ContentManagser settings.json file using the parameter serviceRootAddress.

If you want to skip to be asked for the computer name during login you can configure the defaultComputerName. The configured machine name will be used for all users where the machine name cannot be auto-detected or is not specified manually.

Example:

CODE
{
  "serviceRootAddress": "https://dpe.davidsystems-test.com/DpeWebApplication"
  "defaultComputerName": "MyComputerNameFallback",
}  

Application Switcher Menu

Content Manager includes a built-in app switcher that allows users to toggle between native Content Manager applications such as Subclip Editor, and RoughCut Edit, depending on their access rights.

Additional applications like Admin and System Monitor - which now are considered external to CM - can be added to the app switcher as needed. These apps can be configured in two locations:

  1. Settings.json file in the public folder of Content Manager

  2. Parameters in Admin located in ContentManager|AppMenu.

Settings.json has higher priority over Parameters in Admin.

Configuration of the app switcher is done via the appMenu object, which defines the navigation menu items. Each item represents a clickable menu entry.

Below properties can be added in either Settings.json or Admin parameters.

Key

Type

Description

title

string

Human readable string that will be displayed as the application name in the UI.

link

string

The URL that the menu item points to. When the user clicks on the menu item, they will be redirected to this link.

icon

string

Specifies the icon associated with the menu item. This is typically a name or identifier for an icon within the icon library used by the application.

iconSize

string

Defines the size of the icon. The size is usually specified in pixels (e.g., "30px").

backgroundColor

string

The hexadecimal background color of the menu item.

actionRight

string

Represents the action or permission required to open the menu item. This property is typically used for authorization purposes to ensure that only users with the necessary permissions can access the menu item.

displayIndex

number

The display order of the menu item relative to other items in the appMenu. Items with a lower displayIndex value appear earlier in the menu.

forwardToken

boolean

Indicates whether the authentication token should be forwarded to the clicked menu item.

name

string

The internal name of the menu item.

Example with possible values:

CODE
{
  "serviceRootAddress": "https://dpe.davidsystems-test.com/DpeWebApplication",
  "defaultComputerName": "",
  "_useWcf": false,
  "appMenu": [
    {
        "title": "Admin",
        "link": "https://dpe.davidsystems-test.com:41643",
        "icon": "davidsystems-admin",
        "iconSize": "30px",
        "backgroundColor": "#1B58B8",
        "actionRight": "DpeAdmin.Open",
        "displayIndex": 50,
        "forwardToken": true,
        "name": "Admin"
    },
    {
        "title": "System Monitor",
        "link": "https://dpe.davidsystems-test.com:41643/#/system-monitor",
        "icon": "davidsystems-systemMonitor",
        "iconSize": "30px",
        "backgroundColor": "#fe7c22",
        "actionRight": "DpeSystemMonitor.Open",
        "displayIndex": 40,
        "forwardToken": true,
        "name": "SystemMonitor"
    }
  ]
}

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.