Bình luận tài liệu

Khi được tích hợp với một Workspace được kết nối, các dự án Altium Designer cho phép một nhóm thiết kế phân tán làm việc cộng tác trên các dự án được lưu trữ và quản lý tập trung. Giao diện thiết kế hỗ trợ việc bình luận trên nhiều tài liệu thiết kế khác nhau để nâng cao quy trình cộng tác thiết kế. Các comment, tức là các ghi chú do người dùng thêm vào, có thể được đặt trong tài liệu và được những người dùng khác trả lời.

Panel Comments and Tasks 

Các comment đã đặt sẽ khả dụng theo thời gian thực cho những người dùng đang cộng tác (những người có quyền truy cập dùng chung vào tài liệu) và được lưu vào máy chủ độc lập với dự án mà không làm thay đổi các tài liệu cấu thành của dự án theo bất kỳ cách nào. Tính năng bình luận được quản lý thông qua panel Comments and Tasks. Khi một mục comment được chọn trong panel Comments and Tasks, hệ thống sẽ mở (và tải, nếu cần) tài liệu thiết kế liên quan.

Panel Comments and Tasks cho phép bạn thêm comment vào một vùng hoặc điểm xác định trong tài liệu đang hoạt động của một dự án Workspace và gán các comment này cho các thành viên Workspace, về cơ bản là tạo tác vụ cho họ. Panel này cho phép tất cả người dùng đang làm việc trên tài liệu thêm comment và xem tất cả comment mà không thực sự sửa đổi chính tài liệu đó. Tính năng này giúp thúc đẩy các quy trình cộng tác hiệu quả và đặc biệt hữu ích khi cần chỉ ra các vấn đề trong tài liệu mà không phải hợp nhất thủ công và phát sinh xung đột. Panel Comments and Tasks về cơ bản có thể được dùng để tạo một danh sách 'việc cần làm', và khi thiết kế hoàn thiện dần, các comment có thể được xử lý và đóng lại. Các comment đã đặt sẽ khả dụng theo thời gian thực cho những người dùng cộng tác – những người có quyền truy cập dùng chung vào tài liệu – và được lưu vào Workspace độc lập với dự án mà không làm thay đổi các tài liệu cấu thành của dự án theo bất kỳ cách nào.

Lưu ý rằng comment và tác vụ có thể được thêm và quản lý cả trong Altium Designer lẫn trong Workspace liên quan thông qua chế độ xem thiết kế trên giao diện trình duyệt của nó. Chức năng của hai hệ thống bình luận này về cơ bản là giống nhau, và do cả dữ liệu dự án lẫn dữ liệu comment đều được lưu trong Workspace, các hệ thống này hoạt động cùng nhau theo thời gian thực.

Xem Commenting in the Web Viewer (Altium 365 Workspace, Enterprise Server Workspace) để biết thông tin chi tiết về hệ thống bình luận trong giao diện trình duyệt của Workspace.

Nơi Hỗ Trợ Bình Luận

Schematic

Một comment có thể được áp dụng cho một đối tượng, một điểm cụ thể hoặc một vùng trong tài liệu schematic.

PCB

Một comment có thể được áp dụng cho một đối tượng, một điểm cụ thể hoặc một vùng trong tài liệu PCB (ở chế độ bố trí 2D) – .

Draftsman

Một comment có thể được áp dụng cho một điểm cụ thể hoặc một vùng trong tài liệu Draftsman của dự án PCB, Multi-board hoặc Harness Design – .

Multi-board Schematic

Một comment có thể được áp dụng cho một đối tượng hoặc một điểm cụ thể trong tài liệu Multi-board Schematic – .

Multi-board Assembly

Một comment có thể được áp dụng cho một điểm cụ thể trong tài liệu Multi-board Assembly – .

Harness Wiring Diagram and Layout Drawing

Một comment có thể được áp dụng cho một đối tượng, một điểm cụ thể hoặc một vùng trong tài liệu Wiring Diagram hoặc Layout Drawing của dự án thiết kế harness.

ActiveBOM

Một comment có thể được áp dụng cho một hàng trong tài liệu ActiveBOM – .

Truy Cập Panel Comments and Tasks

Panel này được truy cập từ một dự án Workspace theo các cách sau:

• Nhấp vào nút Panels ở góc dưới bên phải của không gian thiết kế, sau đó chọn Comments and Tasks.

  Biểu tượng Workspace bên cạnh tên panel trong menu ở góc dưới bên phải của không gian thiết kế cho biết rằng cần có kết nối tới Workspace để xem dữ liệu của panel liên quan. Biểu tượng màu xanh lam () biểu thị hiện đang có kết nối tới Workspace. Biểu tượng màu xám () cho biết hiện không có kết nối tới Workspace và bạn sẽ được yêu cầu kết nối tới Workspace trước khi có thể truy cập dữ liệu của panel.

