=== Overview ===
From the CaTissue home page:
"caTissue Suite is caBIG's biorepository tool for biospecimen inventory management, tracking, and annotation."

https://cabig.nci.nih.gov/tools/catissuesuite


Notes on the upgrade process from v1.1.p5 to v1.2 are at CaTissueUpgrade.


=== BRICCS Needs - note that the API client is live, v1.0 released on May 20th, 2011 ===
We need to learn how to use the caTissue API. In particular:

   * what would it take to get the 2d bar code reader to feed caTissue with an array of sample barcodes, such that caTissue would check them against the database to verify that the samples are in the right box, and in the right location? Possibly without even knowing the ID of the box?

   * what would it take to be able to process more than one participant at a time through the collection protocol? Currently the submission process includes checking for empty data in form elements which presumably have the same ID in each open tab or window, thus throwing an error.

While we work with 1.1.2p5, it might be useful to know that there is a pre-built VM with caTissue 1.2 (the next version) available here:

https://cabig-kc.nci.nih.gov/Biospecimen/KC/index.php/2010_User_Meeting_VM

This was used during the Houston User Meeting. I know it works on Ubuntu host, using !VirtualBox. YMMV.

Demo files for using the caTissue API are here: https://cabig-kc.nci.nih.gov/Biospecimen/uploaded_files/4/4c/APIDemo1.1.zip

And files demonstrating the bulk operations feature of caTissue are here: https://cabig-kc.nci.nih.gov/Biospecimen/uploaded_files/1/19/BO_-_Loading_Data_Session.zip

The following pages are working notes:
* [wiki:CaTissueClientAPI API Client]
* [wiki:CaTissueBulkOperations Bulk Operations]
* [wiki:CaTissueUseCases Use cases]
* BarCodeReaders
* [[Ranolazine]]
* [[Collection Protocol amendments for DNA processing]]

The following is the current work instruction followed by the lab technicians:
[raw-attachment:'WI-LCB-026-caTissue Data Entry (20101119v1).docx' BRICCS caTissue Work Instruction]

=== User Privileges ===
A note on user privileges in caTissue from Jeff. It is not our favoured model of privileges, but probably defined in the caBIG CSM (Common Security Model). We'd like more fine-grain privileges, but in the meantime this is how it works:

"It seems from the privileges tab of the admin page for collection protocol, that privileges have to be OK'd from the protocol side too; ie: you can set up privileges for users (and you can see these on the protocol/privileges tab) but there are none in operation (for a protocol) until you enable them from the protocol side."

"I (naively) thought that setting up privileges for each individual user would suffice. Seems reasonable. Then the penny dropped. What if I were doing admin on the protocol and wanted to stop people using it whilst changes were underway? If I were relying upon individual user privileges alone, I would have to go into each user and change their privilege, then do the protocol admin, then go back into each user again to re-enable their use. Very tedious. The way it is set up in caTissue, I can disable / enable wholesale privileges for one protocol with one admin action. Quite clever?"


=== Storage location structure: ===


=== BRICCS Collection Protocol: ===

A BRICCS 'initial db' dump was taken during system set-up, after creating the storage hierarchy and CP but before populating with any specimen, and submitted to svn using the following command:
svn import -m "Importing caTissue dump of initial db setup " catissue.dump             svn+ssh://svn.briccs.org.uk/var/local/svn/repo/sysadmin/trunk/scripts/catissue


=== Starting caTissue (temp solution) ===

Currently caTissue does not start automatically.

To run it:
> /usr/local/jboss/bin/run.sh -b 0.0.0.0 &