Custom Properties (Metadata)

Custom Properties allow you to add metadata fields to objects in TrialGrid. Think of them as user-defined attributes that extend the built-in properties of each object type.

When you define a Custom Property for an object type in a URL, that property becomes available to all objects of that type in that URL. For example, adding a "Version" property to Fields means every field in your URL will have a Version attribute you can edit.

Supported Objects

Custom Properties can be associated with:

• Projects

• Drafts

• Custom Functions

• Data Dictionaries

• Data Dictionary Entries

• Derivations

• Edit Checks

• Forms

• Fields

• Folders

• Matrices

• Unit Dictionaries

• Test Cases

• Custom Objects

Property Types

Type	Description
Text	Free text up to 8,000 characters
Choice	A set of predefined options from which users select a value
Reference	A reference to another object type (e.g., Fields can reference Data Dictionaries). Creates a dynamic pick-list from objects of the referenced type in the same Draft

Important

Reference properties are only valid for Drafts and objects within Drafts. Projects cannot have reference properties.

Property Attributes

Each Custom Property has several configurable attributes:

Attribute	Description
Display Order	Controls the sequence in which properties appear. Properties with the same order value appear in undefined order. Negative values are allowed.
Active	Determines if the property is available for use. Unchecking this retires the property while preserving existing data.
Display as HTML	(Text type only) Renders HTML tags in property values instead of displaying them as plain text.
Show in Lists	Makes the property visible in object listings alongside standard attributes like Name and OID.
Reserved for Actions	Prevents manual editing. Only Actions can modify these values. Read-only properties display with a icon.
Include in Compliance Calculations	Controls whether property values affect compliance checks when comparing objects for standards deviations.

Inactive Properties

When a property is marked inactive, it becomes hidden in most contexts but remains functional where already in use:

Hidden from:

• New object creation screens

• Property listings

• Spreadsheet views (unless at least one row has a value)

• Metadata tabs in editors (unless a value exists)

• Comparison views (unless either object has a value)

Still active in:

• Compliance calculations and rules

• Diagnostic processing

• ALS imports and exports

• Existing projects that already use the property

Tip

Use inactive properties to phase out metadata fields without breaking existing projects or losing historical data.

HTML Display Properties

Properties with "Display as HTML" enabled can render formatted content.

Warning

HTML content is sanitized for security. Script tags and potentially dangerous HTML are automatically removed to protect TrialGrid and its users.

Compliance Calculations

The "Include in Compliance Calculations" setting is particularly useful for library objects that contain metadata not relevant to study drafts.

Example scenario:

A library form might have properties like "Standards Reference" or "Usage Instructions" that shouldn't trigger compliance failures when absent from study drafts.

Import and Export

Custom Properties integrate with the Architect Loader Spreadsheet format:

Export

Properties are exported to worksheets named TG_<objectname>Properties (e.g., TG_FieldProperties)

Import

Properties can be imported from these same worksheets, with one critical requirement:

Important

TrialGrid only imports properties that already exist in the destination URL. For example, if your spreadsheet contains a "DOMAIN" property for Fields, it will only import if "DOMAIN" is already defined as a Field property in the target URL. Undefined properties are skipped with a warning.

Note

Medidata Rave ignores Custom Property worksheets in Architect Loader Spreadsheets uploaded to Architect.

Common Use Cases

Version Management

Add a "Version" text property to track iteration numbers across draft objects

Documentation

Add an HTML-enabled "Instructions" text property to provide formatted guidance within objects