1282 |
25 Jan 11 |
nicklas |
== Requirements == |
1282 |
25 Jan 11 |
nicklas |
2 |
|
7372 |
06 Oct 23 |
nicklas |
1. BASE 3.19.10 |
7372 |
06 Oct 23 |
nicklas |
2. Job scheduler extension 1.11 must be installed |
6052 |
12 Nov 20 |
nicklas |
3. Thumbnails extension 1.2 must be installed |
1282 |
25 Jan 11 |
nicklas |
6 |
|
1282 |
25 Jan 11 |
nicklas |
== Introduction == |
1282 |
25 Jan 11 |
nicklas |
8 |
|
1282 |
25 Jan 11 |
nicklas |
This package is an extension package to BASE that can be used to |
1282 |
25 Jan 11 |
nicklas |
simplify biosource and sample registration. |
1282 |
25 Jan 11 |
nicklas |
11 |
|
1282 |
25 Jan 11 |
nicklas |
* The homepage for this extension: |
6309 |
11 Jun 21 |
nicklas |
https://baseplugins.thep.lu.se/wiki/net.sf.basedb.reggie |
1282 |
25 Jan 11 |
nicklas |
14 |
|
1463 |
14 Nov 11 |
martin |
== Installation and updating == |
1282 |
25 Jan 11 |
nicklas |
16 |
|
1282 |
25 Jan 11 |
nicklas |
1. Download the reggie-*.tar.gz file. |
1282 |
25 Jan 11 |
nicklas |
2. Unpack the downloaded file to a directory of your choice. |
1463 |
14 Nov 11 |
martin |
3. Copy the 'reggie.jar' file to your BASE plug-ins directory. |
1463 |
14 Nov 11 |
martin |
Eg. the directory specified by the 'plugins.dir' setting in 'base.config'. |
2747 |
07 Oct 14 |
nicklas |
4. Edit and copy configuration files to their correct location. See |
2747 |
07 Oct 14 |
nicklas |
config/readme.txt for more information. If this is a first-time |
2747 |
07 Oct 14 |
nicklas |
installation shut down BASE and run 'updatedb.sh' script so |
2747 |
07 Oct 14 |
nicklas |
that additional reporter annotations and raw data columns are |
2747 |
07 Oct 14 |
nicklas |
created. |
2747 |
07 Oct 14 |
nicklas |
5. Log in to BASE as a user with Administrator priviliges. |
2747 |
07 Oct 14 |
nicklas |
6. Go to 'Administrate->Plug-ins & Extensions->Overview' page. |
1463 |
14 Nov 11 |
martin |
Run the installation wizard and select to install/update 'reggie.jar'. |
2747 |
07 Oct 14 |
nicklas |
7. Create a project and set it as the active project. This step is |
1310 |
04 Mar 11 |
nicklas |
optional but is recommended. Running Reggie without an active project |
1310 |
04 Mar 11 |
nicklas |
will generate warning messages later on. |
2747 |
07 Oct 14 |
nicklas |
8. Go to the Extensions->Reggie menu. Select the 'Installation wizard' |
1334 |
05 Apr 11 |
nicklas |
If the 'Reggie' menu is not visible try BASE->Reload permissions menu. |
2747 |
07 Oct 14 |
nicklas |
9. It should display a list with several error message about missing items. |
1310 |
04 Mar 11 |
nicklas |
Click on the "Create missing items" button to create them. If no project |
1310 |
04 Mar 11 |
nicklas |
was created in step 6, all annotatation types will be shared with the |
1310 |
04 Mar 11 |
nicklas |
'PatientCurator' group, otherwise only some will be shared to the |
1310 |
04 Mar 11 |
nicklas |
group and some will be shared to the active project. |
2747 |
07 Oct 14 |
nicklas |
10. Manual fixes. Check the release information if any manual changes are |
1630 |
27 Apr 12 |
nicklas |
needed to items that already exists in BASE. |
2747 |
07 Oct 14 |
nicklas |
11. Done. |
1301 |
28 Feb 11 |
nicklas |
42 |
|
1301 |
28 Feb 11 |
nicklas |
== Using == |
1301 |
28 Feb 11 |
nicklas |
44 |
|
1282 |
25 Jan 11 |
nicklas |
Reggie appears as a menu entry in the Extensions menu. All operations |
1301 |
28 Feb 11 |
nicklas |
are available on that page. |
1282 |
25 Jan 11 |
nicklas |
47 |
|
1334 |
05 Apr 11 |
nicklas |
* Installation wizard: |
1301 |
28 Feb 11 |
nicklas |
This entry is available if the logged in user is an 'Administrator' and |
1301 |
28 Feb 11 |
nicklas |
will perform some basic checks that items that are needed by Reggie |
1301 |
28 Feb 11 |
nicklas |
exists and have been properly configured. Items that doesn't exists can |
1301 |
28 Feb 11 |
nicklas |
be created automatically. |
1301 |
28 Feb 11 |
nicklas |
53 |
|
1334 |
05 Apr 11 |
nicklas |
* Personal information registration wizard: |
1301 |
28 Feb 11 |
nicklas |
This entry is available for 'Administrators' and members of the |
1301 |
28 Feb 11 |
nicklas |
'PatientCurator' group. It is used to register new patients and |
1301 |
28 Feb 11 |
nicklas |
cases and connect this information to (already existing) |
1334 |
05 Apr 11 |
nicklas |
specimen tubes. It can also be used to update missing information |
1334 |
05 Apr 11 |
nicklas |
on existing cases and specimen tubes. |
1527 |
25 Jan 12 |
nicklas |
60 |
|
1527 |
25 Jan 12 |
nicklas |
* Blood referral form registration wizard |
1527 |
25 Jan 12 |
nicklas |
This entry is available for 'Administrators' and members of the |
1527 |
25 Jan 12 |
nicklas |
'PatientCurator' group. It is used to register blood samples |
1527 |
25 Jan 12 |
nicklas |
and connect them with patients. The patient doesn't have to exists. |
1527 |
25 Jan 12 |
nicklas |
If the blood sample already exists, the wizard can be used to update |
1527 |
25 Jan 12 |
nicklas |
missing information. |
1527 |
25 Jan 12 |
nicklas |
67 |
|
1337 |
11 Apr 11 |
nicklas |
* Referral form registration wizard: |
1337 |
11 Apr 11 |
nicklas |
This entry is available for 'Administrators' and members of the |
1337 |
11 Apr 11 |
nicklas |
'PatientCurator' group. It is used to connect scanned referral |
1337 |
11 Apr 11 |
nicklas |
forms (eg. pdf files) to already existing cases. |
1301 |
28 Feb 11 |
nicklas |
72 |
|
1355 |
28 Apr 11 |
nicklas |
* Consent form registration wizard: |
1355 |
28 Apr 11 |
nicklas |
This entry is available for 'Administrators' and members of the |
1355 |
28 Apr 11 |
nicklas |
'PatientCurator' group. It is used to connect register consent |
1461 |
14 Nov 11 |
martin |
for participating in the study. |
1461 |
14 Nov 11 |
martin |
77 |
|
1461 |
14 Nov 11 |
martin |
* Specimen tube registration wizard: |
1461 |
14 Nov 11 |
martin |
This entry is available for those with permission to create samples. |
1461 |
14 Nov 11 |
martin |
It is used to register new specimen tubes for cases that are not yet |
1461 |
14 Nov 11 |
martin |
in BASE. |
1461 |
14 Nov 11 |
martin |
82 |
|
1461 |
14 Nov 11 |
martin |
* Partition registration wizard: |
1461 |
14 Nov 11 |
martin |
This entry is available for those with permission to create samples |
1461 |
14 Nov 11 |
martin |
and extracts. It is used to register new partitions of existing |
1461 |
14 Nov 11 |
martin |
specimen tubes. |
1645 |
15 May 12 |
nicklas |
87 |
|
1645 |
15 May 12 |
nicklas |
* DNA/RNA extraction wizards |
1645 |
15 May 12 |
nicklas |
Wizards for registering the extraction of DNA and RNA from the |
1645 |
15 May 12 |
nicklas |
sample material. |
1301 |
28 Feb 11 |
nicklas |
91 |
|
1606 |
19 Apr 12 |
nicklas |
* Histology wizards |
1779 |
12 Dec 12 |
nicklas |
Three wizards used in the process of creating H&E stained glass |
1779 |
12 Dec 12 |
nicklas |
slides. The first wizard creates a printable lab tracking protocol |
1779 |
12 Dec 12 |
nicklas |
for the current batch biomaterial items that are about to be |
1779 |
12 Dec 12 |
nicklas |
processed. The second wizard records the paraffin embedding step, |
1779 |
12 Dec 12 |
nicklas |
and the last wizard records the H&E staining step. |
1606 |
19 Apr 12 |
nicklas |
98 |
|
1557 |
12 Mar 12 |
nicklas |
* RNA quality control wizards |
1557 |
12 Mar 12 |
nicklas |
Three wizards that are used in the RNA quality control workflow. The |
1557 |
12 Mar 12 |
nicklas |
first wizard is used for placing the RNA aliquots on a Caliper or |
1557 |
12 Mar 12 |
nicklas |
Bioanalyzer plate. The second wizard generates a sample name file that |
1557 |
12 Mar 12 |
nicklas |
can be used by the Caliper software. The third wizard import the results |
1557 |
12 Mar 12 |
nicklas |
from Caliper back into BASE. |
1557 |
12 Mar 12 |
nicklas |
105 |
|
1282 |
25 Jan 11 |
nicklas |
== Compiling == |
1282 |
25 Jan 11 |
nicklas |
107 |
|
5443 |
21 May 19 |
nicklas |
To compile this package you also need (later versions may also work): |
1282 |
25 Jan 11 |
nicklas |
109 |
|
5443 |
21 May 19 |
nicklas |
1. Ant 1.10 |
5443 |
21 May 19 |
nicklas |
2. Java 11 |
1282 |
25 Jan 11 |
nicklas |
112 |
|
1282 |
25 Jan 11 |
nicklas |
Follow these instructions: |
1282 |
25 Jan 11 |
nicklas |
114 |
|
1282 |
25 Jan 11 |
nicklas |
1. Download the source code from the subversion repository. See |
6309 |
11 Jun 21 |
nicklas |
https://baseplugins.thep.lu.se/wiki/net.sf.basedb.reggie for instructions. |
1282 |
25 Jan 11 |
nicklas |
117 |
|
1282 |
25 Jan 11 |
nicklas |
2. Type `ant download-lib` to automatically download the BASE core JAR files that |
1282 |
25 Jan 11 |
nicklas |
are neeed for compilation. You can also do this manually by copying the |
1463 |
14 Nov 11 |
martin |
base-*.jar files from the BASE installation directory |
1463 |
14 Nov 11 |
martin |
(<basedir>/www/WEB-INF/lib/) to the ./lib/compile directory. |
1282 |
25 Jan 11 |
nicklas |
122 |
|
1282 |
25 Jan 11 |
nicklas |
3. Type 'ant' to compile the code and generate the 'reggie.jar' file |
1282 |
25 Jan 11 |
nicklas |
in the project directory. |
1282 |
25 Jan 11 |
nicklas |
125 |
|
1282 |
25 Jan 11 |
nicklas |
4. Use 'ant package' to create a downloadable tar.gz package. |
1282 |
25 Jan 11 |
nicklas |
127 |
|
1282 |
25 Jan 11 |
nicklas |
Tip: If you need different values for any of the properties defined in |
1282 |
25 Jan 11 |
nicklas |
the 'build.xml' file, create a file named 'build.properties' and set |
1282 |
25 Jan 11 |
nicklas |
the values there. |
1282 |
25 Jan 11 |
nicklas |
131 |
|