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.

Plugins

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

• Service Lab main plugin
• Service Lab utility plugin

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
  • GRITS.servicelab.dev.product - 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.

Tutorials

GRITS Users

Useful tutorials for Service Lab users can be found here:

• Invoice Generation Tutorial
• Project Validation Tutorial

Developers

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 stored in 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
  • File Name - IConfig.PROTOCOL_PRICE_INFO_FILE_NAME
    
  • File Location - ${WORKSPACE_FOLDER}/ ${SERVICELAB_FOLDER}/ ${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 location - ${WORKSPACE_FOLDER}/ ${SERVICELAB_FOLDER}/ ${TASK_PROTOCOL_FILE}
    

• File Upload Information file
  • stores file upload information for protocols
  • File name - IConfig.PROTOCOL_FILE_UPLOAD_INFO_FILE_NAME
    
  • File location - ${WORKSPACE_FOLDER}/ ${SERVICELAB_FOLDER}/ ${FILE_UPLOAD_INFO_FILE}
    

• Handler - handler/VerifyExperimentsHandler
  
• Wizard - wizard/validation/ValidationWizard
  

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

• ProjectTaskAssigner
  • for assigning tasks to samples
  • assigns tasks to each sample equally (if number of tasks is not divisible by number of samples then leaves all the tasks for user to assign)
• SampleProtocolTaskMatcher
  • for matching task to protocols of each sample
  • matches protocols to its possible tasks (uses backtracking to try all possible combination unless each task has valid number of protocols and there is no extra protocol)
• ProtocolFileMatcher
  • for matching files in project archive to protocols in samples
  • matching is done for uploaded file Category and SubCategory
  • makes sure all protocols have their required number of files available in Project archive
  • no errors if extra files are there in the archive

Management for Invoice Generation and Project Validation

The three files (Protocol Price file, Task Protocol file and File Upload Information file) described 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 Editor Parts

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

Each of the three managing editors have only one instance (not Multiple option selected in the fragment.e4xmi file) in the application. These managers reload their information from workspace each time they are opened by a user. To learn more about them also read Project Validation Tutorial.

In the current implementation some of the important functionalities that are missing are:

• Delete manager files
• Import protocol/task information from files of other workspace

Bill Upload

The final bill file can be uploaded for each project. The bill file is stored in the archive of the project. The bill amount is also stored in a Project Statistics File for each project.

• Project Statistics File
  • contains a map of statistic variables and their values
  • name - IConfig.PROJECT_STATS_FILE_NAME
  • Location - ${PROJECT_FOLDER}/${SERVICELAB_FOLDER}/${PROJECT_STATS_FILE}

• Handler - handler/UploadBillHandler
• Dialog - dialog/UploadBillDialog

Deployment

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