使用說明 使用說明
Workspace

匯出與匯入 CSV

把資料表的資料匯出成 CSV 檔案、從 CSV 檔案匯入資料、最近的匯入,以及匯入完成的通知。

本頁內容 10

匯出和匯入都在資料表設定的「匯入匯出」分頁。這個分頁只有存過的資料表才有;還在建立中的新資料表沒有。怎麼打開資料表的設定,請看建立與設定資料表。

這個分頁上有「匯出資料」、「匯入資料」和「最近的匯入」。

匯出資料

打得開這個資料表的人,都可以匯出。匯出的只有你本來就看得到的資料,而且不包括封存的資料和垃圾桶裡的資料。

  • 「人員欄位處理方式」:「以人員電子郵件匯出」(一開始選的是這個),或「以人員名稱匯出」。選名稱時,下面會寫「兩個人可能同名,匯入時同名的人會對不到,建議用電子郵件。」
  • 按鈕上面的說明框,會寫出有幾筆資料會匯出。這個數字只算上面說的那些資料。所以就算框裡寫「這個資料表還沒有資料,沒有東西可以匯出。」,資料表裡還是可能有封存的資料,或你看不到的資料。封存的資料,可以在表格上方「篩選」的資料狀態選「封存」來看。
  • 數字是零的時候,「匯出資料」按鈕是灰的。數字讀不到時,框裡會寫「現在讀不到資料筆數,還是可以匯出。」,這時還是可以匯出。
  • 按「匯出資料」,瀏覽器就會下載一個 CSV 檔案。檔名是資料表的名字加上日期。匯出失敗時,畫面會顯示網站回答的訊息;沒有訊息時,會顯示「無法匯出資料表。」。
  • 這個檔案用 Excel 打開時,中文不會變成亂碼。

檔案裡有什麼:

  • 第一行是每一欄的名字,下面一筆資料一行。
  • 「標題」那一欄是每一筆資料的標題。
  • 其他每一個欄位各一欄,欄名就是欄位的名字。隱藏的欄位也會匯出。
  • 型態是「建立者」、「建立時間」或「更新時間」的欄位,永遠不會匯出。
  • 內文和內文裡的圖片不會匯出。
  • 檔案裡沒有資料表的名字,也沒有日期;它們只在檔名上。

每一格的樣子:

  • 「選項」:選項的名字。
  • 「人員」:這個人的電子郵件;選「以人員名稱匯出」時,是他的名字。
  • 「數字」:數字。
  • 「選擇日期時間區間」的「日期時間」:開始和結束,中間用「 ~ 」接起來。
  • 「核取方塊」:這個欄位自己的「是」或「否」的字。
  • 一個欄位有好幾個值時,都放在同一格,中間用逗號隔開。

資料的順序是它們建立的順序,不是表格上排序的順序。

匯入資料

只有可以在這個資料表新增資料的人,才看得到「匯入資料」:專案角色要有「建立資料」這項權限,而且你可以編輯這個資料表。這和資料集頁的「新增資料」按鈕是同一群人。

  • 先把 CSV 檔案拖到「上傳 CSV 檔案」的框上,或按這個框選一個檔案。
  • 網站會先檢查這個檔案(框上會顯示「檢查中…」),然後顯示一段摘要,說匯入之後會發生什麼事。這時資料表裡還沒有多任何一筆資料。
  • 看完摘要,設定下面的「選項欄位處理方式」和「人員欄位處理方式」。
  • 按「匯入資料」。

「上傳 CSV 檔案」框上的說明說:檔案的第一行要是欄位的名字,「標題」那一欄是每一筆資料的標題,而且檔案最多 5 MB。檔案比這個大時,瀏覽器不會送出它,會直接說檔案太大了。

框的下面寫著「匯入只會新增資料,不會改到或刪掉本來就有的資料。」匯入的每一筆資料,在它的版本紀錄裡,第一筆寫著匯入它的人。

摘要

摘要裡會有這樣的句子(N 是數字):

  • 「會新增 N 筆資料,本來就有的資料不會變動。」
  • 「這個資料表沒有這些欄位,會略過:」,後面接欄名。
  • 「選項」欄位有檔案裡的選項它沒有時:「「欄位名稱」會新增這些選項:」或「「欄位名稱」沒有這些選項,這些格子會留空:」,後面接選項的名字,看「選項欄位處理方式」怎麼選。
  • 「人員」欄位的比對結果:有幾個人用電子郵件或名稱對到了、哪些名字有兩個人以上同名、哪些人對不到。對不到的人不會寫進去:只放一個人的欄位,那一格會留空;可以放好幾個人的欄位,那一格裡其他對得到的人會留著。

改「選項欄位處理方式」或「人員欄位處理方式」時,摘要會馬上跟著改,不用再檢查一次。

