The ArcGIS Pro Client for Network Pro can be customized using a configuration file that is loaded at program startup. This configuration file can be used to customize the available Pro UI.
Description of the Pro UI
The user interface of Pro is defined by the so-called Desktop Application Markup Language (DAML for short). This language allows a declarative definition of the user and input interfaces available in the Pro UI. Each UI element in the Pro application has an application-wide unique DAML ID. For example, the DAML ID for the Catalog button to show the Catalog pane is esri_core_showProjectDockPane.
•A list of all DAML IDs for all UI elements available in a standard ArcGIS Pro application can be found here.
•A list with all DAML IDs of the VertiGIS components can be found here .
Configure the Interface Elements
During the startup phase of the ArcGIS Pro application, it is possible to manipulate the DAML UI tree of the application via the ArcGIS Pro Framework as part of a custom configuration.
The Network Pro ArcGIS Pro extension offers the possibility to identify all those user interface elements that should be hidden or displayed in the application by means of a configuration file. For this purpose, the DAML IDs of the affected UI elements are stored in the configuration file.
The configuration file has the following structure:
{
"damlIds" :
[
"esri_core_previewZoomFullButton",
"esri_sharing_shareAsWebGroupInShareTab",
"esri_mapping_gotoXYControl"
],
"isDamlIdWhitelist": false
}
The damlIds section specifies a list of all DAML IDs whose UI elements should appear or be hidden in the ArcGIS Pro application. The setting isDamlIdWhitelist specifies whether the list is a whitelist or a blacklist:
•If the specified DAML identifiers are whitelisted, only the UI components specified here will be displayed in the ArcGIS Pro interface. All other UI elements are hidden.
•If the specified DAML IDs are interpreted as blacklist (default setting), these UI elements are explicitly removed from the ArcGIS Pro interface.
In order to be able to evaluate this configuration file when ArcGIS Pro is started, the file must be stored under the name proapp.conf in the directory %APPDATA%\VertiGIS\Unity\conf.
Configure the Splash Screen
Applications that build on VertiGIS Studio Desktop can customize the splash screen using a configuration file.
By default, when the program is started, it looks for a file named staging.product.info in the %ProgramData%\VertiGIS\Studio\Desktop directory. This file can be created by the application installer and placed in this location. The content of this file is a JSON structure that looks like this:
{
"title": "VertiGIS Network Pro",
"addTitle": "2.0.1",
"subtitle": "Copyright (c) 2024 VertiGIS GmbH",
"image": "D:/Images/RuToqYR.jpg"
}
If this file exists, it will be evaluated and the product name and version information will be used for display in the splash screen.
Configure Application using JSON
Alternatively, the application configuration, which can be defined at program startup, can also be extended with a JSON product section, as shown above. In this case, the ArcGIS Pro application can be launched from the command line or from a link that adds the following launch argument:
%ProgramFiles%\ArcGIS\Networks\Editor\ArcGISPro.exe /app:%ProgramData%\VertiGIS\Networks\Editor\Desktop\app.conf
{
"app": {
"info": {
"title": "VertiGIS Network Editor"}
},
"splashscreen": {
"title": "VertiGIS Network Editor",
"version": "1.8.0.1424-this-is-a-testversion+instable",
"background": "pack://application:,,,/VertiGIS.Pro.Desktop.Staging;component/Images/SplashScreen.png"},
"landingpage": {
"skip": false,
"title": "Welcome to VertiGIS network Editor",
"background": "pack://application:,,,/VertiGIS.Pro.Desktop.Staging;component/Images/VertiGIS_Cover_With_Overlay.png"},
