Web AppBuilder で作成したアプリは、直接、URL パラメーターを使用して変更できます。URL は常に <your portal url>/apps/webappviewer/index.html? で始まり、以下のうちの 1 つ以上のパラメーターが含まれます。複数のパラメーターを含めるには、アンパサンド (&) を使ってパラメーターを区切ります。例:
http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&webmap=9cf053ea602345ddae060010c470e615注意:
現在、3D アプリは URL パラメーターをサポートしていません。
クエリ パラメーターのエンコード
すべてのクエリ パラメーターがエンコードされる必要があります。エンコーディングでは、無効な文字が、% およびそれらの文字の 16 進数表記に置き換えられます。
次に、エンコードされていない URL パラメーターの例を示します。http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, ca
次に、エンコードされた当該パラメーターを示します。http://<your portal url>/apps/webappviewer/index.html?find=380%20new%20york%20street,%20redlands,%20ca
Web には、エンコードされた URL を生成するための無料のサイトおよびツールが多数存在します。たとえば、Albion Research Ltd. は「URLEncode and URLDecode Page」を設けています。読みやすさに配慮して、このトピックで以降に示す例はエンコードされていません。
保存したアプリを開く
Web AppBuilder で作成および保存したアプリを開くには、id= とアプリの一意の ID を使用します。例:
http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4dWeb マップの定義
Web マップを定義するには、webmap= と Web マップの一意の ID を使用します。例:
http://<your portal url>/apps/webappviewer/index.html?webmap=9cf053ea602345ddae060010c470e615マップの中央配置
特定の位置をマップの中心にするには、地理座標 (x,y) または投影座標 (x,y,WKID) を使用して、center= を設定します。
注意:
区切り文字としてカンマやセミコロンを使用できます。数値の小数点としてコロンを使用している場合は、セミコロンを使用します。
次に、地理座標の例を示します。
http://<your portal url>/apps/webappviewer/index.html?center=34,-50次に、投影座標の例を示します。
http://<your portal url>/apps/webappviewer/index.html?center=500000,5500000,102100スケール レベルの定義
マップのスケール レベルを定義するには、center= パラメーターと level= パラメーターを使用します。level パラメーターは、マップ サービスの REST エンドポイントに示されているキャッシュ スケールのレベル ID を受け入れます。例:
http://<your portal url>/apps/webappviewer/index.html?center=20,45&level=4スケールの定義
マップのスケールを定義するには、center= パラメーターと scale= パラメーターを使用します。scale パラメーターは、マップ サービスの REST エンドポイントに示されているキャッシュ スケールを受け入れます。例:
http://<your portal url>/apps/webappviewer/index.html?center=20,45&scale=4622324範囲の定義
マップの範囲の定義には extent= を使用します。extent パラメーターは MinX,MinY,MaxX,MaxY の形式の地理座標 (GCS) または MinX,MinY,MaxX,MaxY,WKID の形式の投影座標 (PCS) を受け入れます。区切り文字としてカンマやセミコロンを使用できます。数値の小数点としてコロンを使用している場合は、セミコロンを使用します。
次に、地理座標の例を示します。
http://<your portal url>/apps/webappviewer/index.html?extent=-117.20,34.055,-117.19,34.06次に、投影座標の例を示します。
http://<your portal url>/apps/webappviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113マップを開く位置またはフィーチャの検索
マップを開くのに使用される位置またはフィーチャを検索するには、find= を使用します。マップでは、最も近い一致結果に自動的にズームし、吹出しマーカーが追加されます。find パラメーターに指定できる値は、1 行の住所、住所の一部 (たとえば、都市名のみや国名のみ)、場所名、緯度と経度の座標、および検索可能なレイヤー内のフィーチャ (たとえば、パーセル識別番号 (PIN) を表す 1916352001) です。例:
http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, ca注意:
すべてのクエリ パラメーターがエンコードされる必要があります。
ポイントの追加
ポイントをマップに追加するには、marker=<x>,<y> を使用します。また、指定の X 位置と Y 位置にもポイントが追加されます。次のオプション プロパティも含めることができます。
- <wkid> - マップに追加される X,Y 座標の空間参照。WKID を含めない場合、GCS 座標が使用されます。
- <エンコードされたタイトル> - ポイントのポップアップのタイトル。タイトルを含めない場合、ポップアップは空になります。
- <エンコードされたアイコン URL> - ポイントのシンボル。シンボルを含めない場合、青のマーカー シンボルが使用されます。
- <エンコードされたラベル> - ポイント シンボルの横に表示されるラベル。
次の点を考慮します。
- <x>、<y> は必須です。
- title、icon、および label パラメーターは、必ずエンコードしなければなりません。
- プロパティは、marker=<x>,<y>,<wkid>,<エンコードされたタイトル>,<エンコードされたアイコン URL>,<エンコードされたラベル> の順序で追加する必要があります。
- 区切り文字としてカンマやセミコロンを使用できます。数値の小数点としてコロンを使用している場合は、セミコロンを使用します。
- 空の値を使用します。スペースは使用しません。たとえば、ラベルを指定し、それ以外のオプション プロパティをどれも指定しない場合は、6 番目のパラメーターとしてラベルを追加し、その他のパラメーターの値を空にします (x;y;;;;label)。
- (ポイントを中央に配置することに加えて) マップを拡大する場合は、level= パラメーターを含めます。
例:
http://<your portal url>/apps/webappviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7フィーチャのクエリ
フィーチャをクエリして拡大するには、以下のいずれかのオプションを使用します。
- query=<layer name>,<field name>,<field value>
- query=<layer name>, <where clause>
- query=<layer id>,<field name>,<field value>
- query=<layer id>, <where clause>
注意:
すべてのクエリ パラメーターは大文字と小文字を区別し、エンコードする必要があります。
レイヤー名は変更できるので、クエリではレイヤー ID を使用することを強くお勧めします。レイヤー ID は、以下に示すように、Web マップ ID から取得できます。http://<your portal url>/sharing/rest/content/items/32a83775654249dcae6b8f2eff5d4072/data/?f=pjson
マップ サービスのグループのサブレイヤーについては、<layer id_sublayer id> をレイヤー ID として使用します。
例:
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,STATE NAME,Californiahttp://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,STATE NAME='California'http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,POP2000,33871648http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,POP2000=33871648ロケールの切り替え
アプリの言語を切り替えるには、locale=<language code> を使用します。サポートされる言語コードは、ar、cs、da、de、en、el、es、et、fi、fr、he、it、ja、ko、lt、lv、nb、nl、pl、pt-br、pt-pt、ro、ru、sv、th、tr、zh-cn、vi、zh-hk、zh-tw です。
例:
http://<your portal url>/apps/webappviewer/index.html?locale=frユーザーの認証
パブリックではないアプリでユーザーを自動的に認証するには、token=<token> を使用します。そうすると、ユーザーはユーザー名とパスワードを入力する必要はありません。例:
http://<your portal url>/apps/webappviewer/index.html?token=utmVcabc_LNyEQ7OuuHD73em0MErLR_cudJTeSIdMFTnL0poF3shVBeng5ieWHyZn0kAA8nhUg7jseQxz3bi5crnFMMpldDiJLrtzmO3jEM-ZNVIUEh5_qMms-YgXUwGgFbeQlM9WaI3jwraUqwah0yCceBAxEkEIAEWvlBEDfVsYs3LZydORRcs2QIcdLasモバイル用のレイアウトが適用される条件の制御
アプリは、画面サイズに基づいて、2 つのレイアウト スタイルをサポートします。1 つはデスクトップ用、もう 1 つはモバイル デバイス用です。画面の高さか幅のどちらかが 600 ピクセル未満の場合は、モバイル用のレイアウトが自動的に適用されます。ただし、アプリが Web サイトに埋め込まれている場合、これによって予期しない動作が生じることがあります。たとえば、Web サイト内のポップアップがモバイル用のレイアウト スタイルになります。レイアウト スタイルを制御するには、mobileBreakPoint=<pixel number> を使用します。たとえば、画面サイズが 300 ピクセル未満になるまで、デスクトップ用のスタイルのままにすることができます。
http://<your portal url>/apps/webappviewer/index.html?mobileBreakPoint=300