新增/覆蓋記錄用的檔案記載格式

文章編號:040722

以下說明將Excel檔案或CSV檔案匯入已建立的應用程式,大量新增/覆蓋記錄時的檔案記載格式。

另備有各欄位記載格式的樣本檔案,僅供參考。想確認各欄位的記載格式時,請參閱以下頁面並下載檔案。
各欄位記載格式的樣本檔案

欄位名稱的記載方式

建議先在檔案中的欄名(第一列)記載欄位名稱。不記載欄位名稱也可以匯入,但在匯入檔案時,必須個別指定要將哪一欄的資料匯入到哪一個欄位中。事先在檔案中的欄名記載欄位名稱,即可自動對應。

關於在檔案中的欄名中記載欄位名稱的方法,可以直接在檔案中輸入資料,但建議採用從應用程式的記錄清單畫面中的「匯出到檔案」將資料匯出的方法。利用「匯出到檔案」功能,不論是否已登錄記錄,都可以將欄位名稱匯出到檔案。比起直接輸入欄位名稱更節省時間,也能防止輸入錯誤,因此建議採用先匯出檔案,再以該檔案為基礎進行編輯的方法。
將資料匯出到檔案

截圖:欄位名稱的記載方式範例

記錄的記載方式

請在檔案中將每筆記錄的資料記載在一列。

截圖:記錄的記載方式範例

但若記錄中含有表格,則必須配合表格的列數記載在多列中。詳情請參閱以下頁面。
準備新增/覆蓋含有表格的記錄用的檔案

各欄位的值的記載方式

可以從檔案匯入到應用程式中的欄位的格式,取決於各欄位的類型。請參考以下內容,記載符合各欄位格式要求的值。

單行文字方塊、多行文字方塊

截圖:匯入字串欄位的示意圖

  • 請在檔案中記載要登錄到欄位中的內容。
  • 要將多行文字匯入到多行文字方塊欄位時,請在檔案中以換行方式記載。

數值

截圖:匯入數值欄位的示意圖

請在檔案中以下列任一格式記載數值。

  • 整數

  • 小數

  • 負數
    例:-1.23

  • 以科學記號表示的數值
    例:在檔案中輸入「1.20E+03」,應用程式中會登錄為「1200」。

文字編輯方塊

截圖:匯入文字編輯方塊欄位的示意圖

請在檔案中以HTML格式記載內容。

核取方塊、複選

截圖:匯入核取方塊欄位的示意圖

  • 請在檔案中將各選項個別分欄,並在欄的第一列記載「欄位名稱[選項名稱]」。
    例:「交通方式」欄位中有「電車」/「公車」的選項時,請在欄的第一列記載「交通方式[電車]」/「交通方式[公車]」。

  • 請在想選擇的項目儲存格中記載「1」,不選擇的項目儲存格維持空白。

選項按鈕、下拉式選單

截圖:匯入選項按鈕欄位的示意圖

請在檔案中將各欄位個別分欄,並記載想選擇的項目名稱。

日期

截圖:匯入日期欄位的示意圖

  • 在Excel檔案中,可以記載為Excel中可識別為日期的所有格式。

  • 在CSV檔案中,請以下列任一格式記載。

    • YYYY-MM-DD(例:2022-4-1)
    • YYYY/MM/DD(例:2022/4/1)
    • YYYYMMDD(例:20220401)
    • YY/MM/DD(例:22/4/1)
    • MM/DD/YYYY(例:4/1/2022)
    • MM/DD/YY(例:4/1/22)
    • DD/MM/YYYY(例:1/4/2022)
    • DD/MM/YY(例:1/4/22)
  • 1位數的月與日,可以用1位數或2位數的任一格式記載。例如,可將4月記載為「4」或「04」。
    但在CSV檔案中以「YYYYMMDD」格式記載時,請以2位數記載。例如,4月請記載為「04」。

  • 可指定從1000年1月1日0時0分(世界協調時間)到9999年12月31日23時59分(世界協調時間)的日期與時間。

  • 若省略日,匯入應用程式時將轉換為當月1日。
    例:「2022/01」會轉換為「2022/01/01」。

  • 若省略月與日,匯入應用程式時將轉換為1月1日。
    例:「2022」會轉換為「2022/01/01」。

時刻

截圖:匯入時間欄位的示意圖

  • 在Excel檔案中,可以記載為Excel中可識別為時間的所有格式。

  • 在CSV檔案中,請以下列任一格式記載。
    • HH:MM AM/PM
      例:「11:02 PM」
    • HH:MM
      例:「23:02」
  • 1位數的小時與分鐘,可以用1位數或2位數的任一格式記載。例如,可將8點記載為「8」或「08」。

  • 不會匯入記載在檔案中的秒。
    例:「11:01:25」會變為「11:01」。

  • 若省略分,匯入應用程式時將轉換為0分。
    例:「11」會轉換為「11:00」。

日期與時間

