Added docs for descryption templates, improved docs structure on some cases

This commit is contained in:
Thomas Georgios Giannos 2024-05-03 15:13:53 +03:00
parent 08d29aac5b
commit e5a6dee348
7 changed files with 179 additions and 3 deletions

View File

@ -1,3 +1,5 @@
import DocCardList from '@theme/DocCardList';
# Blueprints
In this page, there is a listing where you can view details about all the available plan blueprints.
@ -52,6 +54,8 @@ In order for the filters to apply, you have to click the `Apply filters` button.
You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup.
---
## Edit form
When you try to add new dmp blueprints or edit existing ones, the **dmp blueprint editing form** will appear containing the following controls.
@ -114,6 +118,6 @@ Let's clarify a little bit more about our description multiplicity options. Ther
We will explore this in detail in the [Prefilling Configurations](/docs/documentation/administration/blueprints/prefilling-configurations) section.
import DocCardList from '@theme/DocCardList';
---
<br/><DocCardList />

View File

@ -43,6 +43,8 @@ In order for the filters to apply, you have to click the `Apply filters` button.
You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup.
---
## Edit form
When you try to add new languages or edit existing ones, the **language editing form** will appear containing the following controls:

View File

@ -50,6 +50,8 @@ In order for the filters to apply, you have to click the `Apply filters` button.
You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup.
---
## Edit form
When you try to add new notification templates or edit existing ones, the **notification template editing form** will appear containing the following sections.

View File

@ -47,6 +47,8 @@ In order for the filters to apply, you have to click the `Apply filters` button.
You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup.
---
## Edit form
When you try to add new reference types or edit existing ones, the **reference type editing form** will appear containing the following sections.

View File

@ -32,6 +32,10 @@ Let's explore all the available supportive material types:
- **Terms Of Service**
- **User Guide**: A small guide available to the users directly on the platform
---
## End notes
:::note
All the above are available for the users to read, following the links situated at the bottom part of the side navigation, visible on every page.

View File

@ -1,5 +1,6 @@
---
sidebar_position: 3
description: Manage all description template types
---
# Template Types

View File

