Document Commenting

Po zintegrowaniu z połączonym Workspace projekty Altium Designer umożliwiają rozproszonemu zespołowi projektowemu wspólną pracę nad projektami przechowywanymi centralnie oraz zarządzanymi w jednym miejscu. Interfejs projektowy obsługuje komentowanie różnych dokumentów projektowych, aby usprawnić proces współpracy. Komentarze, tj. notatki dodawane przez użytkowników, mogą być umieszczane 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 (tych, którzy mają współdzielony dostęp do dokumentu) i są zapisywane na serwerze niezależnie od projektu, bez jakiejkolwiek zmiany jego składowych dokumentów. Funkcja komentowania jest zarządzana za pomocą panelu Comments and Tasks. Po wybraniu wpisu komentarza w panelu Comments and Tasks system otworzy (i w razie potrzeby załaduje) powiązany dokument projektowy.

Panel Comments and Tasks umożliwia dodawanie komentarzy do zdefiniowanego obszaru lub punktu w aktywnym dokumencie projektu w Workspace oraz przypisywanie tych komentarzy członkom Workspace, tworząc w praktyce zadania dla nich. Panel pozwala wszystkim użytkownikom pracującym nad dokumentem dodawać komentarze i przeglądać wszystkie komentarze bez faktycznej modyfikacji samego dokumentu. Funkcja ta ułatwia prowadzenie sprawnych procesów współpracy i jest nieoceniona, gdy trzeba wskazać problemy w dokumencie bez fizycznego scalania zmian i ryzyka konfliktów. Panel Comments and Tasks można w istocie wykorzystać do tworzenia listy „to-do”, a w miarę dojrzewania projektu komentarze mogą być rozwiązywane i zamykane. Umieszczone komentarze są dostępne w czasie rzeczywistym dla współpracujących użytkowników – tych, którzy mają współdzielony dostęp do dokumentu – i są zapisywane w Workspace niezależnie od projektu, bez jakiejkolwiek zmiany jego składowych dokumentów.

Pamiętaj, że komentarze i zadania można dodawać oraz zarządzać nimi zarówno w Altium Designer, jak i w powiązanym Workspace poprzez widok projektu w interfejsie przeglądarkowym. Funkcjonalność obu systemów komentowania jest zasadniczo taka sama, a ponieważ zarówno projekt, jak i dane komentarzy są przechowywane w Workspace, systemy współpracują ze sobą w czasie rzeczywistym.

Zobacz Commenting in the Web Viewer (Altium 365 Workspace, Enterprise Server Workspace) aby uzyskać szczegółowe informacje o systemie komentowania w interfejsie przeglądarkowym Workspace.

Gdzie obsługiwane jest komentowanie

Schemat

Komentarz można zastosować do obiektu, konkretnego punktu lub obszaru w dokumencie schematu.

PCB

Komentarz można zastosować do obiektu, konkretnego punktu lub obszaru w dokumencie PCB (w trybie układu 2D) – .

Draftsman

Komentarz można zastosować do konkretnego punktu lub obszaru w dokumencie Draftsman projektu PCB, Multi-board lub Harness Design – .

Multi-board Schematic

Komentarz można zastosować do obiektu lub konkretnego punktu w dokumencie Multi-board Schematic – .

Multi-board Assembly

Komentarz można zastosować do konkretnego punktu w dokumencie Multi-board Assembly – .

Harness Wiring Diagram and Layout Drawing

Komentarz można zastosować do obiektu, konkretnego punktu lub obszaru w dokumencie Wiring Diagram lub Layout Drawing projektu harness design .

ActiveBOM

Komentarz można zastosować do wiersza w dokumencie ActiveBOM – .

Dostęp do panelu Comments and Tasks

Do panelu można uzyskać dostęp z projektu w Workspace na następujące sposoby:

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

  Ikona Workspace obok nazwy panelu w menu w prawym dolnym rogu obszaru projektowego wskazuje, że do wyświetlenia danych powiązanego panelu wymagane jest połączenie z Workspace. Niebieska ikona () oznacza, że aktualnie istnieje połączenie z Workspace. Szara ikona () wskazuje, że aktualnie nie ma połączenia z Workspace i przed uzyskaniem dostępu do danych panelu zostaniesz poproszony o połączenie z Workspace.

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

• Kliknij dwukrotnie pinezkę znacznika komentarza umieszczonego w obszarze projektowym.

