Main Configuration Settings

Main parameters - settings.json

It is important that the file is formatted in valid JSON and contains the following values.

Name	Description	Required
General
title Type: String	Page title shown in navigation bar and browser tab	no, default: "WebDigAIRange"
program Type: String	Program name as used by BCS	yes
license Type: String	License key provided by David Systems to toggle additional features.	no
URL
service Type: URL as String	URL of the BCS Service	yes
restService Type: URL as String	URL to the REST interface of the Service Note: Add trailing slash "/"	yes
audioURL Type: URL as String	URL to audio file upload handler of BCS Service	yes
audioStreamURL Type: URL as String	URL to the audio file handler of the BCS Service Note: The File check task of the BroadcastUtilityServer (BUS) must be configured accordingly in order to create prelisten files.	yes
waveformURL Type: URL as String	URL to waveform file handler of the BCS Service Note: The File check task of the BroadcastUtilityServer (BUS) must be configured accordingly in order to create waveform files.	yes
Features
Features\\nodeLocking	Toggle network messages and user interface for node locking, when editing meta-data. Note: This is a temporary feature flag.	no, default: false
Overview
Overview\\defaultHeight Type: Integer as pixel value	Height of one hour in calendar overview in pixels	no, default: 70
Overview\\firstDay Type: Weekday as String	First day of the week in calendar overview. Can be any of "Monday", "Tuesday", "Wednesday", "Thursday", "Friday", "Saturday", "Sunday"	no, default: Monday
Overview\\calendarListView Type: Boolean	Set true to make the List view the default view in the calendar overview. If set to false, the default view is the Timeline view. (Timeline view/List view)	no, default: false
Overview\\dragDropFillWidth Type: Boolean	Set draggable area on shows to full width or drag helper on the bottom left true nodes are draggable everywhere false nodes can only be dragged at the left side Note: Always false on small screens	no, default: true
Language
locale Type: String	Specify localization. Valid: en-us, de-de	no, default: en-us
Storybox
StoryBox\\minimizeTextElement Type: Boolean	Set true to hide the element information in StoryBox mode for text elements	no
StoryBox\\minimizeAudioElement Type: Boolean	Set true to hide the element information in StoryBox mode for audio elements	no
Editor
Editor\\fontFamily Type: String	Set default font family for text editor	no, default: "Roboto"
Editor\\fontSize Type: Integer as pixel value	Set default font size for text editor	no, default: 14
Editor\\lineHeight Type: Float	Set default line height for text editor	no, default: 1.0
Parameter Service
ParameterService\\host Type: String	URL of Parameter Service	no
Content Service
ContentService\\restService Type: URL as String	URL to REST API of Content Service	no
ContentService\\defaultTable Type: String	ID of the table that is loaded first. The ID is a combination of the DSNname and the tablename separated by two backslashes "\\". Example: "MyServer\\MyTable"	no
ContentService\\refreshInterval Type: Seconds as Integer	Interval to automatically reload table data in seconds. A value of 0 disables the automatic refresh. Note: Requires DPE version 2.4.56.0 or higher.	no, default: 15 [seconds]
Print
Print\\element Type: Boolean	Set print button for elements	no, default: false
Print\\group Type: Boolean	Set print button for groups	no, default: false
Print\\story Type: Boolean	Set print button for story	no, default: false
Print\\textLineHeight Type: Float	Set line height for printed RTF text	no
Print\\Show\\skipAudioElements Type: Boolean	Skip audio elements which has no text from printing a show	no, default: true
Menu
Menu\\OpenCM Type: Object	To open DPE application in a new tab with the same authentication. Warning: Deprecated, will be removed with version 6.2. Use Menu\\buttons instead.	no
Menu\\buttons Type: Array of Objects	Define buttons to display in the top navigation bar, next to the program selection. Each button is configured as an object with two attributes: name: String url: URL as String addDpeToken: Boolean Add DpeToken to URL for logging into David Systems applications. Example: JSON `[{ "label": "Content Manager", "url": "http://cm.example.com/" }]`	no
Transitions
Transitions\\autoDuckEnabled	Auto duck on/off	no
Transitions\\autoDuckGain	refers to the adjustment of audio volume during a voice-over. If the value is greater than 1, it will increase the volume of the audio, and if it's less than 1, it will decrease the volume of the audio during a voice over.	no
Transitions\\autoDuckDuration	The rate at which the fade curve changes, measured in milliseconds (ms).	no
Others
prelistenEndOffset Type: Integer	Offset for prelistening the end of an element in seconds	no, default: 20
Scheduling\\views Type: Array	Array of configurations for Scheduling Pages. (See Scheduling page)	no
Shortcuts Type: Object	Object of Shortcut definitions. (See Shortcuts page)	no
iframePage Type: Object	Creates a page for embedding another web page	no

