コミュニティ · ヘルプ

SheetApps ユーザーガイド

Excel ワークブック(または Google スプレッドシート)を、フォーム・検証・ルックアップ・インポート/エクスポートなどを備えたマルチユーザー Web アプリに変換します。

ルール:検証とキー

ルールはデータをきれいに保ちます — 必須項目、範囲、パターン、キーなど。Rules_(または Validation_)シートに、1 行 1 ルールで、次の列にわたって追加します:FieldRule TypeValueMessageSectionFormRule Type が何を強制するかを決めます:

ルールタイプ効果
requiredフィールドには値が必要です。Value 列に比較を追加できます — 例:end_date で "greater or equal to start_date"。
min / max境界。上限/下限は、数値、ISO 日付、または別のフィールド名にできます("end_date | min | start_date" は end ≥ start を意味し、日付を認識します)。数値の min/max のみがフィールドを必須にもします。
min_length / max_length文字列の長さの境界。
pattern値は正規表現に一致する必要があります。
keyフィールドをフォームのビジネスキーとしてマークします — 必須になり、インポートはこれで既存レコードを照合します。1つのフォームにキーは1つだけです。
subkeyビジネスキーの副次部分 — フォームごとに1つ、かつキーがある場合のみ。両方ある場合、インポートはキー + サブキーをまとめて照合します。「sub key」「sub_key」「sub-key」も使えます。
sensitive / mask / piiフィールド(任意の型)を機密としてフラグします:グリッド・フォーム・印刷・エクスポートでマスクされ、運用者がフィールド暗号化を有効にしている場合は保存時に暗号化されます。Form 列にマスターデータのリスト名を指定すると、代わりにそのリストの列をフラグできます — マスターデータ管理でマスクされ、その列を参照するフォームフィールド(ドロップダウンや自動入力された値)はマスキングを自動的に継承します。
conditional / validation例:"required if status is 'Active'"。条件は複合にできます — AND / OR / XOR — そして記号(=, !=, >=, <=, >, <)または単語を使用します。比較値は別のフィールドにできます。
between / rangebetween <low> and <high>。各境界は、リテラル、フィールド名、または "system date" / "today"(保存日)です。明細の日付は HEADER フィールドで範囲を制限できます("between start_date and end_date from HEADER")。
auto / autogen自動採番:レコード作成時にアプリが次の番号を割り当てます。既定では 1 から、または Value 列に入れた数値から開始します(例:100 → 100、101、102…)。フィールドの Data type が生成 ID(ulid / nanoid)の場合は、番号の代わりにその方式で ID を生成します。表示専用で、既存の値は再割り当てされません。自動採番フィールドは暗黙的にキーになるため、同じセクションに別のキーフィールドを置くことはできません。
derivedフィールドの値は手入力ではなく計算されます — マスターデータ(from Products でレコード全体、または列名とフィールド名が異なる場合は Product.UOM / UOM from Product で単一の列。例:uom から単位ピッカーに入力)や日付計算から求められます。
calc / calculationフィールドは アプリが計算して保存 します — 通貨または単位の変換です(下記の 通貨と単位の変換 を参照)。読み取り専用で、保存のたびに再計算されます。入力またはインポートされた値は無視されます。calculation とも書けます。
displayRead-only — the field is shown but never accepts typing. Use it for a value that comes from a default rather than the user: e.g. a submission_date that is required + display with system date in the Value column shows today's date, uneditable. (Unlike calc/auto, the app doesn't compute or assign it — it just presents whatever default it carries.)
Stack rules on one field. A field can carry several rules — add a separate Rules_ row for each. For example, a sales_order that is both the business key and auto-numbered is two rows with the same Field.
日付のペアは自動的に検証されます。 セクションに開始/終了日のペア(start_date/end_datefrom_date/to_date など)がある場合、アプリは自動的に end ≥ start を強制します — ルールは不要です。

既定値。 任意のルールの Value 列は既定値を持てます:default value "Active" または default = X。引用符付きまたはプレーンなテキストはリテラルです。修飾された参照(default = HEADER.currency_code)または計算(default = amount / 100)は、フォームまたは明細行が開かれたときに評価されます。

マスターデータの自動入力も 自動的に 行われます:ドロップダウンのルックアップテーブルに、フォームの他のフィールドと名前が一致する列がある場合、値を選択するとそれらのフィールドが入力されます — ルールは不要です。推測に頼る代わりにフィールドの型を明示的に固定するには、ルールシートに データ型 列を追加します。

金額と数量のフィールドは自動的に変換できます — 金額を別の通貨に、数量を別の単位に — 結果は保存され、常に最新に保たれます。通貨と単位の変換を参照してください。

For calculated fields — totals, arithmetic, and IF / Boolean logic on a Formula_ sheet — see Formulas.