Report Aviation Chart Changes (Aviation)

Available with Aviation Charting license.

Summary

Compares feature classes in two enterprise geodatabase versions and returns the differences in a report. You can filter the reported changes to determine which charts are affected by the differing data sources. You can set filters based on areas of interest (AOI), definition queries, and Report Chart Changes preferences.

Once generated, the report will be written to the AIS_ChartChanges table in the ArcGIS Aviation Charting AIS geodatabase schema. You can name the report and reference it through the SessionID unique report identifier. You can use the Chart Changes tool to view the report.

Usage

  • The Aviation Workspace parameter value must be a versioned enterprise geodatabase. File geodatabases are not supported.

  • The base version is typically the primary or ancestor version of the enterprise geodatabase, and the comparison version is the secondary version of the enterprise geodatabase. Reported ChangeType values (Delete, Insert, Attribute, Geometry, or Both) are from the base version to the comparison version of the enterprise geodatabase. Delete ChangeType values exist in the base version, but not in the comparison version. Insert ChangeType values exist in the comparison version, but not in the base version.

  • The base and comparison version will have all values (including NULL values) stored.

  • You must populate the workspace preference table with Report Chart Changes preferences before running this tool. These preferences will define which feature classes and attributes will be included in the report. After a preference is created, you can update the attributes as necessary. You can also create multiple preferences by assigning unique names to each preference in the table.

    Learn more about creating preferences

  • The Area of Interest Features polygon feature class is used to set a boundary within which the features will be processed. Features that overlap the AOI entirely or partially will be processed.

  • To avoid unexpected errors when referencing a feature class in an enterprise geodatabase, provide an absolute path to the workspace when using the aoi_features parameter in Python.

  • The generated report must have a unique name. You cannot have two reports with the same name in the AIS_ChartChanges table.

  • Once this tool has been run, it no longer depends on existing versions to compare the changes.

Parameters

LabelExplanationData Type
Aviation Workspace

The versioned enterprise ArcGIS Aviation Charting AIS geodatabase. The workspace cannot be a file geodatabase.

Workspace
Base Version

The version of the ArcGIS Aviation Charting AIS geodatabase to be compared.

String
Comparison Version

The version of the ArcGIS Aviation Charting AIS geodatabase that will be compared to the Base Version parameter value.

String
Report Preference

The Report Chart Changes preference setting from the preference table. This preference will define which feature classes will be included in the report.

String
Report Name

The unique name of the report, containing changes between the geodatabase versions.

String
Area of Interest Features
(Optional)

The boundary within which the features will be processed.

Feature Layer

Derived Output

LabelExplanationData Type
ID of Generated Report

The SessionID of the report from the AIS_ChartChanges table.

String

arcpy.aviation.ReportAviationChartChanges(aviation_workspace, base_version, comparison_version, report_preference, report_name, {aoi_features})
NameExplanationData Type
aviation_workspace

The versioned enterprise ArcGIS Aviation Charting AIS geodatabase. The workspace cannot be a file geodatabase.

Workspace
base_version

The version of the ArcGIS Aviation Charting AIS geodatabase to be compared.

String
comparison_version

The version of the ArcGIS Aviation Charting AIS geodatabase that will be compared to the base_version parameter value.

String
report_preference

The Report Chart Changes preference setting from the preference table. This preference will define which feature classes will be included in the report.

String
report_name

The unique name of the report, containing changes between the geodatabase versions.

String
aoi_features
(Optional)

The boundary within which the features will be processed.

Feature Layer

Derived Output

NameExplanationData Type
report_id

The SessionID of the report from the AIS_ChartChanges table.

String

Code sample

ReportAviationChartChanges example (stand-alone script)

The following code sample demonstrates how to use the ReportAviationChartChanges function.

# Name: ReportAviationChartChanges_example.py
# Description: Creates a report containing differences between feature classes in two enterprise geodatabase version.

import arcpy

# Check out Aviation license

arcpy.CheckOutExtension("Aeronautical")

# Set variables

aviation_workspace = r'D:\Data\Database.sde'

base_version = "GIS.Base"

comparison_version = "GIS.Branch"

report_preference = "MyPreference"

report_name = "MyReport"

aoi_features = aviation_workspace + "\\AOI"

# Execute ReportAviationChartChanges

arcpy.aviation.ReportAviationChartChanges(aviation_workspace, base_version, comparison_version, report_preference, report_name, aoi_features)

# Check in Aviation license
arcpy.CheckInExtension("Aeronautical")

Environments

This tool does not use any geoprocessing environments.

Licensing information

  • Basic: No
  • Standard: Requires ArcGIS Aviation Charting
  • Advanced: Requires ArcGIS Aviation Charting

Related topics