Dodawanie komentarza bez połączenia z Workspace

Przed użyciem funkcji komentowania upewnij się, że jesteś połączony z Workspace i że otworzyłeś projekt oraz jeden z typów dokumentów obsługujących komentarze (w tym schemat, PCB 2D, Draftsman i ActiveBOM). Użyj polecenia File » Open Project, aby wybrać projekt w Workspace spośród tych, które zostały Ci udostępnione. Panel Comments and Tasks będzie podpowiadał te wymagania wstępne.

Opcje panelu Comments and Tasks

Użyj przycisków u góry panelu Comments and Tasks, aby ustawić dostępność komentarzy w panelu i w przestrzeni edytora oraz określić, czy wspomniani użytkownicy mają otrzymywać powiadomienia.

Przycisk  w panelu przełącza widoczność pinezek znaczników komentarzy w dokumencie. Wpisy komentarzy na liście panelu Comments and Tasks nadal można wybierać jak zwykle.

Użyj menu rozwijanego filtra w panelu Comments and Tasks () aby skonfigurować filtrowanie komentarzy oraz powiązanego przycisku  do przełączania między widokiem filtrowanym i niefiltrowanym.

• Tasks only – włącz tę opcję, aby wyświetlać tylko komentarze przypisane do użytkownika.
• ASSIGNED TO – domyślnie wszystkie opcje są wyłączone. W konsekwencji wszystkie zadania/komentarze są wyświetlane i sortowane według nazwy (pierwszy wpis na liście to bieżący użytkownik). Gdy pola wyboru zostaną włączone dla użytkownika(-ów), wyświetlane będą wpisy tych, dla których je włączono. 

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

• Unresolved Only – komentarze, które zostały rozwiązane, nie są uwzględniane na liście.

• Current document only – pokazuj tylko komentarze umieszczone w aktualnie aktywnym dokumencie.

• Notification settings – kliknij, aby otworzyć okno dialogowe Notification Settings i skonfigurować otrzymywanie powiadomień e-mail dla całej aktywności komentarzy w tym projekcie (All), tylko dla tych komentarzy, w których jesteś wspomniany(-a) lub przypisany(-a) (My), albo aby w ogóle nie otrzymywać powiadomień e-mail (None). ► Przykład treści e-maila.

• 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, osobę przypisaną (dla zadań) oraz status (dla komentarza, jeśli jest Resolved; dla zadania: status To Do / In Progress / Resolved). Możesz wybrać eksport wszystkich komentarzy powiązanych z projektem, niezależnie od tego, kiedy zostały dodane, albo tylko komentarzy dodanych pomiędzy określonymi wydaniami projektu. Dostępnych jest też kilka opcji określających, które zrzuty ekranu mają zostać dołączone do generowanego dokumentu PDF. Razem obie opcje dostarczają informacji o tym, gdzie znajduje się komentarz i czego dotyczy (punkt, komponent, obszar). Jeśli pozostawisz obie opcje niezaznaczone, otrzymasz wyłącznie same komentarze. Po skonfigurowaniu kliknij Export , aby wygenerować PDF, a w kolejnym oknie dialogowym określ, gdzie ma zostać zapisany i pod jaką nazwą (domyślnie nazwą projektu).

  • Entire designs snapshots - dołącz migawkę każdego dokumentu źródłowego z komentarzem w wybranym przedziale czasu Period. Zapewnia to wizualne potwierdzenie miejsca na dokumencie, w którym znajduje się komentarz, za pomocą ponumerowanego znacznika komentarza.
  • Original design screenshots - dołącz Oryginalną Migawkę wykonaną w momencie utworzenia komentarza (i będącą migawką dostępną w oknie Contextual Commenting, gdy klikniesz znacznik komentarza w głównej przestrzeni projektu). Pokazuje ona punkt, obszar lub komponent, którego dotyczy komentarz.

  Eksport komentarzy do PDF można również skonfigurować i wygenerować poprzez plik Output Job jako część procesu wydania projektu. Dodaj outputter Export Comments w kategorii Report Outputs.

  Zwróć uwagę, że funkcja eksportu komentarzy jest dostępna wyłącznie dla członków Workspace, w którym znajduje się projekt. Nie jest dostępna dla użytkowników, którym udostępniono projekt spoza Workspace.

Umieszczanie

