Nhập từ Confluence

Việc tập hợp tất cả dữ liệu của bạn tại một nơi là rất quan trọng. Đây là hướng dẫn hữu ích để nhập không gian làm việc Notion của bạn từ Confluence. Tùy thuộc vào nhu cầu, bạn có thể nhập từ Confluence vào Notion theo hai cách.

• Trình nhập tệp Zip: Có thể được sử dụng để chỉ nhập một phần không gian làm việc của bạn. Chỉ có thể nhập các không gian làm việc nhỏ hơn với dung lượng tối đa 5GB (hoặc 15GB theo yêu cầu).

• Trình nhập API: Chỉ có thể nhập toàn bộ không gian làm việc. Có thể nhập các không gian làm việc với dung lượng tối đa 30GB. Giữ lại các nhận xét và ánh xạ người dùng.

Nhập nhiều không gian làm việc Notion: Có thể nhập tối đa 10 không gian làm việc Notion cùng lúc trực tiếp thông qua giao diện người dùng. Mỗi không gian làm việc Notion được chọn sẽ tạo ra trang nhật ký riêng và được nhập dưới dạng một trang Riêng tư cấp cao nhất (vào các không gian nhóm Notion khác nhau nếu cần).

• Trang web Confluence → Tổ chức Notion

• Không gian Confluence → Không gian làm việc Notion

• Trang Confluence → Trang Notion

• Các macro → nội dung được làm phẳng hoặc loại thành phần nội dung Notion gần nhất (ví dụ: Confluence Expand → Notion nút thu gọn/mở rộng)

• Nhập tối đa ~50k trang hoặc 30GB dung lượng. Các tệp nhập lớn hơn có thể bị lỗi.

  • Mẹo: Đối với các không gian lớn, hãy chia nhỏ tệp xuất theo không gian con hoặc phần và sử dụng trình nhập ZIP. Nếu kích thước không gian làm việc >100GB, hãy liên hệ với quản lý tài khoản.

• Sau khi quá trình nhập bắt đầu, bạn có thể đóng trình duyệt một cách an toàn — chúng tôi sẽ gửi email cho bạn khi quá trình hoàn tất.

• Nhận xét tiến trình nhập của bạn trong Cài đặt → Nhập. Tại đó, bạn có thể xem Trạng thái của quá trình nhập và các lần nhập đã hoàn tất.

Xuất không gian Confluence của bạn sang HTML

1. Từ không gian làm việc Confluence của bạn, hãy đi tới Cài đặt không gian trong thanh bên phía trên bên phải.

2. Chọn Công cụ nội dung trên thanh công cụ phía trên, sau đó chọn Xuất. Nếu bạn không thấy một trong hai tùy chọn này, bạn có thể cần yêu cầu quyền Xuất từ quản trị viên không gian làm việc.

3. Chọn HTML từ danh sách định dạng.

4. Chọn Xuất tùy chỉnh và bỏ chọn hộp Bao gồm bình luận.

5. Chọn các trang bạn muốn xuất. Lưu ý rằng các trang chứa tệp đính kèm lớn có thể làm tăng đáng kể kích thước và độ phức tạp của tệp xuất.

6. Hãy để quá trình Xuất hoàn tất. Việc này có thể mất một lúc đối với các không gian làm việc lớn.

7. Sau khi hoàn tất, hãy nhấp vào Tải xuống để lưu tệp xuất vào máy tính của bạn. Tệp sẽ có tên dạng như Confluence-space-export-XXXXXX.html.zip.

Nhập vào Notion

1. Điều hướng đến không gian làm việc Notion mà bạn muốn nhập nội dung Confluence của mình vào.

2. Đi tới Cài đặt trong thanh bên của bạn → Nhập → Third party imports → Confluence.

3. Điều hướng đến tệp .zip được xuất từ Confluence và chọn tệp đó để tải lên. Bạn không cần giải nén tệp - hãy tải lên toàn bộ tệp lưu trữ.

