テキストと数値

ユーザーがテキストと数値による回答を入力できるよう、テキスト、整数、小数の質問を調査に含めることができます。

テキストの質問では、調査にフリー テキストの回答を入力できます。 デフォルトで、フォームには、単一入力行があるテキスト ボックスが表示されます。 テキストがテキスト ボックスのサイズを超えた場合でも、テキスト ボックスのサイズは同じままで、改行なしで水平方向にスクロールします。 これは、短い回答に最適です。 特定の形式を遵守するためにテキスト入力を強制するために、入力マスクを適用できます。 正規表現を適用して、メール アドレスや Web サイトの URL など、特定の形式ではない回答を自動的に拒否するようテキスト フィールドに制限をかけることもできます。

整数と小数の質問タイプでは、ユーザーが該当の数値のみ入力するよう制限されます。 これらの質問タイプの constraint 列では、回答が所定の範囲内である場合を除き、ユーザーが調査を送信することを防ぐために最小値と最大値を指定できます。

表示設定を行うことで、これらの質問タイプの動作とこれらがどのように表示されるかを変更できます。 どの送信アプリが特定の表示設定をサポートしているかを確認するには、「表示設定」をご参照ください。

テキストの表示設定

注意:

Survey123 Mobile では、テキストの質問については [multiline] の表示設定のみがサポートされています。

Survey123 Web アプリでは、[predictivetext] と [nopredictivetext] の表示設定はサポートされていません。

[appearance] 列を [multiline] に設定すると、テキストの質問が複数行のテキスト ボックスとして表示されます。 このより大きいテキスト ボックスは、長い回答に最適です。 入力時に行が折り返され、キャリッジ リターンも可能です。

注意:

Survey123 のフィールド アプリで使用されるフォームでは、[body::esri:style] 列で defaultHeight パラメーターを設定することで、複数行のテキスト ボックスのデフォルトの高さを設定できます。 たとえば、[body::esri:style] 列に defaultHeight=5 と入力すると、調査が開いたときに複数のテキスト ボックスに 5 つの行が表示されます。 これが設定されていなければ、調査が開いたときに複数行テキスト ボックスに 3 つの行が表示されます。

表示設定を [predictivetext] または [nopredictivetext] に設定すると、モバイル デバイス上でテキストの質問の予測テキストが有効または無効になります。 一部のキーボードで音声の文字起こし機能を無効化できる、テキスト質問の予測テキストが Android ではデフォルトで無効になっています。 対象の質問で音声合成を有効にするには、[predictivetext] 表示設定をテキスト質問に適用します。 予測テキストは、iOS ではデフォルトで有効になっています。

表示設定を [geocode] に設定すると、テキストの質問がジオコーディングされた住所の検索と送信に使用されます。

表示設定は、InfraMarker タグ ID の取得と、rangefinder からの値の取得にも使用できます。

ジオコーディングされた住所を検索し、送信します。

注意:

このセクションでは、Survey123 フィールド アプリでのみ利用可能な機能について説明します。この機能は、Survey123 Mobile では利用できません。

[appearance] 列を [geocode] に設定すると、テキストの質問がジオコーディングされた住所の検索と送信に使用されます。 ユーザーが住所の入力を開始すると、組織のデフォルトのロケーターに基づき、位置の候補が一連の自動入力オプションとして表示されます。 ユーザーがサイン インしていない場合は、ArcGIS World Geocoder が使用されます。 [geocode] の表示設定にはインターネット接続が必要です。オフライン環境では動作しません。

最後に選択された住所が文字列としてフィーチャ レイヤーに送信されます。ただし、完全にジオコーディングされたデータは、送信される前に JSON オブジェクトとして一時的に格納されるため、個々のプロパティを他のフィールドに抽出できます。

JSON オブジェクトから特定のプロパティを抽出するには、他の質問の [calculation] 列の pulldata("@json") 関数を使用します。

pulldata("@json", ${address}, "location.x")

pulldata("@json", ${address}, "searchCandidate")

個々のプロパティを定義しなければ、JSON オブジェクト全体が単一テキスト フィールドで返されます。

pulldata("@json", ${address})

pulldata("@json") 関数の詳細については、「JSON からの値の取得」をご参照ください。

注意:

ArcGIS World Geocoding Service を使用するジオコーディングでは、クレジットが消費されます。 詳細については、「クレジットの概要」をご参照ください。

結果を返すために特定のロケーターを設定するには、[bind::esri:parameters] 列にロケーターのアイテム ID を指定します (例: geocode=36ff9e8c13e042a58cfce4ad87f55d19)。 ArcGIS Online の調査で使用されるロケーターは ArcGIS Online のアイテムである必要があります。 ArcGIS Enterprise の調査で使用されるロケーターは調査と同じポータルのアイテムである必要があります。

使用可能なプロパティは、ロケーターによって異なります。 ただし、searchText プロパティは例外です。このプロパティは、使用されるロケーターにかかわらず提供され、住所を検索するために使用される正確な文字列か、結果リストから選択したオプションを返します。

[geocode] 表示設定の質問の表示をさらに制御するには、[body::esri:style] 列で次のいずれかのパラメーターを設定します。

注意:

indicator、proximity、maxResults、suggestions の各パラメーターは、Survey123 Web アプリではサポートされていません。

