Komentowanie dokumentów

Po integracji z połączonym obszarem roboczym projekty Altium Designer umożliwiają rozproszonemu zespołowi projektowemu wspólną pracę nad projektami przechowywanymi i zarządzanymi centralnie. Interfejs projektowy obsługuje dodawanie komentarzy do różnych dokumentów projektowych, usprawniając współpracę. Komentarze, czyli notatki dodawane przez użytkowników, można umieszczać w dokumentach, a inni użytkownicy mogą na nie odpowiadać.

Panel Comments and Tasks

Umieszczone komentarze są dostępne w czasie rzeczywistym dla współpracujących użytkowników (mających współdzielony dostęp do dokumentu) i są zapisywane na serwerze niezależnie od projektu, bez jakichkolwiek zmian w jego dokumentach składowych. Funkcją komentowania zarządza się za pomocą panelu Comments and Tasks. Po wybraniu wpisu komentarza w panelu Comments and Tasks system otworzy powiązany dokument projektowy (i w razie potrzeby go załaduje).

Panel Comments and Tasks umożliwia dodawanie komentarzy do określonego obszaru lub punktu w aktywnym dokumencie projektu z obszaru roboczego oraz przypisywanie tych komentarzy członkom obszaru roboczego, co w praktyce oznacza tworzenie dla nich zadań. Panel pozwala wszystkim użytkownikom pracującym nad dokumentem dodawać i przeglądać wszystkie komentarze bez modyfikowania samego dokumentu. Funkcja ta usprawnia współpracę i jest nieoceniona, gdy trzeba wskazać problemy w dokumencie bez konieczności scalania zmian i rozwiązywania konfliktów. Panel Comments and Tasks może służyć do tworzenia listy zadań do wykonania, a w miarę postępów prac projektowych komentarze można oznaczać jako rozwiązane i zamykać. Umieszczone komentarze są dostępne w czasie rzeczywistym dla współpracujących użytkowników — mających współdzielony dostęp do dokumentu — i są zapisywane w obszarze roboczym niezależnie od projektu, bez jakichkolwiek zmian w jego dokumentach składowych.

Komentarze i zadania można dodawać oraz zarządzać nimi zarówno w Altium Designer, jak i w powiązanym obszarze roboczym, w widoku projektu dostępnym przez interfejs przeglądarkowy. Funkcjonalność obu systemów komentowania jest zasadniczo taka sama, a ponieważ zarówno projekt, jak i dane komentarzy są przechowywane w obszarze roboczym, systemy współpracują ze sobą w czasie rzeczywistym.

Szczegółowe informacje o systemie komentowania w interfejsie przeglądarkowym obszaru roboczego znajdziesz w sekcji Commenting in the Web Viewer (obszar roboczy Altium 365, obszar roboczy Enterprise Server).

Gdzie można dodawać komentarze

Schemat

Komentarz można przypisać do obiektu, określonego punktu lub obszaru w dokumencie schematu.

PCB

Komentarz można przypisać do obiektu, określonego punktu lub obszaru w dokumencie PCB (w trybie projektowania 2D) — .

Draftsman

Komentarz można przypisać do określonego punktu lub obszaru w dokumencie Draftsman projektu PCB, projektu wielopłytkowego lub projektu wiązki przewodów — .

Schemat wielopłytkowy

Komentarz można przypisać do obiektu lub określonego punktu w dokumencie schematu wielopłytkowego — .

Zespół wielopłytkowy

Komentarz można przypisać do określonego punktu w dokumencie zespołu wielopłytkowego — .

Schemat połączeń i rysunek rozmieszczenia wiązki przewodów

Komentarz można przypisać do obiektu, określonego punktu lub obszaru w dokumencie schematu połączeń lub rysunku rozmieszczenia projektu wiązki przewodów.

ActiveBOM

Komentarz można przypisać do wiersza w dokumencie ActiveBOM — .

Dostęp do panelu komentarzy i zadań

Panel można otworzyć w projekcie z obszaru roboczego na następujące sposoby:

