Kommentieren

Requirements Portal unterstützt Kommentare innerhalb Ihrer Anforderungsprojekte. Ein Kommentar ist eine von einem Benutzer hinzugefügte Notiz, die einer bestimmten Anforderung zugeordnet ist und von anderen Benutzern beantwortet werden kann. Kommentare fördern die Zusammenarbeit zwischen Benutzern, ohne die gemeinsam genutzten Daten selbst zu verändern, da sie vom Workspace unabhängig von diesen Daten gespeichert werden. Sie können eine oder mehrere Personen oder Gruppen im Kommentar erwähnen. Ein Kommentar kann auch einem Workspace-Mitglied zugewiesen werden.

Kommentare werden direkt in der Anforderungstabelle über ein kontextbezogenes Kommentarfenster veröffentlicht, beantwortet und verwaltet. Kommentare werden auch im Bereich Comments and Tasks angezeigt, der sich auf der rechten Seite befindet und eher der Übersicht und Navigation dient als der eigentlichen Bearbeitung. Verwenden Sie das Steuerelement  oben rechts, um den Bereich Comments and Tasks ein- oder auszublenden.

Einen Kommentar platzieren

Der Modus zum Platzieren von Kommentaren kann auf eine der folgenden Arten aktiviert werden:

• Klicken Sie oben im Bereich Comments and Tasks auf die Schaltfläche  und wählen Sie dann mit dem angezeigten Platzierungscursor () eine Anforderungszeile aus, die Sie kommentieren möchten.

• Klicken Sie in der Zeile der Anforderung auf die Schaltfläche  und wählen Sie im angezeigten Menü den Befehl „Kommentar“.

In beiden Fällen wird ein Kommentarfenster angezeigt, in dem Sie den Kommentar im Kontext der ausgewählten Anforderung verfassen können. Geben Sie Ihren Kommentar in das dafür vorgesehene Feld ein. Sie können eine oder mehrere Personen oder Gruppen im Kommentar erwähnen. Geben Sie im Kommentarfeld das Zeichen @ ein, um schnell auf eine Liste der Workspace-Mitglieder zuzugreifen. Ein Kommentar kann auch einem Mitglied zugewiesen werden. Weitere Informationen zu diesen zusätzlichen Funktionen finden Sie im Abschnitt Arbeiten mit dem kontextbezogenen Kommentarfenster.

Wenn Sie den Kommentar eingegeben, alle Erwähnungen hinzugefügt und gegebenenfalls eine Zuweisung vorgenommen haben, klicken Sie darunter auf die Schaltfläche  . Der Kommentar wird gespeichert und sowohl im kontextbezogenen Kommentarfenster als auch im Bereich Comments and Tasks angezeigt. Bei einer Anforderung mit Kommentar wird in der Spalte Identifier eine Kommentarmarkierung () angezeigt.

Die folgende Bildsequenz zeigt, wie einer Anforderung ein Beispielkommentar hinzugefügt, ein Teammitglied erwähnt und diesem eine Aufgabe zugewiesen wird (Details siehe unten).

Arbeiten mit dem kontextbezogenen Kommentarfenster

Die folgenden Hinweise betreffen die Arbeit mit Kommentaren und dem kontextbezogenen Kommentarfenster der Benutzeroberfläche:

• Das Kommentarfenster kann durch Klicken auf den Kommentareintrag im Bereich Comments and Tasks geöffnet werden.

  

• Das Fenster lässt sich durch Klicken und Ziehen seiner oberen Leiste frei verschieben.

• Verwenden Sie die Schaltflächen oben links im Kommentarfenster, um nacheinander zum vorherigen bzw. nächsten Kommentar zu wechseln.

  Sie können auch Shift+Left Arrow und Shift+Right Arrow verwenden, um zum vorherigen bzw. nächsten Kommentar zu wechseln.

• Sobald ein erster Kommentar erstellt wurde, ist das Kommentarfenster beim Öffnen für die Eingabe einer Antwort bereit. Geben Sie Ihren Text in das dafür vorgesehene Feld ein und klicken Sie dann zum Speichern auf die Schaltfläche . Um das Fenster ohne Antwort zu verlassen, drücken Sie Esc.