• indicator - ジオコードされた結果に、現在のデバイスの位置からの方向と距離を表示できます。 このパラメーターは、distance、direction、両方の値のカンマ区切り、または none に設定できます。 デフォルトでは、このパラメーターは距離のみを表示するよう設定されています。
• proximity - ジオコードされた結果に、デバイスの位置から一定の半径内にある結果のみを表示するかどうかを制御します。 このパラメーターには、数字と、標準的な単位 (m (メートル)、km (キロメートル)、ft (フィート)、mi (マイル)、yd (ヤード)) を使用できます。 単位が指定されていなければ、デフォルトではメートルが使用されます。 0 に設定されている場合、proximity は検索結果に表示されません。 デフォルトでは、このパラメーターは on に設定されています。つまり、距離によって位置を除外せずに、近接性に基づいて候補を並べ替えます。
• maxResults - 表示される結果の最大数を制御します。たとえば、maxResults=10 は、最大で 10 件の結果を返します。 デフォルトでは、このパラメーターは最大で 6 件の結果を表示するよう設定されています。
• suggestions - ArcGIS REST API の suggest 操作のインターフェイスとして使用されます。 このパラメーターが yes に設定されている場合、候補位置のドロップダウン リストには suggest 操作が設定されます。 このパラメーターが no に設定されているか、ジオコード サービスが suggest 操作をサポートしていない場合、候補位置のリストには findAddressCandidates 操作が設定されます。 デフォルトでは、このパラメーターは yes に設定されています。

InfraMarker タグ ID の取得

注意:

このセクションでは、Survey123 フィールド アプリでのみ利用可能な機能について説明します。この機能は、Survey123 Mobile では利用できません。

以下で説明の表示設定を使用すると、InfraMarker RFID タグからデータを読み取ったり、同タグにデータを書き込んだりできます。

テキストの質問の [appearance] 列を [inframarker] に設定すると、タグに書き込む情報を定義できます。 この情報には、assetOwner、assetName、latitude、longitude を含めることができ、これらの値は、調査の他の質問から取得できます。 たとえば、[calculation] 列の次の式では、asset_name、asset_owner、lat、long の各質問からの回答がタグに書き込まれます。

concat("assetName=", ${asset_name}, "&assetOwner=", ${asset_owner}, "&latitude=", ${lat}, "&longitude=", ${long})

同じ調査で別のテキストの質問の表示設定を [getinframarkerid] に設定すると、一意の 24 文字の InfraMarker タグ ID が取得されて調査に保存されます。

詳細については、InfraMarker ドキュメントをご参照ください。

rangefinder からの値の取得

注意:

このセクションでは、Survey123 フィールド アプリでのみ利用可能な機能について説明します。この機能は、Survey123 Mobile では利用できません。

[appearance] 列を [rangefinder] に設定することで、テキストの質問で完全な JSON オブジェクト、または距離計から返された指定の値を受け付けることができます。 完全な JSON オブジェクトを受け付けるために使用した場合、この質問では [bind::esri:fieldLength] を「1000」に設定して値全体を受け付けられるようにする必要があります。

整数または小数の質問の [rangefinder] の表示設定を行うと、整数または小数の質問で距離計から返された指定の値を受け付けることができます。 [bind::esri:parameters] 列で height、azimuth、horizontalDistance、slopeDistance、または inclination の値のいずれかを使用して、どの測定値を保存するかを指定します。 たとえば、「measurement=height」の場合には距離計から返された高さの値のみが保存されます。

整数の表示設定

注意:

Survey123 Mobile では、整数の質問については [spinner] の表示設定のみがサポートされています。

Survey123 Web アプリでは、これらの整数の表示設定はいずれもサポートされていません。

[appearance] 列を [spinner] に設定すると、整数の質問に値を 1 つずつ増減するボタンが表示されます。 ボタンを選択すると、ボタンを離すまで増加 (または減少) が繰り返されます。

[appearance] を [numbers] に設定すると、ハイライト表示された整数の質問が、値入力用のカスタムのテンキーとともに表示されます。 このキーボードには、値をプラスまたはマイナスにするボタンも含まれています。

[appearance] を [calculator] に設定すると、ハイライト表示された整数の質問が、値の入力および修正用のカスタムの計算機とともに表示されます。

[appearance] を [distress] に設定すると、整数の質問が苦痛の尺度として表示されます。 苦痛の尺度は 10 ポイントの尺度で、ストレス、苦痛、幸福感などの感情を測定するために使用されます。

小数の表示設定

注意:

Survey123 Mobile では、小数の質問については [spinner] の表示設定のみがサポートされています。

Survey123 Web アプリでは、これらの小数の表示設定はいずれもサポートされていません。

[appearance] 列を [spinner] に設定すると、小数の質問に値の最小桁が 1 ずつ増減するボタンが表示されます。 ボタンを選択すると、ボタンを離すまで増加 (または減少) が繰り返されます。

デフォルト値を使用して質問の小数部分の桁数を定義すると、spinner もこれを固守します。 次に、spinner でさまざまな小数値を処理する方法の例を示します。

• 1.0 を 1.1、1.2、1.3、1.4 に増分
• 3.07 を 3.08、3.09、3.10、3.11 に増分
• 2.000000 を 1.1、2.000001、2.000002、2.000003 に増分

[appearance] を [numbers] に設定すると、小数の質問が、値入力用のカスタムのテンキーとともに表示されます。 このキーボードには、値をプラスまたはマイナスにするボタンも含まれています。

[appearance] を [calculator] に設定すると、ハイライト表示された小数の質問が、値の入力および修正用のカスタムの計算機とともに表示されます。

[appearance] を [thousands-sep] に設定すると、小数の質問に対する回答に桁区切り記号が表示されます。 これは、調査の回答の一部として送信される値には影響しません。アプリで表示されるだけです。 区切り記号はデバイスのロケールで設定され、[ドラフト]、[送信箱]、[受信トレイ]、[送信済み] フォルダーから調査を開くときや、回答がデフォルト値または計算で設定されるときにのみ適用されます。 桁区切り記号は、値を手動で入力する際には表示されません。