Skip To Content

Créer des modèles d'applications

Pour créer votre propre modèle d'application Web personnalisée, vous pouvez télécharger et modifier un des modèles existants, mettre à jour une application Web existante pour utiliser le contenu depuis votre portail ou créer une nouvelle application Web à l'aide d'une des API Web ArcGIS. Quelle que soit la manière dont vous créez votre propre modèle, vous utiliserez des paramètres URL et des cartes. Vous pouvez utiliser des groupes si vous créez un modèle de groupe et vous pouvez envisager des conditions supplémentaires pour utiliser des cartes de base Bing, accéder à des cartes non publiques et utiliser des ressources qui nécessitent un proxy ou un service CORS (Cross-Origin Resource Sharing). Vous ajouterez également votre élément à votre portail et, si votre organisation prévoit d'utiliser votre modèle dans sa bibliothèque des modèles, vous le partagerez avec l'un des groupes de modèles de votre organisation.

Portal for ArcGIS comprend ArcGIS API 3.15 for JavaScript. Vous n'avez pas besoin d'héberger votre propre API ni de faire pointer le portail sur la version locale pour les modèles d'applications de création récente. Ceux-ci font automatiquement référence à l'API installée. L'API installée localement est généralement disponible à l'adresse suivante : https://webadaptor.domain.com/arcgis/jsapi/jsapi.

Attention :

Ne modifiez pas les fichiers de modèles d'applications Web fournis avec Portal for ArcGIS, car ces fichiers sont gérés par le portail et toute modification que vous y apportez peut être supprimée par le portail par la suite. Pour personnaliser les modèles, procédez comme suit :

  1. Créez une copie du fichier de modèle existant que vous souhaitez personnaliser.
  2. Placez cette copier dans un emplacement différent sur le disque.
  3. Personnalisez la copie du modèle.
  4. Ajoutez-la à votre portail en tant que nouveau modèle.

Cette rubrique explique comment créer un modèle d'application Web. Vous devez disposer des privilèges appropriés pour créer du contenu et le partager avec les groupes de votre organisation. Une fois que vous avez créé votre modèle, vous pouvez le rendre configurable. Les modèles configurables permettent aux utilisateurs de personnaliser l'apparence et le comportement de l'application.

Cartes Web

Les modèles de cartes sont conçus pour fonctionner avec la carte actuellement affichée dans la visionneuse de carte. Les modèles créent généralement une carte en fonction de la carte Web spécifiée dans le paramètre URL de la carte Web. Chacune des API Web possède une méthode d'assistance qui crée une carte à l'aide des informations issues de l'ID de la carte Web.

Vous pouvez par exemple utiliser la méthode d'ArcGIS API for JavaScriptesri.arcgis.utils.createMap pour créer une carte en fonction de l'ID en entrée. Vous pouvez également inclure une fonction de rappel qui s'exécute lorsque la requête synchrone sur esri.arcgis.utils.createMap est terminée.

esri.arcgis.utils.createMap(webmap,"map",{
   mapOptions:{
     slider:false
   },
   bingMapsKey:bingMapsKey
}).then(function(response){
    map = response.map;
});
Remarque :

Si certaines de vos cartes Web incluent un fond de carte Bing Maps, vous devez indiquer une clé Bing Maps avec la méthode createMap. Vous pouvez également spécifier plusieurs autres options cartographiques, telles qu'indiquer si vous souhaitez afficher le curseur, la navigation, l'attribution, etc.

La fonction de callback permet d'accéder à un objet de réponse qui fournit l'accès à l'objet de carte, aux couches, etc.

Enregistrer le modèle d'application

Si vous utilisez des éléments sécurisés dans votre modèle d'application, vous devez l'enregistrer auprès de la plate-forme. Pour ce faire, vous devez ajouter un nouvel élément d'application cartographique Web et définir l'URL sur le modèle d'application hébergé sur votre serveur Web.

Une fois que vous avez ajouté votre élément, vous devez enregistrer l'application. Puisqu'il s'agit d'une application Web, conservez le type défini sur Browser avec l'Redirect URI qui pointe sur l'URL de l'application modèle.

Une fois que vous avez enregistré votre application, vous devez détenir un ID d'application unique.

Travaillez avec le Gestionnaire d'identité pour qu'il reconnaisse l'ID de l'application enregistrée. Pour plus d'informations, consultez les exemples d'OAuth OAuth Basic et OAuth Popup contenus dans ArcGIS API for JavaScript.

Groupe

Les modèles de groupes affichent le contenu provenant du groupe spécifié sous forme d'une application.

L'API REST d'ArcGIS permet d'accéder au contenu depuis votre portail. Vous pouvez l'utiliser pour extraire le contenu du groupe en fonction de l'ID de groupe en entrée.

Dans cet exemple, vous effectuez une requête pour trouver un groupe avec l'ID en entrée.

var portal = new esri.arcgis.Portal('https://webadaptor.domain.com/arcgis/');
dojo.connect(portal, 'onLoad',function(){
    portal.queryGroup(groupid).then(function(response){
        var group = response.results[0];
     });
});

Une fois le groupe trouvé, vous pouvez demander à extraire les éléments du groupe.

Dans cet exemple, vous interrogez le groupe pour trouver cinq éléments de type Web Map ou Web Mapping Application.

var queryParams = {
    q: 'type:"Web Map" -type:"Web Mapping Application"',
    num: 5
 };
group.queryItems(queryParams).then(function(response){
    var groupItems = response.results;
});

Autres éléments à prendre en compte

Les applications Web étant généralement conçues pour fonctionner avec de nombreux types de contenu différents, vous devrez peut-être paramétrer le modèle pour gérer les cartes comportant des fonds de carte Bing Maps, du contenu non public, etc. Vous trouverez ci-dessous des remarques spécifiques.

Clé Bing Maps

Si certaines des cartes que vous souhaitez afficher utilisent un fond de carte Bing Maps, vous devez inclure une clé Bing Maps dans votre application. La clé Bing Maps est fournie sous forme de paramètre à la méthode createMap.

Prise en charge proxy et CORS

Si votre application doit effectuer des requêtes inter-domaines, vous devez activer CORS (Cross-Origin Resource Sharing) ou ajouter un proxy à votre application.

Ajouter le modèle dans votre portail

Une fois que vous avez créé le modèle et que vous l'avez hébergé sur votre serveur Web, ajoutez le modèle dans votre portail en tant qu'élément d'application Web et spécifiez l'URL de l'application. Pour cela, sélectionnez Configurable. Sélectionnez Javascript comme API.

N'oubliez pas d'inclure un titre descriptif et un résumé, car ces informations s'affichent lorsque les utilisateurs placent le curseur de la souris sur l'élément de modèle dans la bibliothèque des modèles. Vous pouvez également créer un fichier ZIP contenant les fichiers de votre application et l'associer à l'élément pour permettre de la télécharger.

Utiliser le modèle dans la bibliothèque d'applications de votre organisation

Si vous souhaitez utiliser le modèle dans la bibliothèque d'applications de la visionneuse de carte ou la bibliothèque d'applications de groupes de votre organisation, partagez l'élément avec le groupe utilisé pour cette bibliothèque. L'administrateur de votre organisation pourra configurer la visionneuse de carte ou configurer les groupes de façon à utiliser le groupe qui comprend votre modèle.