> For the complete documentation index, see [llms.txt](https://docs.smartglobe.cadac.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.smartglobe.cadac.com/smartglobe-rembrandt/system-configuration/chart-rules.md).

# 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

2. Payload (What)

Defines what the rule does, written in JSON.

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

3. 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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FLTKnHRVB2eXDOKw5vnL9%2FUnknown%20image?alt=media\&token=a50201a0-33b6-4e98-89cc-40ed53fb0545)

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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FhxaroXDhNVHhZMsBLgKV%2FUnknown%20image?alt=media\&token=b9d8397f-0548-42aa-aee7-ca4b10875c2d)

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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FWUU7QugCAckbtS1lGXPG%2FUnknown%20image?alt=media\&token=439d3c42-b958-49ae-b48d-897920dba540)

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:

![](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2F5qOt55plec4Cyh6O7bbK%2FUnknown%20image?alt=media\&token=daaf5968-d9fa-454f-bde7-e6051c4225d9)

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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FT9kedXHq1m10Y3jrsIBo%2FUnknown%20image?alt=media\&token=6a1be359-e489-4bfa-af82-7c1db3b7e2a7)

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.

![](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FtJTkh0ictYJqI6zm3HgK%2FUnknown%20image?alt=media\&token=0ea437e2-8724-4f46-ab62-1b688949f437)

fig. 330 – Chart Rule name input field.

**Description input field**

The description field requires a rule description:

![](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2F8pnC7suTiQAhFpctOzld%2FUnknown%20image?alt=media\&token=58417408-28b8-48b8-b859-dcfecc01dd3a)

fig. 331 – Chart Rule Description input field.

**Type dropdown**

Select the required chart rule type from the *Type* dropdown:

![](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2Fht5HezRHdt8ZgbkFr6lY%2FUnknown%20image?alt=media\&token=81c90990-e0d4-47ee-8322-aa94b79d6037)

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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FWAScmFhBiUgFm3VrTRoT%2FUnknown%20image?alt=media\&token=c0fbddb6-b6e3-4746-a8b3-fd1d759721c5)

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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FWnYaXSdci6Dtf0J9QxpL%2FUnknown%20image?alt=media\&token=459f6dd5-b8fe-4cbb-af11-b2f8b67fc60d)

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.

![](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FM5aExDkufjic5bLYr4iP%2FUnknown%20image?alt=media\&token=7e543b16-b717-4f04-be5c-2020fe6d5bac)

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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2F8leRuGwXs7fUu5wyev9Y%2FUnknown%20image?alt=media\&token=05d399a6-7e91-4cb5-a4da-c1710a27b354)

fig. 336 – Existing type rules.

When selecting the ellipsis (![A group of dots on a white background AI-generated content may be incorrect.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2F6l6BwKALKPKMdbdFpN9s%2FUnknown%20image?alt=media\&token=a9cde842-2980-4777-80c3-7b8d36d5c360)) 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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FmcPbxmbvHROGUpNVsYnp%2FUnknown%20image?alt=media\&token=ab4fb885-e685-4bb2-97d9-f8189aa6fc38)

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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2Fu9lo2ELeoeWCpa5qc90f%2FUnknown%20image?alt=media\&token=db0fc84d-271e-48e6-b7b6-d2eef8a30ae8)

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:

![](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FvT4ulu9AMz1wQZEqzUJN%2FUnknown%20image?alt=media\&token=e2694d66-6883-463f-85a3-38545226aea3)

fig. 339 – Message confirming duplication.

**Disable**

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

![](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FxWpj6vjh1u7m146jeqh8%2FUnknown%20image?alt=media\&token=83778e7d-8b59-4088-bc46-81891e9b9170)

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.

![](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FwfnBvFch3X3AM5QxPs9l%2FUnknown%20image?alt=media\&token=cc136f6a-1620-49ab-a0e7-bb7abde7ca0e)

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.](https://3521354572-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRtcgQh5bBlJVK3sSy7QD%2Fuploads%2FxXUEaKTOH1Ih7KuyugMa%2FUnknown%20image?alt=media\&token=b51176c2-7191-44d7-8032-58423c633f4a)

fig. 342 – Chart rule remove warning message.

Select *Yes* to remove and *No* to cancel.