Chart Rules

The system automatically generates charts and symbols. To give organizations more control, users can define custom symbolization rules.

These rules help to:

  • Control chart generation using configuration instead of automatic defaults;

  • Ensure consistent symbolization across charts;

  • Reduce repetitive manual input and improve productivity.

Rule Engine Quick Reference

What It Does:

The Rule Engine lets you customize charts without coding by creating rules that automatically apply styling, features, and configurations based on where they're needed.

How It Works:

  • Rules match — The system finds rules that apply to your current chart

  • Rules run in order — System defaults first, then your custom rules (most specific last)

  • Chart generates — The final result reflects all applied rules

Three Key Parts:

  1. Scope (Where)

Defines where your rule applies using a path syntax.

  • Example: /organization/*/chart/[ChartType.ChartKind == 'IAC'] targets all Instrument Approach Charts

  1. Payload (What)

Defines what the rule does, written in JSON.

  • Example: Add distance circles, change colors, include specific features

  1. Execution Order (When)

Rules run in priority order:

  • System rules (built-in defaults)

  • Your rules (most specific rules override less specific ones)

Common Rule Types:

  • Rendering — Distance circles, compass roses, sector altitudes

  • Configuration — Which features and airspaces to show

  • Styling — Colors, labels, symbols

Testing Your Rules:

Add rules directly to Cosmos DB with these required fields:

  • EntityType: "ChartJsonRuleEntity"

  • OrganizationId: Your organization ID

  • BuildContextId: Rule type (e.g., "RenderDistanceCircle")

  • Scope: Where it applies

  • Payload: What it does (as a JSON string)

For complete syntax, operators, and examples, see the full Rule Scopes and JSON Payload guides.

Open the Chart Rules dashboard

To open the Chart Rules dashboard select the Chart Rules button:

A white background with black text AI-generated content may be incorrect.

fig. 325 – Chart Rules button.

After selection of the Chart Rules button the_ Chart Rules_ dashboard is displayed:

A screenshot of a computer AI-generated content may be incorrect.

fig. 326 – Chart Rules dashboard.

Use the vertical scroll bar to browse available rules.

At the bottom of the page, navigate between pages using the horizontal arrows (← →).

A screenshot of a computer AI-generated content may be incorrect.

fig. 327 – Horizontal arrow and charts per view selection.

Create Chart Rule

In order to create a new chart rule the _Create Chart Rule button_will be selected:

fig. 328 – Create Chart Rule button.

After selection the Create Chart Rule page will be displayed:

A screenshot of a chart AI-generated content may be incorrect.

fig. 329 – Create Chart Rule page.

Name input field

When creating a new chart rule name you should be careful to create a name that describes the rule sufficiently to other users.

fig. 330 – Chart Rule name input field.

Description input field

The description field requires a rule description:

fig. 331 – Chart Rule Description input field.

Type dropdown

Select the required chart rule type from the Type dropdown:

fig. 332 – Chart Rule type dropdown.

Scope input field

The scope input field requires the scope for the new rule:

A white rectangular object with black text AI-generated content may be incorrect.

fig. 333 – Scope input field.

Defines where your rule applies using a path syntax.

  • Example: /organization/*/chart/[ChartType.ChartKind == 'IAC'] targets all Instrument Approach Charts

Payload

A white background with a black line AI-generated content may be incorrect.

fig. 334 – Payload input field.

Defines what the rule does, written in JSON.

  • Example: Add distance circles, change colors, include specific features

  • Change "lineColor": "", to "blue"

Save/Cancel

Save the new chart rule by selecting Save, or select Cancel to discard it.

fig. 335 – Cancel and Save options.

Type selection

The Chart Rules dashboard includes a Type dropdown that displays existing rules for the selected type:

A screenshot of a computer AI-generated content may be incorrect.

fig. 336 – Existing type rules.

When selecting the ellipsis (A group of dots on a white background AI-generated content may be incorrect.) the following options are displayed:

  • View details;

  • Edit;

  • Duplicate;

  • Disable;

  • Remove.

View details

After selection of the View details button the Chart Rule details are displayed:

A screenshot of a chart AI-generated content may be incorrect.

fig. 337 – Chart Rule details.

Edit

Select Edit to open the Edit Chart Rule page, where you can modify the rule and select Update to save changes or Cancel to discard them:

A screenshot of a chart AI-generated content may be incorrect.

fig. 338 – Edit Chart Rule page.

Duplicate

After selection of the Duplicate button the Chart Rule chosen will be duplicated and message confirming duplication will be displayed:

fig. 339 – Message confirming duplication.

Disable

After selecting the Disable button, the chosen chart rule is disabled and a confirmation message is displayed:

fig. 340 – Message confirming disabled.

When a chart rule is disabled, it is no longer available for use.

Enable

If a chart has been disabled, selecting the ellipsis (…) displays the Enable option. After selecting Enable, the chart rule becomes active.

fig. 341 – Message confirming enabled.

Remove

After selecting the Remove button a warning message is displayed:

A screenshot of a computer error AI-generated content may be incorrect.

fig. 342 – Chart rule remove warning message.

Select Yes to remove and No to cancel.

Last updated