• Kliknij przycisk Panels w prawym dolnym rogu obszaru projektowego, a następnie wybierz Comments and Tasks.

  Ikona obszaru roboczego obok nazwy panelu w menu w prawym dolnym rogu obszaru projektowego wskazuje, że do wyświetlenia danych danego panelu wymagane jest połączenie z obszarem roboczym. Niebieska ikona () oznacza, że połączenie z obszarem roboczym jest obecnie aktywne. Szara ikona () oznacza, że obecnie nie ma połączenia z obszarem roboczym, a przed uzyskaniem dostępu do danych panelu pojawi się monit o nawiązanie takiego połączenia.

• Wybierz polecenie View » Panels » Comments and Tasks z menu głównego.

• Kliknij dwukrotnie znacznik komentarza umieszczonego w obszarze projektowym.

Dodawanie komentarza bez połączenia z obszarem roboczym

Przed użyciem funkcji komentowania upewnij się, że masz połączenie ze swoim obszarem roboczym oraz że masz otwarty projekt i dokument jednego z typów obsługujących komentarze (w tym schemat, PCB 2D, Draftsman i ActiveBOM). Użyj polecenia File » Open Project, aby wybrać projekt z obszaru roboczego spośród projektów, które Ci udostępniono. Panel Comments and Tasks zawiera wskazówki dotyczące tych wymagań.

Opcje panelu Komentarze i zadania

Przyciski u góry panelu Comments and Tasks służą do ustawiania dostępności komentarzy w panelu i przestrzeni edytora oraz określania, czy wspomniani użytkownicy mają otrzymywać powiadomienia.

Przycisk  w panelu przełącza widoczność znaczników komentarzy w dokumencie. Wpisy komentarzy na liście w panelu Komentarze i zadania nadal można wybierać w zwykły sposób.

Użyj menu rozwijanego filtrów w panelu (), aby skonfigurować filtrowanie komentarzy, oraz powiązanego z nim przycisku , aby przełączać się między widokiem filtrowanym i niefiltrowanym.

• TYPE — włącz typ, który ma być wyświetlany. Domyślnie wszystkie typy są włączone.

• SCOPE — włącz Current document, aby wyświetlać komentarze tylko dla bieżącego dokumentu.

• ASSIGNEE — wszystkie opcje są domyślnie wyłączone. W związku z tym wyświetlane są wszystkie zadania i komentarze, posortowane według nazw użytkowników (pierwszą pozycją na liście jest bieżący użytkownik). Po zaznaczeniu pól wyboru przy użytkownikach wyświetlane będą tylko wpisy wybranych osób. 

• Clear Filters — pozwala szybko przywrócić domyślne ustawienia filtrowania.

Użyj opcji w menu przycisku , aby skonfigurować widoczność komentarzy i powiadomienia:

• Unresolved Only — komentarze oznaczone jako rozwiązane nie są uwzględniane na liście.

• Notification settings — kliknij, aby otworzyć okno dialogowe Notification Settings i skonfigurować otrzymywanie powiadomień e-mail o wszystkich działaniach związanych z komentarzami w tym projekcie (All), tylko o komentarzach, w których Cię wspomniano lub które Ci przypisano (My), albo całkowicie wyłączyć powiadomienia e-mail (None). ► Przykładowa treść wiadomości e-mail.

• Export Comments — kliknij, aby otworzyć okno dialogowe Comment Export Configuration i skonfigurować eksport komentarzy do pliku PDF.

  

Wynikowy plik PDF będzie zawierał informacje o komentarzach w projekcie: identyfikator komentarza, autora, datę i godzinę utworzenia, treść komentarza, przypisaną osobę (w przypadku zadań) oraz status (w przypadku komentarza — czy jest Resolved; w przypadku zadania — jego status To Do / In Progress / Resolved). Możesz wyeksportować wszystkie komentarze powiązane z projektem, niezależnie od daty ich dodania, lub tylko komentarze dodane pomiędzy określonymi wydaniami projektu. Dostępnych jest również kilka opcji określających, które zrzuty ekranu mają zostać uwzględnione w generowanym dokumencie PDF. Razem dostarczają one informacji o położeniu komentarza i o tym, czego dotyczy (punktu, komponentu, obszaru). Jeśli pozostawisz obie opcje niezaznaczone, otrzymasz wyłącznie same komentarze. Po zakończeniu konfiguracji kliknij Export , aby wygenerować plik PDF, a w kolejnym oknie dialogowym określ lokalizację zapisu i nazwę pliku (domyślnie jest to nazwa projektu).