• Chọn lệnh View » Panels » Comments and Tasks từ các menu chính.

• Nhấp đúp vào ghim đánh dấu của một comment đã được đặt trong không gian thiết kế.

Thêm Comment Khi Không Kết Nối Với Workspace

Trước khi sử dụng tính năng bình luận, hãy đảm bảo rằng bạn đã kết nối với Workspace của mình và đã mở một dự án cùng một trong các loại tài liệu hỗ trợ comment (bao gồm schematic, PCB 2D, Draftsman và ActiveBOM). Sử dụng lệnh File » Open Project để chọn một dự án Workspace từ những dự án đã được chia sẻ với bạn. Panel Comments and Tasks sẽ cung cấp các gợi ý cho các điều kiện tiên quyết này.

Tùy Chọn Panel Comments and Tasks

Sử dụng các nút ở phía trên panel Comments and Tasks để thiết lập khả năng hiển thị comment trong panel và không gian trình soạn thảo, đồng thời xác định xem người dùng được nhắc đến có nhận thông báo hay không.

Nút  của panel dùng để chuyển đổi khả năng hiển thị của các ghim đánh dấu comment trên tài liệu. Các mục comment trong danh sách của panel Comments and Tasks vẫn có thể được chọn như bình thường.

Sử dụng menu thả xuống bộ lọc trong panel Comments and Tasks () để cấu hình lọc comment và dùng nút  liên quan để chuyển đổi giữa chế độ xem đã lọc và chưa lọc.

• Tasks only - bật tùy chọn này để chỉ hiển thị các comment đã được gán cho người dùng.
• ASSIGNED TO - tất cả các tùy chọn đều bị tắt theo mặc định. Do đó, tất cả tác vụ/comment đều được hiển thị và sắp xếp theo tên (mục đầu tiên trong danh sách là người dùng hiện tại). Khi các ô chọn được bật cho một hay nhiều người dùng, các mục của những người dùng đó sẽ được hiển thị. 

Sử dụng các tùy chọn trong menu của nút  để cấu hình khả năng hiển thị comment và thông báo:

• Unresolved Only – các comment đã được xử lý sẽ không được đưa vào danh sách.

• Current document only – chỉ hiển thị các comment đã được đặt trên tài liệu hiện đang hoạt động.

• Notification settings – nhấp để mở hộp thoại Notification Settings và cấu hình việc nhận cảnh báo email cho mọi hoạt động comment trong thiết kế này (All), chỉ cho những comment mà bạn được nhắc đến hoặc được gán (My), hoặc không nhận cảnh báo email nào cả (None). ► Ví dụ nội dung email.

• Export Comments – nhấp để mở hộp thoại Comment Export Configuration nhằm cấu hình xuất comment ra tệp PDF.

  

  Tệp PDF đầu ra sẽ bao gồm thông tin về các comment trong thiết kế: ID comment, tác giả, ngày và giờ tạo, nội dung comment, người được giao (đối với tác vụ) và trạng thái (đối với comment, nếu là Resolved; đối với tác vụ, là trạng thái To Do / In Progress / Resolved). Bạn có thể chọn xuất tất cả comment liên quan đến thiết kế, bất kể chúng được tạo khi nào, hoặc chỉ các comment được tạo giữa các lần phát hành thiết kế cụ thể. Ngoài ra còn có một số tùy chọn để xác định ảnh chụp màn hình nào sẽ được đưa vào tài liệu PDF được tạo. Kết hợp lại, chúng cho biết comment nằm ở đâu và áp dụng cho cái gì (điểm, linh kiện, vùng). Nếu bạn bỏ chọn cả hai, bạn sẽ chỉ nhận được chính các comment. Sau khi cấu hình xong, nhấp Export để tạo PDF, sử dụng hộp thoại tiếp theo để xác định nơi lưu và tên tệp (mặc định là tên dự án).

  • Entire designs snapshots - bao gồm ảnh chụp của mỗi tài liệu nguồn có comment trong khoảng Period được chỉ định. Điều này cung cấp xác nhận trực quan về vị trí comment trên tài liệu thông qua các dấu comment được đánh số.
  • Original design screenshots - bao gồm Original Snapshot đã được chụp khi comment được tạo (và là ảnh chụp có sẵn từ cửa sổ Contextual Commenting khi nhấp vào dấu comment trong không gian thiết kế chính). Điều này hiển thị điểm, vùng hoặc linh kiện mà comment áp dụng.

  Việc xuất comment ra PDF cũng có thể được cấu hình và tạo thông qua tệp Output Job như một phần của việc phát hành dự án. Hãy thêm một outputter Export Comments thuộc danh mục Report Outputs.

  Lưu ý rằng tính năng xuất comment chỉ khả dụng cho các thành viên của Workspace nơi dự án được lưu trữ. Nó không khả dụng cho những người dùng mà dự án đã được chia sẻ với họ từ bên ngoài Workspace.

