diff --git a/external/daisy/R3labCARD-daisy.md b/external/daisy/R3labCARD-daisy.md new file mode 100644 index 0000000000000000000000000000000000000000..948fd7118b738dba52e40432f6132f775b7e0095 --- /dev/null +++ b/external/daisy/R3labCARD-daisy.md @@ -0,0 +1,37 @@ +--- +layout: page +permalink: /external/daisy/ + +--- +# <a name="top"></a>DAISY User Guide +{:.no_toc} +This LabCard is the user guide for the Data Information System (DAISY). If it is your first time with the guide then start with Section **DAISY at a Glance**. + +* TOC +{:toc} + +{% include_relative at_a_glance.md %} +{% include_relative interface_conventions.md %} +{% include_relative project_management.md %} +{% include_relative dataset_management.md %} +{% include_relative contract_management.md %} +{% include_relative definitions_management.md %} +{% include_relative user_management.md %} + + +<!--- Below fragment is needed for TOC in iAWriter PDF export + +{{TOC}} + +/at_a_glance.md "DAISY at a glance" +/interface_conventions.md "Interface Conventions" +/project_management.md "Project Management" +/dataset_management.md "Dataset Management" +/contract_management.md "Contract Management" +/definitions_management.md "Definitions Management" +/user_management.md "User and Permission Management" + ++++ + +--> + diff --git a/external/daisy/at_a_glance.md b/external/daisy/at_a_glance.md new file mode 100644 index 0000000000000000000000000000000000000000..9789ab92f736e94425fd2384bf91d4a76c419bed --- /dev/null +++ b/external/daisy/at_a_glance.md @@ -0,0 +1,35 @@ + + +# 1 DAISY at a Glance + +DAISY is a tool that assists GDPR compliance by keeping a register of personal data used in research. DAISY's application menu Bar lists the main functions provided. + +  + <center>DAISY Menubar</center> + + * _Project Management_ module allows for the recording of research activities as projects. Documenting projects is critical for GDPR compliance as projects constitute the purpose and the context of use of personal data. Any document supporting the legal and ethical basis for data use can be stored in DAISY. Examples are ethics approvals, consent configurations, or subject information sheets. + * _Dataset Management_ module allows for the recording of personal data held by the institution. The dataset may or may not fall in the context of a particular project. DAISY allows Datasets to be defined in a granular way; where - if desired - each data subset, called a data declaration, can be listed individually. These declarations may list data from a particular partner, data of a particular cohort or data of a particular type. + * _Contract Management_ module allows the recording and storage of legal contracts of various types that have been signed with partner institutes or suppliers. Consortium agreements, data sharing agreements, material transfer agreements are examples of contracts. For GDPR compliance contracts become useful when documenting the source of datasets received or the target datasets transferred. + * _Definitions Management_. DAISY comes pre-packed with default lookup lists; these can be changed during application deployment. Lookup lists are used when defining contracts, projects or datasets. The definitions module of the DAISY application allows the management of dynamic lookup lists, specifically those of cohorts, partner institutes and contact persons. + +The dependencies between DAISY modules is given below. There are no hard dependencies between the Projects, Contracts and Datasets modules. In principle you may start using any of these modules once DAISY is deployed with pre-packed definitions. + + + <center>DAISY module dependencies</center> + +<mark>Our suggestion to first-time users is the following</mark>: + +1. Familiarise yourself with DAISY's interface conventions by reading the [relevant section of this guide](#DIC). +2. Login to DAISY with a user that has Administrator or VIP privileges. E.g. In the demo deployment the _admin_ user has Administrator privileges and _alice.white_ has VIP privileges. +3. Use Project Management to [create a project](#PM1). +4. Use Dataset Management to [create a dataset](#PM21) within the defined project. + + + +<br /> +<br /> +<br /> +<div style="text-align: right;"> <a href="#top">Back to top</a> </div> +<br /> +<br /> +<br /> diff --git a/external/daisy/contract_management.md b/external/daisy/contract_management.md new file mode 100644 index 0000000000000000000000000000000000000000..d175918bbca660c9b122cc2484297e0975898a83 --- /dev/null +++ b/external/daisy/contract_management.md @@ -0,0 +1,51 @@ + +<a name="CM"></a> +# 5 Contract Management + +The Contract Management module allows recording legal documents signed in the context of research activities. Contracts are typically linked to Projects and provide the necessary traceability for the GDPR compliant provision and transfer of data. + +<a name="CM1"></a> +## 5.1 Create New Contract + +<mark>In order to create a new contract</mark>: + +1. Click Contracts from the Menu Bar.<br /> +  +2. Click the add button from the Contract Search Page.<br /> +  +3. You will see an empty Contract Form. The _Project_ field is optional, meanwhile, in practice most contracts are signed in the context of a research project. In the _Roles_ field, you are expected to select one or more GDPR role that identifies your institutions roles as described in the Contract. In the _Other comments_ section you may describe the nature of the document or if the document has an ID/REF e.g. from a document management system, you may put it in. Just like projects and datasets, when creating contracts you are expected to provide a local responsible in the _Local Custodians_ field. As stated before, one of the Local Custodians must be a user with VIP Privileges. E.g. in the demo deployment _alice.white_ is a research principle investigator and is a VIP user.<br /> + +4. Click SUBMIT. Once you successfully save the form, you will be taken to the newly created contract's details page, as seen below.<br /> + + +<a name="CM2"></a> +## 5.2 Manage Contract Details + +After initial creation the contract will be in a skeletal form and would need further input on its signatories and document attachments. + +### 5.2.1 Manage Contract Partners (Signatories) + +Contracts have multiple signatories. These can be managed via the **Partners (Signatories)** detail box. + + +1. Click the plus button on the **Partners (Signatories)** details box, as seen below.<br /> +  +2. You will see the **Partner and role** addition form. In this form, you will be asked to select the _Partner_ as well as the GDPR _Roles_ that this partner assumes in the contract. You can select more than one role. It is also mandatory to provide a contact person that is with the selected partner institute. You can either select from the list or you can add a new contact if it does not already exist. + +3. Once you fill in the information and click SUBMIT the partner will be added to the list of signatories, as seen below. Partners can be removed from a contract by clicking on the trash icon that will appear when hovering over the items in the **Partner and role detail box**.<br /> + + +### 5.2.2 Manage Contract Documents + +You may attach PDF, word documents, scans, via the **Documents** detail box. Document management is common throughout DAISY modules. It is described [here](#PM25). + + + + +<br /> +<br /> +<br /> +<div style="text-align: right;"> <a href="#top">Back to top</a> </div> +<br /> +<br /> +<br /> \ No newline at end of file diff --git a/external/daisy/dataset_management.md b/external/daisy/dataset_management.md new file mode 100644 index 0000000000000000000000000000000000000000..6483c27cd8c17027326c4a13348d760913486b4c --- /dev/null +++ b/external/daisy/dataset_management.md @@ -0,0 +1,120 @@ +<a name="DM"></a> +# 4 Dataset Management + +<a name="DM1"></a> +## 4.1 Create New Dataset +In order to create a new Dataset: + +1. Click Datasets from the Menu Bar.<br /> +  +2. Click the add button from the Dataset Search Page.<br /> +  +3. You will see the **Dataset Creation Quick Form**<br /> +  +4. Click SUBMIT. Once you successfully save the form, you will be taken to the newly created dataset's details page, as seen below. <br /> + +  + +<a name="DM2"></a> +## 4.2 Declare Data within the Dataset +After initial creation the dataset will be in a skeletal form. The dataset needs to be fleshed out with further information on the characteristics of the data it contains. We do this by creating **data declarations** within the dataset, by following these steps. + + 1. Click the plus button on the **Data declarations** details box.<br /> +  + + 2. You will see the **Data declaration Creation Quick Form** as below. With the **Data declaration Creation Quick Form** you are asked for a **Title** for the declaration and denote where the data was **Obtained from** by selecting one of three options. For the **Title** one can use the same title you used earlier when creating the dataset. However, if you're going to have multiple declarations within a dataset you can give them names based on their source or their type (e.g. Helsinki Cohort, Parkinson Study-2, LuxPARK PARK2 Cell lines etc). It is important that the **Title** is a name that is familiar to you and your research group as it will be used in free text search over datasets. The options for the **Obtained from** field is described in detail [in the remainder of this section](#DDEC_OPTIONS). <br /> + + +3. Click SUBMIT. The data declaration will be created you will be taken to the **Data Declaration Editor Page**. + +Before we describe the details of data declaration editing we will discuss the three different options for specifying the origin of data in DAISY. + +<a name="DDEC_OPTIONS"></a> <mark>The <strong>Obtained from</strong> field captures important information, but, for the first-time users of DAISY it can be difficult to populate. Your choice among the three options will determine if and how your dataset will be linked to other entities in DAISY. If you are a first-time user and you're creating records for learning purposes, we suggest that you choose the option "Other" for simplicity.</mark> + +<span>○ </span><mark><strong>From existing data/samples:</strong></mark> When you state that the data is obtained from existing data/samples in your institution, DAISY will prompt you (as below) to search for and choose the data record which is the origin for your current declaration. + +  + +You will be provided a searchable selection box, through which you can find existing data records by their Project, by responsible PI or by their title. As you will be making a selection from existing records, with this option, it is necessary that origin data had been entered into DAISY earlier. + + +By choosing the **from existing data/samples:** you will link the newly created data declaration to an existing data declaration in daisy, as depicted below. + +  + +<span>○</span><mark><strong>Newly incoming data/samples:</strong></mark> When you select this option, it means you are obtaining data from a collaborator institute or from a repository and this data is being recorded for the first time in DAISY. With this option DAISY will first ask you to select a partner (institutes and repositories are both in the partner list). Once you select a partner DAISY will then list all those contracts that are in the system involving this partner and that have local custodians overlapping with the custodians of the dataset you're detailing. If there are no such contracts or if none of the existing contracts foresee the receipt of this data, then you have to option to create an empty contract. You can later on provide the details and documentation for this empty contract. It is possible that in some DAISY deployments the _Contract Management_ module, in that case the empty contract acts as a link to the source partner for the data. + +  + +When the **newly incoming data/samples** option is chose, DAISY will link the newly created data declaration to a Contract and and associated Partner(s), as depicted below. + + +  + +<span>○</span><mark><strong>Other:</strong></mark> When you select this option, it means you do not want to create any structured DAISY records to denote the origin of data being declared. DAISY will prompt you to provide a free-text description of the origin of data as seen below. + +  + +Data declared with the **Other** option will not have links to any other records as to its origin. + +  + + +After selecting any one of the options and creating the data declaration, you will be taken back to the Dataset Details Page. You can see the newly added declaration listed in the **Data Declarations** detail box. This box also provides action buttons for editing, deleting, and cloning data declarations, as seen below. + +  + + +Once created you're advised to edit the declaration to provide further information about the data. Data declarations have several fields in addition to the title and origin supplied during their creation. + + +  + + +## 4.3 Manage Dataset Locations + +As per GDPR, the storage of personal data is considered as a``data processing'' and needs tone recorded. The **Storage Locations detail box** allows you to do this. In order to record a new storage location: +1. click the plus button on the **Storage Locations** detail box depicted below. <br /> + +  + +2. You will see the location creation form asking you for the _Storage Backend_ and the _Nature of data copy_ the _Stored datatypes_ (optional) and _Location of the data_ for the paper. The backends box will list storage platforms for your institution, you need to select one and in the location box you're expected to provide information on where the data can be found on the selected platform. Please note that you are not expected to document individual files. E.g. it is good practice to record the top level folder in which a certain dataset exists. The datatypes are optional and if you're not separately storing data subsets by type then there is no need to specify datatype information for a location. + +  + + +3. Click SUBMIT and the new location will be listed as below. Storage locations can be deleted by clicking on the trash icon that will appear when hovering over items in the **Storage Locations detail box**. <br /> + + +  + +## 4.4 Manage Dataset Accesses + +As per GDPR, any access to personal data held in an institution needs to be recorded. The **Accesses detail box** allows you to do this. **IMPORTANT NOTE: Before recording access, make sure you have recorded storage locations of data.** + +In order to add a new access record: + +1. Click the plus button on the **Accesses** detail box depicted below.<br /> +  +2. You will see the access creation form. Access is defined over a specific storage location, so you'd need to select one from the _Data Locations_ list. In addition you'd need to document the access control policy in the _Remarks_ section. If access is time-limited you may specify the start and end dates for its validity. By default all accesses recorded will fall under the scope of the project, which owns the dataset. It is also possible to record accesses, in the scope of other projects, to do so you must select one from the _Project_ list. We discuss access across projects later in this section.<br /> +  +3. Click SUBMIT and the new access will be recorded and listed on the dataset's page as below. Accesses can be deleted by clicking on the trash icon that will appear when hovering over items in the **Accesses detail box**. <br /> +  + + +As discussed above, when data of one project is being access in the context of another project, this can be specified by in the access creation form by selecting a Project (see below left). When you create access records in this way, the dataset will be linked to the project accessing it. This dataset will be listed in the **Dat used from other projects** detail box (see below right). +  + + + + +<br /> +<br /> +<br /> +<div style="text-align: right;"> <a href="#top">Back to top</a> </div> +<br /> +<br /> +<br /> + + + diff --git a/external/daisy/definitions_management.md b/external/daisy/definitions_management.md new file mode 100644 index 0000000000000000000000000000000000000000..f2c648c53c00ca2458ac8871c5bfb8698a90026d --- /dev/null +++ b/external/daisy/definitions_management.md @@ -0,0 +1,42 @@ +<a name="DEF_M"></a> +# 6 Definitions Management + +With the _Definitions_ module, DAISY allows the management of _Contacts, _Cohorts_ and _Partners_. All pages within _Definitions_ operate according to the interface conventions given in the [relevant section of this guide](#DIC). In the following sections we only discuss what information is held in these definitions. + + +<a name="COH_M"></a> +## 6.1 Cohorts Management +Cohort is a study that collects data and/or bio-samples from a group of participants (e.g. longitudinal case-control or family studies). A cohort is linked to the creation of data and is considered its ultimate source. + +In order to effectively handle data subjects' requests, as per GDPR, it is crucial that an institution keeps track of what data it keeps from which cohorts. Inline with this, DAISY allows maintaining a list of _Cohorts_ and link _Datasets_ to _Cohorts_. + +The information kept on cohorts can be seen in the associated _Editor Page_ seen below. Cohorts are expected to have a _Title_ unique to them, and they are linked to one or more _Cohort Owners_, which are that are Principle Investigators, Clinicians running the study. Cohorts owners are kept as _Contacts_ in DAISY. In order to maintain a controlled list of cohorts, the administrator for the DAISY deployment may assign an accession number to the _Cohort_, which would be the unique identifier for this Cohort. <br /> + + + + <a name="PAR_M"></a> +## 6.2 Partners Management + +A _Partner_ is a research collaborator that is the source and/or recipient of human data. Partners are also legal entities with whom contracts are signed. Clinical entities that run longitudinal cohorts, research institutes, or data hubs are all examples of Partners. +In accordance, when maintaining _Dataset_ source info, _Dataset_ transfer info or when creating _Contract_ records, you will be asked to select Partners. + +The information kept on partners can be seen in the associated _Editor Page_ seen below. <br /> + + +<a name="CONN_M"></a> +## 6.3 Contacts Management + +DAISY allows keeping an address book of all contact persons related to the _Projects_, _Datasets_, _Cohorts_ and _Contracts_. + +The information kept on contacts is pretty standard as can be seen in the associated _Editor Page_ given below. <br /> + + + + +<br /> +<br /> +<br /> +<div style="text-align: right;"> <a href="#top">Back to top</a> </div> +<br /> +<br /> +<br /> \ No newline at end of file diff --git a/external/daisy/images/add_button.png b/external/daisy/images/add_button.png new file mode 100644 index 0000000000000000000000000000000000000000..dfa01b4df3a318ba6612f0a9800263c01588a127 Binary files /dev/null and b/external/daisy/images/add_button.png differ diff --git a/external/daisy/images/cohort_edit_form.png b/external/daisy/images/cohort_edit_form.png new file mode 100644 index 0000000000000000000000000000000000000000..be79a93f4d3edd6063f59aa48c0fee67960028b2 Binary files /dev/null and b/external/daisy/images/cohort_edit_form.png differ diff --git a/external/daisy/images/contact_edit_form.png b/external/daisy/images/contact_edit_form.png new file mode 100644 index 0000000000000000000000000000000000000000..2283a85bb246d9fa3db3126c32622cf3061b6573 Binary files /dev/null and b/external/daisy/images/contact_edit_form.png differ diff --git a/external/daisy/images/contract_add_form.png b/external/daisy/images/contract_add_form.png new file mode 100644 index 0000000000000000000000000000000000000000..a032fa2a4d4559c2e316ad3a9094177b23560d8e Binary files /dev/null and b/external/daisy/images/contract_add_form.png differ diff --git a/external/daisy/images/contract_add_partner.png b/external/daisy/images/contract_add_partner.png new file mode 100644 index 0000000000000000000000000000000000000000..436b0cf2d41a3bb4dd21799cea05ed0eaf25d72f Binary files /dev/null and b/external/daisy/images/contract_add_partner.png differ diff --git a/external/daisy/images/contract_add_partner_form.png b/external/daisy/images/contract_add_partner_form.png new file mode 100644 index 0000000000000000000000000000000000000000..b5bde54768ea976a0fc818f85691a70f18b473be Binary files /dev/null and b/external/daisy/images/contract_add_partner_form.png differ diff --git a/external/daisy/images/contract_add_partner_result.png b/external/daisy/images/contract_add_partner_result.png new file mode 100644 index 0000000000000000000000000000000000000000..6b4db26f221966f6d2ccaf9347477135dbfef2ed Binary files /dev/null and b/external/daisy/images/contract_add_partner_result.png differ diff --git a/external/daisy/images/contract_created.png b/external/daisy/images/contract_created.png new file mode 100644 index 0000000000000000000000000000000000000000..0091cd09fe30f14bc7845f47267078ee9c2a89f7 Binary files /dev/null and b/external/daisy/images/contract_created.png differ diff --git a/external/daisy/images/contract_menubar.png b/external/daisy/images/contract_menubar.png new file mode 100644 index 0000000000000000000000000000000000000000..2af1b92ef47edfa9f9a2fc454242379456bf3df2 Binary files /dev/null and b/external/daisy/images/contract_menubar.png differ diff --git a/external/daisy/images/datadec_actions.png b/external/daisy/images/datadec_actions.png new file mode 100644 index 0000000000000000000000000000000000000000..af729a9ee73b51e4a2596b1e8e65acdfdbaf912d Binary files /dev/null and b/external/daisy/images/datadec_actions.png differ diff --git a/external/daisy/images/datadec_added.png b/external/daisy/images/datadec_added.png new file mode 100644 index 0000000000000000000000000000000000000000..76012663f00b35267d6c6b7be73c7b6c3ed25598 Binary files /dev/null and b/external/daisy/images/datadec_added.png differ diff --git a/external/daisy/images/datadec_edit_1.png b/external/daisy/images/datadec_edit_1.png new file mode 100644 index 0000000000000000000000000000000000000000..8328781408012c1e600460c2d8bf734d8a832517 Binary files /dev/null and b/external/daisy/images/datadec_edit_1.png differ diff --git a/external/daisy/images/datadec_empty.png b/external/daisy/images/datadec_empty.png new file mode 100644 index 0000000000000000000000000000000000000000..226bff7f55871a74db1a91c53c1e2d8d0f943da4 Binary files /dev/null and b/external/daisy/images/datadec_empty.png differ diff --git a/external/daisy/images/datadec_from_existing.png b/external/daisy/images/datadec_from_existing.png new file mode 100644 index 0000000000000000000000000000000000000000..04e7a3a5ffb1ea91461b7fcec2e005c8f5eee865 Binary files /dev/null and b/external/daisy/images/datadec_from_existing.png differ diff --git a/external/daisy/images/datadec_newly_incoming.png b/external/daisy/images/datadec_newly_incoming.png new file mode 100644 index 0000000000000000000000000000000000000000..173678f95aad1239c4cf1a9a7f75c4d81073f0ef Binary files /dev/null and b/external/daisy/images/datadec_newly_incoming.png differ diff --git a/external/daisy/images/datadec_other.png b/external/daisy/images/datadec_other.png new file mode 100644 index 0000000000000000000000000000000000000000..239df8fabdfb39ae27c3a0f828160c3ac7b269fe Binary files /dev/null and b/external/daisy/images/datadec_other.png differ diff --git a/external/daisy/images/datadec_quick_form.png b/external/daisy/images/datadec_quick_form.png new file mode 100644 index 0000000000000000000000000000000000000000..5437138b14287ae46cd9c75ea7d1b2458a8df9bf Binary files /dev/null and b/external/daisy/images/datadec_quick_form.png differ diff --git a/external/daisy/images/dataset_access_other_project.png b/external/daisy/images/dataset_access_other_project.png new file mode 100644 index 0000000000000000000000000000000000000000..a2f88772e987f3fb0b398ffe1d9da242b4b39b0b Binary files /dev/null and b/external/daisy/images/dataset_access_other_project.png differ diff --git a/external/daisy/images/dataset_add_access.png b/external/daisy/images/dataset_add_access.png new file mode 100644 index 0000000000000000000000000000000000000000..695b1e183af7db08811a6a69d6a03dc312a44089 Binary files /dev/null and b/external/daisy/images/dataset_add_access.png differ diff --git a/external/daisy/images/dataset_add_access_form.png b/external/daisy/images/dataset_add_access_form.png new file mode 100644 index 0000000000000000000000000000000000000000..f8df895a2266187f0753afcd09c5e2a63b624bba Binary files /dev/null and b/external/daisy/images/dataset_add_access_form.png differ diff --git a/external/daisy/images/dataset_add_location.png b/external/daisy/images/dataset_add_location.png new file mode 100644 index 0000000000000000000000000000000000000000..84e3dea8bb9639f85ac1c4069843216cddc5236b Binary files /dev/null and b/external/daisy/images/dataset_add_location.png differ diff --git a/external/daisy/images/dataset_add_location_form.png b/external/daisy/images/dataset_add_location_form.png new file mode 100644 index 0000000000000000000000000000000000000000..28e3c6cc81147d8e4894de0ad446f3839ce84b1c Binary files /dev/null and b/external/daisy/images/dataset_add_location_form.png differ diff --git a/external/daisy/images/dataset_details.png b/external/daisy/images/dataset_details.png new file mode 100644 index 0000000000000000000000000000000000000000..07a3c242640fa8ae043e63b27716e6590514bdfb Binary files /dev/null and b/external/daisy/images/dataset_details.png differ diff --git a/external/daisy/images/dataset_menubar.png b/external/daisy/images/dataset_menubar.png new file mode 100644 index 0000000000000000000000000000000000000000..41bff6eb6f71465f12406b9822e406ee83bf095c Binary files /dev/null and b/external/daisy/images/dataset_menubar.png differ diff --git a/external/daisy/images/dataset_quick_form.png b/external/daisy/images/dataset_quick_form.png new file mode 100644 index 0000000000000000000000000000000000000000..0cd6e3ab1b64683e668eff1839417cc546b1fd81 Binary files /dev/null and b/external/daisy/images/dataset_quick_form.png differ diff --git a/external/daisy/images/dataset_remove_access.png b/external/daisy/images/dataset_remove_access.png new file mode 100644 index 0000000000000000000000000000000000000000..68d8f0bea2da3bdaed0040218d6bfb77b490566c Binary files /dev/null and b/external/daisy/images/dataset_remove_access.png differ diff --git a/external/daisy/images/dataset_remove_location.png b/external/daisy/images/dataset_remove_location.png new file mode 100644 index 0000000000000000000000000000000000000000..8813f39a0957aaba43acc154d836b666bda7401a Binary files /dev/null and b/external/daisy/images/dataset_remove_location.png differ diff --git a/external/daisy/images/dependencies.png b/external/daisy/images/dependencies.png new file mode 100644 index 0000000000000000000000000000000000000000..b79be720d0678af23b266fed1b56e9e33a92643c Binary files /dev/null and b/external/daisy/images/dependencies.png differ diff --git a/external/daisy/images/details_page.png b/external/daisy/images/details_page.png new file mode 100644 index 0000000000000000000000000000000000000000..42dcf2d6892839785a0fe119badce1aed3412c7a Binary files /dev/null and b/external/daisy/images/details_page.png differ diff --git a/external/daisy/images/editor_form.png b/external/daisy/images/editor_form.png new file mode 100644 index 0000000000000000000000000000000000000000..9fe2988b24842c641280d3224b0c4d31875ad3a6 Binary files /dev/null and b/external/daisy/images/editor_form.png differ diff --git a/external/daisy/images/from_existing_topology.png b/external/daisy/images/from_existing_topology.png new file mode 100644 index 0000000000000000000000000000000000000000..07d8acba49162661f068e953ea4e9761d3cfb807 Binary files /dev/null and b/external/daisy/images/from_existing_topology.png differ diff --git a/external/daisy/images/login.png b/external/daisy/images/login.png new file mode 100644 index 0000000000000000000000000000000000000000..a0ef3d316d4fca065cb8a0aa2476fa1a91b00743 Binary files /dev/null and b/external/daisy/images/login.png differ diff --git a/external/daisy/images/menubar.png b/external/daisy/images/menubar.png new file mode 100644 index 0000000000000000000000000000000000000000..80d6523908e4696bc35d1a117540f1fed6ae2ed0 Binary files /dev/null and b/external/daisy/images/menubar.png differ diff --git a/external/daisy/images/newly_incoming_topology.png b/external/daisy/images/newly_incoming_topology.png new file mode 100644 index 0000000000000000000000000000000000000000..3b42a7787832235cc07df2992e9fbe6d25364bc7 Binary files /dev/null and b/external/daisy/images/newly_incoming_topology.png differ diff --git a/external/daisy/images/other_topology.png b/external/daisy/images/other_topology.png new file mode 100644 index 0000000000000000000000000000000000000000..7ab5279ab20f34a250f3318a1211c59e0676a908 Binary files /dev/null and b/external/daisy/images/other_topology.png differ diff --git a/external/daisy/images/page_messages.png b/external/daisy/images/page_messages.png new file mode 100644 index 0000000000000000000000000000000000000000..ffe18f8da269fe5e19c8bf6312e2eaf576881167 Binary files /dev/null and b/external/daisy/images/page_messages.png differ diff --git a/external/daisy/images/partner_edit_form.png b/external/daisy/images/partner_edit_form.png new file mode 100644 index 0000000000000000000000000000000000000000..048449992541be699bf6e864cbb1393cc4475caa Binary files /dev/null and b/external/daisy/images/partner_edit_form.png differ diff --git a/external/daisy/images/project_add_contact.png b/external/daisy/images/project_add_contact.png new file mode 100644 index 0000000000000000000000000000000000000000..f8440f6e15f08d161bb4c69c8c61fa62370001ec Binary files /dev/null and b/external/daisy/images/project_add_contact.png differ diff --git a/external/daisy/images/project_add_contact_form.png b/external/daisy/images/project_add_contact_form.png new file mode 100644 index 0000000000000000000000000000000000000000..f1fb8d533af29d84471a7bab0ea272cdce55c03e Binary files /dev/null and b/external/daisy/images/project_add_contact_form.png differ diff --git a/external/daisy/images/project_add_dataset.png b/external/daisy/images/project_add_dataset.png new file mode 100644 index 0000000000000000000000000000000000000000..d0987f628a4b41c2c572cb55f5bee1cf81c65d4b Binary files /dev/null and b/external/daisy/images/project_add_dataset.png differ diff --git a/external/daisy/images/project_add_dataset_form.png b/external/daisy/images/project_add_dataset_form.png new file mode 100644 index 0000000000000000000000000000000000000000..d1d3a4a81a07085bf3ad55697de758db1e869643 Binary files /dev/null and b/external/daisy/images/project_add_dataset_form.png differ diff --git a/external/daisy/images/project_add_dataset_result.png b/external/daisy/images/project_add_dataset_result.png new file mode 100644 index 0000000000000000000000000000000000000000..47371ac96aca90c98f306611c0675cde73a35a8d Binary files /dev/null and b/external/daisy/images/project_add_dataset_result.png differ diff --git a/external/daisy/images/project_add_document.png b/external/daisy/images/project_add_document.png new file mode 100644 index 0000000000000000000000000000000000000000..40ec4b09c26344a8ab676311e6d9afd9970a8f2c Binary files /dev/null and b/external/daisy/images/project_add_document.png differ diff --git a/external/daisy/images/project_add_document_form.png b/external/daisy/images/project_add_document_form.png new file mode 100644 index 0000000000000000000000000000000000000000..fd078a11474143072d1bf5ecb2c3117a132a0b3b Binary files /dev/null and b/external/daisy/images/project_add_document_form.png differ diff --git a/external/daisy/images/project_add_publication.png b/external/daisy/images/project_add_publication.png new file mode 100644 index 0000000000000000000000000000000000000000..784c8b28b1b0463484bbfdbba1a146ed246c7e7e Binary files /dev/null and b/external/daisy/images/project_add_publication.png differ diff --git a/external/daisy/images/project_add_publication_form.png b/external/daisy/images/project_add_publication_form.png new file mode 100644 index 0000000000000000000000000000000000000000..636e7d7a9f9e1cf207bb2f27b0fc96fd3b04f5f0 Binary files /dev/null and b/external/daisy/images/project_add_publication_form.png differ diff --git a/external/daisy/images/project_created.png b/external/daisy/images/project_created.png new file mode 100644 index 0000000000000000000000000000000000000000..2aa85d82e78bc6f55c2ce256d4ce635999a383be Binary files /dev/null and b/external/daisy/images/project_created.png differ diff --git a/external/daisy/images/project_custodians.png b/external/daisy/images/project_custodians.png new file mode 100644 index 0000000000000000000000000000000000000000..255f0e570da28fc78ddae40e17b0d657d861467d Binary files /dev/null and b/external/daisy/images/project_custodians.png differ diff --git a/external/daisy/images/project_menubar.png b/external/daisy/images/project_menubar.png new file mode 100644 index 0000000000000000000000000000000000000000..ca17b1d1a7dc7e861f857bfb3917889c8c02afe4 Binary files /dev/null and b/external/daisy/images/project_menubar.png differ diff --git a/external/daisy/images/project_ref_contact.png b/external/daisy/images/project_ref_contact.png new file mode 100644 index 0000000000000000000000000000000000000000..cbebe331dbd7e9428633f36fd16f7ba6559698e5 Binary files /dev/null and b/external/daisy/images/project_ref_contact.png differ diff --git a/external/daisy/images/project_ref_publication.png b/external/daisy/images/project_ref_publication.png new file mode 100644 index 0000000000000000000000000000000000000000..20228d8a545ea8f08bfb3e2354bee78e77df02f8 Binary files /dev/null and b/external/daisy/images/project_ref_publication.png differ diff --git a/external/daisy/images/project_ref_user.png b/external/daisy/images/project_ref_user.png new file mode 100644 index 0000000000000000000000000000000000000000..e8deaad669c31a2ed66e597ca85c23c00f847ce4 Binary files /dev/null and b/external/daisy/images/project_ref_user.png differ diff --git a/external/daisy/images/project_ref_user_search.png b/external/daisy/images/project_ref_user_search.png new file mode 100644 index 0000000000000000000000000000000000000000..1023a6709ce6cfa4de929cd70dcc6cddeb7802c7 Binary files /dev/null and b/external/daisy/images/project_ref_user_search.png differ diff --git a/external/daisy/images/project_remove_contact.png b/external/daisy/images/project_remove_contact.png new file mode 100644 index 0000000000000000000000000000000000000000..012c9229de4cc7556f85f636bf82d6c43e0e068c Binary files /dev/null and b/external/daisy/images/project_remove_contact.png differ diff --git a/external/daisy/images/project_remove_document.png b/external/daisy/images/project_remove_document.png new file mode 100644 index 0000000000000000000000000000000000000000..1de10d9dba64dbbf76faf4b5f8d9fc267804ff02 Binary files /dev/null and b/external/daisy/images/project_remove_document.png differ diff --git a/external/daisy/images/project_remove_publication.png b/external/daisy/images/project_remove_publication.png new file mode 100644 index 0000000000000000000000000000000000000000..155d8c72f6a69326f07a8f832079ab4763849bb0 Binary files /dev/null and b/external/daisy/images/project_remove_publication.png differ diff --git a/external/daisy/images/project_remove_user.png b/external/daisy/images/project_remove_user.png new file mode 100644 index 0000000000000000000000000000000000000000..6522e416a39e3e33f8a54b376ef49c0b9f3cbec7 Binary files /dev/null and b/external/daisy/images/project_remove_user.png differ diff --git a/external/daisy/images/search_page.png b/external/daisy/images/search_page.png new file mode 100644 index 0000000000000000000000000000000000000000..2c5b09e5ceb83bf8c3d20eb366f8d094a65534d1 Binary files /dev/null and b/external/daisy/images/search_page.png differ diff --git a/external/daisy/images/validation_error.png b/external/daisy/images/validation_error.png new file mode 100644 index 0000000000000000000000000000000000000000..8f9cba92865aab2d8793661cefe849690d5f7fc1 Binary files /dev/null and b/external/daisy/images/validation_error.png differ diff --git a/external/daisy/interface_conventions.md b/external/daisy/interface_conventions.md new file mode 100644 index 0000000000000000000000000000000000000000..3bfbece6c874e7376b07d4ea404712a39bf4db49 --- /dev/null +++ b/external/daisy/interface_conventions.md @@ -0,0 +1,75 @@ + +<a name="DIC"></a> +# 2 DAISY Interface Conventions + +<a name="SP"></a> +## 2.1 Search Pages + + +DAISY provides search pages for all entities manageable via modules. Currently these are: _Projects, Contracts, Datasets_, and, under definitions, _Partners, Cohorts, Contacts_. All search pages have similar layout and operational conventions. Search pages are also the only entry point for the functions in a module. When you select a module from the menu bar, you will be taken to the search page for the entity managed by that module. + +A screenshot of the search page for Projects is given below. +Each search page is headed with _help text search facets on the left hand side and search results on the right hand side. + + +  + <center>Search Page for Projects</center> + +By default, all entities - in our example, all projects- will be listed on the search page. The list can be filtered by either selecting one or more facet from the left hand side or by typing in a keyword into the search box. Currently DAISY search does not support partial matching; instead the entire keyword will be matched in a case insensitive manner. + +On the top right section of search results a few attributes will be listed. Clicking on these attributes repeatedly will respectively (1) enable the ordering either (2) change order to ascending/descending (3) disable ordering for the clicked attribute. + +Each entity listed in the search results will be displayed in a shaded box are listing few of attributes; in our example the project's name and number of publications are listed. Each result box will also contain a "DETAILS" link, through which you can go to the [Entity Details Page](#EDP). + +Depending on the permissions associated with your user type, you may see a **add button (denoted with a plus sign)** at the bottom right section of the search page. You can add a new entity by clicking the plus button, which will open up an empty editor form for you to fill in. + + +<a name="EDP"></a> +## 2.2 Entity Details Pages + +Information about a single entity is provided through a Details Page. As example page for a _Project_ named ``SYSCID'' is given below. + + +<center>Details page of a Project in DAISY</center> + +You may end up on an Entity Details Page in two primary ways. (1) Through the ``DETAILS'' link of a search results in a search page (2) Through links on details pages of other (linked) entities in DAISY. + +Each Details Page is headed with an **overview box) listing some of the entity's attributes. Depending on the permissions associated with your user type, you may see an **edit entity button (denoted with a pencil icon)** and an **permissions button (denoted with an eye icon)**. These will take you to the Entity Editor Page and the Permissions Management Page respectively. + +Beneath the overview box several information boxes will be listed displaying further details of the entity. + +If you have edit permissions for the entity, then at the top right corner of some detail boxes you will see an **add detail button (denoted with a plus sign)**. Via this button you can do the following: + +* create links to other entities e.g. link contacts with projects. +* create (inline) detail records to the current entity e.g. one or more publications to a project. + +<a name="EEP"></a> +## 2.3 Entity Editor Pages + + +When you click the edit button on the Details Page of an entity, you will be taken to the Editor Page containing a form for entity update. An example is given below. + + +<center>Editor page of a Project</center> + +Each field in the form will be listed with a **Name**, a **Value** and a **Help text**. Names of fields that are required to have a value will end with a red asterisk. + +Editor forms can be saved by pressing the **SUBMIT** button found at the bottom of the page. Forms will be validated upon submission. If validation fails for one or more fields, these will be highlighted with inline validation _ERROR_ messages, illustrated below. + + +<center>Field validation error</center> + + +Upon successful save of a form, you will be returned to the entity details page. DAISY may give **SUCCESS** and/or **WARNING** messages upon form save; these will be displayed at the top of the page, as illustrated below. + +  +<center>Message display in DAISY</center> + + +<br /> +<br /> +<br /> +<div style="text-align: right;"> <a href="#top">Back to top</a> </div> +<br /> +<br /> +<br /> \ No newline at end of file diff --git a/external/daisy/project_management.md b/external/daisy/project_management.md new file mode 100644 index 0000000000000000000000000000000000000000..dccf61fcf9fe44d9f692a42a07c1839a1fc280d2 --- /dev/null +++ b/external/daisy/project_management.md @@ -0,0 +1,133 @@ + +<a name="PM"></a> +# 3 Project Management + + <a name="PM1"></a> +## 3.1 Create New Project + +<mark>In order to create a new project</mark>: + +1. Click Projects from the Menu Bar.<br /> +  +2. Click the add button from the Project Search Page.<br /> +  +3. You will see an empty Project Form. _Acronym, Title_ and _Local Custodians_ are mandatory fields, whereas others are optional. Provide values for fields. Please note that one of the Local Custodians must be a user with VIP Privileges. E.g. in the demo deployment _alice.white_ is a research principle investigator and is a VIP user.<br /> + +4. Click SUBMIT. Once you successfully save the form, you will be taken to the newly create project's details page, as seen below.<br /> + + + +<a name="PM2"></a> +## 3.2 Manage Project Details + + +When you first create a _Project_ in DAISY, it will be isolated, with no links to other entities. The _Project_ page provides shortcuts to create such entities, most importantly Datasets and Contracts. If you use these shortcuts the newly created entities will automatically be linked to the project. In the following section we describe how such shortcuts work. +<a name="PM21"></a> +### 3.2.1 Add Dataset to Project + + +When a project is created, it will have no associated Datasets. On the project's details page this situation will be highlighted in the **Data of this project** detail box as follows: + +  + + <mark>In order to create a Dataset and automatically link it to the project</mark>: + + 1. Click the **Add** button pointed by the arrow in the **Data of this project** detail box. + 2. You will see the **Dataset Creation Quick Form** as below. The _Project_ field will be auto-selected, in addition you need to provide _Local Custodians_ and a _Title_ for your dataset. Typically the local custodians would be the same as the project, but you are free to choose any user as the custodian. Remember that one of the custodians needs to be a VIP User. Provide the field values and press submit.\ +  + + 3. Once the dataset is created, you will be taken to the **Dataset's Details Page**, seen below. You can continue working on the data set as described in [this part of the guide](#DM). If you want to go pack to the Project that owns this dataset, then you can click the project link in the dataset's overview box, highlighted below.<br /> +  + +<a name="PM22"></a> +### 3.2.2 Add Contract to Project + +TBC + +<a name="PM23"></a> +### 3.2.3 Add Personnel to Project + + +A project's _Personnel_ refer to those persons that work on the project, we assume that these persons will all have a user account for the DAISY system. The **Personnel** detail box on the _Project_ page also allows linking DAISY _Users_ as personnel of a Project, to do so; + + +1. Click the plus button on the **Personnel** details box, as seen below.<br /> +  +2. You will be asked to select one user from a searchable list of existing users. Users will be listed with their name and surname. Make a selection and click SUBMIT. <br /> +  + + + Personnel can be unlinked from a Project by clicking on the trash icon that will appear when hovering over items in the **Personnel detail box**, as seen below. Note that the personnel will not be deleted from the system, it will simply be unlinked.<br /> + + +  + +<a name="PM24"></a> +### 3.2.4 Manage Project Contacts + + +A project's _Contacts_ refer to those persons that are associated with the Project, but that are not a user of the DAISY system. Under the _Definitions Management_ module, it is possible to manage _Contacts_ and search for them. The **Contacts** detail box on the _Project_ page also allows contact management, as follows; + + 1. Click the plus button on the **Contacts** details box. You will be given the options to either **Create a new contact** or **Reference an existing contact** as seen below.<br /> +  + + 2. If you choose to reference, you will be asked to select one contact from a searchable list of existing contacts. Contacts will be listed with their name, surname and role as seen below. Make a selection and click SUBMIT.<br /> +  + + 3. If you choose to create new, you will see the contact creation form. Once you fill in the details and click SUBMIT a new contact will be created and automatically linked to the project.<br /> +  + + + Contacts can be unlinked from a Project by clicking on the trash icon that will appear when hovering over items in the **Contacts detail box**, as seen below. Note that the contact will not be deleted from the system, it will simply be unlinked.<br /> + + + +<a name="PM25"></a> +### 3.2.5 Manage Project Documentation + + +You can attach documents to a project record in DAISY. Examples of documents are the Project Proposal, Ethics Approvals, Templates of Consent Form or the Subject Information Sheet. Documents can be in any format, PDF, Word or scans. If the document is stored already in an external system, you can also record its link in DAISY. + +Document management is done via the **Documents** detail box, as follows: + +1. Click the plus button on the **Documents** detail box.<br /> + + +2. You will see the _Document_ creation form. Either select _Content_, i.e. file to upload, or paste the document link (if in external system). You will be required to provide a brief description of the document in _Document Notes_. Also you will also be required to select a _Type_ for the document. <br /> + + +3. Click SUBMIT and the new document will be listed as below. Documents can be deleted by clicking on the trash icon beside each document, also document information can be edited by clicking the pencil icon.<br /> + + + + +### 3.2.6 Manage Project Publications +<a name="PM26"></a> + +A project's _Publications_ can be managed via the **Publications detail box**, as follows: + + 1. Click the plus button on the **Publications** detail box. You will be given the options to either **Create a new publication** or **Reference an existing publication** as seen below.<br /> +  + + 2. If you choose to reference, you will be asked to select one publication from a searchable list of existing publications. Publications will be listed with their citation string. Make a selection and click SUBMIT.<br /> +  + + 3. If you choose to create new, you will see the publication creation form asking you for the _Citation string_ and the _DOI_ for the paper. Once you fill in the details and click SUBMIT a new publication will be created and automatically linked to the project.<br /> +  + + + Publications can be unlinked from a Project by clicking on the trash icon that will appear when hovering over items in the **Publications detail box**, as seen below. Note that the publication will not be deleted from the system, it will simply be unlinked.<br /> + + + + + +<br /> +<br /> +<br /> +<div style="text-align: right;"> <a href="#top">Back to top</a> </div> +<br /> +<br /> +<br /> + + diff --git a/external/daisy/user_management.md b/external/daisy/user_management.md new file mode 100644 index 0000000000000000000000000000000000000000..ca5c80b66e33310b2b07913eebda4c7ea177d975 --- /dev/null +++ b/external/daisy/user_management.md @@ -0,0 +1,48 @@ + +# 7 Login, Types of Users and Permissions + + +Upon successful installation of DAISY, going to the web address ```https://${IP_ADDRESS_OR_NAME_OF_DEPLOYMENT_SERVER}``` +should display the login page. + +  + <center>DAISY Login Page</center> + +Based on the authentication configuration made for your deployment, you may login by: + +* user definitions in an existing LDAP directory, e.g. institutional/uni credentials +* user definitions maintained within the DAISY database. + + +<mark>DAISY is intended to be used mostly by three categories of end users in a Biomedical research institution</mark>; primarily Research staff e.g. principle investigators, lab members, legal support team, and IT and data management specialists. + +Specifically, DAISY has the following **user groups** to support record access control; + +* **standard**: This is the default role assigned to all users. All DAISY users can view all Dataset, Project, Contract and Definitions (Cohorts, Partner, Contact). The document attachments of records are excluded from this view permission. +* **vip**: This role is typically given to research principle investigators. VIP users have all privileges on the records they own, meaning the records where the user has been appointed as the ``Local Custodian``. They also have the right to give permissions to others on these records. +* **legal**: This role is given to users that will be managing _Contract_ records. Legal personnel will be able to create view and edit contract as well as view all other records in DAISY and manage their document attachments +* **auditor**: This role would designed to an external person, who is given view-only temporary access to all DAISY records. This would typically happening an audit scenario. + + + +DAISY supports fine-grained permission management with the following categories of permissible actions. The ability to _View_ records, _View Document_ attachments of records, ability to _Edit_ and _Delete_ records. The ability to _Administer Permissions_. + + + +| User Category | Administer Permissions | Delete | Edit | View | View Document Attachments | +| -------------|:-------------:|:-------------:|:-------------:|:-------------:|:-----| +| superuser | P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub> | P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub>| P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub>| P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub> | P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub>| +| standard | | | | P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub> | | +| vip | P<sub>own</sub>, D<sub>own</sub> | P<sub>own</sub>, D<sub>own</sub>| P<sub>own</sub>, D<sub>own</sub>| P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub> | P<sub>own</sub>, D<sub>own</sub>, C<sub>own</sub> | +| auditor | | | |P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub>| P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub> | +| legal | C<sub>all</sub> | C<sub>all</sub> | P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub> | P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub> | P<sub>all</sub>, D<sub>all</sub>, C<sub>all</sub>, Def<sub>all</sub> | + + + +<br /> +<br /> +<br /> +<div style="text-align: right;"> <a href="#top">Back to top</a> </div> +<br /> +<br /> +<br /> \ No newline at end of file diff --git a/external/exchange-channels/duma.md b/external/exchange-channels/duma.md index 92c03b8c12bec9ed1ea649ca55e4f3fe352f56ff..36b4aff4d19ffec589af5478565db3a304bf07ec 100644 --- a/external/exchange-channels/duma.md +++ b/external/exchange-channels/duma.md @@ -1,4 +1,4 @@ -# Data Upload Manager - DUMA Quick Guide +# Data Upload Manager - DUMA Quick Guide {{TOC}} @@ -18,10 +18,10 @@ An access link can be reached via standard web browsers. Data can be transferred The use of DUMA is mediated by LCSB's data stewards. If you require assistance in using DUMA, you should send an email to [LCSB admin team](lcsb-sysadmins@uni.lu). -<a name="DUMA_WEB"></a> +<a name="DUMA_WEB"></a> ## Accessing DUMA via Web Interface -In the following steps we provide instructions on how to use DUMA web interface. +In the following steps we provide instructions on how to use DUMA web interface. 1. Once you receive your **access link** and **password** from the LCSB, visit the link using a standard web browser. Firefox 66.x (or higher) recommended, but others should also work. You will be prompted for your password (see below).<br/>  @@ -29,35 +29,35 @@ In the following steps we provide instructions on how to use DUMA web interface. 2. When you visit a DUMA access link for the very first time, you will be prompted to install **IBM Aspera Connect** client. * click **Download** or **Download latest version** links (see below). <br/> - + * Your browser will download the client installer. - -  + +  * Run the installer till you receive the completion message. - -  - - * Once **IBM Aspera Connect** client is installed, refresh the **access link**. You will be prompted whether you want to open **IBM Aspera Launcher**, click **Open**. - -  +  + + + * Once **IBM Aspera Connect** client is installed, refresh the **access link**. You will be prompted whether you want to open **IBM Aspera Launcher**, click **Open**. + +  + - 3. The **access link** page will display a **File Browser** section. Depending on the settings per access link, users can create or delete folders in the File Browser and upload or download data.<br/>  - + 4. Clicking **Upload** or **Download** will launch the **IBM Aspera Connect** client on your computer. You first will be asked whether you allow the client to connect to aspera.lcsb.uni.lu. Choose **Allow**. <br/>  - + 5. At any time you can launch **IBM Aspera Connect** to display the status of uploads to or downloads from your computer. <br/> -  +  @@ -65,59 +65,61 @@ In the following steps we provide instructions on how to use DUMA web interface.  <br/> You will be prompted for encryption passphrase which you should already have received from the repository administrator. <br/>  <br/> -Encrypted files are by default kept on your disc after decryption. If you want to change this behaviour, navigate to Options->Settings and check "Delete encrypted files when finished" box. +Encrypted files are by default kept on your disc after decryption. If you want to change this behaviour, navigate to Options->Settings and check "Delete encrypted files when finished" box. <a name="DUMA_CLI"></a> ## Accessing DUMA via Command-Line Tool -In the following steps we describe instructions on how to use DUMA web interface. +In the following steps we describe instructions on how to use DUMA web interface. 1. **Install the aspera command line client.** The _ascp_ tool, which can be found [here](https://downloads.asperasoft.com/en/downloads/62) as instructed. -2. **Obtain tokens.** You will need **tokens** while using _ascp_. You will need a **download token** for download and a separate **upload token** for upload. Your tokens can be viewed by clicking the **Help** icon on your access link (see below).<br/> +1. **Obtain tokens.** You will need **tokens** while using _ascp_. You will need a **download token** for download and a separate **upload token** for upload. Your tokens can be viewed by clicking the **Help** icon on your access link (see below).<br/>  <br/><br/><br/>  -3. **Obtain SSH key.** You will also need an **SSH private key** to authenticate. This is the Aspera key that comes with the Aspera Connect installation named `asperaweb_id_dsa.openssh`. Below are locations where the ssh_key can be found: + +1. **Obtain encryption passphrase.** You should receive corresponding passphrase from repository administrator. + +1. **Obtain SSH key.** You will also need an **SSH private key** to authenticate. This is the Aspera key that comes with the Aspera Connect installation named `asperaweb_id_dsa.openssh`. Below are locations where the ssh_key can be found: * On MAC * Local installation of Aspera connect: * `/Users/username/Applications/Aspera Connect.app/Contents/Resources/asperaweb_id_dsa.openssh` - * System wide installation of Connect: + * System wide installation of Connect: * `/Applications/Aspera Connect.app/Contents/Resources/asperaweb_id_dsa.openssh` * On WINDOWS - * Local installation of Aspera connect: + * Local installation of Aspera connect: * `C:\\Users\username\AppData\Local\Programs\Aspera\Aspera Connect\etc\asperaweb_id_dsa.openssh` - * System wide installation of Connect: + * System wide installation of Connect: * `C:\\Program Files (x86)\Aspera\Aspera Connect\etc\asperaweb_id_dsa.openssh` - + * On LINUX - * Local installation of Aspera connect: + * Local installation of Aspera connect: * `/home/username/.aspera/connect/etc/asperaweb_id_dsa.openssh` - * System wide installation of Connect: + * System wide installation of Connect: * `/opt/aspera/etc/asperaweb_id_dsa.openssh` -4. **Set necessary environment variables**. `KEY` and `TOKEN` environment variables should be set as follows. If you do not have any of the tokens use `None` as the value. +1. **Set necessary environment variables**. `KEY` and `TOKEN` environment variables should be set as follows. If you do not have any of the tokens use `None` as the value. * `KEY=<path to the ssh key>` * `DTOKEN=<<<<YOUR DOWNLOAD TOKEN>>>>>>` * `UTOKEN=<<<<YOUR UPLOAD TOKEN>>>>>>` - + * `export ASPERA_SCP_FILEPASS=<<<<<YOUR ENCRYPTION PASSPHRASE>>>>>` -5. **Run the relevant _ascp_ commands**. +1. **Run the relevant _ascp_ commands**. * Upload: - * To upload all *png* files to the root of the share: - * `ascp -d -i $KEY -P 33001 -W $UTOKEN *.png app_duma_public_read@aspera.lcsb.uni.lu:/` - * To upload *document.txt* to a subfolder: - * `ascp -d -i $KEY -P 33001 -W $UTOKEN document.txt app_duma_public_read@aspera.lcsb.uni.lu:/subfolder` + * To upload all *png* files to the root of the share: + * `ascp -d -i $KEY -P 33001 --file-crypt=encrypt -W $UTOKEN *.png app_duma_public_read@aspera.lcsb.uni.lu:/` + * To upload *document.txt* to a subfolder: + * `ascp -d -i $KEY -P 33001 --file-crypt=encrypt -W $UTOKEN document.txt app_duma_public_read@aspera.lcsb.uni.lu:/subfolder` * Download: - * To download *subfolder* and all it's content to the current directory: - * `ascp -d -i $KEY -P 33001 -W $DTOKEN app_duma_public_read@aspera.lcsb.uni.lu:subfolder` + * To download *subfolder* and all it's content to the current directory: + * `ascp -d -i $KEY -P 33001 --file-crypt=decrypt -W $DTOKEN app_duma_public_read@aspera.lcsb.uni.lu:subfolder` You can find more information also on the [Aspera website](https://downloads.asperasoft.com/en/documentation/62). - diff --git a/index.md b/index.md index 3f18d557a37d9a720d70aa2992f9f9980f99545d..30ac0498ef33f1f3cc3f2e1bdc534b0635429c5d 100644 --- a/index.md +++ b/index.md @@ -11,3 +11,4 @@ Bioinformatics Core assists Luxembourg Centre for Systems Biomedicine ([LCSB](ht ## Current LabCards * [Exchange data with collaborators](./external/exchange-channels/) + * [Registering human-subject data to DAISY](./external/daisy/)