Table of Contents

Site configuration view in Manager UI

Site configuration view is available to VividWorks Admin and Tenant Admin users.

Site configuration view currently allows restriction of access to the data from arbitrary hosts and domains and Seeting the measurements in unit system and unit lengths.

There are 3 tabs for configuration

  1. Allowed Sources - restricting placement of the planner to specific host sites (URLs)
  2. Unit System - utilizing SI or Imperial system for the measurements
  3. Theme - customizing the Planner theme
  4. Branding - customizing branding in PDF

Site configuration view - Allowed sources tab

Site configuration view

From here you can restrict the access for a planner instance only from certain domains and pages.

Each product library may have a set of domains and pages in form of URLs that can access the product library data.

In order for the restrictions to work, you must have listing of allowed domains defined and "enable allowed sources" selected. If no allowed hosts is listed and/or "Enable allowed sources" is not selected, no restrictions apply.

Select a product library to configure

You can assign urls for each product library that can be selected from the dropdown above.

Add and remove new allowed source

Insert the text in FQDN format in the textbox below and then press "Add".

Site urls can be deleted by pressing the "delete" icon on each row.

Enable or disable allowed sources handling

To turn on restriction to only allowed list, select the checkbox for "Enable allowed sources". To disable restrictions, unselect the checkbox for "Enable allowed sources".

Note

The intention for this feature is to restrict unauthorised access to the configurator data by only permitting named sites to have access.

Site configuration view - Unit system tab

From here you can set the measurement units being displayed in the 3D view.

Site configuration view

You can select the system unit and length unit.

Possible values for the system unit:

METRIC : "metric" IMPERIAL: "imperial"

Possible values for the length unit:

For metric unit system:

MILLIMETER: "mm" CENTIMETER: "cm" METER : "m" KILOMETER: "km"

For imperial unit system:

INCH: "in" FEET: "ft" YARD: "yd" MILE: "mi"

Site configuration view - Theme tab

From here you can configure the colors of some of the CSS elements of the planner.

You can set the CSS attributes for the element of the planner UI Select CSS color

The attributes that can be edited are:

Base:

  • Background color
  • Border color
  • Primary Text Color
  • Secondary Text Color

Primary Action Button:

  • Background color
  • Border color
  • Text color
  • Border radius
  • Box shadow

You can see where these take effect in the following image where

  • 3D Scene is configured for Blue
  • Background color is set to Purple
  • Border color is set to Green
  • Primary Text Color is set to Dark Blue
  • Secondary Text Color (not shown) is set to Black

Example configuration

After saving, return to Products view and regenerate runtime products for the theme to be applied. Note that due to CDN and caching the theme edits may take a while before they are applied in production and testing is easiest using the Manager UI View Product feature

NOTES:

  • The settings affect all parts of the application, therefore Border Color adjusts also borders of summary
  • Primary Text Color affects most text on the planner and summary
  • Secondary Text Color affects specific lines in summary