Đặt Comment

Để đặt một comment trong không gian thiết kế của một trình soạn thảo đồ họa dựa trên đối tượng, chẳng hạn schematic, PCB 2D hoặc Draftsman, trước tiên hãy chạy lệnh tương ứng. Có thể thực hiện điều này bằng một trong các cách sau:

• Nhấp vào nút  có sẵn trong panel Comments and Tasks.

• Nhấp  gần góc trên bên phải của không gian thiết kế.

• Nhấp Place » Comment từ các menu chính.

• Sử dụng phím tắt Ctrl+Alt+C.

• Nhấp chuột phải, sau đó chọn Comment từ không gian thiết kế.

Tùy thuộc vào loại tài liệu (xem ở trên), comment có thể được gán cho một đối tượng, một điểm cụ thể hoặc một vùng trên tài liệu đang hoạt động. Lệnh này sẽ kích hoạt chế độ đặt comment, và con trỏ sẽ chuyển thành hình chữ thập với một vòng tròn màu xanh dương để phát hiện và tô sáng các đối tượng có thể chọn:

• Nhấp vào một đối tượng được tô sáng để đính kèm (ghim) comment vào đối tượng đó.

• Nhấp vào vùng không được tô sáng để đính kèm comment vào chính điểm đó trên tài liệu.

• Nhấp ở vị trí không có đối tượng và kéo con trỏ để tạo một vùng tô sáng hình chữ nhật rồi đính kèm comment vào vùng đã chỉ định ().

Trong tài liệu ActiveBOM, nhấp vào một ô trong tài liệu ActiveBOM để thêm comment vào hàng BOM đó. Nhấp chuột phải vào một hàng rồi chọn lệnh Comment để thêm comment vào hàng này.

Sau đó, thao tác đặt sẽ mở ra một hộp thoại nhập comment, cung cấp một trường để nhập nội dung comment và, đối với tài liệu đồ họa, cũng có thêm một tùy chọn để thêm nét vẽ tay tự do vào comment nếu phù hợp (). Chọn tùy chọn Assign a task to để gán một tác vụ cho chính bạn hoặc cho một trong những người dùng được nhắc đến trong comment (xem chi tiết bên dưới). Nhấp  để xác nhận tạo comment; thao tác này sẽ liên kết comment với một dấu ghim được đánh số trên tài liệu, đồng thời thêm một mục tóm tắt comment vào panel Comments and Tasks.

Đặt comment lên một đối tượng, nhắc đến một người dùng đã đăng ký khác trong comment, di chuyển chỉ báo ghim của comment và thêm nét vẽ tay tự do vào comment.

Nhắc Đến và Gán Tác Vụ

Cùng với văn bản trong hộp thoại nhập comment, có thể thêm tham chiếu 'mention' cho bất kỳ người dùng hoặc vai trò nào khác đã đăng ký với Workspace được kết nối bằng cách nhập ký tự @. Chọn một tên/email từ danh sách thả xuống để thêm tham chiếu người dùng (thành viên Workspace) vào comment, đồng thời thêm dưới dạng một mục Assign a task to – về cơ bản, một task sẽ được gán cho người dùng đó. Bỏ chọn tùy chọn thứ hai nếu bạn không muốn comment được xem là được gán cụ thể cho người dùng đó. Một nhóm Role (ví dụ: 'Engineers'), và do đó cả những người dùng thuộc nhóm đó, cũng có thể được thêm dưới dạng mention.

Nếu một người dùng được nhắc đến không có quyền truy cập vào dự án hiện tại, bạn sẽ được mời chia sẻ dự án đó với người dùng này. Tùy chọn này khả dụng nếu bạn là chủ sở hữu dự án hoặc quản trị viên Workspace. Quyền Truy Cập Người Dùng được cấp thông qua hộp thoại Share dialog; người dùng sẽ nhận được email thông báo rằng họ đã được chia sẻ quyền truy cập. Nếu bạn hủy hộp thoại Share, dự án sẽ không được chia sẻ, nhưng comment vẫn sẽ được đặt như bình thường.

► Xem thêm thông tin về việc chia sẻ thiết kế.

