Differences

This shows you the differences between two versions of the page.

--- rdms:metadata:metadatatemplates [2023/09/12 16:44]
giulio [Examples of Template Usage] Added example pictures for user-defined types
+++ rdms:metadata:metadatatemplates [2023/09/13 11:11] (current)
jelte WebApp to web portal (consistency)
@@ Line 1: / Line 1: @@
 ====== Metadata Templates ======
-As described in the previous sections, every user of the RDMS can easily add metadata to their objects and collections either via the [[rdms:metadata:metadatawebportal|functionality in the WebApp]] or using [[rdms:metadata:cli|iCommands]]. Described here is another functionality of the web portal related to metadata management: the use of metadata templates.\\
+As described in the previous sections, every user of the RDMS can easily add metadata to their objects and collections either via the [[rdms:metadata:metadatawebportal|functionality in the web portal]] or using [[rdms:metadata:cli|iCommands]]. Described here is another functionality of the web portal related to metadata management: the use of metadata templates.\\
 As the name suggests, metadata templates are pre-configured metadata entry forms that the user can define in order to have **a consistent way of recording metadata** for a given data object or collection. For example, you could have a template attached to a collection recording the "Name of the PI", "Starting date", "Publication state", "Funding agency", etc. Such a template could be used to record information on the projects of a research group, such that the same information is always reliably recorded. Another example would be a template attached to a data object recording the "Acquisition method", "Instrument used", "Temperature", "Humidity", "Reagents", "Researcher responsible", or other values. Such a template could be used to record the instrument settings used to obtain the data object.\\
 The advantage of a template over manual entry of metadata is that the user has a pre-defined list of entries. This reduces the risk of forgetting to record a given value or to have objects with different metadata entries, even though they should have been matching.
@@ Line 164: / Line 164: @@
 ++++
-For the use of ''Complex Types'' in the creation of a template, we want to create a metadata entry that records what instrument was used to record a certain set of data. We also want to record the instrument settings and put restrictions on certain fields. We also want to make sure that certain metadata entries are always recorded when this specific template is used.
+For the use of user-defined types in the creation of a template, we want to create a metadata entry that records what instrument was used to record a certain set of data. We also want to record the instrument settings and put restrictions on certain fields. We also want to make sure that certain metadata entries are always recorded when this specific template is used.
 ++++ Click to display example |
+First we need to create a user-defined type to select our instrument from. Figure 11 shows how to create a ''Simple Type'' that will result in a drop-down menu with three options.
 {{ :rdms:metadata:meta_webtemplate_11.png?direct&800 |}}
@@ Line 175: / Line 177: @@
 <html>
 </center></html>
+Next, we need to create our template. Figure 12 shows how to do so, while using our own type for the choice of instrument. Please also notice that we restrict the input of all our variables to just one entry, except for the ''Researcher present'' variable, where we allow for up to five entries. The restriction can be applied either by specifying the number of ''Minimum number of Occurrences'' and ''Maximum number of Occurrences'', or by simply leaving the fields blank. Leaving the fields blank will not make the entry mandatory, however.
 {{ :rdms:metadata:meta_webtemplate_12.png?direct&800 |}}
@@ Line 183: / Line 187: @@
 <html>
 </center></html>
+Finally, we can once again navigate to the object we wish to attach metadata to and right-click it. Select ''Add metadata template'' in the menu, as for the previous example, then select the template you want to use. Figure 13 shows how the ''Instrument*'' value, now mandatory because of our restrictions, appears as a drop down menu from which you can select the instrument your data has been generated by. The ''Researcher present'' value will also appear five times in this template, starting from ''Researcher present 0'' and going to ''Researcher present 4''.
+**Note**:\\
+The web portal will display one value more than the minimum for non-mandatory entries. In our case, ''Researcher present 0'' and ''Researcher present 1'' are immediately displayed in the input form. Instead, ''Researcher 2'', ''Researcher 3'', and ''Researcher 4'' will appear only if the previous fields are filled out, the form saved and then edited again.
 {{ :rdms:metadata:meta_webtemplate_13.png?direct&800 |}}