Skip To Content

Utiliser les paramètres URL

Les applications créées avec Web AppBuilder peuvent être modifiées directement avec des paramètres d'URL. L'URL commence toujours par <your portal url>/apps/webappviewer/index.html? et contient un ou plusieurs des paramètres de requête répertoriés ci-dessous. Si vous souhaitez inclure plusieurs paramètres, utilisez un caractère Et commercial (&) pour les séparer. Par exemple :

http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d&webmap=9cf053ea602345ddae060010c470e615
Attention :

Actuellement, les applications 3D ne prennent pas en charge les paramètres URL.

Coder les paramètres de requête

Tous les paramètres de requête doivent être codés. Le codage remplace les caractères non valides par %, suivis de leur équivalent hexadécimal.

Voici un exemple de paramètre URL non codé :

http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, ca

Voici le même paramètre codé :

http://<your portal url>/apps/webappviewer/index.html?find=380%20new%20york%20street,%20redlands,%20ca

Internet propose de nombreux sites et outils gratuits pour générer des URL codées. Par exemple, Albion Research Ltd. offre une page URLEncode et URLDecode. Pour des raisons de lisibilité, le reste des exemples dans cette rubrique ne sont pas codés.

Ouvrir une application enregistrée

Pour ouvrir une application enregistrée créée avec Web AppBuilder, utilisez id= et l'ID unique de l'application. Par exemple :

http://<your portal url>/apps/webappviewer/index.html?id=6815e148ff1c4aee8dc7159816380a4d

Définir la carte Web

Pour définir la carte Web, utilisez webmap= et l'ID unique de la carte Web. Par exemple :

http://<your portal url>/apps/webappviewer/index.html?webmap=9cf053ea602345ddae060010c470e615

Centrer la carte

Pour centrer la carte à un emplacement en particulier, définissez center= à l'aide des coordonnées géographiques (x,y) ou des coordonnées projetées (x, y, WKID).

Attention :

Vous pouvez utiliser des virgules ou des points-virgules comme séparateurs. Utilisez des points-virgules si vos nombres ont deux points comme symbole de décimales.

Exemple de coordonnées géographiques :

http://<your portal url>/apps/webappviewer/index.html?center=34,-50

Exemple de coordonnées projetées :

http://<your portal url>/apps/webappviewer/index.html?center=500000,5500000,102100

Définir le niveau d’échelle

Pour définir le niveau d'échelle de la carte, utilisez les paramètres center= et level=. Le paramètre level accepte l'ID de niveau de l'échelle du cache tel qu'il figure dans l'extrémité REST du service de carte. Par exemple :

http://<your portal url>/apps/webappviewer/index.html?center=20,45&level=4

Définir l'échelle

Pour définir le niveau d'échelle de la carte, utilisez les paramètres center= et scale=. Le paramètre scale accepte l'échelle du cache tel qu'il figure dans l'extrémité REST du service de carte. Par exemple :

http://<your portal url>/apps/webappviewer/index.html?center=20,45&scale=4622324

Définir l'étendue

Pour définir l'étendue de la carte, utilisez extent=. Le paramètre extent accepte des coordonnées géographiques (GCS) MinX,MinY,MaxX,MaxY ou des coordonnées projetées (PCS) MinX,MinY,MaxX,MaxY,WKID. Vous pouvez utiliser des virgules ou des points-virgules comme séparateurs. Utilisez des points-virgules si vos nombres ont deux points comme symbole de décimales.

Exemple de coordonnées géographiques :

http://<your portal url>/apps/webappviewer/index.html?extent=-117.20,34.055,-117.19,34.06

Exemple de coordonnées projetées :

http://<your portal url>/apps/webappviewer/index.html?extent=-13079253.954115,3959110.38566837,-12918205.318785,4086639.70193162,102113

Rechercher un emplacement ou une entité pour ouvrir la carte

Pour rechercher l'emplacement ou l'entité sur lequel ouvrir la carte, utilisez find=. La carte effectue automatiquement un zoom sur le résultat le plus proche et un symbole ponctuel de rappel est ajouté à la carte. Le paramètre find accepte les adresses à une seule ligne, les adresses partielles (comme une ville ou un pays uniquement), les noms de lieux, les coordonnées de longitude-latitude et les entités contenues dans des couches dans lesquelles il est possible d'effectuer des recherches (par exemple, 1916352001 comme numéro d'identification de parcelle (PIN)). Par exemple :

http://<your portal url>/apps/webappviewer/index.html?find=380 new york street, redlands, ca
Attention :

Tous les paramètres de requête doivent être codés.

Ajouter un point