Khi một tác vụ được gán cho người dùng, hình ảnh/ảnh đại diện của người dùng đó sẽ được hiển thị ở góc trên bên trái của hộp thoại comment và ô comment trong panel Comments and Tasks. Ngoài ra, tác vụ sẽ được đặt tên theo tên dự án và số thứ tự (ví dụ, Kame_FMU-1) thay vì chỉ là một số đơn giản như với các comment thông thường. Tên này cũng được hiển thị trong hộp thoại comment và ô comment. Nhấp vào đó để mở trang Tasks của dự án trong giao diện trình duyệt của Workspace với tác vụ đã chọn được lấy nét trong danh sách tác vụ.

Định Vị

Vị trí của một comment trong không gian trình soạn thảo được di chuyển bằng cách kéo 'ghim' liên kết của nó tới vị trí mới – trong khi đặt hoặc sau khi đã đặt. Khi được chọn, ghim comment sẽ bao gồm một đường nối tới đối tượng hoặc vùng được liên kết.

Lưu ý rằng một comment cũng có thể được định vị trong lần đặt ban đầu bằng cách nhấp và kéo khi đang ở chế độ đặt ().

Dán Hình Ảnh

Bạn có thể thêm hình ảnh vào comment bằng cách trước tiên sao chép hình ảnh từ một cửa sổ Explorer  hoặc từ một trang trình duyệt bằng cách nhấp chuột phải vào hình ảnh, thao tác này sẽ sao chép hình ảnh vào clipboard. Để đính kèm hình ảnh, hãy dùng thao tác nhấp chuột phải Paste (hoặc phím tắt Ctrl+V ) trong chính comment đó (ở trường có nội dung Add others with @ or paste images). 

Mỗi hình ảnh có kích thước tối đa là 2MB. Sau khi dán vào bình luận, hãy nhấp vào hình ảnh để hiển thị ảnh đầy đủ, như minh họa ở hình bên phải.

Bạn cũng có thể đăng một bình luận chỉ chứa hình ảnh được dán mà không có văn bản nào, như minh họa bên dưới.

Vẽ

Khi đặt hoặc chỉnh sửa bình luận, hãy chọn nút tùy chọn  để thêm bản vẽ tự do bằng con trỏ bút xuất hiện tương ứng. Nhấp và kéo để tạo các đường nét, sau đó nhấp chuột phải để hoàn tất và gắn bản vẽ với bình luận hiện đang được chọn.

Để truy cập chế độ Freehand Drawing của bảng Properties, nhấn phím Tab khi chế độ vẽ tự do đang hoạt động (điều này được biểu thị bằng biểu tượng  trong không gian thiết kế). Các tùy chọn này cho phép bạn hoàn tác và làm lại bình luận trong danh sách thả xuống Commands và thay đổi độ rộng, kích thước và màu sắc trong danh sách thả xuống Properties .

Tác vụ Chung

Các tác vụ chung (các tác vụ áp dụng cho dự án hiện tại nhưng không liên kết với bình luận dự án hoặc tài liệu nào) được liệt kê trong bảng thành một nhóm riêng bên dưới mục của dự án. Cùng một nội dung và thuộc tính cũng được hiển thị trong bảng cho các tác vụ chung (người được giao, mức ưu tiên, v.v.).

Các tác vụ chung được liệt kê trong bảng Comments and Tasks.

Nhấp vào một mục Tác vụ Chung trong bảng để truy cập các hộp thoại bình luận của nó. Sử dụng hộp thoại để đăng bình luận (bao gồm cả những bình luận có hình ảnh được dán) cho Tác vụ Chung đã chọn.

Bình luận Tách rời

Khi một tài liệu dự án bị xóa hoặc UniqueID của tài liệu thay đổi, các bình luận của tài liệu đó có thể trở thành "tách rời". Những bình luận đó vẫn có thể được truy cập từ vùng có thể thu gọn Detached Comments của bảng. Nhấp vào ô của một bình luận tách rời trong bảng Comments and Tasks để hiển thị hộp thoại của nó trong không gian thiết kế của tài liệu hiện đang mở.

Làm việc với Bình luận

Các bình luận được đặt trong tài liệu thiết kế được đăng ký cả trong bảng Comments and Tasks (dưới dạng một chuỗi các mục được đánh số) và trong trình chỉnh sửa tài liệu tương ứng (dưới dạng các ghim đồ họa được đánh số). Mỗi mục trong bảng đại diện cho một luồng bình luận và cung cấp thông tin tóm tắt, bao gồm ai đã đặt bình luận và khi nào, nội dung bình luận ban đầu, mọi mention/giao việc được áp dụng và số lượng phản hồi trong luồng.

Một luồng bình luận được mở bằng cách chọn mục của nó trong bảng Comments and Tasks hoặc bằng cách nhấp vào ghim liên kết của nó trong không gian thiết kế. Thao tác này làm nổi bật bình luận trong trình chỉnh sửa tài liệu và mở hộp thoại mục bình luận, bao gồm bình luận khởi đầu và mọi phản hồi của người dùng. Nếu bình luận được chọn liên kết với một tài liệu thiết kế khác, hệ thống sẽ mở (và tải, nếu cần) tài liệu đó.

