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 wspierają współpracę między użytkownikami bez modyfikowania samych współdzielonych danych, ponieważ są one przechowywane przez Workspace niezależnie od tych danych. W komentarzu możesz wspomnieć jedną lub więcej osób albo grup. Komentarz może także zostać przypisany do członka Workspace.

Komentarze są publikowane, komentowane i zarządzane bezpośrednio w tabeli wymagań za pomocą kontekstowego okna komentarzy. Komentarze są również prezentowane w panelu Comments and Tasks, który znajduje się po prawej stronie i pełni raczej funkcję przeglądową/nawigacyjną niż operacyjnego interfejsu. Użyj kontrolki  w prawym górnym rogu, aby przełączać wyświetlanie panelu 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 umieszczania (), aby wybrać wiersz wymagania do skomentowania.

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

W każdym przypadku zostanie wyświetlone okno komentarza, w którym można zdefiniować komentarz w kontekście wybranego wymagania. Wpisz komentarz w udostępnionym polu. W komentarzu możesz wspomnieć jedną lub więcej osób albo grup. Wpisz znak @ w polu komentarza, aby szybko uzyskać dostęp do listy członków Workspace. Komentarz może też zostać przypisany do członka. Więcej informacji o tych dodatkowych funkcjach znajdziesz w sekcji Praca z kontekstowym oknem komentarzy.

Po wpisaniu komentarza, dodaniu ewentualnych wzmianek i wykonaniu przypisania, jeśli jest wymagane, kliknij przycisk  poniżej. Komentarz zostanie zapisany i pojawi się zarówno w kontekstowym oknie komentarzy, jak i w panelu Comments and Tasks.

Poniższa sekwencja ilustracji pokazuje dodanie przykładowego komentarza do wymagania, wraz z dodaniem wzmianki o członku zespołu i przypisaniem mu zadania (szczegóły poniżej).

Praca z kontekstowym oknem komentarzy

Poniższe punkty dotyczą pracy z komentarzami i kontekstowego okna komentarzy interfejsu:

• Do okna komentarzy można uzyskać dostęp, 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 poprzednich i następnych komentarzy.

  Możesz również używać Shift+Left Arrow i Shift+Right Arrow, aby przechodzić odpowiednio do poprzednich i następnych komentarzy.

• Po dodaniu pierwszego komentarza, po otwarciu okna komentarzy będzie ono gotowe do wpisania odpowiedzi. Wprowadź tekst w udostępnionym polu, a następnie kliknij przycisk , aby go zatwierdzić. Aby wyjść bez odpowiadania, naciśnij Esc.

• W komentarzu możesz wspomnieć osobę lub grupę. Wpisz znak @, aby uzyskać dostęp do wyskakującej listy wszystkich członków zespołu Workspace. Alternatywnie wyszukaj grupę lub osobę (w tym drugim przypadku po nazwie lub adresie e-mail), wpisując @ i jeden lub więcej znaków — zostanie wyświetlona lista pasujących grup, członków zespołu oraz osób spoza zespołu (ale w ramach Twojej organizacji), z której można dokonać wyboru. Możesz kliknąć wpis, aby go dodać, albo użyć klawiszy Up Arrow / Down Arrow i nacisnąć Enter , aby dodać.

  Osoba wspomniana w komentarzu, która jest członkiem zespołu lub należy do wspomnianej grupy, otrzyma powiadomienie e-mail o komentarzu.

  

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

  

  Alternatywnie wpisz @ i zacznij pisać, aby wyszukać grupę lub osobę. Dynamiczna lista obejmuje członków Workspace, inne osoby w Twojej organizacji oraz grupy zdefiniowane dla Workspace.

  

  Podczas odpowiadania na komentarz możesz również przypisać zadanie nowo wspomnianej osobie.

  

  Wymagana osoba, osoby lub grupy pojawią się jako wspomniane w tekście komentarza (tam, gdzie to możliwe — po nazwie).

   

• Możesz przypisać zadanie osobie, która została wspomniana. Włącz odpowiednio opcję Assign a Task to — domyślnie wskazuje ona pierwszą wspomnianą osobę, a jeśli nie ma żadnej wzmianki, Ciebie (Me). Alternatywnie użyj menu rozwijanego, aby wybrać innego członka Workspace, któremu chcesz przypisać zadanie. Przypisana osoba jest widoczna we wpisie panelu Comments and Tasks jako obraz/ litera profilu użytkownika, wraz z powiązanym odwołaniem do zadania. Przypisanie zadania można zmienić lub usunąć podczas edycji komentarza.

  

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

  • ikonę (obraz/literę) wskazującą członka, któremu przypisano zadanie komentarza. Wybierz ikonę, aby przypisać zadanie innemu członkowi Workspace z listy rozwijanej.

  • alfanumeryczne odwołanie do zadania, złożone z identyfikatora wymagania z sufiksem numeru zadania. Kliknij odwołanie, aby przejść do wpisu tego zadania na stronie Workspace Tasks page.

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

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

  

