レコード登録・上書き用のファイルの記載形式

記事番号:040722

作成済みのアプリにExcelファイルやCSVファイルを読み込んで、レコードをまとめて登録/上書きする場合の、ファイルの記載形式について説明します。

参考までに、各フィールドの記載形式のサンプルファイルを用意しています。各フィールドの記載形式を確認したい場合は、以下を参照してファイルをダウンロードしてください。
各フィールドの記載形式のサンプルファイル

フィールド名の書きかた

ファイルの列名(先頭行)に、フィールド名を記載しておくことをおすすめします。フィールド名を記載しなくても読み込みは可能ですが、その場合はファイルを読み込む際に、どの列のデータをどのフィールドに読み込むか、個別に指定する必要があります。ファイルの列名にフィールド名を記載しておくと、自動で対応付けされるため、便利です。

ファイルの列名にフィールド名を記載する方法として、ファイルに直接入力する方法もありますが、アプリのレコード一覧画面の「ファイルに書き出す」からデータを書き出す方法をおすすめします。「ファイルに書き出す」を利用すると、レコードが登録されているかどうかにかかわらず、ファイルにフィールド名を書き出すことができます。フィールド名を直接入力するよりも手間がかからず、入力ミスを防ぐこともできるため、先にファイルを書き出し、そのファイルを元に編集する方法をおすすめします。
ファイルにデータを書き出す

スクリーンショット:フィールド名の書きかたの例

レコードの書きかた

ファイルには、1レコードのデータを1行で記載してください。

スクリーンショット:レコードの書きかたの例

ただし、レコードにテーブルが含まれる場合は、テーブルの行数にあわせて複数行で記載する必要があります。詳細は、次のページを参照してください。
テーブルを含むレコードを登録・上書きするためのファイルを準備する

各フィールドの値の書きかた

ファイルからアプリのフィールドに読み込むことができる形式は、フィールドの種類ごとに決まっています。以下を参考にし、各フィールドに適した形式で値を記載してください。

文字列(1行)・文字列(複数行)

スクリーンショット:文字列フィールドの読み込みイメージ

  • ファイルには、フィールドに登録したい内容を記載してください。
  • 文字列(複数行)フィールドに複数行の文字列を読み込みたい場合は、ファイルにも改行を使って複数行で記載してください。

数値

スクリーンショット:数値フィールドの読み込みイメージ

ファイルには、次のいずれかの形式で数値を記載してください。

  • 整数
  • 小数
  • マイナスの数値
    例:-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」

リンク(Webサイトのアドレス)

スクリーンショット:リンク(Webサイトのアドレス)フィールドの読み込みイメージ

  • 「http://」または「https://」で始まるアドレスを記載してください。
  • 次の文字および記号を記載できます。
    • 大文字または小文字のアルファベット
    • アラビア数字
    • 次の記号
      -_.!~*'():@&=+$,;?/#%
      アドレスの構成部位により、一部の記号は使用できない場合があります。

リンク(電話番号)

スクリーンショット:リンク(電話番号)フィールドの読み込みイメージ

  • 電話番号を記載してください。
  • ハイフンあり/なしのどちらで記載しても問題ありません。

リンク(メールアドレス)

スクリーンショット:リンク(メールアドレス)フィールドの読み込みイメージ

  • 「(ローカル部)@(ドメイン)」形式のメールアドレスを記載してください。
  • ローカル部には、次の文字および記号を記載できます。
    • 大文字または小文字のアルファベット
    • アラビア数字
    • 次の記号
      .!#$'%&*+/=?^_-`{}|~
  • ドメインには、次の文字および記号を記載できます。
    • 大文字または小文字のアルファベット
    • アラビア数字
    • 次の記号
      .-

ユーザー選択