• Entire designs snapshots — dołącz migawkę każdego dokumentu źródłowego zawierającego komentarz z określonego przedziału czasu Period. Pozwala to wizualnie potwierdzić położenie komentarza w dokumencie na podstawie numerowanego znacznika komentarza.
• Original design screenshots — dołącz oryginalną migawkę wykonaną podczas tworzenia komentarza (jest to migawka dostępna w oknie Contextual Commenting po kliknięciu znacznika komentarza w głównej przestrzeni projektowej). Przedstawia ona punkt, obszar lub komponent, którego dotyczy komentarz.

Dodawanie komentarzy

Aby dodać komentarz w przestrzeni projektowej obiektowego edytora graficznego, takiego jak edytor schematów, PCB 2D lub Draftsman, najpierw uruchom odpowiednie polecenie. Możesz to zrobić na jeden z następujących sposobów:

• Kliknij przycisk  dostępny w panelu Comments and Tasks.

• Kliknij  w pobliżu prawego górnego rogu przestrzeni projektowej.

• Wybierz Place » Comment z menu głównego.

• Użyj skrótu klawiaturowego Ctrl+Alt+C.

• Kliknij prawym przyciskiem myszy w przestrzeni projektowej, a następnie wybierz Comment.

W zależności od typu dokumentu (patrz wyżej) komentarze można przypisywać do obiektu, konkretnego punktu lub obszaru w aktywnym dokumencie. Polecenie uruchamia tryb dodawania komentarzy, a kursor zmienia się w krzyżyk z niebieskim okręgiem, który wykrywa i podświetla obiekty możliwe do wybrania:

• Kliknij podświetlony obiekt, aby przypiąć do niego komentarz.

• Kliknij w niepodświetlonym obszarze, aby przypiąć komentarz do tego konkretnego punktu w dokumencie.

• Kliknij poza obiektem i przeciągnij kursor, aby utworzyć prostokątny podświetlony obszar i przypiąć do niego komentarz ().

W dokumencie ActiveBOM kliknij komórkę, aby dodać komentarz do danego wiersza zestawienia materiałowego (BOM). Możesz też kliknąć wiersz prawym przyciskiem myszy, a następnie wybrać polecenie Comment, aby dodać komentarz do tego wiersza.

Następnie otworzy się okno dodawania komentarza z polem do wpisania jego treści, a w przypadku dokumentów graficznych także z dodatkową opcją dodania odręcznego rysunku do komentarza, jeśli ma to zastosowanie (). Wybierz opcję Assign a task to, aby przypisać zadanie sobie lub jednemu z użytkowników wspomnianych w komentarzu (szczegóły poniżej). Kliknij , aby potwierdzić utworzenie komentarza. Spowoduje to powiązanie komentarza z numerowanym znacznikiem w dokumencie oraz dodanie wpisu z podsumowaniem komentarza do panelu Comments and Tasks.

Dodawanie komentarza do obiektu, wspominanie w komentarzu innego zarejestrowanego użytkownika, przesuwanie znacznika komentarza oraz dodawanie odręcznego rysunku do komentarza.

Wzmianki i przypisywanie zadań

Oprócz tekstu w oknie wprowadzania komentarza można dodać wzmiankę o dowolnym innym użytkowniku lub roli zarejestrowanej w połączonym obszarze roboczym, wpisując znak @. Wybierz nazwę lub adres e-mail z listy rozwijanej, aby dodać do komentarza odwołanie do użytkownika (członka obszaru roboczego), a także wpis Assign a task to — w praktyce użytkownikowi zostanie przypisane task. Usuń zaznaczenie tej ostatniej opcji, jeśli nie chcesz, aby komentarz był traktowany jako przypisany konkretnie do tego użytkownika. Jako wzmiankę można również dodać grupę ról (np. „Inżynierowie”), a tym samym należących do niej użytkowników.

Jeśli wspomniany użytkownik nie ma dostępu do bieżącego projektu, pojawi się propozycja udostępnienia mu projektu. Ta opcja jest dostępna dla właściciela projektu lub administratora obszaru roboczego. Prawa dostępu użytkownika są nadawane w oknie dialogowym Udostępnij; użytkownik otrzyma wiadomość e-mail z powiadomieniem o przyznaniu dostępu. Jeśli anulujesz okno dialogowe Udostępnij, projekt nie zostanie udostępniony, ale komentarz zostanie umieszczony w zwykły sposób.

