Configuration settings
Configuration settings allow administrators to configure application-level organizational settings within ArcGIS Excalibur. This includes general application settings and specific ArcGIS Video Server settings. These ArcGIS Video Server settings are only available on ArcGIS Enterprise. The application-level configuration settings will only be displayed and available if you are signed in as an administrator. These settings can be accessed through Set app configuration level settings
in the side navigation bar. Alternatively access these settings by clicking the profile drop-down menu in the upper corner and clicking App settings.
Configure general app settings
General settings are configured with the following workflows in the App Settings tab.
Change the theme
An administrator can choose to change the Default Theme setting, which is set to the dark theme by default. To change the default theme, complete the following steps:
Select the theme.
Dark Theme works well when viewing imagery or video in dark or dimly lit operating environments.
Light Theme works well when viewing imagery or video in brighter and well-lit environments.
Click Save.
Relaunch the application to apply the selected theme.
Users can override the default theme by changing their own App Theme in the user settings.
Change the default start page
An administrator can change the Default Start Page. This is set to the Home page by default. To change the Default Start Page, complete the following steps:
Select the desired page from the available list.
Click Save.
Relaunch the application to apply the new default start page.
Users can override the default start page by changing their Start Page in the user settings.
Configure organizational system-managed fields
As an administrator, you can configure the fields available for observations created in ArcGIS Excalibur. Observation field settings are managed at the application level and are applied when new observation layers are created. Administrators can create custom fields, manage Excalibur fields, modify field display properties, and restore the default configuration.
To manage observation fields:
- Click the Observation Fields tab in the Configuration Settings page.
The Observation Fields page contains the following sections:
Custom Fields—These are user-defined fields that automatically populate values from metadata in the source analysis layer when an observation is collected. Administrators configure custom fields to capture metadata relevant to their workflows for their organization.
Excalibur Fields—These fields are managed by the application. They automatically populate values from metadata in the source analysis layer when an observation is collected. Excalibur fields cannot be deleted.
Editor Tracking Fields—These fields automatically record who created or updated an observation, along with the data and time of those changes. Editor tracking must be enabled on the feature layer to capture this information.
Create a custom field
Custom fields allow administrators to define additional information captured with observations.
To create a Custom Field do the following:
In the Custom Fields section, click Create
.Provide the required field information.
Click Save.
See the table below for specific information on each input:
| Property | Description | Required | Requirements and Restrictions | Editable After Creation |
|---|---|---|---|---|
| Field Name | The internal name used to store the field. | Yes | Must begin with a letter. Can contain only letters, numbers, and underscores (_). Maximum length is 63 characters. Must be unique. | No |
| Display Name | The label displayed to users throughout the application. | No | Duplicate values are allowed. Special characters are supported. | Yes |
| Description | A description of the field and its intended purpose. | Yes | Maximum length is 500 characters. Cannot contain < or > characters. |
Yes |
| Type | Defines the field category. See table below for supported types. | Yes | Selected when the field is created and cannot be changed later. | No |
| Value Type | Defines the type of data accepted by the field. | Yes | Determines the data that can be stored in the field. | Yes |
| Mapped Source Fields | Source field names that map incoming data to the observation field. | At least one | At least one mapped source field is required. Duplicate source fields are not allowed. Source field names must follow the same naming rules as Field Name. | Yes |
See the table below for more information on the Data Types supported:
| Data Type | Description |
|---|---|
| String | Any sequence of characters. |
| Double | Numbers with decimal places. |
| Integer | Whole numbers from -2,147,483,648 to 2,147,483,647 (long integer). |
| Big Integer | Whole numbers from -9,007,199,254,740,991 to 9,007,199,254,740,991. Use this type when you need to store numbers that do not fit within the range of the Integer data type. |
| Date | Stores both date and time values. For more information, see Date and time fields in ArcGIS Enterprise. |
| Date Only | Stores a date but no time value. This is useful when time is not needed, such as recording the day a permit expires or a customer's birth date. |
| Time Only | Stores a time but no date value. Time is stored in 24-hour format, such as 16:30 for 4:30 PM. This field type is useful for recording values such as business hours and bus schedules. |
Edit a custom field
You can update certain properties of an existing Custom Field as requirements evolve.
To edit a Custom Field:
Select the field.
Click Edit Field
.Update the field properties as needed.
Click Save.
Changes are immediately reflected in the field configuration.
Delete a Custom Field
If a Custom Field is no longer needed, it can be removed from the configuration.
To delete a field:
Open the Custom Field.
Click Delete Field
.Review the confirmation message.
Click Delete.
The field is permanently removed from the fields configuration.
Configure Excalibur Fields
Excalibur Fields are system-provided fields that support observation and imagery analysis workflows. Administrators can determine which Excalibur Fields are available for new observation layers.
The provided Excalibur Fields are:
NameLayer TypeSublayer IDPortal Item IDImage IDService URLProject IDObservation Collection Time (Local)Image Collection Time (UTC)Video TimeObservation Lat LonNative XY CoordinatesCollection Map ScaleSecurity ClassificationPredicted NIIRSSensor Name
To manage these Excalibur Fields:
Enable or disable the desired fields by clicking the checkbox next to a specific field under the Excalibur Fields section.
Click Save.
Your selections are saved and applied to future observation layer configurations.
Customize Excalibur Field Properties
Excalibur Fields support additional customization options.
For Excalibur Fields, you can:
Update the Display Name. (Available for all fields)
Update the field Description. (Available for the Name, Image Collection Time (UTC), Security Classification, Predicted NIIRS, and Sensor Name fields)
Add additional mapped source fields. (Available for the Name, Image Collection Time (UTC), Security Classification, Predicted NIIRS, and Sensor Name fields)
Default mapped source fields cannot be removed, but administrator-added mappings can be modified or deleted.
To edit an Excalibur Field:
Select the field.
Click Edit Field
.Update the field properties as needed.
Click Save.
Changes are immediately reflected in the field configuration.
Configure Editor Tracking Fields
Editor Tracking fields store information about feature creation and editing activity.
These fields are automatically maintained by the system and cannot be added, removed, or reconfigured beyond their display names.
To update an Editor Tracking Field:
Open the field.
Select Edit Field
.Update the display name.
Click Save.
Changes are immediately reflected in the field configuration.
Reset Observation Fields
If needed, you can restore observation field settings to their default configuration.
To reset observation fields:
Click Reset
at the top of the page.Review the confirmation message.
Click Reset again to confirm.
After the reset is complete:
Default Excalibur Field settings are restored.
Default Editor Tracking Field settings are restored.
All Custom Fields are removed.
Resetting observation fields cannot be undone.
Configure ArcGIS Video Server settings
If an ArcGIS Video Server is installed and federated in the environment in which Excalibur is running, an administrator can configure specific settings that directly impact the environment running Video Server. If no Video Server server is identified, these settings will not be available. These settings will only be available for ArcGIS Enterprise.
Configure a system managed data store
The default storage location for streaming web optimized video content and metadata is the local file system. Alternatively, a portal administrator can register an existing object store to the video server. The hosting server's object store is a data management system for streaming web-optimized video content and metadata.
To optionally register an existing object store to the Video Server, complete the following steps:
Click the Data Stores tab in the Configuration Settings page.
Click Register in the Video Persistence section.
Click OK to confirm the changes in the dialog box.
The active storage location is updated and this can be changed as needed by selecting a different storage location under Set active storage location and clicking Update.
Configure a video search data store
ArcGIS Video Server can be configured to use a spatiotemporal big data store. When configured, Video Server indexes video metadata, telemetry, footprints, and temporal coverage information in a way that allows efficient searching across video collections. Enabling a spatiotemportal big data store allows you to perform a single search across all indexed video layers in that data store rather than searching each video layer individually within the Search and Discover experience. This provides a centralized way to discover video content across your organization, saving time and ensuring relevant footage is not overlooked.
This capability is especially useful in environments with many video feeds, collections, or archived recordings distributed across multiple layers. By searching across all available video content from one location, users can quickly identify datasets that contain coverage for a specific area and time period, streamlining workflows for analysis, investigation, and situational awareness.
To optionally enable a spatiotemportal big data store with the Video Server, complete the following steps:
Ensure a spatiotemporal big data store has been registered with the Video Server.
Click the Data Stores tab in the Configuration Settings page.
Click Enable in the Video Search Store section.
Click OK to confirm the changes in the dialog box.
A spatiotemportal big data store is enabled for enterprise search capabilities. You are able to run a site level search across the video collections within this data store.
Set the elevation source
Using an elevation source increases the accuracy of the video frame footprints. ArcGIS Video Server is installed with a preconfigured set of global elevation resources, including Shuttle Radar Topography Mission (SRTM) 2 and Earth Gravitational Model (EGM) 2008 1 and 2.5 minute spacing for use in georeferencing video content. An administrator can register additional elevation-based imagery layer items that are registered as an item in the system.
To register an elevation source, complete the following steps:
Click the Elevation Sources tab in the Configuration Settings page.
Input the item ID of the ArcGIS imagery layer to use as the elevation source.
Click Register Layer.
The layer will be registered as the elevation source. To remove the registered elevation source, click Remove on the layer you want to remove.
Set port configurations for livestreams
An administrator can manage multiple livestream settings to include defining default ports used by certain livestream protocols and defining the dynamic port range. To set the port configurations and protocols for livestreams, complete the following steps:
Click the Livestreams tab in the Configuration Settings page.
Specify a default RTMP port or RTSP port.
By default, ArcGIS Video Server uses the reserved ports for RTMP (port 1935) and RTSP (port 554). These ports can be changed, but must be within the port range of 1024 to 65535.
Specify a dynamic port range that should be allowed for livestream that uses dynamic port bindings.
The dynamic port range applies to the SRT and UDP livestream protocols.
Click Save to save your changes.
Set Listen and Pull Mode settings
An administrator can enable or disable the use of specific protocols and protocol listeners when publishing new or viewing existing video layers for both Listen and Pull modes. Listen mode enables ArcGIS Video Server to listen for livestream content being pushed to it using designated ports and protocols. The livestream listener for Listen mode can turned off for specific protocols. Pull mode enables ArcGIS Video Server to pull remote livestream content using a provided URL. To specify the Listen and Pull mode settings, complete the following steps:
Click the Livestreams tab in the Configuration Settings page.
Select which Listen Mode listeners should be turned on or off in the Listen Mode Settings.
Turning off a listener will disable the processor required to view existing or create new livestream feeds for the selected protocol. This means any existing video layer of the selected protocol published prior will no longer be accessible.
Select which Listen Mode protocols should be available during livestream video layer publishing.
Click Save.
Select which Pull Mode protocols should be available during livestream video publishing.
Click Save.
Listen mode and pull mode settings are updated.
Set the maximum upload file size
An administrator can set the maximum upload file size for a single file when uploading video content during the publishing process. The default maximum upload size is 5 GB and can be increased up to 20 GB. Setting the maximum upload size to 0 will disallow uploaded files from being saved on the server and will prevent publishing video layers by file uploads. To set the maximum upload file size, complete the following steps:
Click the Uploads tab in the Configuration Settings page.
Use the slider to set the value to the desired maximum upload file size.
Click Update Max Size.