SheetBridgeのプロパティ型マッピング
SheetBridgeは、列データを読み取り、それをAdaloのプロパティタイプに自動的にマッピングします。このマッピングの仕組みを理解することで、予期せぬ結果が生じないようにシートを適切に構成することができます。
本題に入る前に
すべてのデータ型の検出は、Google スプレッドシートのセルの書式設定ではなく、列内の実際のデータに基づいて行われます。
はじめに
SheetBridgeがスプレッドシートを連携する際、各列を分析し、対応するAdaloのプロパティタイプにマッピングします。一般的な列タイプは問題なく変換されますが、一部のGoogleスプレッドシートの形式については、Adaloで期待通りに機能させるために少し準備が必要になる場合があります。
サポートされているGoogleスプレッドシートのプロパティ型
テキスト (Text)
Googleスプレッドシートの形式：プレーンテキスト、またはテキストと数値が混在したセル。
Adaloでの仕組み：Text（テキスト）プロパティにマッピングされます。これは、他の型に明確に一致しないすべての列に対するデフォルトの代替（フォールバック）型です。名前、説明、ステータスラベル、ID、およびその他の自由形式の文字列データにはTextを使用してください。
注意点：
同じ列内に内容が混在するセルがある場合（例えば、一部の行には数値が含まれ、他の行には単語が含まれるなど）、列全体がTextとして処理されます。
列内でのデータ型の一貫性を保つことが、正確な型マッピングを確実にするための最善の方法です。
数値 (Number)
Googleスプレッドシートの形式：整数および小数を含む数値セル。
Adaloでの仕組み：Number（数値）プロパティにマッピングされます。カウント、数量、評価、価格、およびその他の任意の数値に使用できます。
注意点：
通貨の列（スプレッドシートで「$」やその他の記号で書式設定されているもの）は、Numberとして処理されます。通貨記号や書式はAdaloには引き継がれず、生の数値データのみが保存されます。
パーセンテージ（％）の列は、スプレッドシート内でセルがパーセンテージとして書式設定されている場合にのみ、対応する小数値として保存されます。例えば、75%と表示されているセルは、Adalo内では0.75として保存されます。アプリ内でパーセンテージとして表示したい場合は、数式を使用して100を掛けるか、UI（ユーザーインターフェース）側で書式設定を処理してください。
同じ列内で数値と非数値を混在させないでください。本来は数値の列である中にテキスト入力が1つでもあると、列全体がTextとして読み込まれる原因になります。
（例：ある列が「75%」をプレーンテキストとして保存している場合、それは文字列の「75%」のままとなります。）
真偽値 (True/False)
Googleスプレッドシートの形式：チェックボックスセル（Googleスプレッドシートの「挿入」＞「チェックボックス」）。
Adaloでの仕組み：True/False（真偽値）プロパティにマッピングされます。これは、切り替えスイッチ、完了ステータス、はい/いいえのフラグ、および同様の2者択一のフィールドに便利です。
注意点：
Googleスプレッドシートのチェックボックスは、確実にTrue/Falseにマッピングされます。
「TRUE」や「FALSE」といったテキスト値は、すべてのレコードに設定されていない限り、True/FalseプロパティではなくTextプロパティとして処理されます。
boolean（真偽値）フィールドが必要な場合は、値を手動で入力するのではなく、シートのチェックボックスのセル型を使用してください。
日付と時間 (Date & Time)
Googleスプレッドシートの形式：日付、時間、または日付＋時間が書式設定されたセル。
Adaloでの仕組み：Date & Time（日時）プロパティにマッピングされます。Adaloは、利用可能な場合は完全なタイムスタンプを保存します。最善の結果を得るには、日付＋時間が書式設定されたセルを使用してください。
注意点：
日付のみ（例：2025-06-01）：SheetBridgeはこれをUTCの午前0時の時間とともに保存します。アプリで時間を表示したり、時間でフィルタリングしたりする場合は、タイムゾーンの違いに注意してください。
時間のみ（例：14:30）：時間値として保存されます。並べ替えや表示のために日付と組み合わせる必要がある場合は、代わりにシート内で結合された「日付＋時間」の列を使用することを検討してください。
日付＋時間（例：2025-06-01 14:30）：きれいに転送され、Adaloにおける日付関連のフィルタリングや並べ替えにおいて最も信頼性の高い形式です。
スプレッドシート内で日付として書式設定されているものの、プレーンテキスト（例：「June 2025」）が含まれているセルは、Textとして処理され、日付ベースのフィルタリングや並べ替えでは機能しません。
スプレッドシートで日付や日付/時間を「現在の時刻」で更新する場合、書式設定を「なし」に変更する必要があります。
画像（URLベース）
Googleスプレッドシートの形式：直接の画像URL（.jpg、.png、.gifなどで終わるプレーンテキストのリンク）が含まれる列。
Adaloでの仕組み：Adaloには、外部コレクション用の専用の画像列タイプはありません。Textプロパティに保存された画像URLは、Adaloアプリ内の画像コンポーネントで使用できます。
注意点：
「挿入」＞「画像」を使用してGoogleスプレッドシートのセルに直接挿入された画像は、SheetBridgeを介してアクセスできず、Adaloには表示されません。URLベースの画像参照のみがサポートされています。
画像URLがパブリックにアクセス可能であることを確認してください。認証やGoogleドライブの共有権限が必要なリンクは、アプリ内で読み込まれません。
数式 (Formulas)
Googleスプレッドシートの形式：数式が含まれるセル（例：=A2&" "&B2 や =TODAY()）。
Adaloでの仕組み：SheetBridgeは数式そのものではなく、数式の出力値を読み取ります。結果として得られる値は、数式が返すもの（テキスト、数値、日付など）に基づいて、適切な型にマッピングされます。
注意点：
数式の列は、アプリに表示したい計算値（例：名と姓の列から結合されたフルネーム）に対してうまく機能します。
エラー（#REF! や #VALUE! など）を返す数式は、Adalo内では空欄として表示されます。接続する前に、スプレッドシート内の数式エラーを解決してください。
SheetBridgeは、Adaloからの数式値の書き戻しを行いません。ユーザーがアプリ内で数式列に対応するフィールドを更新した場合、スプレッドシート内の数式は静的な値で上書きされます。
ドロップダウン（データの入力規則）
Googleスプレッドシートの形式：Googleスプレッドシートのデータの入力規則のドロップダウンを使用しているセル。
Adaloでの仕組み：ドロップダウンから選択された値は、プレーンテキストとして処理されます。スプレッドシートで定義された許可されたオプションのリストは、Adaloには転送されません。
注意点：
Adaloアプリ内で入力を特定のオプションのセットに制限したい場合は、オプション用の別のコレクション、またはピッカーコンポーネント（Picker component）を備えたフォームを使用して、個別に設定する必要があります。
スプレッドシートでのドロップダウンの検証は、ユーザーがAdaloのフォームを介して他の値を入力することを防ぐものではありません。
ハイパーリンク (Hyperlinks)
Googleスプレッドシートの形式：「挿入」＞「リンク」またはHYPERLINK()数式を介して作成されたハイパーリンク。
Adaloでの仕組み：リンクは、セルのラベルをレコードとするTextプロパティとして取り込まれます。
「挿入」＞「リンク」を介して作成されたハイパーリンクの場合、基礎となるURLではなく、表示テキストが保存されます。
HYPERLINK()数式の場合、数式の表示出力が保存されます。
注意点：
セルの表示値がTextとして保存されます。アプリで生のURLを利用可能にする必要がある場合は、Googleスプレッドシートの「リンクを挿入」機能を使用するのではなく、セルに完全なURLを直接貼り付けてください。
サポートされていないGoogleスプレッドシートのプロパティ型
以下のGoogleスプレッドシートの機能はSheetBridgeではサポートされていないため、無視されるか、あるいは予期しない結果を引き起こす可能性があります。
セルに直接挿入された画像
アクセスできません。空欄として表示されます。
ヘッダー行の結合されたセル
列がスキップされたり、誤って読み込まれたりする原因になります。
セル内の改行（複数行のコンテンツ）
テキストとしてサポートされますが、処理中に改行は半角スペースに置き換えられます。
リッチテキスト形式（太字、色など）
装飾は解除され、プレーンテキストの値のみが保存されます。
名前付き範囲
サポートされていません。SheetBridgeはタブの構造のみを読み取ります。
複数のセルにまたがる配列数式
予期しない出力が生成される可能性があります。注意して使用してください。
クリーンな型マッピングのためのヒント
各列を、単一の一貫したデータ型に維持してください。
boolean（真偽値）フィールドには、TRUE/FALSEをテキストとして入力するのではなく、ネイティブのチェックボックスセルを使用してください。
アプリ内で日付のフィルタリングや並べ替えが必要な場合は、日付＋時間が書式設定されたセルを使用してください。
画像の参照は、専用の列にプレーンURLとして保存してください。
SheetBridgeに接続する前に、シート内のすべての数式エラーを解決してください。
Last updated
Was this helpful?