Sheetward ユーザーガイド

フォーム仕様

各 Form_ シートは 1 つのフォームを記述します。Sheetward はシートのレイアウトを読み取り、フィールド・順序・フォームの形を判断します。このページでは、単一セクションの簡単なフォームから、ヘッダーと明細からなる古典的なドキュメント型、さらに複数のセクションにグループ化された長いフォームまで、サポートされるレイアウトを紹介します。

フォームタイトル。フォームの表示タイトルはセル A1 に入力し、その下に空行を 1 行置きます。タイトルはアプリでのフォームの見出しになり、空行はタイトルの終わりとフィールドの始まりを Sheetward に伝えます。

単一セクションのフォーム — 1 組のフィールドを 2 通りの書き方で:

• 列に並べる。フィールド名を 1 行に横に並べ、その下の行にサンプル値を置きます。1 列が 1 フィールドの小さな表の形です。サンプル値はデータ型の判定のみに使われ、レコードとして取り込まれることはありません。
• フィールド : 値のペア。1 行に 1 フィールド — A 列にフィールド名、その隣にサンプル値。紙のフォームのような形です。

2 セクションのフォーム — 古典的なドキュメント型:ヘッダー(1 レコード)の下に繰り返しの明細テーブルが続き、HEADER 行と LINE ITEMS 行で示します:

• ヘッダーセクション:フィールドはどちらの配置でも構いません — 列、またはフィールド : 値のペア。
• 明細セクション:常に列配置です — フィールド名の行を明細行の上に置き、ヘッダーセクションの下に配置します。

グループ化されたフォーム — 長いフォームをセクションに分割します。HEADER の見出しを 1 つだけ書く代わりに、グループごとに見出しを書き、その下にそのグループのフィールドを並べます:

• グループごとに見出しを 1 つ。 グループ名を独立した行に置き — IDENTIFICATION、WARRANTY、LOCATION — その下にフィールドを、どちらの配置(列またはフィールド : 値のペア)でも並べます。アプリはシートの順序で見出しごとに 1 枚のカードを描画します。
• 見出しは大文字で。 大文字が合図です。その行が値のラベルではなくグループの開始であることを、Sheetward(そして読み手)に伝えます。小文字のタイトルはエラーとなりアップロードが止まります。
• 名前はそれぞれ異なるものに。 アプリはセクション名でカードにラベルを付け、翻訳の対象を特定します。そのため見出しの重複もエラーになります。
• レコードは 1 つのまま。 グループ化はレイアウトだけの話です。すべてのフィールドは同じレコードに入るため、エクスポート、インポート、ルール、数式はフォームを分割する前とまったく同じように動作します。
• 明細は引き続き独立。 グループの下に LINE ITEMS テーブルを追加できますが、1 フォームにつき 1 つだけです。

フォームが長くなったらグループを使ってください — フィールドが十数個を超えたとき、あるいはフィールドが明らかなテーマに分かれるときです。短いフォームにはマーカーは一切不要です。セクションのタイトルは翻訳できます。各見出しについて Translation_ シートに section 行を追加してください。