Jira items drawer

Duyệt, sửa, và liên kết issue Jira Cloud hoặc Server/Data Center tự host với worktree, giống hệt cách bạn liên kết Linear hoặc GitHub.

Jira nằm cạnh GitHub và Linear trong task drawer. Duyệt issue Jira, cập nhật chúng, và tạo worktree từ bất kỳ issue nào mà không cần rời Orca.

Kết nối một site Jira

1. Mở mục sidebar Tasks và chọn Jira từ bộ chọn nguồn - Jira nằm cạnh GitHub và Linear mặc định, kể cả trước khi có credential nào được lưu.
2. Click Connect Jira. Dialog Connect Jira site hiện ra.
3. Chọn Cloud hoặc Self-hosted (Server / Data Center).

Cloud

• Jira Cloud site URL - ví dụ https://example.atlassian.net.
• Atlassian email - địa chỉ gắn với tài khoản Atlassian của bạn.
• Atlassian API token - tạo tại id.atlassian.com → Security → API tokens.

Self-hosted

• Jira base URL - base của Server/DC (kèm path nếu Jira không nằm ở /).
• Phương thức xác thực:
  • Personal access token - Bearer PAT (ưu tiên trên Server/DC hiện đại).
  • Username and password - Basic auth cho instance cũ chưa có PAT.

4. Click Connect. Orca xác minh credential và tải các site của bạn.

Bạn có thể kết nối nhiều hơn một site Atlassian. Header Tasks có bộ chọn site khi đã kết nối; chọn All sites để gộp issue từ mọi site.

Nếu bạn không dùng Jira, ẩn nó khỏi bộ chọn nguồn ở Settings → Tasks.

Dùng Jira

• Task drawer hiện issue của GitHub, Linear, và Jira trong một danh sách hợp nhất khi mỗi nguồn đã được bật.
• Mở một issue để xem đầy đủ description, comment, và metadata trong một drawer bên cạnh. Sửa status (qua các transition khả dụng), priority, assignee, và custom field ngay inline.
• Thêm comment từ ô soạn comment của drawer.
• New Jira issue giữ lại title và description nếu bạn lỡ tay đóng dialog - Escape, Cancel, click ra ngoài, hoặc đóng. Text được khôi phục khi bạn mở lại dialog trong cùng session app; bản nháp bị xóa sau khi tạo thành công và không sống sót qua một lần khởi động lại app. Picker issue type và các picker khác vẫn dùng mặc định lúc mở như thường lệ.
• Tạo worktree từ một Jira issue tự điền tên task và liên kết worktree với issue, để review và issue luôn gắn liền với nhau.
• Từ dialog Create workspace, bạn cũng có thể dán một URL issue Jira (https://…/browse/ABC-123) vào ô tên, hoặc chuyển ô đó sang chế độ tìm kiếm Jira và chọn issue theo text. Orca tự điền tên workspace, liên kết issue, và hiện key + summary trên card worktree kèm View on Jira. Paste nhận biết đa site: khi nhiều hơn một site đã kết nối khớp với origin của URL, Orca hỏi bạn chọn site nào; khi không site nào khớp, nó báo site chưa được kết nối.
• Orca nhớ nguồn task bạn dùng lần cuối theo từng repo, nên một repo dùng Jira sẽ mặc định về Jira ở lần mở tiếp theo.

Credential được lưu ở đâu

API token Atlassian hoặc credential tự host của bạn được mã hoá qua keychain của hệ điều hành và lưu local - chúng chỉ được dùng để gọi tới site Jira bạn đã cấu hình. Thu hồi token từ settings tài khoản Atlassian nếu bạn ngừng dùng Orca.

Bước tiếp theo

• Linear items drawer - cùng luồng đó áp dụng cho Linear.
• Hosted reviews, issues & Actions - bàn giao worktree cho hosted review khi issue Jira đang tiến hành.
• Commit & push từ Orca - ship branch mà không cần rời Orca.

Nguồn

Dịch và biên soạn từ trang Jira items drawer trong tài liệu chính thức của Orca ADE (onorca.dev).