Điều hướng giữa các bình luận bằng cách chọn các dấu ghim trong không gian thiết kế và bằng cách chọn các mục trong bảng Comments and Tasks.

Hộp thoại Bình luận

Tương tác với một bình luận đã đặt được thực hiện thông qua hộp thoại bình luận bật lên, hiển thị tất cả các mục trong luồng bình luận đã chọn và bao gồm các tùy chọn để xem trước, trả lời, chỉnh sửa, giải quyết và xóa một mục. Hộp thoại được mở khi ban đầu đặt một bình luận hoặc khi một bình luận đã đặt được chọn trong bảng Comments and Tasks hoặc trong không gian thiết kế. Nhấn Esc hoặc nhấp vào không gian thiết kế để đóng hộp thoại bình luận.

Xem trước

Chọn tùy chọn Original Snapshot trong bình luận ban đầu để xem ảnh chụp đồ họa của vùng trình chỉnh sửa tại thời điểm bình luận được đặt. Nhấp vào biểu tượng ở góc trên bên phải của ảnh chụp màn hình hoặc vào chính ảnh đó để mở bản xem trước kích thước đầy đủ (nhấp vào biểu tượng  ở góc trên bên phải của bản xem trước này hoặc vào chính hình ảnh để đóng lại).

Trả lời

Nhập văn bản và tùy chọn thêm mention người dùng ('@') trong trường Reply để thêm một mục mới vào luồng bình luận. Chọn tùy chọn Assign a task to để tạo một tác vụ được giao cho người dùng được chỉ định trong danh sách thả xuống. Nhấp vào  để xác nhận mục nhập.

Chỉnh sửa và Xóa

Một bình luận hiện có có thể được chỉnh sửa bởi tác giả của bình luận đó bằng tùy chọn Edit có sẵn từ menu  của bình luận. Nhấp vào nút  để xác nhận việc chỉnh sửa bình luận.

Sử dụng tùy chọn Delete để xóa bình luận hiện đang được chọn. Lưu ý rằng toàn bộ luồng sẽ bị xóa nếu bình luận ban đầu (thay vì một Reply) bị xóa.

Sử dụng tùy chọn Convert to Task để chuyển đổi bình luận thành một tác vụ được giao cho chính bạn.

Sử dụng tùy chọn Copy Link để sao chép URL tới luồng bình luận. Liên kết này có thể được dùng để mở dự án này trong Web Viewer của giao diện trình duyệt Workspace, với đối tượng, điểm hoặc vùng của bình luận được phóng to và căn giữa.

Giải quyết

Nhấp vào nút / để chuyển đổi trạng thái bình luận giữa Resolved và Unresolved (mặc định). Một bình luận đã được giải quyết (đóng là hoàn tất) sẽ không hoạt động và không thể chỉnh sửa, đồng thời cả mục của nó trong bảng Comments and Tasks và dấu ghim của nó trên tài liệu đều bị làm mờ.

Thiết lập Mức ưu tiên và Trạng thái Tác vụ

Nếu một bình luận tác vụ đã được giao cho người dùng, mức ưu tiên và trạng thái của nó có thể được thiết lập. Một tác vụ ban đầu ngay lập tức được đặt thành mức ưu tiên Medium và trạng thái To Do, nhưng chúng có thể được thay đổi bằng cách nhấp vào điều khiển liên quan ở đầu hộp thoại bình luận.

Thông tin Thẻ Commit, ID Bản sửa đổi Phát hành và Design Review 

Các thẻ commit và ID bản sửa đổi phát hành được hiển thị khi xem các bình luận/tác vụ áp dụng trong cả bảng Comments and Tasks và hộp thoại bình luận trong Altium Designer.

• Các bình luận được tạo trong Web Viewer khi xem ảnh chụp thiết kế của một commit đã gắn thẻ sẽ bao gồm tên thẻ liên kết. Nhấp vào liên kết tên thẻ để mở ảnh chụp commit liên quan trong Web Viewer.

• Các bình luận được tạo trong Web Viewer khi xem một bản phát hành cụ thể sẽ bao gồm ID bản sửa đổi phát hành. Nhấp vào liên kết ID bản sửa đổi phát hành để mở Manufacturing Portal cho bản phát hành này.

• Các bình luận được tạo trong Web Viewer khi xem một ảnh chụp Design Review sẽ bao gồm mục design review. Nhấp vào liên kết design review để mở trang của bản review.

Làm việc với Tác vụ Jira