4. Bạn sẽ thấy thông báo "Uploading..." khi trình duyệt tải tệp của bạn lên, sau đó là thông báo trạng thái khi quá trình nhập diễn ra.

5. Khi quá trình nhập hoàn tất, bạn sẽ được đưa đến nội dung mới nhập của mình.

Kết nối Confluence và Notion

1. Đi tới Cài đặt trong thanh bên của bạn → Nhập → Confluence.

2. Chọn Nhập qua API.

3. Chọn loại phiên bản Confluence của bạn: cloud hoặc server. Để tìm loại phiên bản của mình, hãy mở Confluence, nhấp vào Help → ? bên cạnh hồ sơ của bạn → About Confluence. Notion chỉ hỗ trợ các phiên bản cloud và server.

Xác thực với Confluence Cloud

1. Nhập email và trang Confluence của bạn.

2. Tạo mã thông báo API từ tài khoản Atlassian của bạn và nhập mã đó vào trường này. Đọc thêm về cách tạo mã thông báo trong Confluence.

3. Nhấp vào Xác thực.

Xác thực với Confluence Server

1. Tìm và chọn phiên bản Confluence của bạn.

2. Nhập email và trang Confluence của bạn.

3. Nếu bạn đang chạy Confluence 7.9 trở lên, hãy tạo Personal Access Token và dán mã đó vào. Nếu bạn đang sử dụng phiên bản cũ hơn, hãy nhập tên người dùng và mật khẩu Confluence của bạn.

4. Nhấp vào Xác thực.

Nhập

1. Nhấp vào Confluence từ menu Nhập.

2. Theo dõi tiến trình nhập của bạn — bước này có thể mất vài giờ đối với các không gian lớn.

   • Khi bạn thấy Importing pages…, bạn có thể đóng cửa sổ trình duyệt một cách an toàn. Chúng tôi sẽ gửi email cho bạn sau khi quá trình nhập hoàn tất.

3. Lặp lại phần này nếu bạn muốn nhập nhiều hơn một không gian làm việc Notion.

• Notion nhập mọi thứ vào một gốc/cha duy nhất trong phần Riêng tư, hoặc vào một không gian nhóm đã chọn của người thực hiện việc nhập.

• Người dùng cần dọn dẹp và thiết lập cấu trúc không gian làm việc trước khi mời người khác.

• Quyền phải được áp dụng lại trong Notion — hãy lên kế hoạch cho một bước sau khi nhập để ánh xạ các nhóm và hạn chế của Confluence sang các nhóm, không gian nhóm và quyền cấp trang của Notion.

• Nếu có tệp hoặc tệp đính kèm trong bảng biểu Confluence, nó sẽ trở thành cơ sở dữ liệu Notion; nếu không, nó sẽ trở thành một bảng biểu đơn giản.

• Kiểu bảng biểu và các macro/plugin thường bị giảm chất lượng (ví dụ: ui-steps, làm nổi bật, chú thích hình ảnh).

• Hầu hết các macro đều không được hỗ trợ. Notion cố gắng ánh xạ dữ liệu sang thành phần nội dung Notion gần nhất.

• Các lỗi tạm thời do sự không ổn định của API Confluence có thể khiến toàn bộ quá trình nhập hoặc một số trang nhất định bị lỗi. Bạn có thể cần thử lại toàn bộ quá trình nhập.

• Đối với nhiều không gian, hãy chạy Nhập tuần tự (từng không gian một) trừ khi sử dụng Nhập nhiều không gian (chỉ dành cho gói Business/Enterprise).

• Lỗi Nhập có thể xảy ra với dữ liệu Confluence phức tạp (ví dụ: ô đã hợp nhất, bảng biểu lồng trong bảng biểu).