會被拒絕的檔案

檔案有下面這些問題時,不能匯入,會顯示這些訊息:

  • 「這個檔案讀不開。」
  • 「這個檔案是空的。」
  • 「這個檔案的第一行讀不出欄位名稱。」
  • 「這個檔案裡沒有任何資料。」
  • 「這個檔案的欄位名稱和這個資料表對不起來,沒有東西可以匯入。」

欄和欄位怎麼對起來

  • 檔案的每一欄,用欄名和資料表的欄位名字對,名字要一樣。所以從另一個欄位名字一樣的資料表匯出的檔案,也可以匯入。
  • 資料表沒有的欄名,那一欄會被略過。
  • 欄名和「建立者」、「建立時間」或「更新時間」型態的欄位一樣時,那一欄也會被略過,因為這些欄位由網站自己填。摘要會把它們列在「這個資料表沒有這些欄位」裡,就算資料表真的有這個欄位。
  • 至少要有一欄的欄名和一個欄位一樣,而且那一欄裡有值,才能匯入。所以只有「標題」的檔案會被拒絕。
  • 匯入不會新增欄位。請先在「客製欄位」分頁,用和檔案欄名一樣的名字建立欄位,再匯入。

選項和人員的設定

「選項欄位處理方式」決定檔案裡有、但「選項」欄位裡沒有的選項怎麼辦:

  • 「忽略不存在的選項」:不寫進這個選項。只放一個選項的欄位,那一格會留空;可以放好幾個選項的欄位,那一格裡其他有的選項會留著。
  • 「新增不存在的選項」:把它加成這個欄位的新選項。

只有可以改這個資料表欄位的人,才可以選。其他人看到的是「檔案裡沒有的選項會忽略,那些格子會留空。」

「人員欄位處理方式」決定怎麼找到檔案裡寫的人:「比對電子郵件和名稱」(一開始選的是這個)、「只比對電子郵件」或「只比對名稱」。

  • 電子郵件會先比對。
  • 兩個人以上同名時,這個名字誰都對不到,就像對不到的人一樣不會寫進去。
  • 只對得到這個資料表所在專案的成員。

按下「匯入資料」之後

  • 匯入會在背景做,下面會寫「匯入已經開始,會在背景執行;關掉視窗也不會停。」
  • 匯入只會新增資料。同一個檔案匯入兩次,每一筆都會新增兩次。
  • 檔案裡空的格子,那個欄位就不填。
  • 欄位不能接受的值會留空,並記下一個警告,但那一筆資料還是會新增。
  • 匯入失敗時,一筆資料都不會新增。
  • 新的資料屬於開始這個匯入的人,而且跟著資料表的分享設定。資料表是公開的話,新的資料也是公開的。
  • 同一次匯入只能開始一次。

最近的匯入

「最近的匯入」列出這個資料表最近的匯入,不管是誰匯入的。還在排隊或進行中的在最上面,其他的越新越上面。打得開這個資料表的人都看得到。

每一個匯入會顯示:

  • 狀態:「還沒開始」、「排隊中」、「進行中」、「完成」或「失敗」。
  • 誰開始的,以及時間。
  • 結束或還沒開始的匯入,會寫「新增 N 筆,M 個值留空。」
  • 失敗的原因。
  • 警告,例如哪一個欄位的哪一個值留空了幾次。

還沒有任何匯入時,會寫「這個資料表還沒有匯入過。」

選好檔案、檢查過之後,就已經有一個「還沒開始」的匯入了。 它不會自己開始。你沒有按「匯入資料」就關掉,它會一直是「還沒開始」,直到下面說的清理把它刪掉。要匯入這個檔案,請再選一次檔案,再按「匯入資料」。

網站每天會清理一次:已經結束,或從來沒開始的匯入,超過 30 天就會被刪掉。還在排隊或進行中的匯入,不管多久都不會被刪掉。

匯入完成的通知

匯入結束時,開始這個匯入的人會在使用者選單的鈴鐺收到一則通知:

  • 成功時,標題是「「資料表名稱」匯入完成」,下面寫新增了幾筆、幾個值留空。
  • 失敗時,標題是「「資料表名稱」匯入失敗」,下面寫失敗的原因。

按這則通知,會打開這個資料表的設定,停在「匯入匯出」分頁。

如果你正在資料集頁看著這個資料表,匯入結束時,打開著的「最近的匯入」會自己更新;匯入成功時,表格也會自己重新讀一次。

匯入失敗的原因

匯入開始之後,還是可能失敗,例如:

  • 「開始這個匯入的人已經沒有權限在這個資料表新增資料。」
  • 「這個匯入的專案已經不在了,沒辦法比對人員。」

失敗的匯入,一筆資料都不會新增。