Aby umieścić komentarz w przestrzeni projektu edytora graficznego opartego na obiektach, takiego jak schemat, 2D PCB lub Draftsman, najpierw uruchom odpowiednie polecenie. Można to zrobić, wykonując jedną z poniższych czynności:

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

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

• Kliknij Place » Comment w menu głównym.

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

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

W zależności od typu dokumentu (patrz wyżej), komentarze mogą być przypisywane do obiektu, konkretnego punktu lub obszaru w aktywnym dokumencie. Polecenie uruchamia tryb umieszczania komentarza, a kursor zmienia się w celownik z niebieskim okręgiem, który wykrywa i podświetla obiekty do wyboru:

• Kliknij podświetlony obiekt, aby dołączyć (przypiąć) komentarz do tego obiektu.

• Kliknij w niepodświetlonym miejscu, aby dołączyć komentarz do konkretnego punktu na dokumencie.

• Kliknij z dala od obiektu i przeciągnij kursor, aby utworzyć prostokątny podświetlony obszar i dołączyć komentarz do wskazanego obszaru ().

W dokumencie ActiveBOM kliknij komórkę, aby dodać komentarz do tego wiersza BOM. Kliknij prawym przyciskiem myszy wiersz, a następnie wybierz polecenie Comment, aby dodać komentarz do tego wiersza.

Następnie otwiera się okno dialogowe wprowadzania komentarza, które oferuje pole do wpisania treści komentarza oraz – dla dokumentów graficznych – dodatkową opcję dodania do komentarza rysunku odręcznego, 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, co powiąże komentarz z ponumerowanym znacznikiem „pinezki” na dokumencie oraz doda wpis podsumowania komentarza do panelu Comments and Tasks.

Umieszczenie komentarza na obiekcie, wspomnienie innego zarejestrowanego użytkownika w komentarzu, przesunięcie wskaźnika „pinezki” komentarza oraz dodanie do komentarza rysunku odręcznego.

Wzmianki i przypisywanie zadań

Oprócz tekstu w oknie dialogowym wprowadzania komentarza można dodać odwołanie typu „wzmianka” do dowolnego innego użytkownika lub roli zarejestrowanej w połączonym Workspace, wpisując znak @. Wybierz imię/nazwę lub e-mail z listy rozwijanej, aby dodać odwołanie do użytkownika (członka Workspace) w komentarzu, a także jako wpis Assign a task to – w praktyce użytkownikowi zostanie przypisane task. Odznacz tę drugą opcję, 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. „Engineers”), a tym samym jej użytkowników.

Jeśli wspomniany użytkownik nie ma dostępu do bieżącego projektu, zostaniesz poproszony(-a) o udostępnienie mu projektu. Ta opcja jest dostępna, jeśli jesteś właścicielem projektu lub administratorem Workspace. Prawa dostępu użytkownika są nadawane w oknie dialogowym Share dialog; użytkownik otrzyma e-mail z informacją o udostępnionym dostępie. Jeśli anulujesz okno Share dialog, projekt nie zostanie udostępniony, ale komentarz zostanie umieszczony jak zwykle.

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

Gdy zadanie zostanie przypisane do użytkownika, obraz/zdjęcie tego użytkownika będzie wyświetlane w lewym górnym rogu okna dialogowego komentarza oraz na kafelku komentarza w panelu Comments and Tasks. Ponadto zadanie będzie nazwane nazwą projektu i numerem sekwencyjnym (np. Kame_FMU-1) zamiast prostego numeru, jak ma to miejsce w przypadku zwykłych komentarzy. Ta nazwa jest również wyświetlana w oknie dialogowym komentarza i na kafelku komentarza. Kliknij ją, aby otworzyć stronę Tasks projektu w interfejsie przeglądarkowym Workspace, z wybranym zadaniem wyróżnionym na liście zadań.

Pozycjonowanie

Położenie komentarza w przestrzeni edytora zmienia się przez przeciągnięcie powiązanej „pinezki” w nowe miejsce – w trakcie lub po umieszczeniu komentarza. Po zaznaczeniu pinezka komentarza zawiera linię łączącą z powiązanym obiektem lub obszarem.

Zwróć uwagę, że komentarz można również pozycjonować podczas jego początkowego umieszczania, klikając i przeciągając w trybie umieszczania ().

Wklejanie obrazów

