> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Nhập từ Quip

> Nhập tài liệu, bảng tính và thư mục Quip trực tiếp vào Craft mà không cần xuất tệp.

## Cách bắt đầu nhập

Mở [docs.craft.do/import/quip](https://docs.craft.do/import/quip) trong trình duyệt và đăng nhập vào tài khoản Craft nếu bạn chưa đăng nhập.

## Lấy mã truy cập Quip của bạn

Craft kết nối với Quip bằng mã truy cập cá nhân do chính bạn tạo.

<Steps>
  <Step title="Mở trang mã truy cập của Quip">
    Truy cập [quip.com/dev/token](https://quip.com/dev/token) khi đang đăng nhập vào tài khoản Quip mà bạn muốn nhập dữ liệu từ đó.
  </Step>

  <Step title="Tạo và sao chép mã">
    Nhấp **Get Personal Access Token** rồi sao chép mã hiển thị.

    <Warning title="Hãy coi mã truy cập như mật khẩu">
      Mã truy cập cho phép truy cập đầy đủ vào mọi thứ trong tài khoản Quip của bạn. Đừng chia sẻ và đừng đăng nó ở nơi công khai.
    </Warning>
  </Step>
</Steps>

<Info title="Những tài liệu nào sẽ được nhập">
  Mã truy cập cho phép Craft xem mọi thứ mà tài khoản Quip của bạn nhìn thấy: tài liệu riêng tư của bạn, cùng các thư mục chia sẻ và thư mục nhóm mà bạn tham gia. Bạn không cần cấp quyền cho từng tài liệu.
</Info>

## Nhập tài liệu của bạn

<Steps>
  <Step title="Dán mã truy cập">
    Dán mã vào ô trên trang nhập.
  </Step>

  <Step title="Chọn nơi lưu">
    Chọn **Craft Space** nơi bạn muốn tài liệu Quip xuất hiện. Bạn cũng có thể chọn **thư mục đích** để giữ nội dung đã nhập ở cùng một chỗ.
  </Step>

  <Step title="Thiết lập tùy chọn">
    Nếu muốn, hãy bật **Bao gồm bình luận** để đưa bình luận Quip vào cùng với tài liệu.
  </Step>

  <Step title="Bắt đầu nhập">
    Nhấp **Import**. Bạn sẽ thấy thanh tiến trình trong lúc tài liệu được nhập. Bạn có thể đóng trang bất cứ lúc nào — quá trình nhập vẫn tiếp tục chạy nền.
  </Step>
</Steps>

<Tip title="Tài khoản lớn sẽ mất thời gian">
  Quip giới hạn tốc độ đọc dữ liệu. Nếu tài khoản của bạn lớn, quá trình nhập sẽ tự tạm dừng rồi tiếp tục cho đến khi xong — vài trăm tài liệu có thể mất mười lăm phút hoặc hơn. Bạn không cần giữ trang mở.
</Tip>

## Sau khi nhập

Khi hoàn tất, bạn sẽ thấy thông báo xác nhận kèm nút đưa bạn đến Craft, nơi bạn tìm thấy các tài liệu đã nhập.

## Những gì Craft không thể mang sang

Một số thứ trong Quip không có tương ứng trong Craft, và đôi khi một tệp không tải xuống được. Thay vì để bạn tự phát hiện, Craft liệt kê sau khi nhập xong tất cả những gì không mang sang trọn vẹn, kèm theo các tài liệu liên quan để bạn kiểm tra.

Bạn có thể thấy những mục sau:

* **Tài liệu không nhập được** — cuộc trò chuyện và bản trình chiếu, hoặc tài liệu mà Quip không trả về.
* **Hình ảnh hoặc tệp đính kèm không tải xuống được** — tài liệu vẫn được nhập nhưng thiếu chúng.
* **Live App được nhập dưới dạng bảng** — nội dung vẫn còn, nhưng không còn tương tác được.
* **Bình luận không nhập được** — tài liệu được nhập mà không có chúng.
* **Tệp đính kèm trong bình luận** — nội dung bình luận vẫn được mang sang, tệp đính kèm thì không.
* **Bình luận bị mất vị trí** — chúng gắn với cả tài liệu thay vì đoạn văn mà chúng đề cập.

<Check title="Điều này không có nghĩa là việc nhập đã thất bại">
  Bản tóm tắt như vậy là bình thường, nhất là với tài khoản lớn, và tài liệu của bạn đã có trong Craft. Nó giúp bạn biết chính xác cần xem lại điều gì, chứ không phải báo rằng có gì đó sai.
</Check>

<Info title="Không phải mục nào trong danh sách cũng mở được">
  Cuộc trò chuyện hoặc bản trình chiếu không được nhập thì không có tài liệu Craft nào để mở, nên chỉ hiển thị tên. Những mục còn lại đều liên kết trực tiếp đến tài liệu đã nhập.
</Info>

## Những gì được mang sang

<AccordionGroup>
  <Accordion title="Tài liệu và định dạng">
    Tiêu đề, in đậm, in nghiêng, gạch ngang, mã nội dòng, liên kết, đánh dấu, danh sách gạch đầu dòng và đánh số, danh sách việc cần làm, bảng, khối mã, đường phân cách và trích dẫn.

    Quip có gạch chân còn Craft thì không, nên văn bản gạch chân sẽ được đánh dấu bằng nền xám nhạt — phần nhấn mạnh vẫn giữ được dù kiểu định dạng không hoàn toàn giống.
  </Accordion>

  <Accordion title="Thư mục và tài liệu được gắn sao">
    Cấu trúc thư mục của bạn được tái tạo trong Craft, và các tài liệu bạn đã gắn sao trong Quip sẽ được gắn sao khi sang Craft.

    Trong Quip, một tài liệu có thể nằm trong nhiều thư mục cùng lúc. Craft đặt mỗi tài liệu vào một thư mục, nên tài liệu đã nhập sẽ nằm ở thư mục đầu tiên tìm thấy nó. Thư mục rỗng không được tái tạo.
  </Accordion>

  <Accordion title="Hình ảnh và tệp đính kèm">
    Hình ảnh và tệp đính kèm được tải xuống rồi tải lại lên Craft, nên vẫn hoạt động sau khi nhập — chúng không chỉ là liên kết trỏ ngược về Quip.
  </Accordion>

  <Accordion title="Bảng tính">
    Bảng tính Quip trở thành bảng trong Craft, bạn có thể đọc và chỉnh sửa ngay tại chỗ. Tệp `.xlsx` gốc cũng được đính kèm vào tài liệu, nên không mất gì so với bản gốc.
  </Accordion>

  <Accordion title="Bảng Kanban và Project Tracker">
    Chúng trở thành bộ sưu tập trong Craft, với các cột thành thuộc tính trạng thái và mỗi thẻ giữ trạng thái của nó. Màu cột cũng được giữ nguyên.
  </Accordion>

  <Accordion title="Liên kết giữa các tài liệu">
    Liên kết và lượt nhắc trỏ đến tài liệu, thư mục Quip khác sẽ được viết lại để trỏ đến bản đã nhập trong Craft, nhờ vậy liên kết nội bộ vẫn hoạt động. Liên kết đến tài liệu không nằm trong lần nhập này vẫn trỏ về Quip.
  </Accordion>

  <Accordion title="Ngày tháng">
    Các lượt nhắc ngày trong Quip trở thành ngày thật trong Craft thay vì chỉ là văn bản.
  </Accordion>

  <Accordion title="Bình luận">
    Nếu bạn bật **Bao gồm bình luận**, bình luận và các phản hồi sẽ được mang sang cùng tên tác giả và thời gian gốc, gắn với đoạn văn bản mà chúng đề cập.
  </Accordion>
</AccordionGroup>

## Giới hạn

Phần lớn các trường hợp dưới đây sẽ được nêu trong bản tóm tắt sau khi nhập, để bạn biết những tài liệu nào bị ảnh hưởng. Hai mục được đánh dấu thì không được báo, vì với Craft không có gì bị thiếu để báo cả.

* **Cuộc trò chuyện và bản trình chiếu không được nhập.** Craft không có tính năng tương ứng với cả hai, nên hội thoại và bài trình bày trong Quip sẽ bị bỏ qua. Tài liệu và bảng tính thì vẫn được nhập.
* **Các Live App khác ngoài bảng Kanban và Project Tracker** — ví dụ như lịch — được nhập dưới dạng bảng thường hiển thị nội dung. Thông tin vẫn còn, nhưng không còn tương tác được.
* **Tệp đính kèm trong bình luận không được nhập.** Nội dung bình luận vẫn được mang sang; tệp đính kèm thì không.
* **Một số bình luận có thể mất vị trí.** Nếu đoạn văn bản mà bình luận đề cập không còn trong bản xuất của Quip, bình luận sẽ gắn với toàn bộ tài liệu thay vì đoạn đó. Không mất nội dung, nhưng có thể không nằm ở nơi bạn mong đợi.
* **Mẫu được nhập như tài liệu thông thường** *(không được báo)*. Mẫu của Quip sẽ thành tài liệu Craft bình thường, không phải mẫu của Craft. Toàn bộ nội dung vẫn còn — chỉ là nó không được thiết lập như một mẫu.
* **Tài liệu trong thùng rác của Quip không được nhập** *(không được báo)*. Craft chỉ thấy những tài liệu mà tài khoản Quip của bạn giữ bên ngoài thùng rác.

<Info title="Tài khoản Quip của bạn không bị thay đổi">
  Việc nhập chỉ đọc dữ liệu từ Quip. Không có gì trong tài khoản Quip bị di chuyển, chỉnh sửa hay xóa, nên bạn vẫn dùng bình thường và có thể nhập lại nếu cần.
</Info>

## Khắc phục sự cố

<AccordionGroup>
  <Accordion title="Mã truy cập Quip không hợp lệ">
    Hãy kiểm tra xem bạn đã sao chép đầy đủ mã từ [quip.com/dev/token](https://quip.com/dev/token) chưa. Nếu bạn không chắc mã đã dán có phải mã hiện tại hay không, hãy mở lại trang đó và sao chép mã đang hiển thị.
  </Accordion>

  <Accordion title="Không tìm thấy tài liệu nào">
    Điều này nghĩa là mã hoạt động nhưng Craft không thấy tài liệu nào qua mã đó. Hãy chắc chắn bạn đã tạo mã khi đang đăng nhập đúng tài khoản Quip — nếu bạn có nhiều tài khoản, rất dễ tạo mã cho nhầm tài khoản.
  </Accordion>

  <Accordion title="Quá trình nhập mất nhiều thời gian">
    Thường là do giới hạn tốc độ của Quip chứ không phải lỗi. Quá trình nhập tự tạm dừng rồi chạy tiếp, và vẫn chạy sau khi bạn đóng trang. Tài khoản lớn có thể mất một lúc.
  </Accordion>

  <Accordion title="Thiếu tài liệu hoặc tài liệu nằm sai thư mục">
    Tài liệu nằm trong nhiều thư mục Quip sẽ được đặt vào thư mục đầu tiên tìm thấy, nên có thể không ở nơi bạn mong đợi. Nếu tài liệu mất hẳn, hãy kiểm tra xem đó có phải cuộc trò chuyện hay bản trình chiếu không (những thứ không được nhập), và xem nó có nằm trong thùng rác của Quip không.
  </Accordion>

  <Accordion title="Nhập không thành công">
    Hãy thử chạy lại quá trình nhập. Những tài liệu đã được mang sang sẽ không bị trùng lặp. Nếu vẫn còn lỗi, hãy liên hệ bộ phận hỗ trợ.
  </Accordion>
</AccordionGroup>