Usage

Usage is role-dependent and there are three roles of authorized users: Researcher, Data Steward, and Administrator. Higher-level role can do the same as lower-level role and also something more, so let's describe it from the simplest one...

Anonymous

User of DSW that is not logged in yet is able to register, log in, or recover forgotten password via confirmed email address.

If configured, anonymous user can test out Questionnaire Demo (next to Log In and Sign Up buttons in navigation bar. that is a example of DS Planner without any ability to save or export the answers, only to try out and learn. This functionality is always accessible in our global instance.

Researcher

Researcher is a user who works on a scientific project and has the knowledge about the specific project. His/her goal is to get high-quality FAIR Data Management Plan and learn how to work with data in the project.

DS Planner

Data Stewardship Planner provides simple way to create questionnaire from KM package and fill it in smart way - only relevant questions for your case will be shown.

  • Create (button) = create new questionnaire from certain version of certain KM package

  • For each questionnaire:

    • Delete

    • Fill questionnaire = starts interactive questionnaire that guides you through answering relevant questions for specific project

    • Export = export plan (summary of answers) in selected format

Data Steward

Data Steward is a user who has good knowledge of DS domain (how to deal with data) and puts this knowledge into a knowledge model. The knowledge model is then used by scientists to create the DMP with DS Planner.

KM Packages

Knowledge Model Package is published collection of DS domain knowledge. Each package has own unique identifier consisting of organization ID and km ID (and then also version). It stores all the knowledge units = changes of "zero" knowledge (add, delete, edit - chapter, question, answer, reference, etc.).

  • Import = import new KM package or new version of KM package

  • For each KM package:

    • Delete

    • View detail = shows detail with versions and basic information about the KM package and for each version:

      • Create KM Editor = shortcut to create editor from specific version of KM package

      • Create DS Planner = shortcut to create planner from specific version of KM package

      • Export = export specific version of KM package, that can be then imported (e.g. in different instance of DSW)

      • Delete

KM Editor

Knowledge Model Editor allows to create new knowledge models:

  1. from scratch (i.e. totally new root KM package)

  2. as new version of existing KM package (i.e. some improvements needs to be done)

  3. as a customization of an existing KM package (i.e., extension for specific subdomain - can be based on organizational, geographical, legal or other expertise)

  4. Create = create editor with specific name and KM ID, optionally based on some parent KM.

  5. For each KM editor:

    • Delete

    • Open editor = shows editor that allows to go through the all parts of KM, create new parts, edit or delete them.

    • Publish (if changes are made) = create KM package with specific version and description of changes

    • Upgrade (if newer version of parent KM) = migrate to newer version of parent KM package in interactive migration tool

Administrator

Administrator manages overall settings of the Data Stewardship Wizard instance and has the highest privileges.

Organization

Administrator can set two things in organization settings:

  • Organization name = visible name of the organization that uses DSW instance

  • Organization ID = unique identifier of the organization, it is then used in identifier of created knowledge models

Users

User management is also quite simple. Administrator can see table with registered users, delete or edit single one of them, or create new user directly. When editing the user, it is possible to change all the attributes from registration and also manually change the "Active" status.