An example settings file may look like this:

Example

JS

{
	"title": "WebDigAIRange",
	"program": "Program 1",

	"service": "ws://192.168.178.33:8085/",
	"restService": "https://192.168.178.33:8081/bcs/",

    "audioURL": "http://192.168.178.33:8081/bcs/AudioFile?Id=%@",
	"audioStreamURL": "http://192.168.178.33:8081/bcs/PrelistenFile?Id=%@",
	"waveformURL": "http://192.168.178.33:8081/bcs/WaveFormFile?Id=%@",
    "rtfURL": "http://192.168.178.33:8081/bcs/RtfFile?OutputFormat=1&Id=%@",

    "Overview\\defaultHeight": 90,
    "Overview\\firstDay": "Monday",
	"Overview\\calendarListView": false,
    
    "StoryBox\\minimizeTextElement": true,
    "StoryBox\\minimizeAudioElement": true,

	"Editor\\fontSize": 16,
	"Editor\\lineHeight": 1.6,
	"Editor\\fontFamily": "Times New Roman, Times, serif",
    
    "ParameterService\\host": "http://10.1.4.80/DpeWebApplication/",

	"ContentService\\restService": "https://cm.davidsystems.com/DpeWebApplication/api/",
	"ContentService\\defaultTable": "WebDA\\webDA",
	
	"Transitions\\autoDuckEnabled": true,
	"Transitions\\autoDuckGain": 0.15,
	"Transitions\\autoDuckDuration": 400,

	"Print\\element": true,
	"Print\\story": true,
	"Print\\group": true,

	"prelistenEndOffset": 10,

    "Scheduling\\views": [],

	"Shortcuts": {},

	"iframePage" : {
		"title":"ROAD",
		"icon": "si-glyph-road.svg",
		"url": "http://davidqa-nas3/HTML/RecordingPlaybackForCC/RecordingPlaybackForCC.html"
	}
}

Confirm Validity

Modifying the file settings.json can easily introduce errors, because it must follow strict JSON specifications. Two mistakes are most common:

Missing comma at the end of a line.
Missing quotes for the parameter name (string to the left of the colon).

It is recommended to run any modifications to settings.json trough a JSON linter, which checks the code for validity. An easy to access and free solution can be found under: http://www.jsonlint.com/

Simply copy and paste the full contents of settings.json and click “Validate JSON”.

Parameter Service

Instead of the settings file parameters can also be stored in the Parameter Service. If the Parameter Service is configured in settings.json, WebDigAIRange will first try to read a parameter from the settings file and fall back to the Parameter Service if it was not found.

The Menu\\OpenCM object will add a new menu to the top bar and allows to open the DPE application using the same WebDigAIRange authentication.

Note: Deprecated, will be removed with version 6.2. Use Menu\\buttons instead.

Name	Description	Required
^name ^{Type: String}	The name of the option to display in the top bar	yes
^url ^{Type: URL as String}	The url of the DPE application	yes

Example

JS

"Menu\\OpenCM": {
	"name": "Open CM",
	"url": "http://vm-dpedemo/DpeWebApplication/Logon.aspx"
},