► Zobacz więcej informacji o udostępnianiu projektu.

Gdy zadanie zostanie przypisane użytkownikowi, jego obraz lub zdjęcie pojawi się w lewym górnym rogu okna komentarza oraz na kafelku komentarza w panelu Comments and Tasks. Ponadto zadanie otrzyma nazwę składającą się z nazwy projektu i numeru kolejnego (np. Kame_FMU-1), zamiast samego numeru, jak w przypadku zwykłych komentarzy. Ta nazwa jest również wyświetlana w oknie komentarza i na jego kafelku. Kliknij ją, aby otworzyć stronę Tasks projektu w interfejsie przeglądarkowym obszaru roboczego z zaznaczonym zadaniem na liście zadań.

Pozycjonowanie

Położenie komentarza w obszarze edytora można zmienić, przeciągając powiązaną z nim „pinezkę” w nowe miejsce — podczas umieszczania komentarza lub później. Po zaznaczeniu pinezki komentarza widoczna jest linia łącząca ją z powiązanym obiektem lub obszarem.

Pamiętaj, że położenie komentarza można również określić podczas jego początkowego umieszczania, klikając i przeciągając w trybie umieszczania ().

Wklejanie obrazów

Aby dodać obraz do komentarza, najpierw skopiuj go z okna Explorer  lub strony w przeglądarce, klikając obraz prawym przyciskiem myszy, co umożliwia skopiowanie go do schowka. Aby dołączyć obraz, użyj polecenia Paste z menu dostępnego po kliknięciu prawym przyciskiem myszy (lub skrótu Ctrl+V ) w samym komentarzu (w polu z tekstem Add others with @ or paste images). 

Każdy obraz może mieć maksymalnie 2 MB. Po wklejeniu go do komentarza kliknij obraz, aby wyświetlić go w całości, jak pokazano na ilustracji po prawej stronie.

Możesz również opublikować komentarz zawierający wyłącznie wklejony obraz, bez tekstu, jak pokazano poniżej.

Rysowanie

Podczas umieszczania lub edytowania komentarza wybierz przycisk opcji , aby dodać odręczny rysunek za pomocą kursora w kształcie pióra. Klikaj i przeciągaj, aby tworzyć linie, a następnie kliknij prawym przyciskiem myszy, aby zakończyć i powiązać rysunek z aktualnie wybranym komentarzem.

Aby przejść do trybu Freehand Drawing panelu Properties, naciśnij klawisz Tab , gdy aktywny jest tryb rysowania odręcznego (wskazuje go ikona  w obszarze projektowania). Opcje te umożliwiają cofanie i ponawianie komentarzy za pomocą menu rozwijanego Commands oraz zmianę szerokości, rozmiaru i koloru za pomocą menu rozwijanego Properties .

Zadania ogólne

Zadania ogólne (zadania dotyczące bieżącego projektu, ale niepowiązane z komentarzem ani dokumentem projektu) są wyświetlane w panelu w oddzielnej grupie pod wpisem projektu. W przypadku zadań ogólnych panel wyświetla te same informacje i atrybuty (osobę przypisaną, priorytet itp.).

Zadania ogólne są wyświetlane w panelu Comments and Tasks.

Kliknij wpis zadania ogólnego w panelu, aby uzyskać dostęp do jego okien komentarzy. Użyj okna dialogowego, aby publikować komentarze (w tym komentarze z wklejonymi obrazami) dotyczące wybranego zadania ogólnego.

Odłączone komentarze

Gdy dokument projektu zostanie usunięty lub zmieni się jego UniqueID, komentarze do tego dokumentu mogą zostać „odłączone”. Nadal można uzyskać do nich dostęp w rozwijanej sekcji Detached Comments panelu. Kliknij kafelek odłączonego komentarza w panelu Comments and Tasks, aby wyświetlić jego okno dialogowe w obszarze projektowania aktualnie otwartego dokumentu.

Praca z komentarzami

Komentarze umieszczone w dokumencie projektu są rejestrowane zarówno w panelu Comments and Tasks (jako sekwencja numerowanych wpisów), jak i w odpowiednim edytorze dokumentu (jako numerowane znaczniki). Każdy wpis w panelu reprezentuje wątek komentarzy i zawiera podsumowanie informacji, w tym autora i czas dodania komentarza, tekst początkowego komentarza, wszelkie wzmianki i przypisania oraz liczbę odpowiedzi w wątku.

