== xQTL workbench application user stories == === As a user I want to have an overview of available data per investigation === Short name: StudyBook Acceptance criteria: * I want one page overview of all annotations, observedvalues and data sets available * This screen must be very prominent, maybe even starting point of the app * This overview must function as a portal for browsing and adding data to the database (see ImportWizard), plus downloading of sections or a complete set (see DownloadWizard) * ... === As a user I want to be able to import any data type as quickly and easily as possible === Short name: ImportWizard Acceptance criteria: * The import must be a (semi) guided process where it is clear what I must do (next), and what I have done wrong or right * I would like import in Excel and CSV file formats (with the tool automatically choosing the right import procedure based on type) * I would like to keep other files in existing well-defined formats (eg. BAM, CEL, FASTA files) * As a developer I would like the ability to 'plug-in' importers for other types * I would also like to attach miscellanious files, such as images, videos, docs, machine output etc. * There must be help available on how to succesfully import, and examples of datasets I can edit and reuse * I would not want to loose progress during the import process so that partial imports must be logged (tech note: this info is kept between sessions) === As a biologist I want to choose and run pre-defined compute protocols === Short name: ApplyCompution Acceptance criteria: * I would like a clear overview of compute protocols I can run, and what their purpose is * I do not want to be bothered with technical details on how they are implemented unless I choose to * I would like to see help on the analyses I can run and their input and output parameters * The application should make clear to me if my data is not complete for running a certain tool, and suggest how/where to fix it * If anything goes wrong, I want a clear error message with suggestions how to proceed, or who to contact * When a computation protocol is running I want to monitor progress and choose to get an email if it is completed * When a tool is finished running, I would like to go directly to my results * I want to be able to get a report of all the settings and software I used to produce the data so I can report my provenance to others (note: so also get this information when browsing data) * ... Technical notes: * This has a huge overlap with ApplyProtocol where we also want to allow provide users with a dialog to parameterize a protocol * Implementation can use Measurement.dataType and molgenis.framework.ui to autogenerate these dialogs === As a biologist I want to view results === Discussion: incomplete, needs concrete examples of what should be possible and may be multiple stories * The place to view data (including results) should be reachable from multiple places so I never get lost * The viewer should provide a clear menu of things I can do with the data * I want useful viewers (plugins) that add meaning to my data and save me from using my own tools to e.g. make a graph * I would like to see help and instructions on how to use the more complicated viewers * ... === As a biologist I want to download all data, investigation data, or a selection thereof === Short name: DownloadWizard * I would like to retrieve the data in multiple formats, both 'generic' (Excel, CSV..) as 'specific' (FASTA, PDF) if the data allows it * I would like to make aggregated views on the data (ie. include annotation) and them download them * Downloading 'archives' is handy, where data is exported into a single file for backup/reuse in similar databases * ... === As a biologist I want to connect external tools * I want to have linkouts to popular databases, datatypes permitting * I want to manually add linkouts if they are not present * I want to able to export XGAP data immediatly into popular online tools, for example get a link for a DAS service that I can plug in elsewhere * It would be great if XGAP already featured integration or enrichment functions with popular database, for example map genes to KEGG and them visualize them * ... === As a bioinformatician I want to add new analyses === * I want a clear screen to add and configure new tools * I want to be able to testdrive the tools before people can use them * I want to be able to sort out technical details such as compute resource, batching, default parameters so the user does not have to deal with this * I would like information on who to contact if the application or computation server needs additional configuring or installing * ... === As a bioinformatician I want to add and configure workflows === * I want to be able to build workflows from analyses protocols using a helpful screen (may or may not be graphical) * I would like help connecting analyses in a meaningful way, ie. be sure the outcome is not nonsense, by having good documentation, ontologies, strict typing, etc * The screen not have to be extensive, a simple concatenation of a few steps is already very helpful (ie. normalization -> correction -> scan QTL -> make network -> visualize) * I want to be able to import workflows from tool such as Taverna or Galaxy, from files * I would like to be able to browse a catalog of workflows or services and incorporate those as well * I want to be able to export workflows in various formats * I would like to share workflows with others within the system, but also share them with the outside world (ie. MyExperiment) * ... === As an administrator I want user management and security === See all stories of [http://www.molgenis.org/wiki/AuthModuleUserStories auth]. === As an administrator I want to configure the application * I want a configuration screen for all kinds of application settings, such as: * View the status of the database, is it set up correctly, how much space am I using, how much is available, how fast are the queries, etc * View status of file storage, does the application have read/write rights, are backups being made, what kind of files do people store, how often are they retrieved, etc * I want the ability to restore backups of the database, additional files, other settings such as this panel, and view a history of changes/additions/deletions of these aspects * I would like to view user activity and registration, and be able to communicate with users by either email, messages inside the application, or otherwise * ...