截圖:匯入日期與時間欄位的示意圖

  • 在Excel檔案中,可以記載Excel中可識別為日期與時間的所有格式。

  • 在CSV檔案中,請在日期後面加上半形空格,再記載時間。
    例:「2022/01/11 11:01」

  • 不會匯入記載在檔案中的秒。

  • 若省略時間,匯入應用程式時將轉換為0時0分。
    例:「2022/01/11」會轉換為「2022/01/11 00:00」。

  • CSV/TXT/TSV檔案中的記載內容若包含時區,即使在檔案匯入畫面設定時區,該設定仍會被忽略。

  • 在CSV檔案中,請以下列任一格式記載。
    • YYYY-MM-DD HH24:NN
      例:「2022-12-20 23:20」
    • YYYY-MM-DDTHH24:NN
      例:「2022-12-20T23:20」
    • YYYY-MM-DDTHH24:NNZ
      例:「2022-12-20T23:20Z」
    • YYYYMMDDHH24NN
      例:「202212202320」
    • YYYY/MM/DD HH12:NN AM/PM
      例:「2022/12/20 11:20 PM」
    • YYYY/MM/DD HH24:NN
      例:「2022/12/20 23:20」
    • MM/DD/YYYY HH12:NN AM/PM
      例:「12/20/2022 11:20 PM」
    • MM/DD/YYYY HH24:NN
      例:「12/20/2022 23:20」
    • DD/MM/YYYY HH12:NN AM/PM
      例:「20/12/2022 11:20 PM」
    • DD/MM/YYYY HH24:NN
      例:「20/12/2022 23:20」

連結(URL)

截圖:匯入連結(URL)欄位的示意圖

  • 請記載開頭為「http://」或「https://」的網址。

  • 可記載以下文字及符號。
    • 大寫或小寫字母
    • 阿拉伯數字
    • 下列符號
      -_.!~*'():@&=+$,;?/#%
      依照網址的組成,可能會有無法使用部分符號的情形。

連結(電話號碼)

截圖:匯入連結(電話號碼)欄位的示意圖

  • 請記載電話號碼。
  • 有/無連字號皆可。

連結(電子郵件地址)

截圖:匯入連結(電子郵件地址)欄位的示意圖

  • 請記載「(域內部分)@(網域)」格式的電子郵件地址。

  • 域內部分可記載以下文字及符號。

    • 大寫或小寫字母
    • 阿拉伯數字
    • 下列符號
      .!#$'%&*+/=?^_-`{}|~
  • 網域可記載以下文字及符號。

    • 大寫或小寫字母
    • 阿拉伯數字
    • 下列符號
      .-

選擇使用者

截圖:匯入選擇使用者欄位的示意圖

  • 請記載想選擇的使用者的登入名稱。

  • 想選擇多個使用者時,請以換行符號分隔記載登入名稱。

    • 在Excel等程式中編輯檔案時,請在1個儲存格內以換行符號分隔記載使用者的登入名稱。
    • 在文字編輯器中編輯CSV檔案時,請在1個欄中以換行符號分隔記載使用者的登入名稱。
      截圖:文字編輯器中的記載範例
  • 若要登錄訪客,請在訪客的電子郵件地址(登入名稱)的開頭記載「guest/」。

選擇組織

截圖:匯入選擇組織欄位的示意圖

  • 請記載想選擇的組織的組織代碼。

  • 想選擇多個組織時,請以換行符號分隔記載組織代碼。

    • 在Excel等程式中編輯檔案時,請在1個儲存格內以換行符號分隔記載組織代碼。
    • 在文字編輯器中編輯CSV檔案時,請在1個欄中以換行符號分隔記載組織代碼。

選擇群組

截圖:匯入選擇群組欄位的示意圖

  • 請記載想選擇的群組的群組代碼。

  • 想選擇多個群組時,請以換行符號分隔記載群組代碼。

    • 在Excel等程式中編輯檔案時,請在1個儲存格內以換行符號分隔記載群組代碼。
    • 在文字編輯器中編輯CSV檔案時,請在1個欄中以換行符號分隔記載群組代碼。

Lookup

截圖:匯入Lookup欄位的示意圖

  • 請在檔案中記載應用程式的Lookup欄位設定中,指定為「要複製的欄位」的欄位值。
    例:想將值匯入「員工姓名」欄位時,請記載欄位設定中指定為「要複製的欄位」的「姓名」欄位(其他應用程式)的值。

  • 在應用程式的Lookup設定中,指定為「其他要複製的欄位」的欄位,在匯入檔案後將重新取得欄位值。因此不需要在檔案中記載值。

記錄號碼

截圖:匯入記錄號碼的示意圖

  • 要將記錄號碼指定為「大量更新key」時,請記載想覆蓋的記錄的記錄號碼。

  • 想登錄為新記錄的資料列中,記錄號碼請維持空白。

  • 應用程式已設定應用程式代碼時,請只記載記錄號碼,不必包含應用程式代碼。
    設定應用程式代碼

類別

截圖:匯入類別的示意圖

  • 請記載想選擇的類別名稱。

  • 想選擇多個類別時,請以換行符號分隔記載類別名稱。

    • 在Excel等程式中編輯檔案時,請在1個儲存格內以換行符號分隔記載類別名稱。
    • 在文字編輯器中編輯CSV檔案時,請在1個欄中以換行符號分隔記載類別名稱。

