Custom fields

Custom fields are additional, user-defined metadata fields that can be attached to various data structure and documentation elements like tables, columns etc.

Basics

Custom field is an additional field that you can add to better describe objects in your documentation. These fields can behave differently based on a defined field type.

They are defined on repository level, so a custom field in each repository will apply to all its documentations.

Custom field can be enabled for one or more of the following elements:

• tables/views
• columns
• procedures/functions
• parameters
• triggers
• primary/unique keys
• table relations
• modules

Displaying custom fields

While defining new custom fields you must choose one of the existing types. The chosen type defines what values are allowed and how they display in the field you just created.

In the screenshot below you can see a table with some filled in custom fields in web catalog.

The numbers represent different types of custom fields:

1. Drop-down list (open)
2. Checkbox
3. Drop-down list (closed)
4. Color
5. Date
6. User selection
7. Tags

Defining custom fields

To define custom fields click Custom fields button in the ribbon.

This opens custom field administration panel where you can view and edit the list of custom fields defined in the repository.

Adding a field

To add a field click Add button or choose predefined field (see below).

Once you click Add, a form with field definition will show. Provide a unique name of the field, field scope and an optional description for future reference.

Confirm with OK and once you defined all the fields save changes with Save button.

Setting field scope

Field scope defines which data element the field will be added to.

Adding predefined fields

You can quickly add one of our predefined custom fields simply by clicking on the predefined fields on the bottom of the form:

Removing fields

To remove a field, select it and click Remove button.

Then, click the Save button to confirm the change.

Sorting

You can change default field order using Move up and Move down buttons. It will impact display order in application and exports.

Editing custom fields

After you define custom fields you will notice that additional text fields will show up next to relevant objects.

Here are a few exaples of where you can find custom fields:

Module:

Table list:

Table:

Columns:

Exporting

You can choose which custom fields should be exported on Choose custom fields screen:

In exported files, the custom field data are usually only visible when they are filled.

Custom fields in PDF export:

Custom fields in HTML export:

Custom fields in repository database

All custom fields are saved in relevant tables (e.g. in procedures or parameters tables) in columns named field1 to field40. To find which column holds value of a specific field check the second column of the query below:

select title as field_name,
       field_name as database_column_name
  from dbo.custom_fields

You can find out more about this in Dataedo repository documentation.

Importing/Exporting extended properties

Dataedo lets you import and export custom fields to and from SQL Server extended properties.

Learn more:

• Importing extended properties
• Exporting extended properties