Global configurations

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<centerZoom> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <centerZoom>14</centerZoom>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<chartsProvider> of the file optima-configuration.xml.

Example 1: the default setting (all providers are feeding into TS charts)

<appSettings>
.....
     <!-- all possible providers are given here -->
     <!-- <chartsProviders>JSONCONF["tre", "ml", "harmonizer", "trafficstate", "kpi"]</chartsProviders> -->
.....
</appSettings>

Example 2: only two providers, tre and harmonizer, are feeding into TS charts

<appSettings>
.....
     <!-- all possible providers are given here -->
     <chartsProviders>JSONCONF["tre", "harmonizer"]</chartsProviders>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<checkPathLenght> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <checkPathLength>1000000</checkPathLength>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<customBGMap> of the file optima-configuration.xml.

Example 1:

<appSettings>
.....
	<customBGMap>[{
          "url": "https://dars-gis.geoprostor.net/ewMapOGC/ogc/wmts",
          "url_params": {
              "SERVICE": "WMTS",
              "REQUEST": "GetCapabilities"
           },
           "name": "WMST test",
           "layerOptions": {
              "layer": "osm",
              "matrixSet": "WebMercatorQuad",
              "projection": "EPSG:3857"
            }
        }]</customBGMap>
.....
</appSettings>	

Example 2:

<appSettings>
   …																								
    <customBGMap>				
    JSONCONF[
    {
      "name": "osm",
      "url": "http://ows.terrestris.de/osm-gray/service",
      "layerOptions": {
      "layers": "OSM-WMS"
     }
    },
    {
      "url": "https://a.tile.openstreetmap.fr/osmfr/${z}/${x}/${y}.png",
      "name": "OSM France"
    },
    {
      "url": "https://dars-gis.geoprostor.net/ewMapOGC/ogc/wmts",
      "url_params": {
      "SERVICE": "WMTS",
      "REQUEST": "GetCapabilities"
    },
      "name": "WMTS test",
      "layerOptions": {
      "layer": "osm",
      "matrixSet": "WebMercatorQuad",
      "projection": "EPSG:3857"
     }
    }
    ] 
    </customBGMap>
   …
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<defaultLanguage> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <defaultLanguage>ITA</defaultLanguage>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<documentationUrl> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <documentationUrl>/optima-docs/PTV-Optima-Help-Center_CSH.htm</documentationUrl>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<drivingSideRule> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <drivingSideRule>0</drivingSideRule>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<enabledEventRoadLocationTypes> of the file optima-configuration.xml.

Example:

<TrafficSupervisor>
  <appSettings>
  ...
    <enabledEventRoadLocationTypes>JSONCONF["road", "roadKm", "tmc"]</enabledEventRoadLocationTypes>
  </appSettings>
  ...
</TrafficSupervisor>

The JSON object is placed in the tag <configuration>/<TrafficSupervisor>/<AppSettings>/<enabledEventsTypes> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <enabledEventsTypes>JSONCONF
   ["road", "routing", "signal"]
   </enabledEventsTypes>
.....
</appSettings>

An example of TS GUI where the value signal is not specified:

<appSettings>
.....
   <enabledEventsTypes>JSONCONF
   ["road", "routing"]
   </enabledEventsTypes>
.....
</appSettings>

If the value signal is specified, a new accordion pane associated to the SIGNAL event type is shown in the GUI.

In TS you can enable or disable the display of a workspace (→ Control Room dashboard).

The JSON object is placed in the tag <configuration>/<TrafficSupervisor>/<AppSettings>/<enabledWorkspaces> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <enabledWorkspaces>JSONCONF
   ["standard-map", "kpi-dasboard", "admin-panel", "optima-control"]
   </enabledWorkspaces>
.....
</appSettings>

Caution:  If you change the list of loaded workspaces, when you launch the application you might need to clear the user settings (on the Upper Bar, click and clear the user settings).

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<eventFormat> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <eventFormat>datex2</eventFormat>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<executeSimulationsWithWorkflow> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <executeSimulationsWithWorkflow>true</executeSimulationsWithWorkflow>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<geoserverTileRequestTimeoutMs> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <geoserverTileRequestTimeoutMs>60000</geoserverTileRequestTimeoutMs>
.....
</appSettings>