• Sie können eine Person oder Gruppe in einem Kommentar erwähnen. Geben Sie das Zeichen @ ein, um eine Pop-up-Liste aller Mitglieder des Workspace-Teams aufzurufen. Alternativ können Sie nach einer Gruppe oder Person (bei Personen nach Name oder E-Mail-Adresse) suchen, indem Sie @ gefolgt von einem oder mehreren Zeichen eingeben. Daraufhin wird eine Liste passender Gruppen, Teammitglieder und Personen außerhalb des Teams (aber innerhalb Ihrer Organisation) angezeigt, aus der Sie auswählen können. Klicken Sie auf einen Eintrag, um ihn hinzuzufügen, oder verwenden Sie die Tasten Up Arrow / Down Arrow und drücken Sie zum Hinzufügen Enter .

  Eine erwähnte Person, die entweder Teammitglied oder Mitglied einer erwähnten Gruppe ist, erhält eine E-Mail-Benachrichtigung über den Kommentar.

  

  Sie können jede Person oder Gruppe in einem Kommentar erwähnen. Geben Sie das Zeichen @ ein, um eine Liste aller Workspace-Mitglieder und -Gruppen aufzurufen.

  

  Alternativ können Sie @ eingeben und mit der Eingabe beginnen, um nach einer Gruppe oder Person zu suchen. Die dynamische Liste umfasst Workspace-Mitglieder, andere Personen innerhalb Ihrer Organisation und für den Workspace definierte Gruppen.

  

  Wenn Sie auf einen Kommentar antworten, können Sie der neu erwähnten Person auch eine Aufgabe zuweisen.

  

  Die gewünschten Personen oder Gruppen werden im Kommentartext als Erwähnungen angezeigt (nach Möglichkeit mit ihrem Namen).

   

• Sie können einer erwähnten Person eine Aufgabe zuweisen. Aktivieren Sie dazu die Option Assign a Task to. Standardmäßig wird die zuerst erwähnte Person ausgewählt oder, wenn keine Erwähnung enthalten ist, Sie selbst (Me). Alternativ können Sie über das Dropdown-Menü ein anderes Workspace-Mitglied auswählen, dem Sie die Aufgabe zuweisen möchten. Die zugewiesene Person wird im Eintrag des Bereichs Comments and Tasks durch ihr Benutzerprofilbild bzw. ihren Profilbuchstaben zusammen mit einer zugehörigen Aufgabenreferenz angezeigt. Die Aufgabenzuweisung kann beim Bearbeiten des Kommentars geändert oder entfernt werden.

  

  Wenn einem Kommentar eine Aufgabe zugeordnet ist, enthält der obere Rand des Kommentarfensters Folgendes:

  • ein Symbol (Bild/Buchstabe), das das Mitglied anzeigt, dem die Aufgabe des Kommentars zugewiesen wurde. Wählen Sie das Symbol aus, um die Aufgabe über die Dropdown-Liste einem anderen Workspace-Mitglied zuzuweisen.

  • die alphanumerische Referenz der Aufgabe, bestehend aus der Anforderungskennung mit einer angehängten Aufgabennummer. Klicken Sie auf die Referenz, um zum entsprechenden Aufgabeneintrag auf der Aufgabenseite des Workspace zu springen.

    Auf der Workspace-Seite Tasks können Sie auch die Aufgabenpriorität anzeigen und ändern (standardmäßig Medium).

  • der aktuelle Bearbeitungsstatus der Aufgabe (To Do, In Progress, Resolved), der über das zugehörige Dropdown-Menü () geändert werden kann.

  

• Über die Option Convert to Task im Menü  des Fensters kann einem bestehenden Kommentar eine Aufgabe hinzugefügt werden. Die neue Aufgabe wird zunächst Ihnen zugewiesen und kann einem anderen Workspace-Mitglied zugewiesen werden, indem Sie dessen Eintrag in der Dropdown-Liste auswählen, die über den Avatar der zugewiesenen Person (oben links) geöffnet wird.

  

• Im Kommentarfenster können Sie auch eine Bilddatei oder einen Screenshot aus der Windows-Zwischenablage einfügen. Sie können den Screenshot (oder die kopierte Bilddatei) vor oder nach Textnotizen und Benutzererwähnungen in das Kommentarfeld einfügen. Die Bilder werden im Hauptbereich des Kommentarfensters angezeigt – klicken Sie auf ein Bild, um es in voller Größe zu öffnen. Der Eintrag des platzierten Kommentars im Bereich Comment and Tasks enthält einen entsprechenden Hinweis includes images.

  

• Ein Kommentar kann ausschließlich über das Kommentarfenster mit den Befehlen Edit bzw. Delete bearbeitet oder gelöscht werden. Diese sind im Menü des Bedienelements  verfügbar. Beachten Sie, dass diese Befehle nur für Kommentare verfügbar sind, die Sie selbst verfasst haben – Sie können Kommentare anderer Benutzer weder bearbeiten noch entfernen. Wenn Sie einen bestehenden Kommentar bearbeiten, nehmen Sie Ihre Änderungen vor und klicken Sie anschließend auf die Schaltfläche , um sie zu übernehmen. Um das Fenster ohne Übernahme der Änderungen zu verlassen, drücken Sie Esc.

  Beachten Sie beim Löschen eines Kommentars, dass auch alle zugehörigen Antworten gelöscht werden.

  

• Beim Öffnen des Kommentarfensters werden nur der erste und der neueste Kommentar des Threads angezeigt. Um alle Kommentare im Thread anzuzeigen, klicken Sie auf das Bedienelement zwischen diesen Einträgen. Mit der Bildlaufleiste können Sie durch alle Kommentare scrollen.

  