Pour ajouter un point sur la carte, utilisez marker=<x>,<y>. Le point est ajouté à la carte à l'emplacement x et y spécifié. Vous pouvez également inclure les propriétés facultatives suivantes :

  • <wkid> : référence spatiale des coordonnées x,y ajoutées à la carte. Si vous n'incluez pas de WKID, les coordonnées GCS sont utilisées.
  • <titre codé> : titre de la fenêtre contextuelle de point. Si vous n'incluez pas de titre, la fenêtre contextuelle sera vide.
  • <URL d'icône codée> : symbole du point. Si vous n'incluez pas de symbole, un symbole ponctuel bleu est utilisé.
  • <étiquette codée> : étiquette en regard du symbole de point.

Vous devez prendre en compte les éléments suivants :

  • <x>,<y> sont requis.
  • Veillez à coder les paramètres de titre, d'icône et d'étiquette.
  • Vous devez ajouter des propriétés dans cet ordre : marker=<x>,<y>,<wkid>,<titre codé>,<URL d'icône codée>,<étiquette codée>.
  • Vous pouvez utiliser des virgules ou des points-virgules comme séparateurs. Utilisez des points-virgules si vos nombres ont deux points comme symbole de décimales.
  • Utilisez des valeurs vides. N'utilisez pas d'espaces. Par exemple, si vous voulez préciser une étiquette et aucune autre propriété facultative, ajoutez l'étiquette en tant que sixième paramètre avec des valeurs vides pour les autres (x;y;;;;label).
  • Si vous voulez appliquer un zoom avant sur la carte (en plus de centrer sur le point), incluez le paramètre level=.

Par exemple :

http://<your portal url>/apps/webappviewer/index.html?marker=-79.234826;38.147884;;Race start and finish;;Grindstone 100 Ultra Marathon&level=7

Interroger une entité

Pour interroger une entité et zoomer dessus, vous pouvez utiliser une des options suivantes :

  • query=<layer name>,<field name>,<field value>
  • query=<layer name>, <where clause>
  • query=<layer id>,<field name>,<field value>
  • query=<layer id>, <where clause>
Attention :

Tous les paramètres de requête respectent la casse et doivent être codés.

Comme le nom de la couche peut être modifié, il est fortement recommandé d'utiliser l'ID de la couche dans la requête. Vous pouvez récupérer l'ID de la couche à partir de l'ID de la carte Web, comme illustré ci-dessous.http://<your portal url>/sharing/rest/content/items/32a83775654249dcae6b8f2eff5d4072/data/?f=pjson

Pour une sous-couche dans un groupe de services de carte, utilisez <layer id_sublayer id> comme ID de la couche.

Exemples:

http://<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,STATE NAME='California'
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,POP2000,33871648
http://<your portal url>/apps/webappviewer/index.html?id=da80a448ac9246148da0811bddc18c94&query=Census_7501,POP2000=33871648

Changer de langue

Pour modifier la langue de l'application, utilisez locale=<language code>. Ces codes de langues sont pris en charge : 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 et zh-tw.

Par exemple :

http://<your portal url>/apps/webappviewer/index.html?locale=fr

Authentifier un utilisateur

Pour authentifier automatiquement un utilisateur dans une application non publique, utilisez token=<token>. Ainsi, les utilisateurs n'ont pas besoin de saisir leur nom d'utilisateur et leur mot de passe. Par exemple :

http://<your portal url>/apps/webappviewer/index.html?token=utmVcabc_LNyEQ7OuuHD73em0MErLR_cudJTeSIdMFTnL0poF3shVBeng5ieWHyZn0kAA8nhUg7jseQxz3bi5crnFMMpldDiJLrtzmO3jEM-ZNVIUEh5_qMms-YgXUwGgFbeQlM9WaI3jwraUqwah0yCceBAxEkEIAEWvlBEDfVsYs3LZydORRcs2QIcdLas

Contrôler l'activation de la mise en page mobile

L'application prend en charge deux styles de mise en page en fonction de la taille d'écran. Une est destinée aux ordinateurs de bureau et l'autre aux appareils mobiles. Lorsque la hauteur ou la largeur d'un écran est inférieure à 600 pixels, la mise en page mobile s'applique automatiquement. Toutefois, ceci peut produire un comportement inattendu lorsque l'application est incorporée sur un site Web. Par exemple, la fenêtre contextuelle sur le site Web peut adopter le style de mise en page mobile. Pour contrôler le style de mise en page, utilisez mobileBreakPoint=<pixel number>. Par exemple, vous pouvez conserver le style bureautique tant que la taille d'écran n'est pas inférieure à 300 pixels :

http://<your portal url>/apps/webappviewer/index.html?mobileBreakPoint=300