Komentowanie dokumentów

Po integracji z połączonym Workspace projekty Altium Designer umożliwiają rozproszonemu zespołowi projektowemu współpracę nad projektami przechowywanymi i zarządzanymi centralnie. Interfejs projektowy obsługuje komentowanie różnych dokumentów projektowych w celu usprawnienia procesu współpracy projektowej. 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 udostępnia umieszczone komentarze współpracującym użytkownikom (tym, którzy mają współdzielony dostęp do dokumentu) w czasie rzeczywistym; są one zapisywane na serwerze niezależnie od projektu, bez wprowadzania jakichkolwiek zmian w dokumentach składowych projektu. Funkcja komentowania jest obsługiwana 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 Workspace oraz przypisywanie tych komentarzy członkom Workspace, tworząc w ten sposób zadania. Panel pozwala wszystkim użytkownikom pracującym nad dokumentem dodawać komentarze i przeglądać wszystkie komentarze bez faktycznego modyfikowania samego dokumentu. Ta funkcja usprawnia efektywne procesy współpracy i jest nieoceniona, gdy trzeba wskazać problemy w dokumencie bez fizycznego scalania zmian i powodowania konfliktów. Panel Comments and Tasks może być zasadniczo używany do tworzenia listy „do zrobienia”, 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 dokumentów składowych.

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

Szczegółowe informacje o systemie komentowania w interfejsie przeglądarkowym Workspace znajdują się w Commenting in the Web Viewer (Altium 365 Workspace, Enterprise Server Workspace).

Obsługiwane miejsca komentowania

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 układu 2D) – .

Draftsman

Komentarz można przypisać do określonego punktu lub obszaru w dokumencie Draftsman projektu PCB, Multi-board lub Harness Design – .

Multi-board Schematic

Komentarz można przypisać do obiektu lub określonego punktu w dokumencie Multi-board Schematic – .

Multi-board Assembly

Komentarz można przypisać do określonego punktu w dokumencie Multi-board Assembly – .

Harness Wiring Diagram and Layout Drawing

Komentarz można przypisać do obiektu, określonego punktu lub obszaru w dokumencie Wiring Diagram lub Layout Drawing projektu harness design.

ActiveBOM

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

Dostęp do panelu Comments and Tasks

Do panelu można uzyskać dostęp z projektu 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 obecnie istnieje połączenie z Workspace. Szara ikona () oznacza, że obecnie 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 ze swoim Workspace i masz otwarty projekt oraz jeden z typów dokumentów obsługujących komentarze (w tym schemat, 2D PCB, Draftsman i ActiveBOM). Użyj polecenia File » Open Project, aby wybrać projekt Workspace spośród tych, które zostały Ci udostępnione. Panel Comments and Tasks będzie zawierał wskazówki dotyczące tych wymagań wstępnych.

Opcje panelu Comments and Tasks

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

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

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

• Tasks only - włącz tę opcję, aby wyświetlać tylko komentarze przypisane użytkownikowi.
• ASSIGNED TO - domyślnie wszystkie opcje są wyłączone. W rezultacie wszystkie zadania/komentarze są wyświetlane i sortowane według nazwy (pierwszym wpisem na liście jest bieżący użytkownik). Po zaznaczeniu pól wyboru dla użytkownika lub użytkowników będą wyświetlane wpisy tych zaznaczonych osób. 

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

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

• Current document only – wyświetlaj tylko komentarze umieszczone w aktualnie aktywnym dokumencie.

• Notification settings – kliknij, aby otworzyć okno dialogowe Notification Settings i skonfigurować odbieranie alertów e-mail dla całej aktywności komentarzy w tym projekcie (All), tylko dla tych komentarzy, w których zostałeś wspomniany lub do których zostałeś przypisany (My), albo całkowicie wyłączyć alerty e-mail (None). ► Przykład treści wiadomości e-mail.

