Skip to main content

​
如何開始匯入

在瀏覽器中開啟 docs.craft.do/import/quip，如果尚未登入，請登入你的 Craft 帳戶。

​
取得你的 Quip 存取權杖

Craft 透過你自行產生的個人存取權杖連接 Quip。
1

開啟 Quip 的權杖頁面

在登入你要匯入內容的那個 Quip 帳戶後，前往 quip.com/dev/token。
2

產生並複製權杖

點擊 Get Personal Access Token，然後複製顯示出來的權杖。
存取權杖擁有你 Quip 帳戶中所有內容的完整權限。請勿分享，也不要張貼到任何公開場合。
該權杖讓 Craft 能夠存取你的 Quip 帳戶可見的全部內容——你的私人文件，以及你參與的共用資料夾和群組資料夾。你不需要逐份文件授權。

​
匯入你的文件

1

貼上存取權杖

把權杖貼到匯入頁面的輸入欄位中。
2

選擇目標位置

選擇你希望 Quip 文件出現的 Craft Space。你也可以選擇一個目標資料夾，把匯入的內容集中放在一起。
3

設定選項

如有需要，可開啟包含留言，把 Quip 的留言與文件一起匯入。
4

開始匯入

點擊 Import。匯入過程中會顯示進度列。你可以隨時關閉頁面——匯入會在背景繼續進行。
Quip 會限制讀取資料的速度。如果你的帳戶較大，匯入會自動暫停並繼續，直到全部內容傳輸完畢——幾百份文件可能需要十五分鐘甚至更久。你不需要一直開著頁面。

​
匯入完成後

完成後你會看到一則確認訊息，其中的按鈕可以帶你進入 Craft，在那裡找到匯入的文件。

​
Craft 未能帶過來的內容

Quip 中有些內容在 Craft 裡沒有對應形式，偶爾也會有檔案下載不成功。為了不讓你自己去察覺這些情況，Craft 會在匯入結束後列出所有未能完整帶過來的內容，並附上受影響的文件，方便你逐一查看。 你可能會看到以下幾類：
  • 未能匯入的文件——聊天與簡報，或 Quip 未回傳的文件。
  • 未能下載的圖片或附件——文件已匯入，但不包含這些內容。
  • 以表格形式匯入的 Live App——內容仍在，但不再能互動。
  • 未能匯入的留言——文件匯入時不包含留言。
  • 留言中的附件——留言內文已帶過來，附加的檔案沒有。
  • 失去位置的留言——它們關聯到整份文件，而不是原本所指的那段文字。
出現這樣的摘要是正常的，帳戶較大時尤其如此，而且你的文件已經在 Craft 中了。它的作用是告訴你需要查看哪些內容，而不是提示出了問題。
未被匯入的聊天或簡報在 Craft 中沒有對應文件可開啟，因此只會顯示名稱。其餘項目都會直接連結到匯入後的文件。

​
會被帶過來的內容

標題、粗體、斜體、刪除線、行內程式碼、連結、螢光標示、項目符號與編號清單、待辦清單、表格、程式碼區塊、分隔線與引用。Quip 有底線而 Craft 沒有，因此帶底線的文字會以淺灰色螢光標示的形式匯入——強調效果得以保留，儘管樣式並不完全相同。
你的資料夾結構會在 Craft 中重建，你在 Quip 中加過星號的文件匯入後同樣帶有星號。在 Quip 中，一份文件可以同時位於多個資料夾。Craft 會把每份文件放進其中一個，因此匯入的文件會落在最先找到它的那個資料夾裡。空資料夾不會被重建。
圖片和附件會被下載並重新上傳到 Craft，因此匯入後仍可正常使用——它們不是指回 Quip 的連結。
Quip 試算表會轉換為 Craft 表格，可以直接檢視與編輯。原始的 .xlsx 檔案也會作為附件附在文件上，因此原件的內容不會有任何損失。
它們會轉換為 Craft 集合，你的欄位會成為狀態屬性，每張卡片保留各自的狀態。欄位顏色也會一併保留。
指向其他 Quip 文件與資料夾的連結和提及，會被改寫為指向匯入後的 Craft 版本，因此內部連結仍然有效。指向未包含在這次匯入中的文件的連結，仍會指向 Quip。
Quip 中的日期提及會轉換為真正的 Craft 日期，而不是純文字。
如果啟用包含留言，留言及其回覆會連同原始作者名稱與時間一起匯入，並錨定在其所針對的文字上。

​
限制

以下大多數情況會在匯入後的摘要中列出，讓你知道哪些文件受到影響。下方標註的兩項不會提示，因為對 Craft 來說並沒有缺少任何內容。
  • 聊天與簡報不會被匯入。 Craft 對這兩者都沒有對應形式，因此 Quip 的對話與簡報會被略過。文件與試算表會被匯入。
  • 除看板與 Project Tracker 之外的 Live App（例如行事曆）會以呈現其內容的一般表格形式匯入。資訊仍在，但不再能互動。
  • 留言中的附件不會被匯入。 留言內文仍會帶過來，附加的檔案不會。
  • 部分留言可能失去位置。 如果某則留言所針對的文字在 Quip 的匯出內容中已不存在，該留言會錨定到整份文件，而不是那段文字。內容不會遺失，但可能不在你預期的位置。
  • 範本會作為一般文件匯入（不會提示）。Quip 範本會成為一般的 Craft 文件，而不是 Craft 範本。全部內容都在，只是沒有被設定為範本。
  • Quip 垃圾桶中的文件不會被匯入（不會提示）。Craft 只能看到你的 Quip 帳戶中位於垃圾桶之外的文件。
匯入只會從 Quip 讀取資料。你 Quip 帳戶中的任何內容都不會被移動、編輯或刪除，因此你可以照常使用，並在需要時重新匯入。

​
疑難排解

請確認你從 quip.com/dev/token 完整複製了整個權杖。如果你不確定貼上的權杖是否為目前的權杖，請重新開啟該頁面並複製上面顯示的權杖。
這表示權杖本身有效，但 Craft 透過它沒有看到任何文件。請確認你是在登入正確的 Quip 帳戶時產生權杖的——如果你有多個帳戶，很容易為錯誤的帳戶建立權杖。
這通常是 Quip 的速率限制所致，而不是出了問題。匯入會自動暫停並繼續，關閉頁面後也會繼續執行。帳戶較大時可能需要一段時間。
位於多個 Quip 資料夾中的文件會被放入最先找到的那個資料夾，因此可能不在你預期的位置。如果某份文件完全找不到，請確認它是否是不會被匯入的聊天或簡報，以及它是否在 Quip 的垃圾桶中。
請嘗試重新開始匯入。已經匯入的文件不會重複。如果問題仍然存在，請聯絡支援團隊。