In TS you can set the pagination size for all the lists of items shown in different areas of the GUI (→ Showing a selected item).

The JSON object is placed in the tag <configuration>/<TrafficSupervisor>/<AppSettings>/<grid PaginationOptions> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <gridPaginationOptions>JSONCONF{
   "pageSize": 50,
   "multiplesOfPageSize": 3					
   </gridPaginationOptions>
}.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<hasChatbot> of the file optima-configuration.xml.

Example:

<appSettings>
    .....
    <hasChatbot>true</hasChatbot>
    .....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<hideSimulationEngines> of the file optima-configuration.xml.

Example 1: the default setting

<appSettings>
.....
     <!-- uncomment this to remove the simulation engines block from the TS3 control room -->
     <!-- to get them back once defined, please either comment this option again or set it to false -->
     <!-- <hideSimulationEngines>true</hideSimulationEngines> -->
.....
</appSettings>

Example 2: the simulation engine widget is hidden

<appSettings>
.....
     <hideSimulationEngines>true</hideSimulationEngines>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<httpRequestTimeoutMs> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <httpRequestTimeoutMs>60000</httpRequestTimeoutMs>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<kpiDaysWindow> of the file optima-configuration.xml.

<kpiDaysWindow>5</kpiDaysWindow>

Example:

<appSettings>
.....
   <kpiDaysWindow>3</kpiDaysWindow>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<languages> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <languages>ENG,ITA,FRA</languages>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<layersStyleTitleField> of the file optima-configuration.xml.

In the table, you can see the relation between the Geoserver style name and the associated "Title" and "Abstract" properties.

Example:

<appSettings>
.....
   <layersStyleTitleField>"Title"</layersStyleTitleField>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<maxAcceptableDelayChart> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <maxAcceptableDelayChart>5</maxAcceptableDelayChart>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<mapCenterLat> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <mapCenterLat>41.70572851046083</mapCenterLat>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<mapCenterLon> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <mapCenterLon>14.941406247920982</mapCenterLon>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<networkName> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <networkName>Torino 5T</networkName>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<planningAssignmentTypes> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <planninAssignmentTypes>JSONCONF
   ["DTA","DNL"]
   </planninAssignmentTypes>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<planningIterationsNumber> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <planningIterationNumber>15</planningIterationNumber>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<putMode> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <putMode>false</putMode>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<searchBBoxExtension> of the file optima-configuration.xml.

                                    searchBBox = [
    max(-180, mapCenterLon - searchBBoxExtension.lon),
    max(-90, mapCenterLat - searchBBoxExtension.lat),
    min(180, mapCenterLon + searchBBoxExtension.lon),
    min(90, mapCenterLat + searchBBoxExtension.lat)
]
                                

Example:

<appSettings>
.....
   <searchBBoxExtension>JSONCONF
   {"lon": 30, "lat": 60}
   </searchBBoxExtension>
.....
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<TSTimezone> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <TSTimezone>Europe/Rome</TSTimezone>
.....
</appSettings>

In TS you can enable or disable the selection of a simulation engine in more than one area:

• → Control Room dashboard .
• → Scenario workspace

The set of available simulation engines is shown in the list:

• real time: Real Time.
• micro: Optima Micro.
• planning: Optima Planning.

The JSON object is placed in the tag <configuration>/<TrafficSupervisor>/<AppSettings>/<scenarioEvaluationMode> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <scenarioEvaluationMode>JSONCONF
   ["real time", "micro", "planning"]
   </scenarioEvaluationMode>
.....
</appSettings>

Important:  After an update of this tag, you need to re-start the Traffic Supervisor GUI.

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<systemTimeProvider> of the file optima-configuration.xml.

Example:

<appSettings>
{
.....
   <systemTimeProvider>JSONCONF
   {
    "providerName": "tre",
    "websocketQueue: "optima_tre",
    "serviceUrl": "optima-wsi/tre/TRE_tattico?action=getTime"
   }
   </systemTimeProvider>}
.....
}
</appSettings>

This parameter is placed in the tag <configuration>/<TrafficSupervisor>/<appSettings>/<webSocketMsgTimeThreshold> of the file optima-configuration.xml.

Example:

<appSettings>
.....
   <webSocketMsgTimeThreshold>10</webSocketMsgTimeThreshold>
.....
</appSettings>