Kết nối GitHub với Notion

Tính năng đồng bộ hóa GitHub được quản lý đưa những công việc bạn chọn trên GitHub vào Notion: yêu cầu kéo, mục sự cố hoặc cả hai. Notion nhập các bản ghi hiện có của bạn và kiểm tra GitHub để tìm các bản cập nhật ở chế độ nền.

Hướng dẫn này đề cập đến Đồng bộ hóa cơ sở dữ liệu trong phần cài đặt kết nối GitHub của bạn. Các thuộc tính được đồng bộ hóa chỉ đọc. Hãy chỉnh sửa yêu cầu kéo và mục sự cố trên GitHub.

Chọn nội dung cần đưa vào Notion từ các kho lưu trữ có thể truy cập thông qua ứng dụng GitHub đã cài đặt: yêu cầu kéo, mục sự cố hoặc cả hai. Các kho lưu trữ bạn chọn sẽ cung cấp dữ liệu cho Notion.

Thuộc tính Tác giả (GitHub) chứa tên người dùng GitHub. Tác giả là một thuộc tính người dùng Notion khi email công khai của tác giả khớp với một thành viên trong không gian làm việc.

Thuộc tính Mô tả đồng bộ hóa mô tả của yêu cầu kéo dưới dạng văn bản thuần, được sao chép chính xác như đã viết trong GitHub. Nó không được hiển thị dưới dạng markdown.

Bạn có thể đồng bộ hóa các mục sự cố GitHub riêng hoặc cùng với yêu cầu kéo. Quá trình đồng bộ hóa này không bao gồm bình luận về yêu cầu kéo hoặc thông tin chi tiết về nhận xét.

Bạn sẽ cần:

• Tư cách thành viên trong không gian làm việc Notion.

• Một tài khoản GitHub có quyền truy cập vào các kho lưu trữ bạn muốn đồng bộ hóa.

• Một cài đặt Ứng dụng GitHub có quyền truy cập vào các kho lưu trữ đó.

• Gói Business (Gói Mobile Business cũng hợp lệ). Đồng bộ hóa GitHub không khả dụng trên các gói khác.

Cả tài khoản GitHub và việc cài đặt ứng dụng của bạn đều cần quyền truy cập. Tổ chức GitHub của bạn có thể yêu cầu chủ sở hữu phê duyệt hoặc cài đặt ứng dụng.

1. Trong Notion, đi tới Cài đặt → kết nối → GitHub.

2. Mở Đồng bộ hóa cơ sở dữ liệu và kết nối tài khoản GitHub của bạn nếu bạn chưa kết nối.

3. Hoàn tất các bước ủy quyền và cài đặt của GitHub.

4. Chọn tổ chức hoặc tài khoản có các kho lưu trữ mà bạn muốn đồng bộ hóa. Sử dụng Thêm tổ chức… nếu bạn cần thêm một cài đặt khác.

5. Chọn các kho lưu trữ cần bao gồm.

6. Đặt tên cho quá trình đồng bộ hóa của bạn và chọn nội dung cần đưa vào Notion: yêu cầu kéo, mục sự cố hoặc cả hai.

7. Chọn tất cả lịch sử có sẵn hoặc một khoảng thời gian lịch sử.

8. Chọn Tạo đồng bộ.

Notion tạo cơ sở dữ liệu được đồng bộ trong mục Riêng tư trên thanh bên của bạn và bắt đầu nhập các bản ghi phù hợp.

Trong lần nhập đầu tiên, Notion đọc các yêu cầu kéo và mục sự cố mà bạn đã chọn từ từng kho lưu trữ được chọn, bắt đầu từ những bản ghi được cập nhật gần đây nhất rồi tiếp tục duyệt phần lịch sử đã chọn.

Sau khi nhập, Notion thường xuyên kiểm tra từng kho lưu trữ để tìm các bản ghi mới và được cập nhật. Những thay đổi như nhãn mới, yêu cầu kéo đã đóng hoặc mục sự cố được mở lại sẽ cập nhật các thuộc tính tương ứng trong Notion.

Quá trình đồng bộ hóa vẫn chạy ngay cả khi bạn đóng Notion. Các kho lưu trữ lớn, giới hạn yêu cầu của GitHub và các sự cố dịch vụ tạm thời có thể làm chậm quá trình cập nhật. Hãy kiểm tra trạng thái đồng bộ hóa để biết tiến trình hoặc lỗi.

Chọn Tất cả lịch sử, 30 ngày qua, 90 ngày qua hoặc 365 ngày qua. Khi tính năng đồng bộ hóa tất cả lịch sử được cung cấp dưới dạng nút chuyển đổi, hãy để Đồng bộ hóa tất cả lịch sử có sẵn ở trạng thái bật để bao gồm tất cả các yêu cầu kéo có sẵn.

Cửa sổ này sử dụng thời gian Đã cập nhật lúc của yêu cầu kéo. Nó không phụ thuộc vào thời điểm yêu cầu kéo được tạo hoặc liệu nó đang mở, đã đóng hay đã hợp nhất.

