---
title: "Register a definition"
slug: "register-a-definition"
updated: 2025-07-31T13:08:14Z
published: 2025-07-31T13:08:14Z
canonical: "knowledge.curiositysoftware.ie/register-a-definition"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://knowledge.curiositysoftware.ie/llms.txt
> Use this file to discover all available pages before exploring further.

# Register a definition

This process creates a snapshot of a database, file or swagger document. You can use it to view the relationships between tables in a database and for activities like data generation.

In order to register the definition, carry out the following steps:

## Navigate to the definitions page

Navigate to Data dictionary (1)→ Definitions tab (2) and click New Definition (3).

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-BAJR2DPM.png)

This will display the Create Definition dialog box

## Fill in the Create Definition dialog box

This is split into three pages, as specified below. When the page is filled in, you can click ‘Next Step’ or Cancel. Note that the following steps/page will depend on the type of definition being created.

### Details tab

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-3HY7KQA2.png)

| **Name** | Definition name |
| --- | --- |
| **Application** | drop-down list of the available applications |
| **Description** | Description for the definition |
| **Type of Definition** | Database | Create a database definition |
| File | Create a file definition |
| Swagger | Create a swagger definition |

### Connection/Schema/Swagger tab

Note that the name of this page depends on the type of definition that you are creating.

#### **Database**

You have the following four options,with regard to what database connection to use:

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-0ZO6PIKM.png)

**Existing Connection:** This will display a drop-down list of the available connections, for you to pick the appropriate one.

**New Connection:** This will display a box that will have the tabs and fields that are available when you [create a new database connection](/kb/docs/create-a-new-database-connection).

**No Connection:** This will display a drop-down list of available database types, then the next step will be to enter a schema name.

**Skip:** This will display a drop-down list of available database types, but then will allow you to save the definition without configuring it at this time.

#### File

You have the following four options available when creating a file definition

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-BUQ73VV8.png)

**Existing Schema:** This will display a drop-down list of the available schema, for you to pick the appropriate one.

**New Schema:** This will display the fields required to define a new schema.

**No Schema:** This will display a drop-down list of available file types.

**Skip:** This will display a drop-down list of available file types, then allow you to save the definition without configuring it at this time.

#### **Swagger specification**

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-IM42SZPN.png)

**New Swagger:** This will display the fields required to define a new swagger specification.

**Skip:** This will allow you to save the definition without configuring it at this time.

### Scan

This is not available for Swagger. For database and file definitions, you can choose an existing scan to base the definition on or trigger a new scan.

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-6IDGKCWD.png)

### Create the definition

The final page is a summary of the actions that will be carried out, so you can either click Finish to make the definition or cancel it.

![](https://cdn.document360.io/77f722a6-2d0a-49fa-8074-572515a6c4b8/Images/Documentation/image-9IFOH95S.png)