Wątek komentarzy otwiera się przez wybranie jego wpisu w panelu Comments and Tasks lub kliknięcie powiązanego z nim znacznika w obszarze projektowania. Powoduje to wyróżnienie komentarza w edytorze dokumentu i otwarcie okna dialogowego komentarza, które zawiera komentarz początkowy oraz wszystkie odpowiedzi użytkowników. Jeśli wybrany komentarz jest powiązany z innym dokumentem projektu, system otworzy ten dokument (i w razie potrzeby go załaduje).

Nawigowanie po komentarzach przez wybieranie znaczników w obszarze projektowania oraz wpisów w panelu Comments and Tasks.

Okno dialogowe komentarzy

Interakcja z umieszczonym komentarzem odbywa się za pośrednictwem wyskakującego okna dialogowego komentarza, które pokazuje wszystkie wpisy w wybranym wątku komentarzy i zawiera opcje podglądu, odpowiadania, edytowania, rozwiązywania i usuwania wpisów. Okno dialogowe otwiera się podczas dodawania komentarza lub po wybraniu istniejącego komentarza w panelu Comments and Tasks albo w obszarze projektowania. Naciśnij Esc lub kliknij w obszarze projektowania, aby zamknąć okno dialogowe komentarza.

Podgląd

Wybierz opcję Original Snapshot w początkowym komentarzu, aby zobaczyć zrzut obszaru edytora z chwili umieszczenia komentarza. Kliknij ikonę w prawym górnym rogu zrzutu ekranu lub sam zrzut, aby otworzyć podgląd w pełnym rozmiarze (kliknij ikonę  w prawym górnym rogu tego podglądu lub sam obraz, aby go zamknąć).

Odpowiedź

Wprowadź tekst i opcjonalnie wzmiankę o użytkowniku („@”) w polu Reply, aby dodać nowy wpis do wątku komentarzy. Wybierz opcję Assign a task to, aby utworzyć zadanie przypisane do użytkownika wskazanego na liście rozwijanej. Kliknij  , aby zatwierdzić wpis.

Edytowanie i usuwanie

Istniejący komentarz może być edytowany przez jego autora za pomocą opcji Edit dostępnej w menu  komentarza. Kliknij przycisk , aby zatwierdzić zmiany w komentarzu.

Użyj opcji Delete, aby usunąć aktualnie wybrany komentarz. Pamiętaj, że usunięcie początkowego komentarza (zamiast odpowiedzi) spowoduje usunięcie całego wątku.

Użyj opcji Convert to Task, aby przekształcić komentarz w zadanie przypisane do siebie.

Użyj opcji Copy Link, aby skopiować adres URL wątku komentarzy. Ten link umożliwia otwarcie projektu w Web Viewer w interfejsie przeglądarkowym przestrzeni roboczej, z przybliżonym i wyśrodkowanym obiektem, punktem lub obszarem, którego dotyczy komentarz.

Rozwiązywanie

Kliknij przycisk / , aby przełączyć stan komentarza między Resolved a Unresolved (stan domyślny). Rozwiązany komentarz (zamknięty jako zakończony) jest nieaktywny i nie można go edytować, a jego wpis w panelu Comments and Tasks oraz znacznik w dokumencie są wyszarzone.

Ustawianie priorytetów i statusów zadań

Jeśli komentarz będący zadaniem został przypisany do użytkownika, można ustawić jego priorytet i status. Zadanie otrzymuje od razu priorytet Medium i status To Do, ale można je zmienić, klikając odpowiednią kontrolkę u góry okna dialogowego komentarza.

Informacje o tagu zatwierdzenia, identyfikatorze rewizji wydania i przeglądzie projektu 

Tagi zatwierdzeń i identyfikatory rewizji wydań są wyświetlane podczas przeglądania odpowiednich komentarzy/zadań zarówno w panelu Comments and Tasks, jak i w oknie dialogowym komentarzy w Altium Designer.

• Komentarze utworzone w przeglądarce Web Viewer podczas wyświetlania migawki projektu dla zatwierdzenia oznaczonego tagiem będą zawierać nazwę powiązanego tagu. Kliknij link z nazwą tagu, aby otworzyć migawkę powiązanego zatwierdzenia w przeglądarce Web Viewer.

