Barre latérale

Le modèle Barre latérale repose sur le modèle d’application Web Barre latérale de Instant Apps. Il fournit une expérience d’application native pour un ensemble d’outils et d’options qui apparaissent dans un volet latéral en regard de la carte. Vous pouvez inclure les outils cartographiques essentiels pour explorer la carte et les géosignets et zoomer sur des régions en particulier. Fournissez des outils de mise à jour pour permettre aux utilisateurs d’ajouter et de mettre à jour des entités dans la carte. Configurez des filtres permettant d’obtenir davantage d’informations sur les données.

Conditions requises

Les conditions requises pour utiliser le modèle Barre latérale sont les suivantes :

• Fournissez une ou plusieurs applications Web Barre latérale. Il peut s’agir d’un seul ID d’élément valide, de l’ID d’un groupe contenant plusieurs applications Web Barre latérale ou d’une requête de recherche contenant plusieurs ID d’élément.
• Les applications Web Barre latérale peuvent être publiques ou sécurisées. Pour accéder à une application Web sécurisée dans votre organisation ArcGIS Online ou dans le portail de ArcGIS Enterprise en utilisant l’authentification OAuth2, inscrivez votre application et fournissez un ID de client. Pour plus d’informations, reportez-vous à Signer votre application. Par défaut, seules les applications Web Barre latérale publiques apparaissent dans la bibliothèque Barre latérale. Pour accéder aux applications Web Barre latérale sécurisées, cliquez sur Settings (Paramètres) > Licensing (Licences) > Gallery (Bibliothèque) et fournissez un ID de client.

Fonctionnalités de l’application

La liste suivante inclut les paramètres et fonctionnalités clés qui, s’ils sont configurés dans l’application Web, sont pris en charge dans l’application native :

• Layer list (Liste de couches) : affiche la liste des couches avec des icônes permettant d’activer et de désactiver leur visibilité sur la carte. Vous pouvez choisir quelles couches inclure dans l’outil lors de l’exécution.
• Bookmarks (Géosignets) : effectue un zoom et un déplacement sur la carte vers une collection d’étendues prédéfinies enregistrées dans la carte.
• Pop-up (Fenêtre contextuelle) : présente le contenu contextuel lorsqu’un utilisateur touche une entité.
• Edit tools (Outils de mise à jour) : propose des options permettant d’ajouter et de mettre à jour des entités dans des couches modifiables.
• Details (Détails) : affiche dans le volet latéral de l’application le contenu de la description des détails d’élément de la carte source.
• Filter (Filtrer) : filtre les données dans la carte en fonction d’options préalablement définies.
• Basemap toggle (Bouton de bascule du fond de carte) : modifie l’aspect de la carte en changeant de fond de carte.

Une application créée avec le modèle Barre latérale prend également en charge les cartes hors connexion lorsque les couches et cartes sont activées pour l’utilisation hors connexion.

Personnaliser une application

Une fois que vous avez créé une application, vous pouvez la personnaliser en modifiant ses paramètres.

Démarrez AppStudio, puis, dans le volet latéral, cliquez sur Settings (Paramètres) > Properties (Propriétés). La table suivante présente le contenu des onglets de l’onglet Sidebar Properties (Propriétés de Barre latérale), triés en fonction de l’onglet sur lequel ils apparaissent et de leur utilisation. Vous pouvez également modifier les propriétés directement dans le fichier appinfo.json de l’application. Si vous modifiez ces propriétés, cliquez sur Apply (Appliquer) pour les enregistrer avant de redémarrer votre application.

Contenu de l'onglet Ecran de démarrage

Propriété	Nom JSON	Type	Description
Image d’arrière-plan	startBackground	Chaîne (URL image)	Image à utiliser en arrière-plan de la page de démarrage.
Couleur personnalisée	brandColor	Chaîne (valeur de couleur)	Couleur à utiliser comme couleur principale.
Fichier de police de titre	mediumFontTTF	Chaîne (URL fichier de polices)	Définit la police de titre personnalisée à utiliser dans toute l’application. Cette police sera utilisée dans les en-têtes, les titres de pages, etc.
Fichier de police de texte	regularFontTTF	Chaîne (URL fichier de polices)	Définit la police de texte personnalisée à utiliser dans toute l’application. Cette police sera utilisée dans les descriptions de photos, le texte À propos de l’application, etc.
Adresse e-mail pour les commentaires	feedbackEmail	Chaîne (ID du message électronique)	Adresse e-mail à laquelle les commentaires des utilisateurs doivent être envoyés.
Afficher la clause de non-responsabilité	showDisclaimer	Booléen (true|false)	Affiche le texte de la clause de non-responsabilité dans une fenêtre contextuelle dans l’application. Ce texte correspond au contenu de la section Access and Use Constraints (Restrictions d’accès et d’utilisation) de l’onglet Details (Détails).

Contenu de l'onglet Bibliothèque

Propriété	Nom JSON	Type	Description
Applications Web Barre latérale	galleryMapsQuery	Chaîne	Saisissez une requête ArcGIS pour répertorier les applications Web Barre latérale valides dans la bibliothèque. Il peut s’agir d’un seul ID d’élément valide de l’application Web, tel que id:87e4ea0800d64d4cb0e9d2e3784a5519, d’un ID de groupe contenant plusieurs applications Web, tel que group:47597bdf4b6d49fd85c0f4175a6e7b60 ou d’une requête de recherche avec plusieurs ID d’élément d’application Web, telle que (id:87e4ea0800d64d4cb0e9d2e3784a5519 OR id:5a2cff5558704870bd5dbe36fbb94183).
Nombre total de résultats à afficher dans la bibliothèque	maxNumberOfQueryResults	Nombre	Saisissez le nombre maximal d’applications Web que l’interrogation du portail doit renvoyer.
URL de Portal	portalUrl	Chaîne	URL de Portal à interroger pour rechercher des applications Web Barre latérale.
Prendre en charge les applications Web sécurisées	supportSecuredMaps	Booléen (true|false)	Offre la possibilité de se connecter à une organisation pour accéder aux applications Web sécurisées conformément aux paramètres de requête.
Ignorer la connexion	enableAnonymousAccess	Booléen (true|false)	Si la propriété Support secured web apps (Prendre en charge les applications Web sécurisées) est définie sur true (vrai), la définition de cette option sur true (vrai) permet d’ignorer l’étape de connexion et de n’afficher que les applications Web en accès public dans la bibliothèque.
Champ de tri du portail	portalSortField	Chaîne	Utilisé pour trier les applications Web affichées dans la bibliothèque. Les valeurs possibles sont notamment : title, created, type, owner, modified, avgRating, numRatings, numComments et numViews.
Ordre du tri du portail	portalSortOrder	Chaîne	Utilisé avec le champ de tri de la bibliothèque pour classer les applications Web par ordre croissant ou décroissant. Les valeurs possibles sont asc ou desc.