Contents of this Guide
- Introduction
- Site Map
- Mica Configuration
- Content Types
- Study related Content Types
- Dataset related Content Types
- Data Access related Content Types
- Consortium related Content Types
- Roles and their Permissions
- Consortium Administrator
- Study Reviewer
- Study Administrator
- Data Access Committee Officer
- Researcher
- Authenticated User
- Anonymous User
- Operations
- Data Access Committee Member
Introduction
Drupal administration knowledge is required.
Site Map
|
Mica Configuration
The Mica configuration page is accessible to administrators at: Configuration > Mica.
Mica configuration consists of creating an encryption key pair for:
- being authenticated by remote servers,
- establish secured connections to remote servers.
Content Types
Mica provides several content-types and mechanism to link them together.
Study related Content Types
The entry point/portal of a study in the Consortium website is a content of type Study. As information about a Study can be quite large and of different nature, apart of the Study content-type, one would expect to be able to split information into contents of different types that would be related to their parent content of type Study. One would also like to index this information in a search engine and look for Study that match criteria on related content.
Mica provides provides such a relational mechanism:
- Define a parent-child relation between any content-types (e.g. Study being the parent and Study Information being the child for example),
- Create/delete a content of type Study will cascade creation/deletion of child contents and link them together using references.
The following will describe the default Study related content-types.
Study
General information about the study.
A Study content can optionaly be part of several Dataset contents.
Field Description
Operations
Adding a new Study related Content Type
New content-types can be defined, according to the needs of the Consortium, and be related as a child of Study content-type.
To achieve that follow the procedure:
- Add a new content-type,
- Select Relations bottom menu:
- Select parent content-type Study,
- Check boxes for cascading parent events on child,
- Select Search Index to be used for indexing child content.
Adding a Field Description
Once fields have been added to a content type, each field can have additional description which is realized as a content of type Field Description. This operation also pushes the field for being indexed in the search index defined in the content type.
To achieve that follow the procedure:
- Manage fields of the content type,
- Edit a field,
- Check 'Use Field Descriptor for this field' at the end of the field form:
- Select the value type (default selection is supposed to match the filed type),
- Add a description (optional).
Dataset related Content Types
Dataset
A Dataset is made of a set of Study and a set of Variable contents.
Variable
Describes the participant data type, related to a Dataset. The set of Variables for a Dataset makes the Dataset's dictionary.
Data Access related Content Types
The Data Access is combination of a Request and of a Review. The status of the latter controls the accessibility of the former.
Data Access Request
The Data Access Request as provided by Mica can be enhanced depending on the needs of the Consortium. It currently contains a minimal description of project aims, investigators and institution.
Data Access Review
The Data Access Review is always linked to a Request and depending on the value of the Status field, the request might be editable or not.
Permissions
Default permissions are:
- Requests can only be created by Researcher,
- Reviews can only be created by Data Access Committee Officer.
Consortium related Content Types
Documents
Any Documents that are relevant to the Consortium. Full description of the Documents can be provided.
Project
Projects are meeting points for Consortium researchers.
Event
An Event has a start and a end date. It will automatically appear in the Event Calendar.
Publication
Publications allows to inform Consortium members about the abstract, authors, reference of a scientific publication based on Consortium work.
Contact
A Contact is a person coordinates in an Institution.
A Study can refer to several Contacts.
Roles and their Permissions
Consortium Administrator
Can create, edit, delete all the content of the Mica site.
Study Reviewer
Can edit and publish study related contents.
Study Administrator
Can edit, delete all own study related contents.
Data Access Committee Officer
Can create, edit, delete Data Access Review contents and edit, delete any Data Access Request contents.
Researcher
Can create, edit, delete own Data Access Request contents.
Authenticated User
Can create its own Dataset queries and configure the visibility of search facets.
Anonymous User
Can access to any content and execute Dataset queries.
Operations
Content Access Control
Access to any content can be controlled at Content Type level (default) or at content node level.
To activate access control a Content node level, edit the content type and check Enable per content node access control settings.
Data Access Committee Member
A Data Access Committee Member is a Contact