Kết nối GitHub với Notion

Tính năng đồng bộ hóa GitHub được quản lý đưa những nội dung bạn chọn từ GitHub vào Notion: yêu cầu kéo, vấn đề 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 nội dung cập nhật trong 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. Bạn chỉ có thể xem các thuộc tính được đồng bộ hóa. Hãy chỉnh sửa yêu cầu kéo và vấn đề 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 bản cài đặt ứng dụng GitHub: yêu cầu kéo, vấn đề hoặc cả hai. Dữ liệu từ các kho lưu trữ bạn chọn sẽ được đưa vào 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 vấn đề trên 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 chi tiết 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 và chọn nội dung cần đưa vào Notion: yêu cầu kéo, vấn đề 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à vấn đề bạn đã chọn từ từng kho lưu trữ được chọn, bắt đầu từ các bản ghi được cập nhật gần đây nhất rồi tiếp tục duyệt qua 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 hoặc được cập nhật. Những thay đổi như nhãn mới, yêu cầu kéo đã đóng hoặc vấn đề đượ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 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 bỏ vấn đề hay yêu cầu kéo: Thay đổi loại dữ liệu đượ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 bỏ 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ẽ vẫn được giữ nguyên.

• 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 riêng để 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à 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 riêng này 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 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 nhất nằm trong khoảng thời gian lịch sử đã chọn và chế độ xem Notion của bạn không lọc bỏ mục đó. Lượt 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 →