Komentowanie

Requirements Portal obsługuje komentowanie w projektach wymagań. Komentarz to notatka dodana przez użytkownika, przypisana do konkretnego wymagania, na którą inni użytkownicy mogą odpowiadać. Komentarze ułatwiają współpracę między użytkownikami bez zmieniania samych udostępnionych danych, ponieważ są przechowywane w obszarze roboczym niezależnie od tych danych. W komentarzu można oznaczyć jedną lub więcej osób lub grup. Komentarz można również przypisać do członka obszaru roboczego.

Komentarze są publikowane, obsługiwane i zarządzane bezpośrednio w tabeli wymagań za pomocą kontekstowego okna komentarzy. Komentarze są również wyświetlane w panelu Comments and Tasks po prawej stronie, który służy raczej do przeglądania i nawigacji niż do wykonywania operacji. Użyj elementu sterującego  w prawym górnym rogu, aby pokazać lub ukryć panel Comments and Tasks.

Dodawanie komentarza

Tryb dodawania komentarza można włączyć na jeden z następujących sposobów:

• Kliknij przycisk  u góry panelu Comments and Tasks, a następnie użyj wyświetlonego kursora dodawania (), aby wybrać wiersz wymagania, które chcesz skomentować.

• Kliknij przycisk  w wierszu wymagania i wybierz polecenie Komentarz z wyświetlonego menu.

W każdym przypadku zostanie wyświetlone okno komentarzy, w którym można wprowadzić komentarz w kontekście wybranego wymagania. Wpisz komentarz w odpowiednim polu. W komentarzu można oznaczyć jedną lub więcej osób lub grup. Wpisz znak @ w polu komentarza, aby szybko uzyskać dostęp do listy członków obszaru roboczego. Komentarz można również przypisać do członka obszaru roboczego. Więcej informacji o tych dodatkowych funkcjach znajdziesz w sekcji Praca z kontekstowym oknem komentarzy.

Po wpisaniu komentarza, dodaniu oznaczeń i ewentualnym przypisaniu kliknij przycisk  poniżej. Komentarz zostanie zapisany i pojawi się zarówno w kontekstowym oknie komentarzy, jak i w panelu Comments and Tasks. W kolumnie Identifier przy wymaganiu z komentarzem zostanie wyświetlony znacznik komentarza ().

Poniższa sekwencja ilustracji przedstawia dodawanie przykładowego komentarza do wymagania wraz z oznaczeniem członka zespołu i przypisaniem mu zadania (szczegóły poniżej).

Praca z kontekstowym oknem komentarzy

Poniższe wskazówki dotyczą pracy z komentarzami i kontekstowym oknem komentarzy w interfejsie:

• Okno komentarzy można otworzyć, klikając wpis komentarza w panelu Comments and Tasks.

  

• Okno można swobodnie przesuwać, klikając i przeciągając jego górny pasek.

• Użyj przycisków w lewym górnym rogu okna komentarzy, aby kolejno przechodzić odpowiednio do poprzedniego i następnego komentarza.

  Możesz również użyć Shift+Left Arrow i Shift+Right Arrow, aby przechodzić odpowiednio do poprzedniego i następnego komentarza.

• Po dodaniu pierwszego komentarza okno komentarzy będzie po otwarciu gotowe do wpisania odpowiedzi. Wpisz tekst w odpowiednim polu, a następnie kliknij przycisk , aby go zapisać. Aby wyjść bez odpowiadania, naciśnij Esc.

