フォーム仕様
各 Form_ シートは 1 つのフォームを記述します。Sheetward はシートのレイアウトを読み取り、フィールド・順序・フォームの形を判断します。このページでは、単一セクションの簡単なフォームから、ヘッダーと明細からなる古典的なドキュメント型まで、サポートされるレイアウトを紹介します。
フォームタイトル。フォームの表示タイトルはセル A1 に入力し、その下に空行を 1 行置きます。タイトルはアプリでのフォームの見出しになり、空行はタイトルの終わりとフィールドの始まりを Sheetward に伝えます。
単一セクション — 列配置
フィールド名を 1 行に並べ、サンプル値をその下の行に
| A | B | C | D | |
|---|---|---|---|---|
| 1 | Part Stock | |||
| 2 | ||||
| 3 | Part | Price | Quantity | Location |
| 4 | CPU Fan | $50 | 10 | Austin |
| 5 | RAM | $500 | 75 | Dallas |
Form_Parts
単一セクション — フィールド : 値ペア
1 行に 1 フィールド — A 列に名前、その隣にサンプル値
| A | B | |
|---|---|---|
| 1 | Part Stock | |
| 2 | ||
| 3 | Part | CPU Fan |
| 4 | Price | $50 |
| 5 | Quantity | 10 |
| 6 | Location | Austin |
Form_Parts
2 セクション — ヘッダー + 明細
先にヘッダー(ペアまたは列)、その下に LINE ITEMS テーブル(常に列配置)
| A | B | C | |
|---|---|---|---|
| 1 | Invoice | ||
| 2 | |||
| 3 | HEADER | ||
| 4 | Invoice No | INV-001 | |
| 5 | Customer | Acme Corp | |
| 6 | |||
| 7 | LINE ITEMS | ||
| 8 | Item | Qty | Amount |
| 9 | Widget | 3 | $75 |
| 10 | Gadget | 1 | $120 |
Form_Invoice
単一セクションのフォーム — 1 組のフィールドを 2 通りの書き方で:
- 列に並べる。フィールド名を 1 行に横に並べ、その下の行にサンプル値を置きます。1 列が 1 フィールドの小さな表の形です。サンプル値はデータ型の判定のみに使われ、レコードとして取り込まれることはありません。
- フィールド : 値のペア。1 行に 1 フィールド — A 列にフィールド名、その隣にサンプル値。紙のフォームのような形です。
2 セクションのフォーム — 古典的なドキュメント型:ヘッダー(1 レコード)の下に繰り返しの明細テーブルが続き、HEADER 行と LINE ITEMS 行で示します:
- ヘッダーセクション:フィールドはどちらの配置でも構いません — 列、またはフィールド : 値のペア。
- 明細セクション:常に列配置です — フィールド名の行を明細行の上に置き、ヘッダーセクションの下に配置します。
フォームの定義は 1 回だけ。同じフォームを 2 回記述したシート(例:列グリッドとペアの両方)は不正です。明細テーブルがヘッダーより前に来ることはないため、Sheetward はエラーで停止します。1 シートに 1 定義です。
迷ったらマーカーを。
HEADER と LINE ITEMS の行は意図を明確にします — レイアウトが複数の読み方をされうるときは必ず追加してください。