Normalerweise erzeugen Sie eine Anmerkung, indem Sie eine Aktion zur Symbolleiste für Anmerkungen hinzufügen. Diese Aktion wird in Form einer Schaltfläche in der Symbolleiste angezeigt.
Gehen Sie wie folgt vor, um eine neue Aktion zur Symbolleiste für Anmerkungen hinzuzufügen:
- Deklarieren Sie in der Datei plugin.xml eine neue Anmerkungsaktion. Verwenden Sie dazu den Erweiterungspunkt com.ibm.rational.test.lt.recorder.ui.annotationContribution und das Element annotationAction.
- Weisen Sie der Anmerkungsaktion eine eindeutige ID zu.
- Entscheiden Sie, ob diese Aktion standardmäßig sichtbar sein soll. Aktionen, die standardmäßig sichtbar sind, stehen in allen Aufzeichnungssitzungen zur Verfügung, sofern Sie nicht durch einen Client oder Recorder ausgeblendet werden. Aktionen, die nicht standardmäßig sichtbar sind, stehen nur dann zur Verfügung, wenn die Aktion für einen Recorder oder Client erforderlich ist.
- Definieren Sie eine Implementierungsklasse für diese Aktion. Die Implementierungsklasse muss die abstrakte Klasse "com.ibm.rational.test.lt.recorder.ui.actions.AbstractAnnotationAction" erweitern.
Berücksichtigen Sie in Bezug auf Implementierungen von "AbstractAnnotationAction" die folgenden Fakten:
- Mit dieser Klasse wird die JFace Action-Klasse erweitert.
- Legen Sie im Konstruktor den Namen, den QuickInfo-Text und den Imagedeskriptor der Aktion fest.
- Implementieren Sie die Methode "run()". Diese Methode kann mit dem Benutzer interagieren und den Benutzer z. B. zur Eingabe eines Textfelds auffordern. Wenn eine Interaktion mit dem Benutzer stattfindet, muss die Zeit für die Interaktion mit dem Benutzer in Millisekunden gemessen werden.
- Zum Erzeugen einer Anmerkung erstellen Sie eine Instanz der Klasse "com.ibm.rational.test.lt.recorder.core.annotations.RecorderAnnotation" und übergeben Sie dann den Anmerkungstyp als ein Argument. Legen Sie die Anmerkungseigenschaften mithilfe der in dieser Klasse bereitstehenden Setter-Methoden fest.
- Nachdem die Anmerkung erstellt wurde, leiten Sie sie weiter, indem Sie eine Nachricht des Typs "AnnotationMessage" an den Anmerkungsrecorder senden. Dabei handelt es sich in der Regel um einen Aufruf in folgendem Format: annotationRecorder.sendMessage(new AnnotationMessage(annotation, interactionTime));