Version 6 (modified by shan, 5 years ago) (diff)


Service Lab Documentation

Service Lab has a GRITS installation in its lab. This installation has some additional features added specifically for the lab. It is a short documentation of additional functionalities provided to the lab and their management in GRITS.


GRITS provides some specialized functionalities for Service Lab. Currently there are two plugins that have been created for this purpose.

Service Lab main plugin

This plugin provides functionalities related to accounting and management in Service Lab. This plugin should be added to the product file when creating a deployment for the lab. Currently this plugin has following functionalities:

  • Invoice Generation
    • price management for protocols and generation of invoice for projects
  • Project Validation
    • Task assignment to individual samples in projects, verification of experiments in samples and files in archives
  • Management of Task and File Upload information
  • Upload of final Bill for projects

This plugin also contains

  • the set of latest experiment designer's ontology provided to Service Lab
  • the protocol variants provided to Service Lab
  • product files that generate GRITS products for deployment
    • GRITS.servicelab.product - to deploy in lab
    • - for developers use before deployment (has the additional developers fragment)

Service Lab utility plugin

This plugin is used for generation of GRITS workspace projects from spread sheets. It is also used for adding new protocols to ontology from a spread sheet and for generating its protocol variants. This plugin should not be added to any product file that would be deployed for use. Currently this plugin adds two commands to GRITS in the popup menu of the project explorer:

  • Import Projects
  • Add Ontology

This plugin contains

  • Protocol spread sheet for generation of ontology
    • name would be Protocol Set <SET_NUMBER> Rev<REVISION_NUMBER>.xlsx
  • Sample spread sheet for creating descriptors from sample names while generating workspace
  • a product file GRITS.all.lab.service.product for ontology and workspace generation.

Note: Service Lab has changed format of its project spread sheet (spread sheets from which workspace is generated) several times. These were indicated by a number type in source code packages. The most recent type that was used for generating workspace was type 3.

Note: For data privacy, the spread sheet containing project information for generating workspace is not added to the svn and is used locally. For generating workspace from the 3rd type (latest version) spread sheet, the spread sheet should be placed in the doc folder of this plugin.


Steps for deploying GRITS in Service Lab is described below :

  1. Copy two ontologies before building - copy the two ontologies from ontology folder of Service Lab main plugin to ontology folder of Experiment designer plugin
    1. experimentdesignontology.owl
    2. localexperimentdesignontology.owl
  2. Use the product "GRITS.servicelab.product" in Service Lab Main plugin to build a product
  3. Deploy the product in Service Lab computer

Adding new protocol variants (it would remove all local protocols and protocol variants)

  1. Get a copy of protocol variants from protocol variants folder of Service Lab main plugin (use the variants with matching version of the ontology that was used for deployment in step 1)
  2. Clean the org.grits.toolbox.editor.experimentdesigner folder inside config folder and copy the new protocol variants and extract it here



Useful tutorials for Service Lab users can be found here:


Service Lab Main Plugin

It is broadly divided into 4 parts based on current functionalities.

  • Invoice Generation
  • Project Validation
  • Management for Invoice Generation and Project Validation information
  • Bill Upload

Also important thing to note is that there are ${SERVICELAB_FOLDER} at two levels that are used for storing Service Lab information in a workspace. ${SERVICELAB_FOLDER} has its name accessible through variable IConfig.SERVICE_LAB_FOLDER_NAME.

Location :

  • Service Lab folder in workspace - ${WORKSPACE_FOLDER}/ ${SERVICELAB_FOLDER}
  • Service Lab folder for a project - ${WORKSPACE_FOLDER}/ ${PROJECT_FOLDER}/ ${SERVICELAB_FOLDER}

Note:2nd level of Service Lab folder inside each project is used to independently store specific Service Lab information of projects and to avoid update issues when projects are renamed or removed.

Invoice Generation

When a invoice is to be generated, the handler class gets invoked. This class looks for Protocol Price file in the .servicelab folder and passes the required information to a Invoice wizard for further processing. Once the information has been edited/confirmed by user for download, it saves the invoice as MS Word file to a location that is returned by the wizard. Important information to note :

  • Protocol Price file
  • Handler - handler/GenerateBillHandler
  • Wizard - wizard/invoice/InvoiceWizard
  • Price calculation - invoice/ProtocolPriceCalculator
  • Saving as MS Word - invoice/MSWordInvoiceGenerator
Project Validation

To validate a project the handler class gets invoked. This class looks for Task Protocol file and File Upload Information file in the .servicelab folder and passes the required information to a wizard for further processing. Important information are summarized below :

  • Task Protocol file
    • stores protocol information for tasks
    • File name - IConfig.TASK_PROTOCOL_INFO_FILE_NAME
  • File Upload Information file
    • stores file upload information for protocols
  • Handler - handler/VerifyExperimentsHandler
  • Wizard - wizard/validation/ValidationWizard

Various classes for matching and validation algorithm (inside "validation/" package)

  • ProjectTaskAssigner - for assigning tasks to samples
  • SampleProtocolTaskMatcher - for matching task to protocols of each sample
  • ProtocolFileMatcher - for matching files in project archive to protocols in samples

Management for Invoice Generation and Project Validation

The three files talked in the above two sections are used for managing invoice and project validation information and are located in the ${SERVICELAB_FOLDER} folder of the workspace. These files are managed by three Managing Editors

  • PriceManager (part/pricemanager/ProtocolPriceManager)
  • ProtocolManager (part/taskmanager/TaskProtocolManager)
  • FileUploadManager (part/filemanager/ProtocolUploadFileManager)

All the three managing editors have a single instance (not Multiple option selected in the fragment.e4xmi file) in the application. These managers reload their information from workspace eachtime they are opened by a user. For more about them also read Project Validation Tutorial.

Attachments (1)

Download all attachments as: .zip