• Ein Kommentar kann über das Bedienelement oben im Kommentarfenster als erledigt markiert (oder wieder aktiviert) werden. Wenn dem Kommentar eine Aufgabe zugewiesen ist, kann deren aktueller Status über das Status-Dropdown-Menü auf Resolved (oder einen anderen Status) geändert werden. Erledigte Kommentare werden im Bereich Comments and Tasks standardmäßig nicht angezeigt, können aber über die Option zum Ein-/Ausblenden von Pins eingeblendet werden – weitere Informationen finden Sie im nächsten Abschnitt.

  

Arbeiten mit dem Kommentarbereich

Die folgenden Punkte beziehen sich auf die Arbeit mit Kommentaren und dem Bereich Comments and Tasks der Benutzeroberfläche:

• Der Bereich Comments and Tasks dient als Übersicht und Navigationshilfe für Kommentare im gesamten Projekt, nicht jedoch als Oberfläche zum Verfassen, Bearbeiten und Beantworten von Kommentaren. Diese Funktionen stehen ausschließlich im kontextbezogenen Kommentarfenster zur Verfügung.

• Der Bereich Comments and Tasks kann auch durch Klicken auf eine Kommentarmarkierung im Hauptanzeigebereich geöffnet werden. Dadurch wird auch das kontextbezogene Kommentarfenster geöffnet.

• Verwenden Sie das Bedienelement oben rechts im Bereich, um Kommentarmarkierungen in der Anforderungstabelle anzuzeigen () oder auszublenden ().

  

  

   

• Oben im Bereich Comments and Tasks befinden sich Bedienelemente für den Zugriff auf die Thread-Filter, mit denen Sie festlegen können, was im Bereich angezeigt wird. Grundsätzlich lassen sich zwei Filterebenen definieren. Auf der ersten, primären Ebene können Sie steuern, welche Benutzerkommentare angezeigt werden.

  

  Die Filteroptionen des Bereichs beschränken die Kommentareinträge auf:

  • Tasks only – nur die Kommentare, die als Benutzeraufgaben zugewiesen wurden und wiederum im Ablauf auf der Aufgabenseite verfügbar sind.

  • Assigned to – nur Kommentare, die den unten ausgewählten Benutzern zugewiesen sind. Wenn das Kontrollkästchen eines Benutzers aktiviert ist, werden im Bereich (und im angezeigten Dokument) nur die Kommentare angezeigt, deren Aufgaben diesem Benutzer zugewiesen sind. Beachten Sie, dass der aktuell angemeldete Benutzer unabhängig von etwaigen Zuweisungen von Kommentaraufgaben ganz oben in der Liste aufgeführt wird.

  Die sekundäre Filterebene, die in Kombination mit der primären Filtermethode angewendet wird, bietet zwei Optionen: Sie können alle erledigten Kommentare oder Aufgaben ausblenden (Unresolved only aktiviert) und/oder nur Kommentare für den aktuell ausgewählten Kontext (d. h. Ordner, Spezifikation oder Abschnitt) statt für das gesamte Projekt anzeigen (Current context only aktiviert).

  

• Klicken Sie auf den Eintrag Notification Settings (unten im oben beschriebenen Optionsfenster), um ein Fenster zu öffnen, in dem Sie festlegen können, für welche Kommentare im Projekt Sie E-Mail-Benachrichtigungen erhalten möchten. Sie können Benachrichtigungen für alle Kommentar-Threads, für keine Kommentar-Threads oder nur für diejenigen erhalten, an denen Sie beteiligt sind (die Sie gestartet oder beantwortet haben oder in denen Sie erwähnt wurden).

  

• Auch bei der Sortierung der Kommentar-Threads im Bereich gibt es zwei Ebenen. Zunächst werden die Kommentare nach der Spezifikation sortiert, in der sie sich befinden. Dabei wird dieselbe Reihenfolge wie in der Struktur Requirements im linken Projektbaum verwendet. Anschließend werden die Kommentare zu jeder Anforderung nach ihrem Erstellungsdatum in absteigender Reihenfolge sortiert.

• Wenn Sie auf einen Kommentar-Thread-Eintrag im Bereich klicken, wird dieser Kommentar im kontextbezogenen Kommentarfenster geöffnet. Der Kommentareintrag im Bereich Comments and Tasks wird außerdem blau hervorgehoben. Wenn Sie auf einen Kommentar klicken, der sich nicht in der aktuell angezeigten Spezifikation befindet, werden Sie zu der Spezifikation navigiert, in der sich dieser Kommentar befindet.

  

• Jeder Kommentareintrag im Bereich enthält eine Zusammenfassung der wichtigsten Informationen zu diesem Kommentar, wie im folgenden Beispiel dargestellt.