• W komentarzu można oznaczyć osobę lub grupę. Wpisz znak @, aby wyświetlić listę wszystkich członków zespołu obszaru roboczego. Możesz też wyszukać grupę lub osobę (po imieniu i nazwisku lub adresie e-mail), wpisując @ oraz co najmniej jeden kolejny znak — zostanie wyświetlona lista pasujących grup, członków zespołu oraz osób spoza zespołu (ale należących do Twojej organizacji), z której możesz wybrać odpowiednią pozycję. Aby dodać pozycję, kliknij ją lub użyj klawiszy Up Arrow / Down Arrow i naciśnij Enter .

  Oznaczona osoba, która jest członkiem zespołu lub należy do oznaczonej grupy, otrzyma powiadomienie e-mail o komentarzu.

  

  W komentarzu można oznaczyć dowolną osobę lub grupę. Wpisz znak @, aby uzyskać dostęp do listy wszystkich członków i grup obszaru roboczego.

  

  Możesz też wpisać @ i zacząć pisać, aby wyszukać grupę lub osobę. Dynamiczna lista obejmuje członków obszaru roboczego, inne osoby z Twojej organizacji oraz grupy zdefiniowane dla obszaru roboczego.

  

  Odpowiadając na komentarz, możesz również przypisać zadanie nowo oznaczonej osobie.

  

  Wybrana osoba, osoby lub grupy zostaną oznaczone w treści komentarza (w miarę możliwości z użyciem ich nazw).

   

• Możesz przypisać zadanie oznaczonej osobie. W tym celu włącz opcję Assign a Task to — domyślnie zadanie jest przypisywane pierwszej oznaczonej osobie, a jeśli nikogo nie oznaczono, Tobie (Me). Możesz też użyć menu rozwijanego, aby wybrać innego członka obszaru roboczego, któremu przypiszesz zadanie. Przypisana osoba jest widoczna we wpisie w panelu Comments and Tasks jako zdjęcie profilowe lub litera, wraz z odnośnikiem do powiązanego zadania. Przypisanie zadania można zmienić lub usunąć podczas edycji komentarza.

  

  Jeśli z komentarzem jest powiązane zadanie, górna krawędź jego okna zawiera:

  • ikona (obraz/litera) wskazująca członka, któremu przypisano zadanie powiązane z komentarzem. Wybierz ikonę, aby przypisać zadanie innemu członkowi obszaru roboczego z listy rozwijanej.

  • alfanumeryczne oznaczenie zadania, składające się z identyfikatora wymagania z dodanym na końcu numerem zadania. Kliknij oznaczenie, aby przejść do wpisu tego zadania na stronie zadań w obszarze roboczym.

    Na stronie Tasks obszaru roboczego możesz również sprawdzić i zmienić priorytet zadania (domyślnie Medium).

  • bieżący status zadania (To Do, In Progress, Resolved), który można zmienić za pomocą powiązanego menu rozwijanego ().

  

• Zadanie można dodać do istniejącego komentarza za pomocą opcji Convert to Task dostępnej w menu  tego okna. Nowe zadanie jest początkowo przypisane do Ciebie — możesz przypisać je innemu członkowi obszaru roboczego, wybierając jego wpis z listy rozwijanej otwieranej za pomocą awatara osoby przypisanej do zadania (w lewym górnym rogu).

  

• Okno komentarzy umożliwia również wklejenie pliku obrazu lub zrzutu ekranu ze schowka systemu Windows. Zrzut ekranu (lub skopiowany plik obrazu) możesz wkleić w polu komentarza przed lub po notatkach tekstowych i wzmiankach o użytkownikach. Obraz jest wyświetlany w treści okna komentarzy — kliknij go, aby wyświetlić go w pełnym rozmiarze. Wpis dodanego komentarza w panelu Comment and Tasks będzie zawierał powiązaną adnotację includes images.

  

• Komentarz można edytować lub usunąć wyłącznie w oknie komentarzy, używając odpowiednio poleceń Edit i Delete . Są one dostępne w menu powiązanym z kontrolką . Pamiętaj, że te polecenia są dostępne tylko dla komentarzy utworzonych przez Ciebie — nie możesz edytować ani usuwać komentarzy innych użytkowników. Podczas edycji istniejącego komentarza wprowadź zmiany, a następnie kliknij przycisk , aby je zatwierdzić. Aby wyjść bez zastosowania zmian, naciśnij Esc.

  Pamiętaj, że usunięcie komentarza spowoduje również usunięcie wszystkich powiązanych odpowiedzi.

  

• Po otwarciu okna komentarzy wyświetlane są tylko pierwszy i najnowszy komentarz w wątku. Aby zobaczyć wszystkie komentarze w wątku, kliknij kontrolkę dostępną między tymi wpisami. Użyj paska przewijania, aby przeglądać wszystkie komentarze.

  