Nếu Jira Integration được bật và cấu hình cho Altium 365 Workspace của bạn, thì một bình luận đã đặt sẽ bao gồm tùy chọn bổ sung là tạo và liên kết với một issue Jira trong dịch vụ Atlassian Jira® của bạn. Giống như các bình luận thông thường và các tác vụ liên quan của chúng, các issue Jira đã đặt có thể được xem, chỉnh sửa và bình luận từ bên trong các tài liệu thiết kế, cũng như được xem/chọn thông qua bảng Comments and Tasks.

Một phiên bản tác vụ Jira đã đặt được đồng bộ với issue tương ứng của nó trong không gian Jira. Việc đồng bộ dữ liệu hai chiều giữa các issue Jira và tác vụ Workspace cho phép việc quản lý dự án thiết kế được thực hiện thông qua không gian Jira kết hợp với Altium 365.

Tạo một Jira Issue

Để đặt một tác vụ Jira Issue cho dự án thiết kế, trước tiên hãy đặt một bình luận theo cách thông thường rồi chọn tùy chọn Jira Issue trong hộp thoại bình luận. Tiếp theo, chọn loại Issue và thêm phần tóm tắt để tạo tác vụ Jira issue được đồng bộ.

❯ ❮ Javascript ID: CreateJiraIssue

Đặt một tác vụ Jira trong tài liệu dự án hiện tại bằng cách trước tiên đặt một phiên bản bình luận. Chế độ Jira thay thế có sẵn từ menu thả xuống Comment. Gọi việc đặt tác vụ Jira bằng cách chọn tùy chọn Jira Issue từ menu Comment của hộp thoại. Nhấp vào tùy chọn Create Issue nếu chưa được chọn. Chọn loại issue sẽ được tạo từ danh sách thả xuống Issue Type, danh sách này bao gồm các loại có sẵn trong dịch vụ Jira của bạn. Nhập Summary của issue và mô tả/người được giao tùy chọn. Danh sách thả xuống Assignee sẽ chỉ bao gồm những người dùng là thành viên đã đăng ký của tài khoản Jira của bạn. Chọn Post để xác nhận. Issue Jira được đặt tại vị trí bình luận ban đầu trong tài liệu, được đưa vào bảng Comments and Tasks, cung cấp liên kết đến issue trong không gian Jira và bao gồm quyền truy cập tương tác vào mức ưu tiên tác vụ của nó (Medium, High, v.v.) và các thiết lập trạng thái (To Do, In Progress, v.v.).

Chọn Task ID của Jira issue trong Workspace trong hộp thoại bình luận hoặc bảng Comments and Tasks để trực tiếp mở issue đó trong không gian Jira trong một tab mới của trình duyệt mặc định của bạn. Task ID của Workspace ánh xạ tới Issue Key trong không gian Jira, và các tham số Jira chính như Summary, Description, Assignee và Comments được ánh xạ giữa hai phiên bản. Người dùng Workspace đã tạo Jira Issue là Issue Reporter ở phía Jira. Lưu ý rằng ảnh chụp tài liệu Workspace hiện tại được đưa vào dưới dạng tệp đính kèm Jira nếu tùy chọn Attach original snapshot đã được chọn khi tạo Jira issue trong Workspace (xem ở trên).

Một tác vụ Jira của Workspace đã đặt sẽ tạo một Jira issue được đồng bộ trong không gian Jira. Hai bên được liên kết bằng việc ánh xạ Task ID của Workspace với Issue Key của Jira.

Cùng với các tham số được ánh xạ giữa các issue Workspace và Jira, các thiết lập trạng thái Priority và Progress liên quan đến tác vụ cũng được đồng bộ. Ví dụ: việc chuyển tác vụ issue trong Workspace từ trạng thái ưu tiên Medium sang High sẽ ngay lập tức được phản ánh ở issue phía Jira, và việc thay đổi trạng thái tiến độ từ To Do sang In Progress ở phía Jira cũng sẽ tương tự thay đổi trạng thái của Jira issue trong Workspace. Có thể cần làm mới dữ liệu (thực hiện bằng cách nhấp vào nút  ở đầu bảng Comments and Tasks) để thấy dữ liệu đã cập nhật.

Liên kết tới một Jira Issue

Altium 365 Jira Integration cũng cho phép một Workspace Task được liên kết tới một Jira issue hiện có trong dịch vụ Atlassian Jira của bạn thông qua chế độ Jira Issue của hộp thoại bình luận. Bạn có thể liên kết tới bất kỳ issue nào trong dự án Jira được chỉ định, sau đó issue này sẽ được đồng bộ với tác vụ Jira trong Workspace.

❯ ❮ Javascript ID: LinkJiraIssue

