インポートとエクスポート
フォームから、そのレコードを Excel・CSV・JSON に エクスポート したり、レコードを インポート し直したりできます。どちらも現在のフォームが対象で、エクスポートはフォーム名に _export を付けて命名されます(例:Invoices_export)。
インポートの最良の方法は、エクスポートから始めることです。 アップロードしたワークブックはアプリの構造のみを定義するため(値はインポートされません)、データを確実に読み込むには、エクスポートファイルのレイアウトに正確に合わせます。まずフォームをエクスポートして — レコードがなくても — 正しい列見出し(
Record ID 列や明細列を含む)を持つファイルを取得します。行を記入し、同じ列を同じ順序で保ち、インポートします。- インポートは更新と追加を行います。 既存レコードに一致する行はそれを更新し、一致しない行は新規作成されます。
- キーによるアップサート: フォームが
keyフィールドを定義している場合、インポートはそれらのキー値に一致する既存レコードを更新します。キーがない場合は、Record ID列が更新と作成のどちらかを制御します。 - auto フィールドはインポート時にシステムが設定します:
auto列の値は既存レコードを更新のために照合する用途のみに使われ、新規行には常に新しい値(連番またはulid/nanoid)が割り当てられます(セルに値があっても同様)。作成したい行ではauto列を空のままにしてください。 - マスクされた値は再インポートされません: エクスポートでは機微フィールドが
••••••と表示されます。そのファイルを再インポートしても保存値は変更されません(マスクされたセルは「変更なし」を意味します)ので、実データが記号で上書きされることはありません。 - インポートのたびに結果の概要が表示されます。合計行数、作成・更新・スキップ(空または認識できない行)された件数、エラーになった件数が示され、失敗した行は一覧表示されるので修正して再度インポートできます。明細はインポート済みとスキップに分けて集計され、何も黙って破棄されることはありません。
- マスターデータも含まれます。 Excel エクスポート(およびワークスペースのバックアップ)には、各ルックアップ/マスターデータ表の現在の値を収めたシートが含まれます。アプリ全体を再インポートする(またはバックアップを復元する)と、マスターデータ管理で行った編集が復元されます。機微なマスターデータ列はレコードと同様にマスクされ(機微データを含めない限り
••••••)、マスクされたセルが保存値を上書きすることはありません。