Esri カスタム列—ArcGIS Survey123

フィールドタイプ

bind::esri:fieldType カスタム列を使用して、ArcGIS で調査の質問用に作成されるフィールドのタイプや長さを制御します。

多くの質問のタイプは、XLSForm 変換サービスによって自動的に決定できます。 select_one タイプの質問は、デフォルトでは ArcGIS 内で文字列フィールドに変換されます。値を整数で格納するための選択肢リストが必要な場合は、明示的にフィールドタイプを整数に定義する必要があります。

フィールドタイプを制御するには、bind::esri:fieldType 列に次のいずれかの値を入力します。

esriFieldTypeString
esriFieldTypeDate
esriFieldTypeInteger
esriFieldTypeSingle
esriFieldTypeDouble
esriFieldTypeSmallInteger
esriFieldTypePointZ
esriFieldTypeGUID

bind::esri:fieldType は、フィーチャレイヤーで作成されたフィールドタイプのみを制御するので注意してください。調査中の質問のフィールドタイプを制御するには、bind::type 列を使用します。たとえば、「int」という値を calculate の質問の bind::type 列に入力すると、フィールドはデフォルトのフィールドタイプである文字列ではなく、整数として扱われます。 bind::type 列で使用できる値は次のとおりです。

int
decimal
文字列
date
dateTime
時間

bind::esri:fieldType 列には NULL 値も使用できます。これを使用すると、作成されるフィーチャレイヤーから質問が省略されます。質問は調査内に存在したまま正常に動作しますが、回答はフィーチャレイヤーに送信されず、回答を確認すると存在しない状態になります。これは、計算、制約、または表示目的で存在する必要があるが結果には必要ないその他の質問に最適です。

次の質問タイプは、NULL フィールドタイプをサポートしていません。

select_one or other
select_multiple or other
image
hidden

注意:

ジオポイント、ジオトレース、ジオシェープの質問は、調査に少なくとも他に 1 つのジオポイント、ジオトレース、ジオシェープの質問が含まれており、そこに NULL フィールドタイプがない場合、あるいはジオポイント、ジオトレース、ジオシェープが繰り返されている場合にのみ、NULL フィールドタイプをサポートします。

フィールドの長さ

bind::esri:fieldLength カスタム列を使用して、ArcGIS で調査の質問用に作成される文字列 (テキスト) フィールドの長さを制御します。

注意:

整数および小数の質問はこの方法では制御できません。データベースでは数値フィールドの長さを指定しません。有効な値の範囲は、数値フィールドタイプで決定されます。たとえば、整数フィールドは -2,147,483,648 から 2,147,483,647 までの整数値を格納します。

フィールドエイリアス

デフォルトでは、調査フィールドのエイリアスは、フィールドのラベルと同じ値を継承します。この値は主に、ArcGIS で調査を開くときに参照されます。これを変更するには、bind::esri:fieldAlias 列に値を入力します。入力した値がフィールドの新しいエイリアスになります。

非表示の質問と計算の質問はフォームに表示されないため、ラベルフィールドの内容は保持されません。つまり、これらのタイプの質問では、Survey123 Web サイトまたは ArcGIS で調査レコードを表示するとき、列ヘッダーに質問名が表示されます。非表示の質問と計算の質問の列ヘッダーで強制的にラベルを表示するには、スプレッドシートの bind::esri:fieldAlias 列を使用してラベルを指定します。

入力マスク

入力マスクは、文字とシンボルを使用することで、テキストの質問の設定形式を提供します。入力マスクを質問に適用すると、すべての回答が、入力マスクによって定義された特定のパターンに従う必要があります。 Survey123 フィールドアプリおよび Web アプリでは、すべての入力マスクが満たされるまで調査の回答は送信できません。

ヒント:

入力マスクは、text 質問タイプのみに適用できます。 integer または decimal 質問タイプの場合、回答を制限するには constraint 列を使用します。詳細については、「制限」をご参照ください。

入力マスクを質問に適用するには、body::esri:inputMask 列でマスクを定義します。次の表は、入力マスクで使用できる文字とシンボルを示しています。


文字	意味
A	ASCII アルファベット文字が必須です。使用できる文字は A ～ Z および a ～ z です。
a	ASCII アルファベット文字が許可されていますが必須ではありません。
N	ASCII 英数字が必須です。使用できる文字は A ～ Z、a ～ z、0 ～ 9 です。
n	ASCII 英数字が許可されていますが必須ではありません。
X	空白ではない任意の文字が必須です。
x	空白ではない任意の文字が許可されていますが必須ではありません。
9	ASCII 数字が必須です。使用できる数字は 0 ～ 9 です。
0	ASCII 数字が許可されていますが必須ではありません。使用できる数字は 0 ～ 9 です。
D	ASCII 数字が必須です。使用できる数字は 1 ～ 9 です。
d	ASCII 数字が許可されていますが必須ではありません。使用できる数字は 1 ～ 9 です。
#	ASCII 数字または +/- 記号が許可されていますが必須ではありません。
H	16 進数が必須です。使用できる文字は A ～ F、a ～ f、0 ～ 9 です。
h	16 進数が許可されていますが必須ではありません。
B	バイナリ文字が必須です。使用できる文字は 0 ～ 1 です。
b	バイナリ文字が許可されていますが必須ではありません。
>	以降のアルファベット文字はすべて大文字です。
<	以降のアルファベット文字はすべて小文字です。
!	大文字小文字の変換をオフにします。
\	上記の特殊文字をエスケープして、区切り文字として使用します。

マスクは文字と区切り文字による文字列で構成され、オプションで入力マスクを終了するセミコロンや空白用の文字が続きます。空白文字は編集後にテキストから削除されます。次の表に、マスクの例を示します。


マスクの例	説明
>A<xxxxxxxxxxxx	大文字で始まり、後に任意の小文字が続くテキスト。
AAA-AAA-AAA;_	区切り文字としてダッシュ、入力マスクの末尾にセミコロン、その後に入力の必要な各文字を表すアンダースコアを使用する一意の識別子。
B9.99;-	pH 値を表します。この数値は 0 または 1 で始まり、小数点第 2 位までのみを含むように制限されます。セミコロンは入力マスクを終了し、その後にダッシュを使用して入力の必要な各文字を表します。
999-99-9999	米国の社会保障番号。
(999) 999-9999	米国の電話番号。
900 kg	重さ (キログラム単位)。0 ～ 999。
99999	米国の 5 桁の ZIP コード。
AAA	IATA 空港コード。

ワークフロー

[bind::esri:workflow] カスタム列を使用することで、ギャラリーから起動した [距離計] タイルからフィールドに入力できることを示します。この列はテキストの質問でのみサポートされており、[bind::esri:workflow] 列には以下の値を使用できます。

rangefinderMode=height
rangefinderMode=offset
rangefinderMode=height,offset
rangefinderHeight

それぞれの「rangefinderMode」の値でフィールド作業者に対して類似のユーザーエクスペリエンスが実現されます。目的の距離計ワークフローを選択すると、調査を選択して機器で 1 ～ 3 回計測する画面がユーザーに表示されます。フィールド作業者には他の質問に回答するための調査が自動的に表示されます。

[rangefinderHeight] の値は一意であるため、高さの値を受け付けるように構成されている調査の各質問をフィールド作業者が進む矢印と戻る矢印で確認できます。すべての高さが計測されたら、フィールド作業者は [完了] をタップして調査に進み、他の質問に回答します。

注意:

詳細については、「距離計のデータ収集の準備」をご参照ください。

フィールド タイプ

注意: