インポートとエクスポート
Excel での慣れた作業スタイルを手放さずに、データを出し入れできます。どのフォームからでも、そのレコードを Excel・CSV・JSON に エクスポート でき、仕入先から届いた価格表のようなデータを インポート で取り込むこともできます。どちらも一度に 1 つのフォームが対象で、エクスポートファイルの名前は、フォーム名に _export を付けたものになります（例：Invoices_export）。
インポートは、まずエクスポートから始めるのが確実です。 アップロードしたワークブックはアプリの構造を定義するもので、そのセルの値がデータとして読み込まれるわけではありません。エクスポートを省くこともできます。インポートダイアログの 空のテンプレートをダウンロード (.xlsx) で、レコードのない同じヘッダー行が得られます。そこで、レコードが 1 件もなくても、まずフォームをエクスポートします。得られるファイルには、
Record ID 列や明細列を含め、必要な列見出しがそのままそろっています。あとは行を書き込み、列とその順序は変えずにインポートするだけです。| インポートする行 | インポートの動作 |
|---|---|
フォームに key フィールド（たとえば社員番号）があり、行のキー値が既存レコードと一致する | そのレコードが更新されます |
キーフィールドはないが、行の Record ID が既存レコードと一致する | そのレコードが更新されます |
どれにも一致しない — 新しいキー値、または Record ID が空欄 | 新しいレコードが作成されます |
- インポートは更新と追加を一度に行います。 既存レコードに一致する行はそのレコードを更新し、どれにも一致しない行は新しいレコードを作成します。「更新用」と「追加用」のファイルを分けて用意する必要はありません。
- キーによる照合。 フォームに
keyフィールド（たとえば社員番号）が定義されている場合、インポートはキー値が一致するレコードを更新します。キーがない場合は、Record ID列が更新か作成かを決めます。 - 自動採番フィールドはアプリが管理します。
auto列の値は、更新対象の既存レコードを探す用途にだけ使われます。新しい行には、セルに値が入っていても、常に新しく割り当てられた値（連番、またはulid／nanoid）が付きます。そのため、インポートした行がアプリの発行済みの番号と重複することはありません。新規作成したい行ではauto列を空欄のままにしてください。 - マスクされた値は再インポートしても安全です。 エクスポートでは機密フィールドが
••••••と表示されます。そのファイルを再インポートしても保存されている値はそのまま残ります — マスクされたセルは「変更なし」を意味します — ので、実際のデータが黒丸で上書きされることはありません。 - インポートのたびに結果の概要が表示されます。 合計行数のほか、作成・更新・スキップ（空行や認識できない行）された件数と、エラー になった件数が示されます。失敗した行は一覧に表示されるので、修正して再度インポートできます。明細行はインポート済みとスキップに分けて集計されます。黙って破棄されるものは何もありません。
- ルックアップテーブルも一緒に移動します。 Excel エクスポート（およびワークスペースのバックアップ）には、各ルックアップ／マスターデータテーブルの現在の値を収めたシートが含まれます。アプリ全体を再インポートする（またはバックアップを復元する）と、マスターデータ管理 で行った編集が戻ってきます。機密のマスターデータ列はレコードと同様にマスクされ（機密データを含めない限り
••••••）、マスクされたセルが保存値を上書きすることはありません。