@ -1,5 +1,166 @@
# Templates
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';
import DocCardList from '@theme/DocCardList';
# Templates
In this page, there is a listing where you can view details about all the available description templates.
:::info
**Description Templates** describe how a [Description](/docs/category/descriptions) is structured. All the chapters and fields a Description is consisting of, are referenced here. More details will follow in the next sections.
:::
The information displayed by default is: the `display name` of the templates, the `status`, the `version` and timestamps for the `creation` and `updates` of the records. At the top right corner of the listing you can also select which columns to display.
:::tip
For description templates, all the columns are visible by default.
:::
You can create new templates by clicking to the `+ Create Description Template` button at the top right of the page. You can otherwise import one if you have it in **XML** file format by clicking the `Import` button, upload the file and provide a name for your template in the popup form.
There are also many more actions available for description templates. When you clink on the three dots at the last column of a template, you can perform one of the following actions:
- **Edit**
- **New Version**: Create a new version of this template.
- **Clone**
- **All Description Template Versions**: View all the versions of this template.<br/>*In the listing, only the last versions of templates are displayed, by default.*
- **Download XML**: Download the structure of the template in XML format.
- **Delete**
## Authorization
Only users that have the **Admin** role can access this page.
## Navigation
This view is available when the user presses the `Description Templates` link from the side navigation menu.
## Pagination
Not all the records are being displayed at once. By default, there is a pagination of 10 records applied to them.
You can control how many records are being displayed at any time, by adjusting the `items per page` control at the bottom left corner of the table.
## Filtering
There is a filtering option available for plan blueprints.
- **Is Active**: By toggling this control you can view only the active or only the disabled templates.<br/>*By default, this option is set to true.*
- **Status**: Filter templates by their status. The status can either be `Draft` or `Finalized`.<br/>*By default, no status is selected.*
In order for the filters to apply, you have to click the `Apply filters` button.
You can also clear any filters already applied, by pressing the `clear all filters` option, located at the top of the popup.
---
## Edit form
When you try to add new description templates or edit existing ones, the **description template editing form** will appear containing the following controls.
- **Description template name**
- **Description**
- **Descryption template type**: There are two template types by default. `Dataset` and `Software`. There is more information available at the [Description template types](/docs/documentation/administration/template-types) section.
- **Description template language**
- **Editors**: The users that own this template. You can add new owners on the template by using the `Editors` dropdown below the Editors listing. You can also remove existing owners by clicking the `Remove Editor` icon on the last column.
You can add one or more **chapters** to the template by clicking the `Form Description` tab that navigates to the second part of the form. Then you can add the first chapter by clicking the `+ Create the first chapter` button.
For every chapter you add, a new form part appears where you can specify everything about that chapter. It is also added to the template navigation sidebar on the left side of the form.
### Description outline form
For a chapter you can specify:
- **Chapter Name**
You can add one or more **sections** to the form by clicking the `Create section` button. For every section you add, a new form part appears where we can specify everything about that section.
### Section form
For a section you can specify:
- **Section Name**
- **Section Description**: A short description for the section.<br/>*This is optional.*
You can add one or more questions to a form section by clicking the `Add Question` button found both on the sidebar and the form when you hover over it (*It appears below it*).
### Question form
For a question you can specify:
- **Title**: The question title
- **Description**: A description for the question which will be displayed below the title.
- **Type**: Here, you can select the ui element that will appear to the form for the user to answer this question if it is custom, or the system [data source](/docs/documentation/administration/reference-types) that will be used.
- **Semantics**: You can view more information [here](/docs/documentation/administration/blueprints/semantics).
- **Default Value**: If you set this, it will be the default answer for this question.
- **Input Placeholder Text**: Text that will appear to the input if it is empty. Only applicable if no default value is set.
- **Required**: If set to true, the answer will be mandatory.
:::info
Inputs that are custom, meaning they are not system specific, can be conditionally added to the form. More information on how to configure this is available in the [conditional questions](/docs/documentation/administration/templates/conditional-questions) page of this section.
:::
At the bottom of the form, there are more options available for our question.
- **Comment field**: Give the user the option to leave comments about his answer.
- **Multiplicity**: Make multiple answers for this question possible. If set to true, four more controls appear.
- **Minimum**: The minimum amount of answers.
- **Maximum**: The maximum amount of answers.
- **Multiplicity Placeholder Text**
- **View inputs in table**: If set to true, all the given answers will also be displayed to the form in a table.
You can add more inputs to the questions by clicking the `Add input` button. For each input you add, you can specify the `type`, the `semantics` and the `default value` as we saw previously. There are more options available for inputs based on the type selected. We will explore our options in the next section.
If you click on the three dots at the bottom right corner of the question form, you can specify the following.
- **Description**: There is already a description section included by default. Here, you can select to ommit it.
- **Extended Description**: This is useful if you want to hide part of the description. If set, a `View more` link will appear below the main description so that the user can reveal the extended description.
- **Additional Information**: If set, a bubble tooltip will be available next to the question title. This is intended to give some short useful tips to the user.
### Input form
Some input types require extra configurations.
<Tabs>
<TabItem value="upload" label="Upload">
- **Max File Size**: It is required to limit the size of the files uploaded by the user.
- **File types**: You can force the upload of specific file types.
- **Other file types**: If the file type is not available in the dropdown, you can add your own by pressing the `+` icon and giving a name and the specific MIME type you want.
</TabItem>
<TabItem value="radio" label="Radio Box">
You can add one or more options for the users to select, by pressing the `+` button on the `Radio Box Data` section.
- **Label**: The label of the option.
- **Value**: The actual input value.
</TabItem>
<TabItem value="select" label="Select">
You can add one or more options for the users to select, by pressing the `+` button on the `Word List Data` section.
- **Label**: The label of the option.
- **Value**: The actual input value.
- **Multiple Selection**: When set to true, the user can select more than one options.
</TabItem>
<TabItem value="reference-types" label="Reference Types">
- **Reference Type**: You can learn more on the [reference types](/docs/documentation/administration/reference-types) section.
- **Multiple Selection**: When set to true, the user can select more than one options.
</TabItem>
</Tabs>
## End notes
:::tip
For every question you configure, you can view a live preview on how it will look on the form.
:::
---
<DocCardList />