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
- You are a member of the facility.
- You have the permission listed below.
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
- MANSOQ creates the observation definition for your facility.
- The new observation definition shows in the observation definitions list.
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.
- repositories/platform/mansoq-documentation/versioned_docs/version-3.1/flows/definitions/observation-definition/create-observation-definition.mdx:5 · f6e9f05f
- repositories/platform/mansoq-documentation/versioned_docs/version-3.1/flows/definitions/observation-definition/create-observation-definition.mdx:22 · f6e9f05f
- repositories/platform/mansoq-web/src/pages/Facility/settings/observationDefinition/ObservationDefinitionForm.tsx:70 · f6e9f05f