Ví dụ, một yêu cầu kéo hoặc mục sự cố vẫn đang mở nhưng không có thay đổi nào trong hơn 90 ngày có thể nằm ngoài khoảng thời gian 90 ngày.

Mở đồng bộ hóa trong Cài đặt → kết nối → GitHub → Đồng bộ hóa cơ sở dữ liệu.

• Thêm hoặc xóa mục sự cố hoặc yêu cầu kéo: Thay đổi nội dung được đồng bộ hóa và chọn Lưu thay đổi. Khi thêm một loại, các bản ghi tương ứng sẽ được nhập. Khi xóa một loại, các trang thuộc loại đó sẽ bị xóa. Các bản ghi đã nhập thuộc những loại bạn giữ lại sẽ không thay đổi.

• Thêm kho lưu trữ: Chỉnh sửa lựa chọn và chọn Lưu thay đổi. Notion nhập các yêu cầu kéo khớp từ các kho lưu trữ đã thêm.

• Xóa kho lưu trữ: Bỏ chọn chúng và lưu. Các trang yêu cầu kéo đã đồng bộ hóa của chúng sẽ bị xóa khỏi Notion.

• Lịch sử thay đổi: Cửa sổ dài hơn sẽ nhập thêm các bản ghi. Cửa sổ ngắn hơn sẽ xóa các bản ghi nằm ngoài cửa sổ mới.

• Tạm dừng cập nhật: Chọn Tạm dừng đồng bộ. Dữ liệu và cài đặt hiện có vẫn được giữ nguyên.

• Tiếp tục cập nhật: Chọn Tiếp tục đồng bộ để tiếp tục đồng bộ hóa.

Trước khi xóa kho lưu trữ hoặc rút ngắn lịch sử, hãy bảo lưu mọi thông tin chỉ có trên Notion mà bạn cần từ các trang bị ảnh hưởng.

Tạo các chế độ xem theo kho lưu trữ, trạng thái, tác giả hoặc nhãn. Thêm các thuộc tính của riêng bạn để theo dõi mức độ sẵn sàng phát hành hoặc kết nối yêu cầu kéo và mục sự cố với quy trình lập kế hoạch của nhóm bạn. Giá trị của các thuộc tính do bạn tạo sẽ vẫn được lưu trong Notion.

Để thay đổi thuộc tính GitHub, hãy mở bản ghi bằng URL GitHub và thực hiện thay đổi trong GitHub.

Cơ sở dữ liệu bắt đầu ở chế độ riêng tư. Nếu bạn chia sẻ nó, cài đặt chia sẻ của Notion sẽ xác định ai có thể xem dữ liệu đã nhập. Người xem không cần phải có quyền truy cập vào kho lưu trữ nguồn, vì vậy hãy xem xét quyền của cơ sở dữ liệu trước khi chia sẻ thông tin kho lưu trữ riêng tư.

Kiểm tra xem bạn đã chọn đúng tài khoản GitHub và cài đặt ứng dụng hay chưa. Xác nhận rằng cả tài khoản và ứng dụng của bạn đều có quyền truy cập kho lưu trữ. Nếu một tổ chức hạn chế cài đặt ứng dụng, hãy yêu cầu chủ sở hữu phê duyệt quyền truy cập.

Mở cài đặt kho lưu trữ của đồng bộ hóa, xem lại lựa chọn kho lưu trữ và lưu lại. Nếu nó đã được di chuyển sang một tổ chức khác, hãy xác nhận rằng kết nối có quyền truy cập tại vị trí mới.

Tên người dùng GitHub không phải lúc nào cũng có email công khai khớp với thành viên trong không gian làm việc Notion. Sử dụng Tác giả (GitHub) để xác định tác giả khi thuộc tính Tác giả bị trống. Các thay đổi đối với email hoặc tư cách thành viên không gian làm việc của tác giả có thể không tự động làm mới các yêu cầu kéo đã đồng bộ hóa cũ hơn.

Xác nhận rằng loại của mục đó được đưa vào quá trình đồng bộ hóa, kho lưu trữ chứa mục đó đã được chọn, lần cập nhật gần đây nhất của mục đó nằm trong khoảng thời gian lưu lịch sử và chế độ xem Notion của bạn không lọc bỏ mục đó. Lần nhập đầu tiên có thể vẫn đang diễn ra.

Mở chi tiết trạng thái của đồng bộ hóa. Kết nối lại tài khoản GitHub của bạn hoặc khôi phục quyền truy cập kho lưu trữ nếu được nhắc. Các giới hạn yêu cầu của GitHub và sự cố tạm thời có thể làm chậm quá trình cập nhật trong khi Notion thử lại.

Để so sánh với Workers và hướng dẫn khắc phục sự cố chung, hãy xem Đồng bộ hóa dữ liệu từ các công cụ khác vào Notion →