Logo
NeoArc Studio

Key Roles and Property Types

Define node properties with 12 abstract types and 6 key roles. Configure constraints including required, nullable, unique, and indexed. Add per-property projections (search, API, persistence), governance metadata (description, example, tags), and validation rules with min/max values, patterns, and enums.

Graph diagram nodes support typed properties similar to database columns. Each property has a data type, optional key role, and constraints. In Graph DB mode, these properties are used for Cypher export and schema validation.

Property Types

NeoArc supports 12 abstract property types. These map to platform-specific types during export (e.g. Neo4j, SQL, search indices).

Key Roles

Key roles indicate how a property functions in the data model. These appear as badges (PK, FK, NK, etc.) next to property names.

Key Role Examples

Constraints

Properties support four constraint flags that control data integrity.

Validation Rules

Properties can have validation rules that constrain acceptable values. These are enforced during schema validation and exported to Cypher constraints.

Validation Rule Examples

// Price must be positive
{
  "name": "price",
  "type": "float",
  "minValue": 0.01
}

// Status must be one of the allowed values
{
  "name": "status",
  "type": "string",
  "enumValues": ["pending", "active", "completed", "cancelled"]
}

// Email must match pattern
{
  "name": "email",
  "type": "string",
  "pattern": "^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$"
}

Foreign Key Resolution

Foreign key properties can reference specific properties on other nodes. This creates a navigable relationship in the schema.

Description Field

Every property supports a description field for documentation. Descriptions appear in tooltips and are included in Cypher export comments.

Default Values

Properties can specify default values that apply when no value is provided. Defaults are type-specific:

Per-Property Projections

Each property supports projection flags that control how it appears across derived artefacts. Projections are configured in the property details panel.

Governance Metadata

Properties support governance metadata fields that improve documentation quality and support automated tooling.

Adding Properties

Mode Visibility

Property editing features vary by authoring mode: