Kommentieren

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

Kommentare werden direkt in der Anforderungstabelle über ein kontextbezogenes Kommentierungsfenster erstellt, beantwortet und verwaltet. Kommentare werden außerdem im Bereich Comments and Tasks angezeigt, der auf der rechten Seite eingeblendet wird und eher als Übersichts-/Navigationswerkzeug als als eigentliche Arbeitsoberfläche dient. Verwenden Sie das Steuerelement  oben rechts, um die Anzeige des Bereichs Comments and Tasks umzuschalten.

Einen Kommentar platzieren

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

• Klicken Sie oben im Bereich auf die Schaltfläche Comments and Tasks und verwenden Sie dann den daraus resultierenden Platzierungscursor (), um eine Anforderungszeile zum Kommentieren auszuwählen.

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

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

Wenn der Kommentar eingegeben, alle Erwähnungen hinzugefügt und bei Bedarf eine Zuweisung vorgenommen wurde, klicken Sie unten auf die Schaltfläche . Der Kommentar wird übernommen und erscheint sowohl im kontextbezogenen Kommentierungsfenster als auch im Bereich Comments and Tasks.

Die folgende Bildsequenz zeigt das Hinzufügen eines Beispielkommentars zu einer Anforderung, einschließlich der Erwähnung eines Teammitglieds und der Zuweisung einer Aufgabe an dieses Mitglied (Details siehe unten).

Arbeiten mit dem kontextbezogenen Kommentierungsfenster

Die folgenden Punkte beziehen sich auf die Arbeit mit Kommentaren und dem kontextbezogenen Kommentierungsfenster der Benutzeroberfläche:

• Das Kommentierungsfenster kann durch Klicken auf den Kommentareintrag im Bereich Comments and Tasks aufgerufen werden.

  

• Das Fenster kann frei verschoben werden, indem Sie auf seine obere Leiste klicken und sie ziehen.

• Verwenden Sie die Schaltflächen oben links im Kommentierungsfenster, 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 Kommentierungsfenster beim Öffnen für die Eingabe einer Antwort bereit. Geben Sie Ihren Text in das vorgesehene Feld ein und klicken Sie dann auf die Schaltfläche , um ihn zu übernehmen. Um ohne Antwort zu beenden, drücken Sie Esc.

• Sie können in einem Kommentar eine Person oder Gruppe erwähnen. Geben Sie das Zeichen @ ein, um ein Popup mit allen Mitgliedern des Workspace-Teams anzuzeigen. Alternativ können Sie nach der Gruppe oder Person suchen (bei Personen über Namen oder E-Mail), indem Sie @ gefolgt von einem oder mehreren Zeichen eingeben – es wird eine Liste passender Gruppen, Teammitglieder und Personen außerhalb des Teams (aber innerhalb Ihrer Organisation) angezeigt, aus der Sie auswählen können. Sie können entweder auf einen Eintrag klicken, um ihn hinzuzufügen, oder die Tasten Up Arrow / Down Arrow verwenden und Enter drücken, um ihn hinzuzufügen.

  Eine erwähnte Person, die entweder Teammitglied ist oder Mitglied einer erwähnten Gruppe ist, erhält eine Benachrichtigungs-E-Mail zu dem Kommentar.

  

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

  

  Alternativ geben Sie @ ein und beginnen mit der Eingabe, um nach einer Gruppe oder Person zu suchen. Die dynamische Liste enthält Workspace-Mitglieder, andere Personen innerhalb Ihrer Organisation und für den Workspace definierte Gruppen.

  

  Beim Antworten auf einen Kommentar können Sie der neu erwähnten Person auch eine Aufgabe zuweisen.

  

  Die betreffende Person, die betreffenden Personen oder Gruppen erscheinen im Kommentartext als Erwähnung (wenn möglich mit ihrem Namen).

   

• Sie können einer erwähnten Person eine Aufgabe zuweisen. Aktivieren Sie dazu entsprechend die Option Assign a Task to – standardmäßig ist 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 die Aufgabe zugewiesen werden soll. Die zugewiesene Person wird im Eintrag des Bereichs Comments and Tasks mit ihrem Benutzerprofilbild/-buchstaben zusammen mit einer zugehörigen Aufgabenreferenz angezeigt. Die Aufgabenzuweisung kann beim Bearbeiten des Kommentars geändert oder entfernt werden.

  

  Wenn eine Aufgabe mit einem Kommentar verknüpft ist, enthält der obere Rand des Fensters:

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

  • die alphanumerische Referenz der Aufgabe, bestehend aus der Anforderungskennung mit einem Suffix für die Aufgabennummer. Klicken Sie auf die Referenz, um zum entsprechenden Aufgabeneintrag auf der Workspace-Seite Tasks page zu springen.

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

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

  

• Einem bestehenden Kommentar kann über die im Menü des Fensters verfügbare Option Convert to Task eine Aufgabe hinzugefügt werden. Die neue Aufgabe wird zunächst Ihnen zugewiesen und kann geändert werden, indem Sie den Eintrag eines anderen Workspace-Mitglieds aus der Dropdown-Liste auswählen, die über den Avatar des Zuweisungsempfängers (oben links) geöffnet wird.

  