• Komentarz można oznaczyć jako rozwiązany (lub ponownie aktywować), przełączając kontrolkę u góry okna komentarzy. Jeśli komentarz ma przypisane zadanie, jego bieżący status można zmienić na Resolved (lub inny) z menu rozwijanego statusu. Rozwiązane komentarze nie są domyślnie wyświetlane w panelu Comments and Tasks, ale można je wyświetlić za pomocą opcji pokazywania/ukrywania znaczników — więcej informacji znajdziesz w następnej sekcji.

  

Praca z panelem komentarzy

Poniższe punkty dotyczą pracy z komentarzami i panelem Comments and Tasks interfejsu:

• Panel Comments and Tasks służy do przeglądania komentarzy w całym projekcie i nawigowania między nimi, a nie do ich dodawania, edytowania czy odpowiadania na nie. Te funkcje są dostępne wyłącznie w kontekstowym oknie komentarzy.

• Panel Comments and Tasks można również otworzyć, klikając znacznik komentarza w głównym obszarze wyświetlania. Spowoduje to także otwarcie kontekstowego okna komentarzy.

• Użyj kontrolki w prawym górnym rogu panelu, aby wyświetlić znaczniki komentarzy w tabeli wymagań () lub je ukryć ().

  

  

   

• U góry panelu Comments and Tasks znajdują się kontrolki zapewniające dostęp do filtrów wątków, dzięki którym możesz określić, co ma być wyświetlane w panelu. Dostępne są zasadniczo dwa poziomy filtrowania. Pierwszy, czyli podstawowy, pozwala określić, komentarze których użytkowników mają być wyświetlane.

  

  Opcje filtrowania panelu ograniczają wyświetlane wpisy komentarzy do:

  • Tasks only — tylko komentarzy przypisanych jako zadania użytkowników, które są z kolei dostępne w widoku strony zadań.

  • Assigned to — tylko komentarzy przypisanych użytkownikom wybranym z poniższej listy. Po zaznaczeniu pola wyboru użytkownika panel (i wyświetlany dokument) będzie zawierał tylko komentarze z zadaniami przypisanymi temu użytkownikowi. Pamiętaj, że aktualnie zalogowany użytkownik znajduje się na początku listy, niezależnie od przypisania zadań powiązanych z komentarzami.

  Drugi poziom filtrowania, stosowany razem z filtrowaniem podstawowym, oferuje dwie opcje, które pozwalają ukryć wszystkie rozwiązane komentarze lub zadania (włączona opcja Unresolved only) i/lub wyświetlać tylko komentarze dotyczące aktualnie wybranego kontekstu (tj. folderu, specyfikacji lub sekcji), a nie całego projektu (włączona opcja Current context only).

  

• Kliknij pozycję Notification Settings (u dołu opisanego powyżej okna opcji), aby otworzyć okno, w którym możesz określić, o których komentarzach w projekcie chcesz otrzymywać powiadomienia e-mail. Możesz otrzymywać powiadomienia o wszystkich wątkach komentarzy, nie otrzymywać ich wcale lub otrzymywać je tylko o wątkach, w których uczestniczysz (utworzonych przez Ciebie, zawierających Twoją odpowiedź lub wzmiankę o Tobie).

  

• Wątki komentarzy w panelu są również porządkowane na dwóch poziomach. Po pierwsze, komentarze są uporządkowane według specyfikacji, w której się znajdują, zgodnie z kolejnością struktury Requirements w drzewie projektu po lewej stronie. Po drugie, dla każdego wymagania komentarze są uporządkowane według daty utworzenia — malejąco.

• Po kliknięciu wpisu wątku komentarzy w panelu dany komentarz zostanie otwarty w kontekstowym oknie komentarzy. Wpis komentarza w panelu Comments and Tasks zostanie również wyróżniony na niebiesko. Jeśli klikniesz komentarz, który nie znajduje się w aktualnie wyświetlanej specyfikacji, nastąpi przejście do specyfikacji zawierającej ten komentarz.

  

• Każdy wpis komentarza w panelu zawiera podsumowanie najważniejszych informacji dotyczących tego komentarza, jak pokazano w poniższym przykładzie.