Đặt một phiên bản bình luận trên vùng tài liệu hoặc đối tượng mà bạn muốn liên kết với một Jira issue hiện có, sau đó chọn chế độ Jira Issue và tùy chọn Link Issue trong hộp thoại bình luận. Sử dụng danh sách thả xuống Select or search issues để chọn Jira issue (được hiển thị dưới dạng văn bản Summary) sẽ liên kết với phiên bản tác vụ Jira mới được đặt. Bắt đầu nhập vào trường văn bản để tìm kiếm Jira issue cần thiết. Danh sách thả xuống Jira Issue của hộp thoại sẽ hiển thị issue đã chọn từ không gian Jira. Nếu cần, hãy chọn tùy chọn Attach original snapshot để chuyển một hình ảnh của chế độ xem tài liệu hiện tại sang Jira. Nhấp vào nút Post để thiết lập liên kết giữa tác vụ Jira của Workspace và Jira issue đã chọn. Tác vụ Jira issue mới được hiển thị trong bảng Comments and Tasks và hộp thoại bình luận, nơi sẽ bao gồm mọi bình luận hiện có (hoặc được thêm vào) – chọn tùy chọn Show all Replies của hộp thoại để xem toàn bộ danh sách.

Jira issue được liên kết hiện đã được đồng bộ với tác vụ Jira của Workspace, bao gồm Comments của issue và được đặt thành các trạng thái Progress và Priority do Jira issue xác định – In Progress và High trong ví dụ này. Lưu ý rằng các mục Web links của Jira issue giờ đây sẽ cho biết rằng một tác vụ Jira của Altium 365 Workspace đã được liên kết (hoặc liên kết lại) với issue này.

Một Jira issue hiện có được liên kết với một tác vụ Workspace bằng cách chỉ định mục Jira Issue của nó trong chế độ Link Issue của hộp thoại bình luận Workspace.

Bảng To-Do

Mặc dù Workspace được kết nối của bạn cung cấp một bộ tính năng toàn diện cho việc bình luận và giao tác vụ như đã mô tả ở trên, bạn cũng có thể truy cập bảng To-Do để theo dõi các tác vụ của mình. Bảng To-Do liệt kê tất cả các mục To-Do hiện được xác định cho dự án đang hoạt động. Một mục To-Do được dùng như lời nhắc cho một tác vụ cần được thực hiện sau này liên quan đến một tài liệu.

Bảng To-Do

To-Do Panel Content and Use

Bảng To-Do có thể liệt kê hai loại mục 'to-do' cho dự án đang hoạt động:

• Một mục To-Do cấp dự án.
• Một mục To-Do cấp tài liệu - được thêm vào một tài liệu dạng văn bản trong dự án.

Đối với mỗi mục To-Do, thông tin sau sẽ được hiển thị:

• Done - hộp kiểm này cho phép bạn đánh dấu mục khi tác vụ đã xác định của nó đã được hoàn thành.
• Action Item - tác vụ thực tế cần được thực hiện.
• Priority - mức độ quan trọng của tác vụ cần thực hiện (Lowest, Low, Normal (mặc định), High, Highest).
• Document - tham chiếu đến tài liệu nguồn mà một mục To-Do cấp tài liệu đã được thêm vào.
• Owner - đây có thể là tên của người nhập tác vụ hoặc người thực sự sẽ thực hiện tác vụ.
• Category - đây có thể là khu vực cụ thể trong dự án mà tác vụ cần thực hiện thuộc về (ví dụ: sơ đồ nguyên lý, quy tắc thiết kế, đi dây, ràng buộc, v.v.).

Thêm Mục To-Do Cấp Dự án

Các mục To-Do cấp dự án được thêm từ ngay trong chính bảng đó. Trước khi thêm bất kỳ mục nào, hãy đảm bảo rằng tài liệu đang hoạt động trong cửa sổ trình chỉnh sửa thiết kế là một trong các tài liệu thiết kế của dự án mà bạn muốn xác định các mục To-Do.

Để thêm một mục To-Do mới, nhấp chuột phải trong bảng và chọn mục Add Project To-Do Item từ menu ngữ cảnh xuất hiện sau đó. Hộp thoại Edit To-Do Item sẽ mở ra.

Sử dụng hộp thoại này để nhập văn bản phù hợp cho tác vụ phải được thực hiện cho dự án. Sử dụng các trường có sẵn trong hộp thoại để xác định một task's Priority, Owner, and Category. Sau khi xác định mục theo yêu cầu, nhấp vào OK để thêm mục mới vào bảng.

Thêm Mục To-Do Cấp Tài liệu