Możesz dodać obraz do komentarza, najpierw kopiując go z okna Explorer  lub strony przeglądarki, klikając prawym przyciskiem myszy na obrazie, co kopiuje obraz do schowka. Aby dołączyć obraz, użyj kliknięcia prawym przyciskiem Paste (lub skrótu Ctrl+V ) w samym komentarzu (w polu, w którym widnieje Add others with @ or paste images). 

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

Możesz także opublikować komentarz, jeśli zawiera wyłącznie wklejony obraz bez żadnego tekstu, jak pokazano poniżej.

Rysowanie

Podczas umieszczania lub edycji komentarza wybierz przycisk opcji , aby dodać rysunek odręczny, a kursor zmieni się w pióro. Kliknij i przeciągnij, aby tworzyć linie, a następnie kliknij prawym przyciskiem myszy, aby zakończyć i powiązać rysunek z aktualnie wybranym komentarzem.

Aby uzyskać dostęp do trybu Freehand Drawing panelu Properties, naciśnij klawisz Tab , gdy aktywny jest tryb rysowania odręcznego (jest to wskazywane ikoną w przestrzeni projektu). Opcje te pozwalają cofać i ponawiać komentarze w menu rozwijanym Commands oraz zmieniać szerokość, rozmiar i kolor w menu rozwijanym Properties .

Zadania ogólne

