2.2 Project Architecture & Catalog Management
Key Takeaways
- An ArcGIS Pro project file (.aprx) is a JSON-structured container storing references, map definitions, layouts, and connections, but does not store spatial data feature classes directly.
- Every new project initializes a project home folder containing a default file geodatabase (.gdb) and default toolbox (.atbx).
- The Contents pane offers six distinct view modes (Draw Order, Source, Selection, Editing, Snapping, and Labeling) to control layer behavior and workspace auditing.
- The Catalog pane provides lightweight docking access for browsing items, while the Catalog view offers full-tab metadata management, spatial previews, and schema design.
- Enterprise database connections (.sde) and server connections manage access to multi-user spatial databases, web services, and ArcGIS Enterprise portals.
2.2 Project Architecture & Catalog Management
ArcGIS Pro manages work through a centralized project structure centered around the .aprx project file extension. Unlike legacy GIS workflows where maps, toolboxes, and data connections were scattered across disconnected files, an ArcGIS Pro project encapsulates all associated maps, 3D scenes, layouts, geoprocessing histories, styles, folder connections, and database credentials within a structured environment. Mastering project file architecture, default assets, Contents pane view modes, and Catalog management is essential for data integrity and exam readiness.
1. ArcGIS Pro Project File (.aprx) Structure
An ArcGIS Pro project file (.aprx) acts as a lightweight XML/JSON container document. It organizes pointers, metadata, styling properties, and component definitions.
Critical Exam Rule: An
.aprxfile does NOT store actual spatial GIS data (such as vector feature classes, shapefiles, or raster imagery tiles). Instead, it stores file paths, connections, layer properties, and layout definitions pointing to external storage locations.
Key Components Managed Inside an .aprx File:
- Maps & Scenes: Definitions of 2D maps, 3D Local scenes, and 3D Global scenes.
- Page Layouts: Page size specifications, dynamic text elements, legends, and map frame linkages.
- Geoprocessing History: Complete audit trail of tools executed within the project, including parameters, execution timestamps, and output paths.
- Connections: Path definitions for Folder Connections, Database Connections (
.sde), Server Connections, and Portal Items. - Styles: Custom color ramps, point symbols, line patterns, and polygon fills.
2. Project Home Folder & Default Assets
When a new project is created in ArcGIS Pro, the application initializes a Project Home Folder on disk containing three core default assets:
Project_Folder/
├── Project_Name.aprx (Project File Container)
├── Project_Name.gdb (Default File Geodatabase)
├── Project_Name.atbx (Default ArcGIS Toolbox)
└── Index/ (Project Search Index Files)
- Home Folder: Root directory containing all project-specific resources and data outputs.
- Default File Geodatabase (
.gdb): Automatically designated workspace for geoprocessing tool outputs. When geoprocessing tools run without specifying an absolute output path, results are automatically saved into this default geodatabase. - Default Toolbox (
.atbx): Container for storing custom ModelBuilder models, Python script tools, and geoprocessing toolsets specific to the project.
Note: The default geodatabase and toolbox can be changed at any time by right-clicking a different geodatabase or toolbox in the Catalog pane and selecting Make Default.
3. Contents Pane Display Modes
The Contents pane displays the layers and tables associated with the active map, scene, or layout. At the top of the Contents pane are six view buttons that alter how layers are listed and managed:
| Display Mode Icon | Display Mode Name | Primary Function & Exam Relevance |
|---|---|---|
| List By Draw Order | Renders layers top-to-bottom. Top layers display over lower layers in the map view. Used for reordering drawing hierarchy. | |
| List By Source | Groups layers by workspace location (folder path, file geodatabase, enterprise .sde connection, or web service URL). | |
| List By Selection | Controls layer selectability. Displays selection counts and toggles checkboxes to prevent interactive feature selection on reference layers. | |
| List By Editing | Toggles edit permissions per layer. Unchecking a layer prevents accidental feature creation or modification during an active edit session. | |
| List By Snapping | Controls active snapping targets. Toggles snapping per layer (point, end, vertex, edge) during vector feature digitizing. | |
| List By Labeling | Lists label classes per layer. Used to create, reorder, and manage SQL query rules and scale ranges across all label classes. |
4. Catalog Pane vs. Catalog View
ArcGIS Pro provides two distinct environments for exploring, managing, and maintaining GIS datasets: the Catalog pane and the Catalog view.
+-----------------------------------------------------------------------------------------+
| Feature Comparison | Catalog Pane | Catalog View |
+-----------------------------------------------------------------------------------------+
| Workspace Location | Dockable side pane | Full-tab workspace document |
| Primary Purpose | Fast browsing & drag-drop | Data management & metadata |
| Metadata Editing | Basic summary display | Full ISO/FGDC metadata edit |
| Data Previewing | Thumbnail / minimal | Interactive Map & Table |
| Item Details Columns | Compact tree structure | Name, Type, Date, Size, Path|
+-----------------------------------------------------------------------------------------+
- Catalog Pane: Optimized for rapid, lightweight operations during mapping. Allows quick search, drag-and-drop layer addition to maps, and tool invocation.
- Catalog View: Opens as a full workspace tab (similar to a map view). Designed for administrative tasks: editing formal metadata, configuring field schema definitions, building spatial indexes, previewing geographic geometry and attribute tables, and managing enterprise geodatabases.
5. Establishing Connections & Project Templates
Spatial datasets are rarely stored entirely within the home folder. ArcGIS Pro uses Connections to access external repositories:
- Folder Connections: Pointers to local or network file directories. Can be set as project-specific or saved to Favorites for automatic inclusion in all future projects.
- Database Connections (
.sde): Connection files linking to Enterprise Geodatabases (e.g., PostgreSQL, Oracle, Microsoft SQL Server). Stores database host parameters, instance specifications, and user authentication credentials. - Server Connections: Establishes user, publisher, or administrative links to ArcGIS Server or Portal for ArcGIS / ArcGIS Online web services.
- Project Templates (
.aptx): Customized starter files used to standardize organizational workflows. A.aptxtemplate can pre-package standardized map layouts (with corporate title blocks and logos), pre-established folder and database connections, custom styles, and default spatial reference settings.
What type of data is directly stored inside an ArcGIS Pro project file (.aprx)?
Which Contents pane display mode allows a GIS technician to restrict editing permissions so that specific background reference layers cannot be accidentally modified during an edit session?
Which ArcGIS Pro component should be used to edit metadata according to ISO 19139 standards, inspect spatial geometry previews, and modify field schema properties?