Connected Object

Represents the base class for objects that require a connection to the Grooper database.

Remarks

Overview

A Connected Object is a configurable item in Grooper that maintains an active association with a specific Grooper repository database. This class serves as the foundation for all objects that need to access, store, or reference data within the repository, including Nodes, projects, and embedded configuration objects.

Connected Objects are aware of their database context, enabling them to interact with repository resources, resolve references, and participate in repository-wide operations. This connection is essential for managing relationships, enforcing data integrity, and supporting features such as reference tracking and cross-object validation.

Key Features

• Database Awareness:
  Connected Objects always reference a Repository Connection, ensuring that all operations—such as loading, saving, and referencing other objects—are performed within the correct database context.

• Reference Tracking:
  Connected Objects can reference other Nodes or configuration items within the repository. Built-in logic allows these objects to enumerate and manage their references, supporting features like dependency validation, copy/move operations, and repository integrity checks.

• Resource Access:
  Connected Objects can access global resources, such as the Root node, project-level settings, and shared folders, through their database connection.