• Notion chỉ hỗ trợ mã thông báo API theo phạm vi người dùng (không phải mã thông báo theo phạm vi). Sử dụng tùy chọn mã thông báo API cá nhân khi xác thực.

• Các tệp đính kèm và tệp phương tiện không được tham chiếu trên các trang sẽ không được Nhập.

• Cấu trúc phân cấp đôi khi không được bảo toàn hoàn toàn — hãy xác thực bằng một lần Nhập thử nghiệm.

• Các thành phần nội dung LaTeX Math không được Nhập chính xác

  • Tại sao điều này xảy ra: Định dạng macro của thành phần nội dung LaTeX trong plugin Confluence khác với toán học nội tuyến. Notion hỗ trợ các macro LaTeX nội tuyến nhưng không hỗ trợ biến thể macro của thành phần nội dung.

  • Cách khắc phục: Chuyển đổi các macro của thành phần nội dung LaTeX thành macro nội tuyến trong Confluence trước khi Nhập lại, hoặc đặt LaTeX vào khối mã và chuyển đổi thủ công thành thành phần nội dung toán học sau khi Nhập.

• Không thể Nhập nội dung Gliffy

  • Tại sao điều này xảy ra: Notion không hỗ trợ hình ảnh Gliffy thông qua trình Nhập tệp.

  • Cách khắc phục: Sửa đổi HTML để thay thế thành phần nội dung Gliffy bằng một thành phần nội dung hình ảnh tham chiếu đến tệp chính xác trước khi Nhập.

• Quá trình Nhập đang thất bại

  • Tại sao điều này xảy ra: Không gian quá lớn, Xuất bị lỗi, giới hạn tốc độ hoặc hết thời gian chờ.

  • Cách khắc phục: Nhập từng không gian một, chia các không gian lớn thành các phần, Xuất lại tệp ZIP sạch hoặc sử dụng trình Nhập API với các lượt chạy theo phạm vi.

• Quá trình Nhập bị thiếu hình ảnh hoặc tệp đính kèm

  • Tại sao điều này xảy ra: Tài sản có thể không được đóng gói trong Xuất hoặc không thể truy cập được bằng mã thông báo API.

  • Cách khắc phục: Đảm bảo đã chọn \"Include attachments\" khi Xuất, giữ nguyên các đường dẫn tương đối trong tệp ZIP hoặc tải lại các tài sản chính sau khi Nhập.

• Xem trước liên kết Jira bị hỏng sau khi Nhập

  • Tại sao điều này xảy ra: Xem trước liên kết Jira chỉ hoạt động nếu người dùng được xác thực trước khi Bắt đầu di chuyển.

  • Cách khắc phục: Xác thực với Jira trước khi chạy di chuyển.

• Hệ thống phân cấp tệp không được bảo toàn như mong đợi

  • Tại sao điều này xảy ra: Các trường hợp ngoại lệ trong cấu trúc xuất hoặc lồng ghép sâu.

  • Cách khắc phục: Kiểm tra trước với một tập hợp con đại diện; sắp xếp lại trong Notion sau khi Nhập.

• Các macro Confluence và/hoặc định dạng đặc biệt bị mất:

  • Tại sao điều này xảy ra: Các macro hoặc nội dung ứng dụng không được hỗ trợ.

  • Cách khắc phục: Ánh xạ sang các thành phần nội dung gốc của Notion: mở rộng → chuyển đổi, mục hành động → To-do. Đơn giản hóa các bảng biểu phức tạp hoặc Xuất sang CSV và Nhập vào cơ sở dữ liệu Notion.

• Quyền của Confluence không được sao chép trong Notion:

  • Tại sao điều này xảy ra: Đây là điều bình thường đối với các lần nhập tự thực hiện.

  • Cách khắc phục: Lập kế hoạch và thực hiện ánh xạ quyền sau khi nội dung đã có trong Notion, sử dụng các nhóm, không gian nhóm và quyền ở cấp trang của Notion.