Các mục To-Do cấp tài liệu được thêm vào một tài liệu nguồn dạng văn bản (ví dụ: tệp VHDL, tệp Constraint, tài liệu mã nguồn nhúng, v.v.). Trước khi thêm bất kỳ mục nào, hãy đảm bảo rằng tài liệu cần thiết đang hoạt động trong cửa sổ trình chỉnh sửa thiết kế và tài liệu này thuộc về dự án mà bạn hiện đang xác định các mục To-Do tổng thể.

Để thêm một mục To-Do mới, đặt con trỏ văn bản tại vị trí cần thiết trong tài liệu nơi bạn muốn đặt mục To-Do, nhấp chuột phải và chọn mục Add To-Do Item từ menu bật lên xuất hiện sau đó. Hộp thoại Edit To-Do Item sẽ xuất hiện. Sử dụng hộp thoại này để nhập văn bản phù hợp liên quan đến tác vụ phải được thực hiện trong tài liệu. Sử dụng các trường có sẵn trong hộp thoại để xác định một Priority, Owner và Category cho tác vụ (ví dụ: Formatting pass, Code Review pass, v.v.). Sau khi xác định mục To-Do theo yêu cầu, nhấp vào OK để đóng hộp thoại và đưa tiêu điểm trở lại tài liệu hiện tại. Một mục nhập cho mục To-Do sẽ xuất hiện trong bảng To-Do và cũng tại vị trí được đánh dấu bởi vị trí hiện tại của con trỏ văn bản. Mục nhập sẽ xuất hiện dưới dạng một comment (giữa (các) dấu phân cách comment được xác định cho loại tài liệu đó), bao gồm văn bản thực tế của mục và một mã định danh duy nhất, như minh họa trong hình bên dưới.

Menu Nhấp chuột phải

Menu nhấp chuột phải cung cấp các lệnh sau:

• Goto Source - lệnh này khả dụng khi mục được chọn trong bảng là một mục To-Do cấp tài liệu. Sử dụng lệnh này để mở (nếu chưa mở) tài liệu nguồn liên kết được tham chiếu trong trường Document của mục và biến nó thành tài liệu đang hoạt động trong cửa sổ trình chỉnh sửa thiết kế. Con trỏ văn bản sẽ được đặt ở đầu phần văn bản của mục To-Do.
• Add Project To-Do Item - thêm một mục To-Do cấp dự án vào bảng cho dự án đang hoạt động.
• Edit - chỉnh sửa mục To-Do đã chọn. Hộp thoại Edit To-Do Item sẽ xuất hiện, cho phép bạn thực hiện các thay đổi cần thiết.
• Delete - xóa mục To-Do đã chọn khỏi bảng.
• Show Completed Items - khi tùy chọn này được bật, chỉ các mục To-Do đã được đánh dấu là hoàn tất (tùy chọn Done được bật) mới tiếp tục được hiển thị trong bảng.
• Report - tạo một báo cáo chứa tất cả các mục To-Do hiện đang được hiển thị trong bảng. Sau khi chạy lệnh, hộp thoại Report Preview sẽ mở ra, trong đó bạn có thể cấu hình, in và xuất báo cáo ở nhiều định dạng tệp khác nhau.

Lưu ý

• Nếu một mục To-Do cấp tài liệu đã được xác định trong bảng và tài liệu nguồn tương ứng là tài liệu đang hoạt động trong cửa sổ trình chỉnh sửa thiết kế, văn bản cho toàn bộ mục To-Do trong bảng sẽ chuyển thành in đậm.
• Nhấp đúp vào một mục To-Do trong bảng sẽ mở hộp thoại Edit To-Do Item, cho phép bạn sửa đổi định nghĩa của tác vụ.
• Các mục trong bảng có thể được sắp xếp theo bất kỳ cột nào bằng cách nhấp vào tiêu đề của cột đó. Nhấp một lần để sắp xếp theo thứ tự tăng dần; nhấp lần nữa để sắp xếp theo thứ tự giảm dần.
• Lọc trực tiếp cho phép bạn nhanh chóng chuyển đến một mục To-Do bằng cách nhập trực tiếp trong bảng. Bạn có thể lọc dựa trên bất kỳ cột dữ liệu nào trong bảng. Sử dụng phím Right Arrow và Left Arrow để chuyển đổi giữa các cột dùng cho việc lọc, hoặc nhấp trực tiếp vào một trường trong cột. Để sử dụng tính năng lọc này, hãy nhấp vào một cột dữ liệu và nhập chữ cái đầu tiên của mục mà bạn muốn chuyển đến. Mục đầu tiên trong cột đó bắt đầu bằng chữ cái bạn nhập sẽ được chọn, và chữ cái đó sẽ được tô sáng để cho biết việc lọc nội dung của cột đang dựa trên chữ cái đã nhập.