• Export Comments – kliknij, aby otworzyć okno dialogowe Comment Export Configuration w celu skonfigurowania eksportu komentarzy do pliku PDF.

  

  Wyjściowy plik PDF będzie zawierał informacje o komentarzach w projekcie: identyfikator komentarza, autora, datę i godzinę utworzenia, treść komentarza, przypisaną osobę (dla zadań) oraz status (dla komentarza, jeśli jest Resolved; dla zadania jego status To Do / In Progress / Resolved). Możesz wybrać eksport wszystkich komentarzy powiązanych z projektem, niezależnie od tego, kiedy zostały utworzone, albo tylko komentarzy utworzonych między określonymi wydaniami projektu. Dostępnych jest także kilka opcji definiujących, które zrzuty ekranu mają zostać uwzględnione w wygenerowanym dokumencie PDF. Łącznie dostarczają one informacji o tym, gdzie znajduje się komentarz i do czego się odnosi (punkt, komponent, obszar). Jeśli pozostawisz obie opcje odznaczone, otrzymasz tylko same komentarze. Po skonfigurowaniu kliknij Export , aby wygenerować PDF, a następnie w kolejnym oknie dialogowym określ miejsce zapisu i nazwę pliku (domyślnie nazwę projektu).

  • Entire designs snapshots - dołącz migawkę każdego dokumentu źródłowego z komentarzem w określonym czasie Period. Zapewnia to wizualne potwierdzenie miejsca, w którym komentarz znajduje się w dokumencie, za pomocą numerowanego znacznika komentarza.
  • Original design screenshots - dołącz Original Snapshot wykonany w momencie utworzenia komentarza (i będący migawką dostępną w oknie Contextual Commenting po kliknięciu znacznika komentarza w głównym obszarze projektowym). Pokazuje to punkt, obszar lub komponent, do którego odnosi się komentarz.

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

  Zwróć uwagę, że funkcja eksportu komentarzy jest dostępna tylko dla członków Workspace, w którym znajduje się projekt. Jest niedostępna dla użytkowników, którym projekt został udostępniony spoza Workspace.

Umieszczanie

Aby umieścić komentarz w obszarze projektowym obiektowego edytora graficznego, takiego jak schemat, 2D PCB lub Draftsman, należy najpierw uruchomić odpowiednie polecenie. Można 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 obszaru projektowego.

• 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 obszarze projektowym.

W zależności od typu dokumentu (patrz wyżej) komentarze można przypisywać do obiektu, określonego punktu lub obszaru w aktywnym dokumencie. Polecenie uruchamia tryb umieszczania komentarza, a kursor zmienia się w krzyżyk 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 obszar niepodświetlony, aby dołączyć komentarz do tego konkretnego punktu w dokumencie.

• Kliknij z dala od obiektu i przeciągnij kursor, aby utworzyć prostokątny podświetlony obszar i dołączyć komentarz do określonego 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.

Akcja umieszczania otwiera następnie okno dialogowe wprowadzania komentarza, które zawiera pole do wpisania treści komentarza oraz, w przypadku dokumentów graficznych, dodatkową opcję dodania do komentarza rysunku odręcznego tam, gdzie 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 spowoduje skojarzenie komentarza z numerowaną pinezką znacznika w dokumencie, a także dodanie wpisu podsumowującego komentarz do panelu Comments and Tasks.

Umieszczenie komentarza na obiekcie, wspomnienie innego zarejestrowanego użytkownika w komentarzu, przeniesienie 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 nazwę/adres e-mail z listy rozwijanej, aby dodać odwołanie do użytkownika (członka Workspace) do komentarza, a także jako wpis Assign a task to – zasadniczo 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 także 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 tego projektu. Ta opcja jest dostępna, jeśli jesteś właścicielem projektu lub administratorem Workspace. Prawa dostępu użytkownika są przyznawane za pomocą okna dialogowego Share dialog; użytkownik otrzyma wiadomość e-mail z powiadomieniem o udostępnionym dostępie. Jeśli anulujesz okno dialogowe Share, projekt nie zostanie udostępniony, ale komentarz zostanie umieszczony jak zwykle.

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

Gdy zadanie jest przypisane do użytkownika, obraz/zdjęcie tego użytkownika będzie widoczne 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 fokusem ustawionym na wybranym zadaniu na liście zadań.

Pozycjonowanie