表格

截圖:匯入表格的示意圖

  • 請將表格內的各欄位個別分欄記載。

  • 請配合表格的列數,記載1列~多列的值。

  • 檔案的第一欄,請記載如下:

    • 第一列請記載「記錄起始列」。
    • 請在各記錄資料的起始列記載星號「*」,其他列則維持空白。從「*」的列到下一個「*」的前一列為止的值,將匯入為1筆記錄。
  • 更新記錄時,若想在記錄中現有的表格內新增列,請在檔案中新增列,並記載要登錄到表格內欄位的資料。
    若新增的列不是記錄資料的起始列,第一欄「記錄起始列」請維持空白。

  • 要覆蓋現有記錄中表格的資料時,即使有不需要變更的欄位,也請在檔案中記載該表格內的所有欄位的資料。但不用記載會被重新計算/重新取得的欄位資料。

建立人、更新人

截圖:匯入建立人欄位的示意圖

  • 請只記載1個使用者的登入名稱。

  • 建立人/更新人欄位的值,僅限新增記錄時可以匯入。即使在檔案中記載現有記錄的建立人/更新人的值,應用程式的建立人/更新人欄位的值也不會更新。

  • 無法使用以下的值或使用者:

    • 非登入名稱的值
    • 多個使用者
    • 不存在的使用者
    • 已被停用或刪除的使用者
    • 未使用Kintone的使用者
    • 無查看權限的組織的使用者
    • (若為訪客空間內的應用程式)未加入該訪客空間的訪客

建立時間、更新時間

截圖:匯入建立時間欄位的示意圖

  • 在Excel檔案中,可以記載Excel中可識別為日期與時間的所有格式。

  • 在CSV檔案中,請在日期後面加上半形空格,再記載時間。
    例:「2022/1/12 11:26」

  • 只有在新增記錄時可以匯入建立時間/更新時間欄位的值。即使記載現有記錄的建立時間/更新時間的值,應用程式的建立時間/更新時間欄位的值也不會更新。

  • 請記載早於匯入檔案時間點的日期與時間。

  • 不會匯入記載在檔案中的秒。

  • 若省略時間,匯入應用程式時將轉換為0時0分。
    例:「2014/01/11」會轉換為「2014/01/11 00:00」。

  • CSV/TXT/TSV檔案中的記載內容若包含時區,即使在檔案匯入畫面設定時區,該設定仍會被忽略。

  • 在CSV檔案中,請以下列任一格式記載。
    • YYYY-MM-DD HH24:NN
      例:「2022-12-20 23:20」
    • YYYY-MM-DDTHH24:NN
      例:「2022-12-20T23:20」
    • YYYY-MM-DDTHH24:NNZ
      例:「2022-12-20T23:20Z」
    • YYYYMMDDHH24NN
      例:「202212202320」
    • YYYY/MM/DD HH12:NN AM/PM
      例:「2022/12/20 11:20 PM」
    • YYYY/MM/DD HH24:NN
      例:「2022/12/20 23:20」
    • MM/DD/YYYY HH12:NN AM/PM
      例:「12/20/2022 11:20 PM」
    • MM/DD/YYYY HH24:NN
      例:「12/20/2022 23:20」
    • DD/MM/YYYY HH12:NN AM/PM
      例:「20/12/2022 11:20 PM」
    • DD/MM/YYYY HH24:NN
      例:「20/12/2022 23:20」

顯示錯誤訊息,無法匯入檔案

有多個可能原因會導致錯誤,此處介紹幾個常見的原因。

  • 原因:應用程式的欄位設定中勾選了「設為必填項」,但要匯入的檔案中未輸入值。
    處理方式:應用程式的欄位設定中勾選了「設為必填項」時,請在要匯入的檔案中輸入值。

  • 原因:匯入到數值欄位的值,輸入了「1,000萬日圓」等數值以外的值。
    處理方式:匯入到數值欄位的值,請只輸入數值。無法匯入逗號或單位。

  • 原因:匯入到下拉式選單欄位或選項按鈕欄位的值,輸入了設定為選項的項目以外的值。
    處理方式:匯入到下拉式選單欄位或選項按鈕欄位的值,請只輸入應用程式中設定的選項。

  • 原因:匯入到建立人欄位的值,輸入了登入名稱以外的值。
    處理方式:匯入到建立人欄位的值,請只輸入使用者的登入名稱。可以在以下畫面中確認使用者的登入名稱:

    • Kintone共通管理的「組織/使用者」(僅限Kintone共通管理員可確認)
    • 各使用者的用戶URL,或個人資料詳情的URL

除了上述原因外,還有其他可能導致錯誤的原因。詳情請參閱「大量新增/更新記錄失敗時」。

各欄位記載格式的樣本檔案

以下備有各欄位記載格式的樣本檔案,僅供參考。想確認各欄位的記載格式時,請下載以下檔案。

所有欄位的範例檔案.csv