• Komentarze utworzone w przeglądarce Web Viewer podczas wyświetlania określonego wydania będą zawierać identyfikator rewizji wydania. Kliknij link z identyfikatorem rewizji wydania, aby otworzyć portal produkcyjny dla tego wydania.

• Komentarze utworzone w przeglądarce Web Viewer podczas wyświetlania migawki przeglądu projektu będą zawierać wpis dotyczący tego przeglądu. Kliknij link do przeglądu projektu, aby otworzyć jego stronę.

Praca z zadaniami Jira

Jeśli integracja z Jira jest włączona i skonfigurowana dla Twojej przestrzeni roboczej Altium 365, umieszczony komentarz będzie zawierał dodatkową opcję utworzenia zgłoszenia w usłudze Atlassian Jira® i powiązania go z komentarzem. Podobnie jak standardowe komentarze i powiązane z nimi zadania, umieszczone zgłoszenia Jira można przeglądać, edytować i komentować z poziomu dokumentów projektu, a także przeglądać i wybierać za pośrednictwem panelu Comments and Tasks.

Umieszczona instancja zadania Jira jest synchronizowana z odpowiadającym jej zgłoszeniem w przestrzeni Jira. Dwukierunkowa synchronizacja danych między zgłoszeniami Jira a zadaniami przestrzeni roboczej umożliwia zarządzanie projektami za pośrednictwem przestrzeni Jira w połączeniu z Altium 365.

Tworzenie zgłoszenia Jira

Aby umieścić zadanie w postaci zgłoszenia Jira w projekcie, najpierw dodaj komentarz w zwykły sposób, a następnie wybierz opcję Jira Issue w oknie dialogowym komentarza. Następnie wybierz typ zgłoszenia i dodaj podsumowanie, aby utworzyć zsynchronizowane zadanie zgłoszenia Jira.

Wybierz Task ID zgłoszenia Jira z przestrzeni roboczej w oknie dialogowym komentarza lub w panelu Comments and Tasks, aby otworzyć to zgłoszenie bezpośrednio w przestrzeni Jira na nowej karcie domyślnej przeglądarki. Task ID w przestrzeni roboczej odpowiada Issue Key w przestrzeni Jira, a główne parametry Jira, takie jak podsumowanie, opis, osoba przypisana i komentarze, są mapowane między tymi dwoma zgłoszeniami. Użytkownik przestrzeni roboczej, który utworzył zgłoszenie Jira, jest po stronie Jira osobą zgłaszającą. Pamiętaj, że obraz bieżącego dokumentu przestrzeni roboczej jest dodawany jako załącznik Jira, jeśli podczas tworzenia zgłoszenia Jira w przestrzeni roboczej wybrano opcję Attach original snapshot (patrz wyżej).

Umieszczenie zadania Jira w przestrzeni roboczej spowoduje utworzenie zsynchronizowanego zgłoszenia w przestrzeni Jira. Oba elementy są połączone przez mapowanie Task ID z przestrzeni roboczej na Issue Key w Jira.

Oprócz parametrów mapowanych między zgłoszeniami w przestrzeni roboczej i Jira synchronizowane są również ustawienia Priority i Progress związane z zadaniem. Na przykład zmiana priorytetu zadania zgłoszenia w przestrzeni roboczej z Medium na High zostanie natychmiast odzwierciedlona w zgłoszeniu po stronie Jira, a zmiana stanu postępu z To Do na In Progress po stronie Jira analogicznie zmieni stan zgłoszenia Jira w przestrzeni roboczej. Aby zobaczyć zaktualizowane dane, może być konieczne ich odświeżenie (przez kliknięcie przycisku  u góry panelu Comments and Tasks).

Łączenie ze zgłoszeniem Jira

Integracja Altium 365 z Jira umożliwia również połączenie zadania w przestrzeni roboczej z istniejącym zgłoszeniem Jira w usłudze Atlassian Jira za pomocą trybu Jira Issue w oknie dialogowym komentarza. Można połączyć zadanie z dowolnym zgłoszeniem w określonym projekcie Jira, które następnie będzie synchronizowane z zadaniem Jira w przestrzeni roboczej.