• Das Kommentierungsfenster akzeptiert auch eine Bilddatei oder einen erfassten Screenshot, der aus der Windows-Zwischenablage eingefügt wird. Sie können den Screenshot (oder die kopierte Bilddatei) vor oder nach beliebigen Textnotizen und Benutzererwähnungen in das Kommentarfeld einfügen. Die Bildgrafiken werden im Hauptteil des Kommentierungsfensters angezeigt – klicken Sie auf das Bild, um es in voller Größe anzuzeigen. Der Eintrag des platzierten Kommentars im Bereich Comment and Tasks enthält eine entsprechende includes images-Notiz.

  

• Ein Kommentar kann nur über das Kommentierungsfenster mit den Befehlen Edit bzw. Delete bearbeitet oder gelöscht werden. Diese sind über das mit dem Steuerelement  verknüpfte Menü verfügbar. Beachten Sie, dass diese Befehle nur für Kommentare verfügbar sind, die Sie selbst erstellt haben – Sie können einen von einem anderen Benutzer erstellten Kommentar nicht bearbeiten oder entfernen. Wenn Sie einen vorhandenen Kommentar bearbeiten, nehmen Sie Ihre Änderungen vor und klicken dann auf die Schaltfläche , um sie zu übernehmen. Um ohne Übernahme von Änderungen zu beenden, drücken Sie Esc.

  Wenn Sie einen Kommentar löschen, beachten Sie, dass auch alle zugehörigen Antworten gelöscht werden.

  

• Beim Öffnen des Kommentierungsfensters werden nur der erste und der neueste Kommentar im Thread angezeigt. Um alle Kommentare im Thread zu sehen, klicken Sie auf das zwischen diesen Einträgen verfügbare Steuerelement. Verwenden Sie die Bildlaufleiste, um durch alle Kommentare zu blättern.

  

• Ein Kommentar kann als erledigt markiert werden (oder durch Umschalten des Steuerelements oben im Kommentierungsfenster wieder aktiviert werden). Wenn dem Kommentar eine zugewiesene Aufgabe zugeordnet ist, kann ihr aktueller Status über das Status-Drop-down-Menü in Resolved (oder eine andere Stufe) geändert werden. Erledigte Kommentare werden standardmäßig nicht im Bereich Comments and Tasks angezeigt, können jedoch über dessen Option zum Ein-/Ausblenden der Pins sichtbar gemacht 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 Übersichts-/Navigationswerkzeug für Kommentare im gesamten Projekt und nicht als eigentliche Oberfläche zum Veröffentlichen, Bearbeiten und Beantworten. Diese Funktionalität bleibt ausschließlich dem kontextbezogenen Kommentierungsfenster vorbehalten.

• Oben im Bereich Comments and Tasks befinden sich Steuerelemente, die Zugriff auf Filteroptionen für Threads bieten, sodass Sie festlegen können, was im Bereich angezeigt wird. Im Wesentlichen können zwei Filterebenen definiert werden. Die erste bzw. primäre Ebene ermöglicht es Ihnen zu steuern, welche Benutzerkommentare angezeigt werden.

  

  Die Filteroptionen des Bereichs beschränken die Kommentar-Einträge auf:

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

  • Assigned to – nur Kommentare, die den unten aufgeführten Benutzerauswahlen zugewiesen sind. Wenn ein Kontrollkästchen für einen Benutzer aktiviert ist, enthält der Bereich (und das angezeigte Dokument) nur diejenigen Kommentare, deren Aufgaben diesem Benutzer zugewiesen sind. Beachten Sie, dass der aktuell angemeldete Benutzer oben in der Liste enthalten ist, unabhängig von etwaigen Zuweisungen von Kommentaraufgaben.

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

  

• Klicken Sie auf den Eintrag Notification Settings (unten im oben genannten Optionsfenster), um ein Fenster zu öffnen, in dem Sie konfigurieren 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 haben, auf die Sie geantwortet haben oder in denen Sie erwähnt wurden).

  

• Bei der Reihenfolge der Kommentar-Threads im Bereich gibt es ebenfalls zwei Ebenen. Erstens werden Kommentare nach der Spezifikation sortiert, in der sie sich befinden; dies folgt derselben Reihenfolge wie die RequirementsStruktur im linken Projektbaum. Zweitens werden die Kommentare für jede Anforderung nach dem Erstellungsdatum sortiert – in absteigender Reihenfolge.

• Wenn Sie im Bereich auf einen Kommentar-Thread-Eintrag klicken, wird dieser Kommentar im kontextbezogenen Kommentierungsfenster geöffnet. Der Eintrag des Kommentars 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 entsprechenden Spezifikation weitergeleitet.

  

• Jeder Kommentar-Eintrag im Bereich bietet eine Zusammenfassung der wichtigsten Informationen zu diesem Kommentar, wie im folgenden Beispiel gezeigt.