スクリーンショット:ユーザー選択フィールドの読み込みイメージ

  • 選択したいユーザーのログイン名を記載してください。
  • 複数のユーザーを選択したい場合は、ログイン名を改行区切りで記載してください。
    • Excelなどでファイルを編集する場合は、1つのセル内に、ユーザーのログイン名を改行区切りで記載してください。
    • テキストエディターでCSVファイルを編集する場合は、1つのカラムの中で、ユーザーのログイン名を改行区切りで記載してください。
      スクリーンショット:テキストエディターでの記載例
  • ゲストユーザーを登録したい場合は、ゲストユーザーのメールアドレス(ログイン名)の先頭に「guest/」を記載してください。

組織選択

スクリーンショット:組織選択フィールドの読み込みイメージ

  • 選択したい組織の組織コードを記載してください。

  • 複数の組織を選択したい場合は、組織コードを改行区切りで記載してください。

    • Excelなどでファイルを編集する場合は、1つのセル内に、組織コードを改行区切りで記載してください。
    • テキストエディターでCSVファイルを編集する場合は、1つのカラムの中で、組織コードを改行区切りで記載してください。

グループ選択

スクリーンショット:グループ選択フィールドの読み込みイメージ

  • 選択したいグループのグループコードを記載してください。

  • 複数のグループを選択したい場合は、グループコードを改行区切りで記載してください。

    • Excelなどでファイルを編集する場合は、1つのセル内に、グループコードを改行区切りで記載してください。
    • テキストエディターでCSVファイルを編集する場合は、1つのカラムの中で、グループコードを改行区切りで記載してください。

ルックアップ

スクリーンショット:ルックアップフィールドの読み込みイメージ

  • ファイルには、アプリのルックアップフィールドの設定で「コピー元のフィールド」に指定されているフィールドの値を記載してください。
    例:「従業員名」フィールドに値を読み込みたい場合、フィールドの設定で「コピー元のフィールド」に指定されている「氏名」フィールド(別アプリ)の値を記載します。
  • アプリのルックアップフィールドの設定で、「ほかのフィールドのコピー」に指定されているフィールドは、ファイルを読み込んだ後に再取得されます。そのため、ファイルに値を記載する必要はありません。

レコード番号

スクリーンショット:レコード番号の読み込みイメージ

  • レコード番号を「一括更新のキー」に指定する場合は、上書きしたいレコードのレコード番号を記載してください。
  • 新しいレコードとして登録したいデータの行では、レコード番号は空にしてください。
  • アプリにアプリコードを設定している場合は、アプリコードを含めずに、レコード番号だけを記載してください。
    アプリコードを設定する

カテゴリー

スクリーンショット:カテゴリーの読み込みイメージ

  • 選択したいカテゴリー名を記載してください。
  • 複数のカテゴリーを選択したい場合は、カテゴリー名を改行区切りで記載してください。
    • 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万円」など数値以外の値が入力されている。
    対処方法:数値フィールドに読み込む値には、数値のみを入力してください。カンマや単位は読み込めません。
  • 原因:ドロップダウンフィールドやラジオボタンフィールドに読み込む値として、選択肢として設定された項目以外の値が入力されている。
    対処方法:ドロップダウンフィールドやラジオボタンフィールドに読み込む値には、アプリで設定されている選択肢のみを入力してください。
  • 原因:作成者フィールドに読み込む値として、ログイン名以外の値が入力されている。
    対処方法:作成者フィールドに読み込む値には、ユーザーのログイン名のみを入力してください。ユーザーのログイン名は、以下から確認できます。
    • cybozu.com共通管理の「組織/ユーザー」(cybozu.com共通管理者のみ確認可能)
    • 各ユーザーのピープルのURL、またはプロフィール詳細のURL

上記以外にも、エラーが発生する原因は複数あります。詳細は「レコードの一括登録/更新に失敗した場合」を参照してください。

各フィールドの記載形式のサンプルファイル

参考として、各フィールドの記載形式のサンプルファイルを用意しています。各フィールドの記載形式を確認したい場合は、次の全フィールドのサンプルファイルをダウンロードしてください。
sample_all_fields_app.csv