A partir de Portal for ArcGIS 10.5.1, vous pouvez ajouter des widgets à votre portail. Cela signifie que vous pouvez choisir les widgets personnalisés dans l'environnement de conception lorsque vous créez l'application. Avant d'utiliser un widget personnalisé, il doit être hébergé sur un serveur web et enregistré auprès de votre portail. Pour des raisons de sécurité, seuls les administrateurs du portail peuvent enregistrer le widget personnalisé et les applications publiques ne le chargent pas lorsque des utilisateurs anonymes y accèdent.
Héberger un widget personnalisé sur un serveur web
L'hébergement d'un widget personnalisé sur un serveur web s'apparente à l'hébergement de n'importe quelle autre application web. Vous devez installer et configurer un serveur web. Les serveurs web courants sont notamment IIS, OS X Server et Apache.
Pour héberger des widgets personnalisés sur votre serveur web, procédez comme suit :
- Activez l'accès anonyme sur votre serveur web.
L'emplacement d'hébergement doit être accessible anonymement.
- Activez HTTPS.
Activez l'accès HTTPS sur votre serveur web pour éviter de créer du contenu mélangé. Web AppBuilder n'autorise pas le contenu actif mélangé engendré par le chargement HTTP sous une connexion HTTPS. En outre, votre serveur doit posséder un certificat SSL valide émis par une autorité de certification pour établir la connexion HTTPS.
- Activez la norme CORS (Enable Cross Origin Resource Sharing).
Web AppBuilder s'exécute sous votre domaine de portail, qui peut être différent du domaine du serveur web hébergeant votre widget personnalisé. Vous devez activer CORS sur le serveur web afin d'autoriser l'accès depuis votre domaine de portail.
- Ajoutez un gestionnaire JSON à votre serveur web.
Chaque widget se compose d'un fichier manifeste JSON qui décrit les propriétés du widget. Certains serveurs web ne reconnaissent pas l'extension de fichier JSON par défaut. Dans ce cas, vous devez l'ajouter à votre serveur web comme nouveau type MIME au niveau de l'application ou à un niveau supérieur. Le type MIME doit comporter l'extension du nom de fichier .json et le type MIME application/json.
- Déployez le widget personnalisé sur votre serveur web.
Vous pouvez copier le dossier du widget personnalisé sur votre serveur web. Après le déploiement, vous devez obtenir le chemin d'URL menant au fichier manifeste de votre widget personnalisé. Voici un exemple de chemin d'URL menant à un fichier manifeste : <server.domain.com>/<my widget>/manifest.json.
Enregistrer un widget personnalisé
Vous devez enregistrer chaque widget personnalisé dans votre portail. Pour ce faire, vous devez être connecté en tant qu'administrateur.
- Dans une fenêtre de navigateur, connectez-vous au portail.
- Cliquez sur Mon contenu.
- Cliquez sur Ajouter un élément et choisissez Une application.
- Choisissez Extension d'application (App Builder) et indiquez l'URL de votre fichier manifeste.
Voici un exemple de chemin d'URL menant à un fichier manifeste : <server.domain.com>/<my widget>/manifest.json.
- Cliquez sur la zone Titre.
Le titre de votre élément est automatiquement renseigné à partir du fichier manifeste. Vous pouvez également mettre à jour manuellement le titre.
- Ajoutez des balises dans la zone Balises.
- Cliquez sur Ajouter un élément.
Votre widget personnalisé est désormais disponibles dans Mon contenu comme type Extension App Builder.
Partager un widget personnalisé
En tant qu'administrateur, vous pouvez partager le widget personnalisé avec des groupes de votre organisation qui ont besoin d'y accéder, ou avec l'organisation dans son ensemble le cas échéant.
Attention :
Il n'est pas recommandé de partager le widget personnalisé publiquement. Pour des raisons de sécurité, une application publique ne charge pas le widget personnalisé lorsque des utilisateurs anonymes y accèdent. En outre, une application charge uniquement le widget personnalisé qui est enregistré dans la même organisation que les utilisateurs autorisés à accéder à l'application.
Dans Mon contenu, accédez au widget personnalisé et partagez-le avec des groupes ou votre organisation. Lorsque vous ouvrez le générateur, votre widget personnalisé s'affiche sous l'onglet Personnalisé dans la boîte de dialogue Choisir un widget.
Mettre à jour un widget personnalisé
Même si vous ne pouvez pas mettre à jour le widget personnalisé dans votre portail, vous pouvez mettre à jour la structure HTML et le code JavaScript d'un widget personnalisé hébergé sur votre serveur web.
Remarque :
Lorsqu'un widget personnalisé a été déployé sur un serveur web et enregistré en tant que type Extension App Builder dans votre portail, le contenu du fichier manifeste est enregistré dans l'extension. Cela signifie que les modifications apportées à votre fichier manifeste qui est hébergé sur un serveur web ne seront pas reconnues par l'extension enregistrée. Il est recommandé de créer une nouvelle extension au lieu de mettre à jour le fichier manifeste.
Vous avez un commentaire à formuler concernant cette rubrique ?