Położenie komentarza w obszarze edytora zmienia się przez przeciągnięcie powiązanej „pinezki” do nowej pozycji – podczas umieszczania lub po jego zakończeniu. Po wybraniu 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 przez kliknięcie i przeciągnięcie w trybie umieszczania ().

Wklejanie obrazów

Możesz dodać obraz do komentarza, najpierw kopiując obraz z okna Explorer  lub strony przeglądarki przez kliknięcie obrazu prawym przyciskiem myszy, co kopiuje obraz do schowka. Aby dołączyć obraz, użyj kliknięcia prawym przyciskiem myszy Paste (lub skrótu Ctrl+V ) w samym komentarzu (w polu zawierającym tekst 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 pełnym rozmiarze, jak pokazano na ilustracji po prawej stronie.

Możesz także opublikować komentarz zawierający wyłącznie wklejony obraz bez żadnego tekstu, jak pokazano poniżej.

Rysowanie

Podczas umieszczania lub edytowania komentarza wybierz przycisk opcji , aby dodać odręczny rysunek za pomocą kursora pióra. 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 (co jest wskazywane przez ikonę w obszarze projektu). Opcje te umożliwiają cofanie i ponawianie komentarzy w menu rozwijanym Commands oraz zmianę szerokości, rozmiaru i koloru w menu rozwijanym Properties .

Zadania ogólne

Zadania ogólne (zadania przypisane do bieżącego projektu, ale niepowiązane z komentarzem projektu ani dokumentem) są wymienione w panelu w osobnej grupie pod wpisem projektu. Dla zadań ogólnych w panelu wyświetlane są te same treści i atrybuty (przypisanie, priorytet itp.).

Zadania ogólne są wymienione w panelu Comments and Tasks.

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

Odłączone komentarze

Po usunięciu dokumentu projektu lub zmianie jego UniqueID komentarze do tego dokumentu mogą zostać „odłączone”. Do tych komentarzy nadal można uzyskać dostęp z poziomu zwijanego obszaru Detached Comments panelu. Kliknij kafelek odłączonego komentarza w panelu Comments and Tasks, aby wyświetlić jego okno dialogowe w obszarze projektu 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 odpowiednim edytorze dokumentu (jako ponumerowane znaczniki pinezki). Każdy wpis panelu reprezentuje wątek komentarza i zawiera informacje podsumowujące, w tym kto umieścił komentarz i kiedy, początkową treść komentarza, wszelkie zastosowane wzmianki/przypisania oraz liczbę odpowiedzi w wątku.

Wątek komentarza otwiera się przez wybranie jego wpisu w panelu Comments and Tasks lub kliknięcie powiązanej z nim pinezki w obszarze projektu. Powoduje to podświetlenie komentarza w edytorze dokumentu i otwarcie okna dialogowego wpisu komentarza, które zawiera komentarz inicjujący oraz wszelkie odpowiedzi użytkowników. Jeśli wybrany komentarz jest skojarzony z innym dokumentem projektowym, system otworzy (i w razie potrzeby załaduje) ten dokument.

Nawigowanie po komentarzach przez wybieranie znaczników pinezek w obszarze projektu 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 komentarza i zawiera opcje podglądu, odpowiedzi, edycji, rozwiązania i usunięcia wpisu. Okno dialogowe otwiera się podczas początkowego umieszczania komentarza lub po wybraniu umieszczonego komentarza w panelu Comments and Tasks albo w obszarze projektu. Naciśnij Esc lub kliknij w obszarze projektu, aby zamknąć okno dialogowe komentarza.

Podgląd

Wybierz opcję Original Snapshot w komentarzu początkowym, aby zobaczyć graficzny 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 komentarza. Wybierz opcję Assign a task to, aby utworzyć zadanie przypisane użytkownikowi określonemu na liście rozwijanej. Kliknij , aby potwierdzić wpis.

Edycja i usuwanie

Istniejący komentarz może zostać edytowany przez autora tego komentarza przy użyciu opcji Edit dostępnej w menu komentarza. Kliknij przycisk , aby potwierdzić edycję komentarza.

Użyj opcji Delete, aby usunąć aktualnie wybrany komentarz. Pamiętaj, że cały wątek zostanie usunięty, jeśli usunięty zostanie komentarz początkowy (zamiast odpowiedzi).

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

Użyj opcji Copy Link, aby skopiować adres URL do wątku komentarza. 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ąż

Kliknij przycisk / , aby przełączać 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 użytkownikowi, można ustawić jego priorytet i status. Zadanie jest początkowo automatycznie ustawiane na priorytet Medium i status To Do, ale można je zmienić, klikając powiązaną kontrolkę u góry okna dialogowego komentarza.

Tag zatwierdzenia, identyfikator rewizji wydania i informacje o 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 Web Viewer podczas przeglądania migawki projektu oznaczonego tagiem zatwierdzenia będą zawierać nazwę powiązanego tagu. Kliknij łącze nazwy tagu, aby otworzyć powiązaną migawkę zatwierdzenia w Web Viewer.

• Komentarze utworzone w Web Viewer podczas przeglądania konkretnego wydania będą zawierać 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ć wpis przeglądu projektu. Kliknij łącze przeglądu projektu, aby otworzyć stronę tego przeglądu.

Praca z zadaniami Jira

Jeśli Jira Integration jest włączona i skonfigurowana dla Twojego Altium 365 Workspace, umieszczony komentarz będzie zawierał dodatkową opcję umieszczenia i powiązania ze zgłoszeniem Jira w usłudze Atlassian Jira®. Podobnie jak konwencjonalne 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 odpowiednim zgłoszeniem w przestrzeni Jira. Dwukierunkowa synchronizacja danych między zgłoszeniami Jira a zadaniami Workspace umożliwia prowadzenie zarządzania projektem projektowym przez przestrzeń Jira w połączeniu z Altium 365.

Utwórz zgłoszenie Jira

Aby umieścić zadanie Jira Issue dla projektu, najpierw umieść 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.

❯ ❮ Javascript ID: CreateJiraIssue

Aby umieścić zadanie Jira w bieżącym dokumencie projektu, najpierw umieść komentarz. Alternatywny tryb Jira jest dostępny z menu rozwijanego Comment. Uruchom 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 obejmuje typy dostępne w Twojej usłudze Jira. Wprowadź Summary zgłoszenia oraz opcjonalny opis/przypisaną osobę. Lista rozwijana Assignee będzie zawierać tylko tych 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 dokumentu, jest uwzględniane w panelu Comments and Tasks, zapewnia łącze do zgłoszenia w przestrzeni Jira i obejmuje interaktywny dostęp do ustawień priorytetu zadania (Medium, High itd.) oraz statusu (To Do, In Progress itd.).

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

Umieszczone zadanie Workspace Jira utworzy zsynchronizowane zgłoszenie Jira w przestrzeni Jira. Oba są połączone przez mapowanie Task ID Workspace z Issue Key Jira.

Wraz z parametrami mapowanymi między zgłoszeniami Workspace i Jira synchronizowane są także ustawienia priorytetu Priority i statusu Progress związane z zadaniem. Na przykład przeniesienie zadania zgłoszenia Workspace z priorytetu Medium do High zostanie natychmiast odzwierciedlone w zgłoszeniu po stronie Jira, a zmiana stanu postępu z To Do na In Progress po stronie Jira spowoduje analogiczną zmianę stanu zgłoszenia Workspace Jira. Aby zobaczyć zaktualizowane dane, może być wymagane odświeżenie danych (uruchamiane przez kliknięcie przycisku u góry panelu Comments and Tasks).

Połączenie ze zgłoszeniem Jira

Jira Integration w Altium 365 umożliwia również powiązanie zadania Workspace z istniejącym zgłoszeniem Jira w usłudze Atlassian Jira za pomocą trybu Jira Issue w oknie dialogowym komentarza. Możesz połączyć dowolne zgłoszenie w określonym projekcie Jira, które zostanie następnie zsynchronizowane z zadaniem Workspace Jira.

❯ ❮ Javascript ID: LinkJiraIssue

Umieść komentarz na obszarze dokumentu lub obiekcie, który chcesz skojarzyć 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 (pokazane jako tekst Summary), które zostanie połączone z nowo umieszczoną instancją zadania Jira. Zacznij pisać 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 przenieść obraz bieżącego widoku dokumentu do Jira. Kliknij przycisk Post, aby ustanowić połączenie między zadaniem Workspace Jira a wybranym zgłoszeniem Jira. Nowe zadanie zgłoszenia Jira jest wyświetlane w panelu Comments and Tasks i 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ę.

Połączone zgłoszenie Jira jest teraz synchronizowane z zadaniem Workspace Jira, które zawiera 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 połączone (lub połączone ponownie) z tym zgłoszeniem.

Istniejące zgłoszenie Jira jest łączone z zadaniem Workspace przez określenie 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 zawiera listę wszystkich elementów To-Do, które są obecnie 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 umożliwia zaznaczenie elementu po ukończeniu zdefiniowanego zadania.
• Action Item — rzeczywiste zadanie, które należy wykonać.
• Priority — ważność zadania do wykonania (Lowest, Low, Normal (domyślnie), High, Highest).
• Document — odniesienie 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 projektu, którego dotyczy zadanie do wykonania (np. schematy, reguły projektowe, prowadzenie ścieżek, ograniczenia itp.).

Dodawanie elementów To-Do na poziomie projektu

Elementy To-Do na poziomie projektu dodaje się z poziomu samego 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. Otworzy się okno dialogowe Edit To-Do Item.

Użyj tego okna dialogowego, aby wprowadzić odpowiedni tekst zadania, które ma zostać wykonane dla projektu. Użyj 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 są dodawane do tekstowego dokumentu źródłowego (np. pliku VHDL, pliku Constraint, dokumentu z kodem źródłowym systemu wbudowanego 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 obecnie definiujesz ogólne elementy To-Do.

Aby dodać nowy element To-Do, umieść 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 ma zostać wykonane w dokumencie. Użyj dostępnych pól w oknie dialogowym, aby zdefiniować Priority, Owner oraz Category dla zadania (np. przebieg formatowania, przebieg przeglądu kodu itp.). Po zdefiniowaniu elementu To-Do zgodnie z wymaganiami kliknij OK, aby zamknąć okno dialogowe i przywrócić fokus do bieżącego dokumentu. Wpis elementu To-Do pojawi się w panelu To-Do, a także w miejscu wskazanym przez bieżącą pozycję kursora tekstowego. Wpis pojawi się jako komentarz (pomiędzy separatorami komentarza zdefiniowanymi dla tego typu dokumentu), zawierający rzeczywistą treść elementu i unikalny identyfikator, jak pokazano na ilustracji poniżej.

Menu prawego przycisku myszy

Menu prawego przycisku myszy udostępnia następujące polecenia:

• Goto Source — to polecenie staje się dostępne, gdy wybrany element w panelu jest elementem To-Do na poziomie dokumentu. Użyj tego polecenia, aby otworzyć (jeśli nie jest jeszcze otwarty) skojarzony dokument źródłowy, do którego odwołuje się pole Document elementu, i uczynić go aktywnym dokumentem w oknie edytora projektu. Kursor tekstowy zostanie umieszczony 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 będą wyświetlane tylko elementy To-Do oznaczone jako ukończone (włączona opcja Done ).
• 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 do różnych formatów 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 zmianę 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.
• Filtrowanie bezpośrednie umożliwia szybkie przejście do wpisu elementu To-Do przez bezpośrednie wpisywanie tekstu w panelu. Możesz filtrować na podstawie dowolnej kolumny danych w panelu. Użyj klawiszy Right Arrow i Left Arrow, aby przełączać się między kolumnami podczas filtrowania, lub kliknij bezpośrednio pole w obrębie kolumny. Aby skorzystać z tej funkcji filtrowania, kliknij w kolumnie danych i wpisz pierwszą literę wpisu, do którego chcesz przejść. Zostanie zaznaczony pierwszy wpis w tej kolumnie zaczynający się od wpisanej litery, a litera zostanie podświetlona, aby pokazać, że filtrowanie zawartości kolumny opiera się na wpisanej literze.