← Knowledge library

Catalogue & forms

Create an observation definition

Define reportable observations, value details and components for configured tests.

Current source · source reviewed · 3 min read

Before you begin

1. Open the observation definitions list

Go to your facility. Click Settings. Click Observation Definitions.

2. Start a new observation definition

Click Add Definition. MANSOQ opens the Create Observation Definition form.

3. Fill in the basic information

Complete the fields in the Basic Information section.

Components What it captures
Title The name of the test or measurement. Required.
Slug A short unique name that MANSOQ uses in links. MANSOQ builds the slug from the title, and you can edit it. Use 5 to 25 letters, numbers, underscores, or hyphens. Required.
Description Extra detail about the test. Required.
Status Draft, Active, Retired, or Unknown. MANSOQ selects Active. Required.
Category Social History, Vital Signs, Imaging, Laboratory, Procedure, Survey, Exam, Therapy, or Activity. Required.
Data Type The kind of value that a result holds, for example a number, a yes or no answer, or a date. Required.
LOINC Code The standard code of the test. Search for the code, then select it. Required.

4. Fill in the additional details

Complete the fields in the Additional Details section. These fields are optional.

Components What it captures
Body Site The body part that the test applies to.
Method The technique that staff use to do the test.
Unit The unit of measure for the result.

5. Add components for a multi-part test

If the test has more than one part, for example blood pressure, go to the Components section. Click Add your first component. Add one component for each part of the test. Click Add component for each further part.

Each component holds its own Code, Data Type, and Unit.

6. Save the observation definition

Click Create.

Note: To leave the form without a new observation definition, click Cancel.

Permissions

Permission Access
Can Create Observation Definition on Facility Lets you create a new observation definition for your facility.

Expected Outcome

Version and configuration

These steps are grounded in the version 3.1 user guide and current source anchors. Available actions depend on your facility setup, roles, active catalogue records and deployment configuration. Source references identify the documented revision; live screenshots and site-specific SOPs still require instance-level validation.

Source evidence

References are pinned to the private MANSOQ source repository. Repository access is required to open these links.