❯ ❮ Javascript ID: LinkJiraIssue

Umieść komentarz w obszarze dokumentu lub na obiekcie, który chcesz powiązać z istniejącym zgłoszeniem Jira, a następnie wybierz tryb Jira Issue i opcję Link Issue w oknie dialogowym komentarza. Użyj listy rozwijanej Select or search issues, aby wybrać zgłoszenie Jira (wyświetlane jako tekst Summary), które zostanie połączone z nowo umieszczonym zadaniem Jira. Zacznij wpisywać tekst w polu tekstowym, aby wyszukać odpowiednie zgłoszenie Jira. Lista rozwijana Jira Issue w oknie dialogowym wyświetli wybrane zgłoszenie z przestrzeni Jira. W razie potrzeby zaznacz opcję Attach original snapshot, aby przesłać obraz bieżącego widoku dokumentu do Jira. Kliknij przycisk Post, aby ustanowić połączenie między zadaniem Jira w przestrzeni roboczej a wybranym zgłoszeniem Jira. Nowe zadanie zgłoszenia Jira jest wyświetlane w panelu Comments and Tasks oraz w oknie dialogowym komentarza, które zawiera wszystkie istniejące (lub dodane) komentarze — wybierz opcję Show all Replies w oknie dialogowym, aby zobaczyć pełną listę.

Połączone zgłoszenie Jira jest teraz synchronizowane z zadaniem Jira w przestrzeni roboczej, które zawiera Comments zgłoszenia i ma ustawione stany Progress oraz Priority określone w zgłoszeniu Jira — w tym przykładzie In Progress i High. Zwróć uwagę, że wpisy Web links zgłoszenia Jira będą teraz wskazywać, że zadanie Jira z przestrzeni roboczej Altium 365 zostało połączone (lub ponownie połączone) z tym zgłoszeniem.

Istniejące zgłoszenie Jira łączy się z zadaniem w przestrzeni roboczej przez wskazanie jego wpisu Jira Issue w trybie Link Issue okna dialogowego komentarza w przestrzeni roboczej.

Panel zadań do wykonania

Chociaż połączona przestrzeń robocza udostępnia opisany powyżej kompleksowy zestaw funkcji komentowania i przypisywania zadań, możesz również korzystać z panelu To-Do, aby śledzić swoje zadania. Panel To-Do zawiera wszystkie pozycje do wykonania zdefiniowane obecnie dla aktywnego projektu. Pozycja do wykonania służy jako przypomnienie o zadaniu, które należy wykonać później w związku z danym dokumentem.

Panel To-Do

Zawartość i obsługa panelu zadań do wykonania

Panel To-Do może wyświetlać dwa rodzaje pozycji do wykonania dla aktywnego projektu:

• Pozycja do wykonania na poziomie projektu.
• Pozycja do wykonania na poziomie dokumentu — dodana do dokumentu tekstowego w projekcie.

Dla każdej pozycji do wykonania wyświetlane są następujące informacje:

• Done — to pole wyboru umożliwia oznaczenie pozycji po ukończeniu zdefiniowanego w niej zadania.
• Action Item — właściwe zadanie do wykonania.
• Priority — ważność zadania do wykonania (Lowest, Low, Normal (domyślnie), High, Highest).
• Document — odwołanie do dokumentu źródłowego, do którego dodano pozycję do wykonania na poziomie dokumentu.
• Owner — może to być imię i nazwisko osoby wprowadzającej zadanie lub osoby, która ma je wykonać.
• Category - może to być konkretny obszar projektu, którego dotyczy zadanie do wykonania (np. schematy, reguły projektowe, trasowanie, ograniczenia itp.).

Dodawanie zadań na poziomie projektu

Zadania na poziomie projektu dodaje się bezpośrednio w panelu. Przed dodaniem zadań upewnij się, że aktywny dokument w oknie edytora projektu jest jednym z dokumentów projektu, dla którego chcesz zdefiniować zadania.

Aby dodać nowe zadanie, kliknij prawym przyciskiem myszy w panelu i wybierz pozycję Add Project To-Do Item z wyświetlonego menu kontekstowego. Otworzy się okno dialogowe Edit To-Do Item.

