Kết nối GitHub với Notion

Tính năng đồng bộ hóa GitHub được quản lý sẽ tạo một cơ sở dữ liệu Yêu cầu kéo GitHub từ các kho lưu trữ bạn chọn. Notion nhập các yêu cầu kéo hiện có và kiểm tra GitHub để cập nhật trong nền.

Hướng dẫn này bao gồm Đồng bộ hóa cơ sở dữ liệu trong cài đặt kết nối GitHub của bạn. Các thuộc tính được đồng bộ hóa là chỉ đọc. Hãy thực hiện thay đổi đối với các yêu cầu kéo trong GitHub.

Bạn có thể đồng bộ hóa các yêu cầu kéo từ nhiều kho lưu trữ khả dụng thông qua cài đặt Ứng dụng GitHub. Các kho lưu trữ đã chọn sẽ đổ dữ liệu vào một cơ sở dữ liệu 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.

Tính năng đồng bộ hóa này không bao gồm các vấn đề, bình luận, người được phân công hoặc chi tiết nhận xét trên GitHub.

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. Chọn tất cả lịch sử có sẵn hoặc một khoảng thời gian lịch sử.

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

Notion tạo Yêu cầu kéo GitHub trong phần thanh bên Riêng tư của bạn và bắt đầu nhập các yêu cầu kéo khớp.

Trong lần nhập đầu tiên, Notion đọc các yêu cầu kéo từ mỗi kho lưu trữ đã chọn, bắt đầu với các bản ghi được cập nhật gần đây nhất và xử lý 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 yêu cầu kéo mới và đã cập nhật. Các thay đổi như nhãn mới, yêu cầu kéo đã đóng hoặc hợp nhất 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 đang mở mà không thay đổi trong hơn 90 ngày có thể nằm ngoài cửa sổ 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 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 các yêu cầu kéo với quy trình lập kế hoạch của nhóm bạn. Các giá trị thuộc tính của riêng bạn vẫn nằm trong Notion.

Để thay đổi thuộc tính GitHub, hãy mở yêu cầu kéo 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 kho lưu trữ của nó đã được chọn, bản cập nhật cuối cùng của nó nằm trong cửa sổ lịch sử và chế độ xem Notion của bạn không lọc nó ra. Lần nhập đầu tiên có thể vẫn đang chạy.

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 →