Teaching Annotations

There are two ways to get teaching annotations onto a slide once it's imported into OMERO: bring in annotations that already exist (e.g. recovered from a legacy source), or draw new ones directly in OMERO.

Transferring existing OME-XML annotations

If the slide's annotations already exist as an OME-XML file (for example, recovered alongside the original image from a legacy system), use the ROI Importer OMERO.web plugin rather than recreating them by hand:

Open the target Image in OMERO.web, then choose "Open with ROI Importer" (or open the ROI Importer plugin directly and enter the Image ID).
Upload the OME-XML file. Optionally also upload the original source slide file alongside it - if provided, its hash is compared against the Image's own stored file hash to confirm you've got the right Image before anything is written.
Preview parses the file and shows every ROI found in an editable table - shape type, geometry, description, an editable label, and an Include checkbox per row. Untick anything you don't want, edit labels as needed.
Commit creates the still-included rows as real ROIs on the Image, all in one batch.

Tested end-to-end against a real OMERO server and security-reviewed - safe against malicious XML (entity-expansion attacks are rejected before parsing), and runs on your own OMERO permissions rather than an administrator connection.

Creating new annotations directly in OMERO

Recommended workflow, based on experience with both tools:

Create the ROIs in OMERO.insight - rectangles, ellipses, points, polygons, arrows, and other shapes are easier to draw accurately in the desktop client than in the browser.
Adjust and label them in OMERO.web - repositioning, resizing, and adding text labels is easier afterwards in the browser-based viewer's drawing tools (OMERO calls this the "Measurement Tool", but creating and labelling ROIs is exactly what it's used for here, not just measuring existing ones). See the official documentation: OMERO Measurement Tool.

Once annotations are in place, continue to Prepare the Slide for View on the VLE.