匯出和匯入都在資料表設定的「匯入匯出」分頁。這個分頁只有存過的資料表才有;還在建立中的新資料表沒有。怎麼打開資料表的設定,請看建立與設定資料表。
這個分頁上有「匯出資料」、「匯入資料」和「最近的匯入」。
匯出資料
打得開這個資料表的人,都可以匯出。匯出的只有你本來就看得到的資料,而且不包括封存的資料和垃圾桶裡的資料。
- 「人員欄位處理方式」:「以人員電子郵件匯出」(一開始選的是這個),或「以人員名稱匯出」。選名稱時,下面會寫「兩個人可能同名,匯入時同名的人會對不到,建議用電子郵件。」
- 按鈕上面的說明框,會寫出有幾筆資料會匯出。這個數字只算上面說的那些資料。所以就算框裡寫「這個資料表還沒有資料,沒有東西可以匯出。」,資料表裡還是可能有封存的資料,或你看不到的資料。封存的資料,可以在表格上方「篩選」的資料狀態選「封存」來看。
- 數字是零的時候,「匯出資料」按鈕是灰的。數字讀不到時,框裡會寫「現在讀不到資料筆數,還是可以匯出。」,這時還是可以匯出。
- 按「匯出資料」,瀏覽器就會下載一個 CSV 檔案。檔名是資料表的名字加上日期。匯出失敗時,畫面會顯示網站回答的訊息;沒有訊息時,會顯示「無法匯出資料表。」。
- 這個檔案用 Excel 打開時,中文不會變成亂碼。
檔案裡有什麼:
- 第一行是每一欄的名字,下面一筆資料一行。
- 「標題」那一欄是每一筆資料的標題。
- 其他每一個欄位各一欄,欄名就是欄位的名字。隱藏的欄位也會匯出。
- 型態是「建立者」、「建立時間」或「更新時間」的欄位,永遠不會匯出。
- 內文和內文裡的圖片不會匯出。
- 檔案裡沒有資料表的名字,也沒有日期;它們只在檔名上。
每一格的樣子:
- 「選項」:選項的名字。
- 「人員」:這個人的電子郵件;選「以人員名稱匯出」時,是他的名字。
- 「數字」:數字。
- 「選擇日期時間區間」的「日期時間」:開始和結束,中間用「 ~ 」接起來。
- 「核取方塊」:這個欄位自己的「是」或「否」的字。
- 一個欄位有好幾個值時,都放在同一格,中間用逗號隔開。
資料的順序是它們建立的順序,不是表格上排序的順序。
匯入資料
只有可以在這個資料表新增資料的人,才看得到「匯入資料」:專案角色要有「建立資料」這項權限,而且你可以編輯這個資料表。這和資料集頁的「新增資料」按鈕是同一群人。
- 先把 CSV 檔案拖到「上傳 CSV 檔案」的框上,或按這個框選一個檔案。
- 網站會先檢查這個檔案(框上會顯示「檢查中…」),然後顯示一段摘要,說匯入之後會發生什麼事。這時資料表裡還沒有多任何一筆資料。
- 看完摘要,設定下面的「選項欄位處理方式」和「人員欄位處理方式」。
- 按「匯入資料」。
「上傳 CSV 檔案」框上的說明說:檔案的第一行要是欄位的名字,「標題」那一欄是每一筆資料的標題,而且檔案最多 5 MB。檔案比這個大時,瀏覽器不會送出它,會直接說檔案太大了。
框的下面寫著「匯入只會新增資料,不會改到或刪掉本來就有的資料。」匯入的每一筆資料,在它的版本紀錄裡,第一筆寫著匯入它的人。
摘要
摘要裡會有這樣的句子(N 是數字):
- 「會新增 N 筆資料,本來就有的資料不會變動。」
- 「這個資料表沒有這些欄位,會略過:」,後面接欄名。
- 「選項」欄位有檔案裡的選項它沒有時:「「欄位名稱」會新增這些選項:」或「「欄位名稱」沒有這些選項,這些格子會留空:」,後面接選項的名字,看「選項欄位處理方式」怎麼選。
- 「人員」欄位的比對結果:有幾個人用電子郵件或名稱對到了、哪些名字有兩個人以上同名、哪些人對不到。對不到的人不會寫進去:只放一個人的欄位,那一格會留空;可以放好幾個人的欄位,那一格裡其他對得到的人會留著。
改「選項欄位處理方式」或「人員欄位處理方式」時,摘要會馬上跟著改,不用再檢查一次。
會被拒絕的檔案
檔案有下面這些問題時,不能匯入,會顯示這些訊息:
- 「這個檔案讀不開。」
- 「這個檔案是空的。」
- 「這個檔案的第一行讀不出欄位名稱。」
- 「這個檔案裡沒有任何資料。」
- 「這個檔案的欄位名稱和這個資料表對不起來,沒有東西可以匯入。」
欄和欄位怎麼對起來
- 檔案的每一欄,用欄名和資料表的欄位名字對,名字要一樣。所以從另一個欄位名字一樣的資料表匯出的檔案,也可以匯入。
- 資料表沒有的欄名,那一欄會被略過。
- 欄名和「建立者」、「建立時間」或「更新時間」型態的欄位一樣時,那一欄也會被略過,因為這些欄位由網站自己填。摘要會把它們列在「這個資料表沒有這些欄位」裡,就算資料表真的有這個欄位。
- 至少要有一欄的欄名和一個欄位一樣,而且那一欄裡有值,才能匯入。所以只有「標題」的檔案會被拒絕。
- 匯入不會新增欄位。請先在「客製欄位」分頁,用和檔案欄名一樣的名字建立欄位,再匯入。
選項和人員的設定
「選項欄位處理方式」決定檔案裡有、但「選項」欄位裡沒有的選項怎麼辦:
- 「忽略不存在的選項」:不寫進這個選項。只放一個選項的欄位,那一格會留空;可以放好幾個選項的欄位,那一格裡其他有的選項會留著。
- 「新增不存在的選項」:把它加成這個欄位的新選項。
只有可以改這個資料表欄位的人,才可以選。其他人看到的是「檔案裡沒有的選項會忽略,那些格子會留空。」
「人員欄位處理方式」決定怎麼找到檔案裡寫的人:「比對電子郵件和名稱」(一開始選的是這個)、「只比對電子郵件」或「只比對名稱」。
- 電子郵件會先比對。
- 兩個人以上同名時,這個名字誰都對不到,就像對不到的人一樣不會寫進去。
- 只對得到這個資料表所在專案的成員。
按下「匯入資料」之後
- 匯入會在背景做,下面會寫「匯入已經開始,會在背景執行;關掉視窗也不會停。」
- 匯入只會新增資料。同一個檔案匯入兩次,每一筆都會新增兩次。
- 檔案裡空的格子,那個欄位就不填。
- 欄位不能接受的值會留空,並記下一個警告,但那一筆資料還是會新增。
- 匯入失敗時,一筆資料都不會新增。
- 新的資料屬於開始這個匯入的人,而且跟著資料表的分享設定。資料表是公開的話,新的資料也是公開的。
- 同一次匯入只能開始一次。
最近的匯入
「最近的匯入」列出這個資料表最近的匯入,不管是誰匯入的。還在排隊或進行中的在最上面,其他的越新越上面。打得開這個資料表的人都看得到。
每一個匯入會顯示:
- 狀態:「還沒開始」、「排隊中」、「進行中」、「完成」或「失敗」。
- 誰開始的,以及時間。
- 結束或還沒開始的匯入,會寫「新增 N 筆,M 個值留空。」
- 失敗的原因。
- 警告,例如哪一個欄位的哪一個值留空了幾次。
還沒有任何匯入時,會寫「這個資料表還沒有匯入過。」
選好檔案、檢查過之後,就已經有一個「還沒開始」的匯入了。 它不會自己開始。你沒有按「匯入資料」就關掉,它會一直是「還沒開始」,直到下面說的清理把它刪掉。要匯入這個檔案,請再選一次檔案,再按「匯入資料」。
網站每天會清理一次:已經結束,或從來沒開始的匯入,超過 30 天就會被刪掉。還在排隊或進行中的匯入,不管多久都不會被刪掉。
匯入完成的通知
匯入結束時,開始這個匯入的人會在使用者選單的鈴鐺收到一則通知:
- 成功時,標題是「「資料表名稱」匯入完成」,下面寫新增了幾筆、幾個值留空。
- 失敗時,標題是「「資料表名稱」匯入失敗」,下面寫失敗的原因。
按這則通知,會打開這個資料表的設定,停在「匯入匯出」分頁。
如果你正在資料集頁看著這個資料表,匯入結束時,打開著的「最近的匯入」會自己更新;匯入成功時,表格也會自己重新讀一次。
匯入失敗的原因
匯入開始之後,還是可能失敗,例如:
- 「開始這個匯入的人已經沒有權限在這個資料表新增資料。」
- 「這個匯入的專案已經不在了,沒辦法比對人員。」
失敗的匯入,一筆資料都不會新增。