Difference between revisions of "Annotations"

From FMR Knowledge Base
Jump to navigation Jump to search
(Annotation Wizard)
(Overview)
 
(5 intermediate revisions by 2 users not shown)
Line 5: Line 5:
 
Annotations are used to provide extra information to structures, almost every structure can be annotated, and can contain zero to many annotations.  Annotations provide placeholders for Annotation Id, Annotation Title, Annotation Type, Annotation Text, Annotation URI all of which are optional fields.
 
Annotations are used to provide extra information to structures, almost every structure can be annotated, and can contain zero to many annotations.  Annotations provide placeholders for Annotation Id, Annotation Title, Annotation Type, Annotation Text, Annotation URI all of which are optional fields.
  
Multi-lingual capabilities are introduced in Version 11.15.
+
Multi-lingual capabilities are introduced in Version 11.15.0 of the FMR.
  
 
== Annotation Wizard ==
 
== Annotation Wizard ==
Line 19: Line 19:
 
[[File:Annotations - Wizard step 1.png|Step 1|1000px]]
 
[[File:Annotations - Wizard step 1.png|Step 1|1000px]]
  
Note, you do not have to use this step unles you wish the annotation to be attached to the parent structure.
+
Note, you do not have to use this step unless you wish the annotation to be attached to the parent structure.
  
In this example there is one Annotation but the text field shows three different languages. The additional language are added via The Add Language button. To remove a language, select the record in the appropriate language and simpley remove the text then click edit to register the change.
+
In this example there is a single Annotation but the text field shows three different languages. The additional language are added via the "Add Language" button. To remove a language, select the record in the appropriate language and simply remove the text then click "Edit" to register the change.
  
 
The second step allows Annotations to be imported against the sub structures, these are known as Identifiable structures, for example a Code in a Codelist.  The step provides the means to import the annotation(s) as CSV.
 
The second step allows Annotations to be imported against the sub structures, these are known as Identifiable structures, for example a Code in a Codelist.  The step provides the means to import the annotation(s) as CSV.
Line 30: Line 30:
 
The only required fields are Identifiable Id (which must reference an item in the Maintainable parent), and Annotation Id.
 
The only required fields are Identifiable Id (which must reference an item in the Maintainable parent), and Annotation Id.
  
The third step allows Annotations to be manually created, edited, and deleted against the sub structures (Identifiable), i.e,import for Codes in a Codelist.
+
The third step allows Annotations to be manually created, edited, and deleted against the sub structures (Identifiable), i.e,import for Codes in a Codelist.  
 +
 
 +
[[File:Annotations - Wizard step 3.png|Annotations csv input|1000px]]
  
 
This step provides a table view of all the current annotations against the sub-structures, with the means to edit the selected structure, or to create new or delete existing annotations.
 
This step provides a table view of all the current annotations against the sub-structures, with the means to edit the selected structure, or to create new or delete existing annotations.
Line 36: Line 38:
 
== Viewing Annotations ==
 
== Viewing Annotations ==
  
If a structure, or its Identifiable sub-structures, contains annotations, then this will be displayed in the table of details section for the selected structure (under the main table).   
+
If a structure, or its Identifiable sub-structures, contains annotations, then these will be displayed in the table of details section for the selected structure (under the main table).   
 +
 
 +
The '''View Annotations''' button will be present, and on clicking will open a pop-up modal which will show all the annotations against the structure, or any of its sub-structures.
  
The '''View Annotations''' button will be present, and on clicking will open a pop up which will show all the annotations against the structure, or any of its sub-structures.
+
[[File:Annotations - Viewing.png|View Button|1000px]]
  
[[File:Annotations 3.jpg‎|frameless|View Annotations|700px]]
+
Click View Annotations to show the details.
  
<small>''Figure 2 showing the Codelists page, the selected Codelist (FREQ) has annotations for it''</small>
+
[[File:Annotations - View.png|View Button|1000px]]

Latest revision as of 08:57, 12 February 2024

Overview

Annotations are used to provide extra information to structures, almost every structure can be annotated, and can contain zero to many annotations. Annotations provide placeholders for Annotation Id, Annotation Title, Annotation Type, Annotation Text, Annotation URI all of which are optional fields.

Multi-lingual capabilities are introduced in Version 11.15.0 of the FMR.

Annotation Wizard

To create annotations, ensure you are logged into the system as an admin user or an Agency user. Navigate to the structure to be annotated (or the parent structure, for example to annotate a Code, navigate to the Codelist that owns the Codes). On structure selection, click the maintenance icon at the top left of the page, to select Manage Annotations to open an Annotation Wizard.

Manage Annotations

Figure 1 showing the Manage Annotations menu option

The first step of the wizard is to add annotations to the parent structure that was selected, this is the top level parent structure, for example the Codelist. The subsequent steps relate to annotating the sub structures, such as the Codes that belong to the Codelist.

Step 1

Note, you do not have to use this step unless you wish the annotation to be attached to the parent structure.

In this example there is a single Annotation but the text field shows three different languages. The additional language are added via the "Add Language" button. To remove a language, select the record in the appropriate language and simply remove the text then click "Edit" to register the change.

The second step allows Annotations to be imported against the sub structures, these are known as Identifiable structures, for example a Code in a Codelist. The step provides the means to import the annotation(s) as CSV.


Annotations csv input

The only required fields are Identifiable Id (which must reference an item in the Maintainable parent), and Annotation Id.

The third step allows Annotations to be manually created, edited, and deleted against the sub structures (Identifiable), i.e,import for Codes in a Codelist.

Annotations csv input

This step provides a table view of all the current annotations against the sub-structures, with the means to edit the selected structure, or to create new or delete existing annotations.

Viewing Annotations

If a structure, or its Identifiable sub-structures, contains annotations, then these will be displayed in the table of details section for the selected structure (under the main table).

The View Annotations button will be present, and on clicking will open a pop-up modal which will show all the annotations against the structure, or any of its sub-structures.

View Button

Click View Annotations to show the details.

View Button