...

This plugin provides the following main functions:

1. Finds all Workplace items / objects (folders, queries, patient sets, etc.) containing the terms provided (in either their annotations or their names), in the conditions selected.
2. Tabulates such found items (with their corresponding icons) in the alphabetical order of their paths.
3. Optionally exports aforementioned tabulated data (without the item icons) into an Excel spreadsheet file convenientlyFacilitates annotating a Workplace item (object) with
   • distinct short paragraphs, for better descriptions;
   • keywords (tags), to facilitate searches; and
   • author.
4. Dynamically keeps count of the length of the annotation as it is being updated, and warns the user when it reaches the length limit.
5. Displays the saved annotation for review.

Instructions

1. Navigate to the "Specify SearchObject" tab. Enter the comma-separated search terms into the input text area.
2. Select the appropriate Match option radio button.
3. Drag the desired item (object), from the Workplace panel, and drop it into the drop-in box.
4. Click the "Annotate" tab, and wait for the existing annotation to be fetched and displayed:
   1. Any existing annotation text paragraphs will be displayed in corresponding, dintinct, beige text area, along with 2 extra blank, white text areas for any new paragraphs to be added.
   2. Existing keywords (tags) will be displayed in the next-to-last text area (beige if there is existing entry, white if blank).
   3. Existing authors will be displayed in the last text area (beige if there is existing entry, white if blank).
   4. In addition to the length for each text area, the overall length of the annotaation is also displayed at the top and bottom.
   5. Make any updates to any appropriate text area, and its corresponding length count, along with the overall annotation length counts, will be immediately updated for instant feedback.
   6. Any updated text area will turn light pink to indicate changes.
   7. A dialog will be displayed when the annotation length limit is reached, and no more new characters can be added. The text area where the offense occurred will be changed to bright red for additional feedback.
   8. Once appropriate characters are deleted to bring the annotation within limit, normal character addition may proceed, so long as it is under the length limit.
5. Finally, click the "Review Result" tab to view the tabulated search result.resulting saved annotation.

Caveats

This plugin does not support the following Workplace items:

1. Patient Count: The i2b2 web client object drop in framework tends to strip away any descriptive terms and only retains the not-so-descriptive portion (e.g. "PATIENT_COUNT_15"), making it very difficiult to find the original object and fetch its annotation for update. Besides, it is not expected to be of much use or widely shared by the user community any way.
2. The root (top most) items (e.g. "SHARED"), which cannot be annotated as part of the i2b2 Workplace framework constraint.

Browser Compatibilities

• This plugin works on the following browsers: Firefox (v.4.0.1), Chrome (v.12.0.742.122), Safari (v.5.0.5)
• It is not compatible with Internet Explorer (v.9.0.1) -- we are working on a fix in the next release.
• The i2b2 Web client itself does not work on the following browser: Opera (v.11.50).

...

Availability

This plugin is free to the rest of the i2b2 community. It can be downloaded from the University of Massachusetts Medical School website for i2b2 related downloads. 

...

• the general construct / format /style / template used in the i2b2 web client plugin examples by N. Benik & G. Weber;the XLS export feature of the ExportXLS plugin by M. Bucalo, Universita' di Pavia.