W tym oknie dialogowym wprowadź odpowiedni opis zadania, które należy wykonać w projekcie. Użyj dostępnych pól, aby zdefiniować task's Priority, Owner, and Category. Po skonfigurowaniu zadania zgodnie z potrzebami kliknij OK, aby dodać nowe zadanie do panelu.

Dodawanie zadań na poziomie dokumentu

Zadania na poziomie dokumentu dodaje się do tekstowego dokumentu źródłowego (np. pliku VHDL, pliku ograniczeń, dokumentu z kodem źródłowym oprogramowania wbudowanego itp.). Przed dodaniem zadań upewnij się, że wymagany dokument jest aktywny w oknie edytora projektu i należy do projektu, dla którego aktualnie definiujesz zadania.

Aby dodać nowe zadanie, umieść kursor tekstowy w miejscu dokumentu, w którym chcesz wstawić zadanie, kliknij prawym przyciskiem myszy i wybierz pozycję Add To-Do Item z wyświetlonego menu podręcznego. Pojawi się okno dialogowe Edit To-Do Item. W tym oknie wprowadź odpowiedni opis zadania, które należy wykonać w dokumencie. Użyj dostępnych pól, aby określić Priority, Owner i Category dla zadania (np. sprawdzenie formatowania, przegląd kodu itp.). Po skonfigurowaniu zadania zgodnie z potrzebami kliknij OK, aby zamknąć okno dialogowe i wrócić do bieżącego dokumentu. Wpis zadania pojawi się w panelu To-Do oraz w miejscu wskazanym przez bieżącą pozycję kursora tekstowego. Wpis będzie miał postać komentarza (ujętego w znaczniki komentarza zdefiniowane dla danego typu dokumentu) zawierającego treść zadania i unikatowy identyfikator, jak pokazano na poniższej ilustracji.

Menu kontekstowe

Menu wywoływane prawym przyciskiem myszy udostępnia następujące polecenia:

• Goto Source - to polecenie jest dostępne, gdy element zaznaczony w panelu jest zadaniem na poziomie dokumentu. Użyj tego polecenia, aby otworzyć powiązany dokument źródłowy wskazany w polu Document danego zadania (jeśli nie jest jeszcze otwarty) i ustawić go jako aktywny dokument w oknie edytora projektu. Kursor tekstowy zostanie umieszczony na początku treści zadania.
• Add Project To-Do Item - dodaje do panelu zadanie na poziomie projektu dla aktywnego projektu.
• Edit - umożliwia edycję zaznaczonego zadania. Pojawi się okno dialogowe Edit To-Do Item, w którym można wprowadzić wymagane zmiany.
• Delete - usuwa zaznaczone zadanie z panelu.
• Show Completed Items - po włączeniu tej opcji w panelu będą wyświetlane tylko zadania oznaczone jako ukończone (włączona opcja Done ).
• Report - generuje raport zawierający wszystkie zadania aktualnie wyświetlane w panelu. Po uruchomieniu polecenia otworzy się okno dialogowe Report Preview, w którym można skonfigurować, wydrukować i wyeksportować raport w różnych formatach plików.

Uwagi

• Jeśli w panelu zdefiniowano zadanie na poziomie dokumentu, a powiązany dokument źródłowy jest aktywny w oknie edytora projektu, cały wpis tego zadania w panelu będzie wyświetlany pogrubioną czcionką.
• Dwukrotne kliknięcie wpisu zadania w panelu otworzy okno dialogowe Edit To-Do Item, umożliwiające zmianę definicji zadania.
• Wpisy w panelu można sortować według dowolnej kolumny, klikając jej nagłówek. Kliknij raz, aby posortować rosnąco, i ponownie, aby posortować malejąco.
• Filtrowanie bezpośrednie umożliwia szybkie przejście do wpisu zadania przez wpisywanie znaków bezpośrednio w panelu. Filtrować można według dowolnej kolumny danych w panelu. Użyj klawiszy Right Arrow i Left Arrow, aby przełączać się między kolumnami używanymi do filtrowania, lub kliknij bezpośrednio pole w danej kolumnie. Aby skorzystać z tej funkcji, kliknij w kolumnie danych i wpisz pierwszą literę wpisu, do którego chcesz przejść. Zaznaczony zostanie pierwszy wpis w tej kolumnie rozpoczynający się od wpisanej litery, a sama litera zostanie wyróżniona, wskazując, że zawartość kolumny jest filtrowana na jej podstawie.