Zadania ogólne (zadania zastosowane do bieżącego projektu, ale niezwiązane z komentarzem do projektu ani dokumentem) są wyświetlane w panelu w osobnej grupie pod wpisem projektu. Dla zadań ogólnych w panelu pokazywana jest ta sama zawartość i te same atrybuty (osoba przypisana, 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 dialogowych komentarzy. Użyj okna dialogowego, aby publikować komentarze (w tym także z wklejonymi obrazami) dla wybranego Zadania ogólnego.

Odłączone komentarze

Gdy dokument projektu zostanie usunięty lub zmieni się jego UniqueID, komentarze do dokumentu mogą stać się „odłączone”. Do tych komentarzy nadal można uzyskać dostęp z Detached Comments zwijanego obszaru panelu. Kliknij kafelek odłączonego komentarza w panelu Comments and Tasks, aby wyświetlić jego okno dialogowe w przestrzeni projektowej aktualnie otwartego dokumentu.

Praca z komentarzami

Komentarze umieszczone w dokumencie projektowym są rejestrowane zarówno w panelu Comments and Tasks (jako sekwencja ponumerowanych wpisów), jak i w odpowiadającym mu edytorze dokumentu (jako ponumerowane znaczniki w formie pinezek). Każdy wpis w panelu reprezentuje wątek komentarzy i udostępnia informacje podsumowujące, w tym kto i kiedy umieścił komentarz, treść komentarza początkowego, zastosowane wzmianki/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ązanej pinezki w przestrzeni projektowej. Powoduje to podświetlenie komentarza w edytorze dokumentu i otwarcie okna dialogowego wpisu komentarza, które zawiera komentarz inicjujący oraz wszystkie odpowiedzi użytkowników. Jeśli wybrany komentarz jest powiązany z innym dokumentem projektowym, system otworzy (i w razie potrzeby załaduje) ten dokument.

Nawigowanie po komentarzach poprzez wybieranie znaczników pinezek w przestrzeni projektowej oraz wybieranie wpisów w panelu Comments and Tasks.

Okno dialogowe komentarzy

Interakcja z umieszczonym komentarzem odbywa się za pomocą wyskakującego okna dialogowego komentarza, które pokazuje wszystkie wpisy w wybranym wątku komentarzy i zawiera opcje podglądu, odpowiedzi, edycji, rozwiązania oraz usunięcia wpisu. Okno dialogowe jest otwierane podczas początkowego umieszczania komentarza lub gdy umieszczony komentarz zostanie wybrany w panelu Comments and Tasks albo w przestrzeni projektowej. Naciśnij Esc lub kliknij w przestrzeni projektowej, aby zamknąć okno dialogowe komentarza.

Podgląd

Wybierz opcję Original Snapshot w komentarzu początkowym, aby zobaczyć graficzny zrzut obszaru edytora w momencie 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ź

Wpisz tekst oraz 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 potwierdzić wpis.

Edycja i usuwanie

Istniejący komentarz może zostać edytowany przez autora tego komentarza za pomocą opcji Edit dostępnej z menu komentarza. Kliknij przycisk , aby potwierdzić edycję komentarza.

Użyj opcji Delete, aby usunąć aktualnie wybrany komentarz. Zwróć uwagę, że cały wątek zostanie usunięty, jeśli usunięty zostanie komentarz początkowy (a nie odpowiedź).

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

Użyj opcji Copy Link, aby skopiować adres URL do wątku komentarzy. Tego łącza można użyć do otwarcia tego projektu w Web Viewer interfejsu przeglądarkowego Workspace, z obiektem, punktem lub obszarem komentarza powiększonym i wyśrodkowanym.

Rozwiązanie

Kliknij przycisk / , aby przełączyć stan komentarza między Resolved a Unresolved (domyślnie). Rozwiązany komentarz (zamknięty jako ukończony) jest nieaktywny i nieedytowalny, a zarówno jego wpis w panelu Comments and Tasks, jak i znacznik pinezki w dokumencie są wyszarzone.

Ustawianie priorytetów i statusów zadań

Jeśli komentarz zadania został przypisany do użytkownika, można ustawić jego priorytet i status. Zadanie jest początkowo od razu ustawiane na priorytet Medium oraz status To Do, ale można je zmienić, klikając powiązaną kontrolkę u góry okna dialogowego komentarza.

Tag commitu, identyfikator rewizji wydania i informacje o Design Review 

Tagi commitów oraz 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 Web Viewer podczas przeglądania migawki projektu dla otagowanego commitu będą zawierały powiązaną nazwę tagu. Kliknij łącze nazwy tagu, aby otworzyć powiązaną migawkę commitu w Web Viewer.

• Komentarze utworzone w Web Viewer podczas przeglądania konkretnego wydania będą zawierały identyfikator rewizji wydania. Kliknij łącze identyfikatora rewizji wydania, aby otworzyć Manufacturing Portal dla tego wydania.

• Komentarze utworzone w Web Viewer podczas przeglądania migawki Design Review będą zawierały wpis przeglądu projektu. Kliknij łącze Design Review, aby otworzyć stronę przeglądu.

Praca z zadaniami Jira

Jeśli integracja z Jira jest włączona i skonfigurowana dla Twojego Altium 365 Workspace, wówczas umieszczony komentarz będzie zawierał dodatkową opcję utworzenia i powiązania zgłoszenia Jira w usłudze Atlassian Jira® . 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 projektowych oraz przeglądać/wybierać za pomocą 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 Workspace umożliwia prowadzenie zarządzania projektem projektowym w przestrzeni Jira w połączeniu z Altium 365.

Tworzenie zgłoszenia Jira

Aby umieścić zadanie w postaci zgłoszenia Jira dla projektu, najpierw umieść instancję komentarza w standardowy 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.

❯ ❮ Javascript ID: CreateJiraIssue

Umieść zadanie Jira w bieżącym dokumencie projektu, najpierw umieszczając instancję komentarza. Alternatywny tryb Jira jest dostępny z menu rozwijanego Comment. Wywołaj umieszczanie zadania Jira, wybierając opcję Jira Issue z menu Comment okna dialogowego. Kliknij opcję Create Issue, jeśli nie jest jeszcze wybrana. Wybierz typ zgłoszenia do utworzenia z listy rozwijanej Issue Type, która zawiera typy dostępne w Twojej usłudze Jira. Wprowadź Summary zgłoszenia oraz opcjonalny opis/osobę przypisaną. Lista rozwijana Assignee będzie zawierała wyłącznie użytkowników, którzy są zarejestrowanymi członkami Twojego konta Jira. Wybierz Post, aby potwierdzić. Zgłoszenie Jira jest umieszczane w pozycji początkowego komentarza w dokumencie, jest uwzględnione w panelu Comments and Tasks, udostępnia łącze do zgłoszenia w przestrzeni Jira oraz zapewnia interaktywny dostęp do ustawień priorytetu zadania (Medium, High itd.) i statusu (To Do, In Progress itd.).

Wybierz Task ID zgłoszenia Jira w Workspace w oknie dialogowym komentarza lub w panelu Comments and Tasks, aby bezpośrednio otworzyć to zgłoszenie w przestrzeni Jira w nowej karcie domyślnej przeglądarki. Task ID Workspace odpowiada Issue Key w przestrzeni Jira, a główne parametry Jira, takie jak Summary, Description, Assignee i Comments, są mapowane między tymi dwiema instancjami. Użytkownik Workspace, który utworzył zgłoszenie Jira, jest po stronie Jira zgłaszającym (Issue Reporter). Zwróć uwagę, że obraz migawki bieżącego dokumentu Workspace jest dołączany jako załącznik Jira, jeśli podczas tworzenia zgłoszenia Jira w Workspace wybrano opcję Attach original snapshot (patrz wyżej).

Umieszczone zadanie Jira w Workspace utworzy zsynchronizowane zgłoszenie Jira w przestrzeni Jira. Oba elementy są powiązane poprzez mapowanie Workspace Task ID z Jira Issue Key.

Wraz z parametrami mapowanymi pomiędzy zgłoszeniami Workspace i Jira synchronizowane są również ustawienia statusów związanych z zadaniem: Priority oraz Progress. Na przykład przeniesienie zadania zgłoszenia Workspace z priorytetu Medium na High zostanie natychmiast odzwierciedlone po stronie Jira, a zmiana stanu postępu z To Do na In Progress po stronie Jira analogicznie zmieni stan zgłoszenia Jira w Workspace. Aby zobaczyć zaktualizowane dane, może być wymagane odświeżenie danych (uruchamiane kliknięciem przycisku  u góry panelu Comments and Tasks).

Łącze do zgłoszenia Jira

Integracja Altium 365 Jira Integration umożliwia także powiązanie zadania Workspace z istniejącym zgłoszeniem Jira w usłudze Atlassian Jira poprzez tryb Jira Issue w oknie dialogowym komentarza. Możesz połączyć się z dowolnym zgłoszeniem w określonym projekcie Jira, które następnie będzie synchronizowane z zadaniem Jira w Workspace.

❯ ❮ Javascript ID: LinkJiraIssue

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

Powiązane zgłoszenie Jira jest teraz synchronizowane z zadaniem Jira w Workspace, co obejmuje Comments zgłoszenia, i jest ustawione na stany Progress oraz Priority zdefiniowane przez zgłoszenie 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 w Altium 365 Workspace zostało powiązane (lub ponownie powiązane) z tym zgłoszeniem.

Istniejące zgłoszenie Jira jest łączone z zadaniem Workspace poprzez wskazanie jego wpisu Jira Issue w trybie Link Issue okna dialogowego komentarza Workspace.

Panel To-Do

Chociaż połączony Workspace zapewnia kompleksowy zestaw funkcji komentowania i przypisywania zadań opisanych powyżej, możesz także korzystać z panelu To-Do, aby śledzić swoje zadania. Panel To-Do wyświetla wszystkie elementy To-Do, które są aktualnie zdefiniowane dla aktywnego projektu. Element To-Do służy jako przypomnienie o zadaniu, które należy wykonać później w odniesieniu do dokumentu.

Panel To-Do

To-Do Panel Content and Use

Panel To-Do może wyświetlać dwa rodzaje elementów „to-do” dla aktywnego projektu:

• Element To-Do na poziomie projektu.
• Element To-Do na poziomie dokumentu – dodany do dokumentu tekstowego w projekcie.

Dla każdego elementu To-Do wyświetlane są następujące informacje:

• Done - to pole wyboru pozwala zaznaczyć element, gdy zdefiniowane zadanie zostało ukończone.
• Action Item - właściwe zadanie, które należy wykonać.
• 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 element To-Do na poziomie dokumentu.
• Owner - może to być nazwisko osoby wprowadzającej zadanie lub osoby, która ma je faktycznie wykonać.
• Category - może to być konkretny obszar w projekcie, którego dotyczy zadanie (np. schematy, reguły projektowe, trasowanie, ograniczenia itp.).

Dodawanie elementów To-Do na poziomie projektu

Elementy To-Do na poziomie projektu dodaje się bezpośrednio z poziomu panelu. Przed dodaniem jakichkolwiek elementów upewnij się, że aktywny dokument w oknie edytora projektu jest jednym z dokumentów projektowych projektu, dla którego chcesz zdefiniować elementy To-Do.

Aby dodać nowy element To-Do, kliknij prawym przyciskiem myszy w panelu i wybierz wpis Add Project To-Do Item z wyświetlonego menu kontekstowego. Zostanie otwarte okno dialogowe Edit To-Do Item.

Użyj tego okna dialogowego, aby wprowadzić odpowiedni tekst zadania, które musi zostać wykonane w projekcie. Skorzystaj z dostępnych pól w oknie dialogowym, aby zdefiniować task's Priority, Owner, and Category. Po zdefiniowaniu elementu zgodnie z potrzebami kliknij OK, aby dodać nowy element do panelu.

Dodawanie elementów To-Do na poziomie dokumentu

Elementy To-Do na poziomie dokumentu dodaje się do tekstowego dokumentu źródłowego (np. pliku VHDL, pliku Constraint, dokumentu Embedded Source code itp.). Przed dodaniem jakichkolwiek elementów upewnij się, że wymagany dokument jest aktywny w oknie edytora projektu i że dokument ten należy do projektu, dla którego aktualnie definiujesz ogólne elementy To-Do.

Aby dodać nowy element To-Do, ustaw kursor tekstowy w wymaganym miejscu w dokumencie, w którym chcesz umieścić element To-Do, kliknij prawym przyciskiem myszy i wybierz wpis Add To-Do Item z wyświetlonego menu podręcznego. Pojawi się okno dialogowe Edit To-Do Item. Użyj tego okna dialogowego, aby wprowadzić odpowiedni tekst dotyczący zadania, które musi zostać wykonane w dokumencie. Skorzystaj z dostępnych pól w oknie dialogowym, aby zdefiniować dla zadania Priority, Owner oraz Category (np. Formatting pass, Code Review pass itp.). Po zdefiniowaniu elementu To-Do zgodnie z potrzebami kliknij OK, aby zamknąć okno dialogowe i wrócić do bieżącego dokumentu. Wpis elementu To-Do pojawi się w panelu To-Do oraz w miejscu wskazanym przez bieżącą pozycję kursora tekstowego. Wpis pojawi się jako komentarz (pomiędzy ogranicznikami komentarza zdefiniowanymi dla danego typu dokumentu), zawierający właściwy tekst elementu oraz unikalny identyfikator, jak pokazano na poniższym obrazie.

Menu po kliknięciu prawym przyciskiem myszy

Menu kontekstowe udostępnia następujące polecenia:

• Goto Source - to polecenie jest dostępne, gdy wybrany element w panelu jest elementem To-Do na poziomie dokumentu. Użyj go, aby otworzyć (jeśli nie jest już otwarty) powiązany dokument źródłowy wskazany w polu Document danego elementu i ustawić go jako aktywny dokument w oknie edytora projektu. Kursor tekstowy zostanie ustawiony na początku tekstu elementu To-Do.
• Add Project To-Do Item - dodaj do panelu element To-Do na poziomie projektu dla aktywnego projektu.
• Edit - edytuj wybrany element To-Do. Pojawi się okno dialogowe Edit To-Do Item, umożliwiające wprowadzenie wymaganych zmian.
• Delete - usuń wybrany element To-Do z panelu.
• Show Completed Items - po włączeniu tej opcji w panelu pozostaną wyświetlane wyłącznie elementy To-Do oznaczone jako ukończone (opcja Done włączona).
• Report - wygeneruj raport zawierający wszystkie elementy To-Do 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 element To-Do na poziomie dokumentu został zdefiniowany w panelu, a odpowiadający mu dokument źródłowy jest aktywnym dokumentem w oknie edytora projektu, tekst całego wpisu To-Do w panelu zostanie pogrubiony.
• Dwukrotne kliknięcie wpisu elementu To-Do w panelu otworzy okno dialogowe Edit To-Do Item, umożliwiając modyfikację definicji zadania.
• Wpisy w panelu można sortować według dowolnej kolumny, klikając nagłówek tej kolumny. Kliknij raz, aby sortować rosnąco; kliknij ponownie, aby sortować malejąco.
• Bezpośrednie filtrowanie pozwala szybko przejść do wpisu elementu To-Do poprzez bezpośrednie wpisywanie w panelu. Możesz filtrować na podstawie dowolnej kolumny danych w panelu. Użyj klawiszy Right Arrow i Left Arrow, aby przełączać kolumny do filtrowania, lub kliknij bezpośrednio pole w kolumnie. Aby użyć tej funkcji filtrowania, kliknij w kolumnie danych i wpisz pierwszą literę wpisu, do którego chcesz przejść. Pierwszy wpis w tej kolumnie zaczynający się od wpisanej litery zostanie zaznaczony, a litera zostanie podświetlona, aby pokazać, że filtrowanie zawartości kolumny odbywa się na podstawie wpisanej litery.