• Zadanie można dodać do istniejącego komentarza za pomocą opcji Convert to Task dostępnej w menu  okna. Nowe zadanie jest początkowo przypisane do Ciebie i można je zmienić na innego członka Workspace, wybierając jego wpis z listy rozwijanej otwieranej z awatara osoby przypisanej (lewy górny róg).

  

• Okno komentarzy akceptuje również plik obrazu lub przechwycony zrzut ekranu wklejony ze schowka systemu Windows. Zrzut ekranu (lub skopiowany plik obrazu) możesz wkleić do pola komentarza przed notatkami tekstowymi i wzmiankami o użytkownikach lub po nich. Grafiki obrazu są wyświetlane w treści okna komentarzy — kliknij obraz, aby otworzyć go do podglądu w pełnym rozmiarze. Wpis dodanego komentarza w panelu Comment and Tasks będzie zawierał powiązaną notatkę includes images.

  

• Komentarz można edytować lub usunąć wyłącznie za pośrednictwem okna komentarzy, używając odpowiednio poleceń Edit i Delete . Są one dostępne z menu powiązanego z kontrolką . Pamiętaj, że polecenia te są dostępne tylko dla komentarza dodanego przez Ciebie — nie możesz edytować ani usuwać komentarza utworzonego przez innego użytkownika. Jeśli edytujesz istniejący komentarz, wprowadź zmiany, a następnie kliknij przycisk , aby je zatwierdzić. Aby wyjść bez zastosowania zmian, naciśnij Esc.

  Jeśli usuniesz komentarz, pamiętaj, że wszystkie powiązane odpowiedzi również zostaną usunięte.

  

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

  

• Komentarz można oznaczyć jako rozwiązany (lub ponownie uaktywnić), przełączając kontrolkę u góry okna komentarzy. Jeśli do komentarza przypisano zadanie, jego bieżący status można zmienić na Resolved (lub inny poziom) z rozwijanego menu statusu. Domyślnie rozwiązane komentarze nie są wyświetlane w panelu Comments and Tasks, ale można je pokazać za pomocą opcji pokazywania/ukrywania pinezek — więcej informacji znajduje się w następnej sekcji.

  

Praca z panelem Comments

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

• Panel Comments and Tasks służy do przeglądu komentarzy w całym projekcie i jako narzędzie nawigacyjne, a nie jako interfejs operacyjny do publikowania, edytowania i odpowiadania. Ta funkcjonalność jest dostępna wyłącznie w kontekstowym oknie komentarzy.

• U góry panelu Comments and Tasks znajdują się kontrolki zapewniające dostęp do ustawień filtrowania wątków, dzięki czemu możesz określić, co będzie prezentowane w panelu. Zasadniczo można zdefiniować dwa poziomy filtrowania. Pierwszy, czyli podstawowy, pozwala sterować tym, które komentarze użytkowników są wyświetlane.

  

  Opcje filtrowania panelu ograniczają wpisy komentarzy do:

  • Tasks only – tylko tych komentarzy, które zostały przypisane jako zadania użytkownika, a które z kolei są dostępne w przepływie strony Tasks page.

  • Assigned to – tylko komentarzy przypisanych użytkownikom wybranym poniżej. Po zaznaczeniu pola wyboru użytkownika panel (oraz wyświetlany dokument) będzie zawierał tylko te komentarze, których zadania są przypisane do tego użytkownika. Zwróć uwagę, że aktualnie zalogowany użytkownik jest uwzględniony na górze listy niezależnie od przypisania zadań komentarzy.

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

  

• Kliknij pozycję Notification Settings (na dole powyższego okna opcji), aby otworzyć okno, w którym można skonfigurować, dla których komentarzy w projekcie będziesz otrzymywać powiadomienia e-mail. Możesz wybrać otrzymywanie powiadomień dla wszystkich wątków komentarzy, dla żadnych wątków komentarzy albo tylko dla tych, w które jesteś zaangażowany(-a) (zostały rozpoczęte przez Ciebie, odpowiedziałeś(-aś) na nie lub zostałeś(-aś) w nich wspomniany(-a)).

  

• Jeśli chodzi o kolejność wątków komentarzy w panelu, również tutaj występują dwa poziomy. Po pierwsze, komentarze są uporządkowane według specyfikacji, w których się znajdują, i odpowiada to tej samej kolejności co struktura 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 komentarza w panelu dany komentarz zostanie otwarty w kontekstowym oknie komentarzy. Wpis tego komentarza w panelu Comments and Tasks zostanie również podświetlony na niebiesko. Jeśli klikniesz komentarz, który nie znajduje się w aktualnie wyświetlanej specyfikacji, nastąpi przejście do specyfikacji, w której ten komentarz się znajduje.

  

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