Manuel de référence de Geoconcept Web  -  Utilisation

Cette section permet d’interroger les cartes Geoconcept ou des sources webmaps afin de les afficher sous forme de tuiles, via une interface de paramètres. Elle permet de :

Dans la section Couches tuilées, il est possible :

S’il n’existe aucune couche, il n’est possible que d’ajouter une nouvelle couche. S’il existe au moins une couche, la liste des couches s’affiche et présente :

Ajouter une couche ou Editer une couche

Le bouton Ajouter affiche la page de définition de couche organisée en deux onglets :

Onglet Définition

Les options ci-dessous ne sont disponibles que pour les couches basées sur une carte.

Onglet Information

A titre informatif, les champs de cet onglet sont récupérées automatiquement lors de la sélection de la carte puis de l’onglet de visibilité. Ces paramètres sont :

Le calcul des ratios est dépendant de l’unité, de la résolution (précision) et des valeurs des 12/24 échelles logiques de cette carte.

Le bouton Enregistrer enregistre la création ou l'édition de la couche. Pour annuler, il faut soit utiliser le bouton Revenir soit sélectionner la section Couches ou tout autre section du module d’administration.

Le bouton Mettre à jour est utilisé pour mettre à jour les ratios.

Le bouton Test permet de lancer un test d’affichage de la carte sur la couche en cours d'édition.

Le bouton Supprimer permet de supprimer la couche courante.

Calculer le cache d’une couche :

Le bouton Cache permet de lancer un processus de calcul de tuiles sur la couche pour les stocker dans un cache (Cf. section Cache du module d’administration).

Il ouvre une page d'édition des paramètres du processus, des tuiles et du cache concerné. Les paramètres sont :

Le dessin d’un polygone peut être sauvegardé en cliquant sur le bouton Enregistrer, renseigner ensuite son nom dans la fenêtre de dialogue. Il apparait ensuite dans le menu déroulant de la carte et pourra être réutilisé ultérieurement pout d’autres calculs de caches.

Par défaut les limites de l’espace de travail de la carte sont utilisées.

Le bouton Démarrer lance le processus de calcul des tuiles dans le cache. Dans le cas où aucun processus précédent n’a été défini, le démarrage est immédiat. Dans le cas où un processus précédent a été défini, le démarrage se fera après la fin du processus précédent choisi.

La rubrique Outils / Processus permet d’effectuer un suivi en temps réel de l’ensemble des processus de calcul de cache.

Le bouton Revenir permet l’annulation des modifications de la couche et/ou le retour à la fenêtre d'édition de la couche.

Temps de génération

Le temps de génération des tuiles varie d’une part en fonction de la puissance du serveur utilisé et d’autre part en fonction de l’emprise de la zone du nombre et des échelles calculées. Il n’est pas forcément pertinent de générer tous les niveaux d'échelles, car le changement d’un seuil de 2 (par exemple du 1/10 000 au 1/5 000) multiplie par 4 le nombre de tuiles et le temps de génération.

Pour accélérer la pré-génération des tuiles, il est recommandé d’utiliser la valeur 4 pour les méta-tuiles.

L’utilisation du polygone définissant la zone à calculer permet d’optimiser le nombre de tuiles à générer. En effet pour chaque échelle l’emprise est recalculée au plus près du polygone et évite ainsi la pré-génération des tuiles inutiles car situées à l’extérieur du polygone.

Geoconcept Web permet de créer de nouvelles couches au démarrage du service. Pour cela il convient de créer le fichier « htc-layers-configuration.xml » dans le classpath du serveur d’application. Dans le cas de Tomcat, il faut placer le fichier dans le répertoire lib.

Voici un exemple de configuration du fichier xml :

<?xml version="1.0"?>

<htcLayersConfiguration>
        <updatable>false</updatable>
        <layerDefinitions>
                <layerDefinition>
                        <name>layername</name>
                        <map>geoconceptmap</map>
                        <tabName>tabname</tabName>
                </layerDefinition>
        </layerDefinitions>
</htcLayersConfiguration>

Le paramètre updatable à true permet de mettre à jour la couche si celle-ci existe déjà. Dans le cas de false, la couche est créée si elle n’existe sinon elle n’est pas modifiée.

La liste des couches à créer se trouve dans le tag « layerDefinitions ». Il est possible ici de créer plusieurs couches en ajoutant autant de « layerDefinition » que nécessaire. Pour une couche, 3 paramètres sont obligatoires « name », « map », « tabName ». Voici la liste des paramètres disponibles sont les suivants.

Paramètres obligatoires :

Paramètres optionnels :

Sources webmaps Lorsque la section Sources webmaps est choisie, il est possible :

S’il n’existe aucune source de données, il n’est possible que d’en ajouter une nouvelle. S’il en existe au moins une, la liste des sources de données s’affiche et présente :

Ajouter ou Editer une source de données

Est définit ici :

Le bouton Enregistrer enregistre la création de la source de données webmaps. Pour annuler, il faut soit utiliser le bouton Revenir soit sélectionner la section Sources webmaps ou tout autre section du module d’administration.

Le bouton Supprimer permet de supprimer la source de données courante.

Cette section permet de créer des groupes de couches résultant d’une association de plusieurs couches vectorielles afin de réduire le nombre de couches à afficher dans le portail depuis les widgets Gestionnaire de couches simple et Gestionnaire de couches avancé.

Les paramètres sont :

Lorsque la section Couches vectorielles est choisie, il est possible :

S’il n’existe aucune couche, il n’est possible que d’ajouter une nouvelle couche. S’il existe au moins une couche, la liste des couches s’affiche et présente :

Ajouter une couche ou Editer une couche

On définit ici :

Toutes les couches sont visibles pour tous les groupes d’utilisateurs ayant le droit d’accéder au portail.

Les droits d’utilisation des widgets édition se fait dans le Composer au niveau de chaque widget (création, modification de géométrie, suppression et modification des attributs).

Les outils de sélection des objets vecteurs ou de requêtes permettent d’afficher le résultat de la recherche tableau Résultat de recherche. Dans celui-ci, le bouton ouvrir la fiche permet d’éditer directement les attributs d’un objet.

Afin de restreindre les droits d’édition dans le tableau Résultat de recherche, il faut définir pour chaque couche vecteur les droits d’édition, avec le paramètre Groupes pouvant modifier cette couche dans le menu Administration ▸ Couches ▸ Couches vecteurs ▸ Détails de la couche simple

La case à cocher Actualiser la couche périodiquement permet d’actualiser automatiquement la couche vectorielle sans qu’il soit nécessaire pour les utilisateurs de rafraîchir leur navigateur.

Actualiser la couche périodiquement Ce mécanisme s’appuie la table gw_vector_update. Cette table contient, pour chaque couche concernée, l’heure de sa dernière mise à jour. Il est nécessaire d’ajouter un trigger sur les tables vectorielles qui met à jour la table gw_vector_update. Les implémentations peuvent varier, mais voici un exemple possible basé sur PostgreSQL/PostGIS et la table « postgis.city ».

Trigger lié à la table postgis.city 

CREATE TRIGGER log_city_changes
    AFTER INSERT OR UPDATE OR DELETE
    ON postgis.city
    FOR EACH ROW
    EXECUTE PROCEDURE public.log_city_change();

Fonction ajoutée aux Trigger functions 

-- Function: public.log_city_changes()

-- DROP FUNCTION public.log_city_changes()

CREATE OR REPLACE FUNCTION public.log_city_changes()
    RETURNS trigger AS
&BODY&
BEGIN
    UPDATE public.gw_vector_update
    SET last modified=NOW()
    WHERE TABLE_NAME=TG_RELNAME;
    RETURN NEW;
END;
&BODY&
    LANGUAGE plpgsql VOLATILE
    COST 100;
ALTER FUNCTION public.log_city_changes()
    OWNER TO postgres;

Sont également visibles cinq onglets :

Style Cet onglet permet de gérer l’apparence des objets de la couche. Il existe des styles par défaut définis pour les points, les lignes et les surfaces ; mais pour chaque couche, il est possible de paramétrer une apparence spécifique. Lors de la création de la couche, le style apparaissant dans la fenêtre de visualisation est le style par défaut. Le bouton Modifier permet d’accéder aux différents paramètres du style.

Les paramètres disponibles varient en fonction du type de style :

Ponctuel

Linéaire

Surfacique

Champs Cet onglet liste les champs de la couche, et permet d’une part de choisir ceux à proposer aux utilisateurs, en cochant ou décochant la case correspondante, et d’autre part de leur spécifier un libellé différent (Alias) pour, par exemple, les simplifier. La colonne Secteur permet de décider le champ utilisé lors de la définition des secteurs (voir la section secteur. Enfin, la colonne Afficher est utilisée pour définir un style d’objet en fonction de la valeur du champ ou pour faire apparaître cette valeur dans un libellé (voir l'Annexe SLD, elle est utilisable pour tous les styles SLD, y compris celui utilisé pour afficher les résultat du Widget Recherche à proximité.

Fiche Cet onglet permet de définir les champs, leur ordonnancement, leur protection ou si leur saisie est obligatoire depuis le formulaire d'édition des objets. L’administrateur peut créer une liste de valeurs, pour faciliter la saisie d’un champ et d'éviter les erreurs (fautes de frappe évitées, valeurs inconnues renseignées, etc). Dans Administration ▸ Couches ▸ Couches vecteurs, choisir la couche de données vectorielles puis :

Filtre Cet onglet permet de définir des filtres de la couche en sa basant sur le même formulaire que celui des requêtes. Cela permet ainsi de créée l'équivalent de "vue" d’une base de données et d’associer à chaque couche un style distinct en fonction du filtre.

Données Cet onglet permet d’avoir un aperçu des données attributaires de la couche.

Le bouton OK enregistre la création ou l'édition de la couche. Pour annuler, il faut soit utiliser le bouton Revenir soit sélectionner la section Couches ou tout autre section du module d’administration.

Le bouton Supprimer permet de supprimer la couche courante.

Le bouton Dupliquer permet de dupliquer la couche courante en incluant tous les paramètres des onglets Champs, Fiche et Filtre. Ce bouton a été ajouté pour faciliter la création de couches filtrées sur une même table, l’administrateur n’a plus qu'à modifier la valeur de filtre sur les couches dupliquées.

Sources

Lorsque la section Sources est choisie, il est possible :

S’il n’existe aucune source de données, il n’est possible que d’en ajouter une nouvelle. S’il en existe au moins une, la liste des sources de données s’affiche et présente :

Ajouter ou Editer une source de données

Est définit ici :

update <table> set <colonne geom>.STSrid=0;

Sont également visibles deux onglets :

et éventuellement :

Le bouton OK enregistre la création ou l'édition de la source de données. Pour annuler, il faut soit utiliser le bouton Revenir soit sélectionner la section Sources ou tout autre section du module d’administration.

Le bouton Supprimer permet de supprimer la source de données courante.

Styles par default

A partir la version 2022, le comportement des styles a été modifié, pour les couches créées dans les versions antérieures, il est nécessaire de faire les opérations suivantes :

Les styles par défaut sont conservés mais désormais la définition du style se fait dans chaque couche vectorielle.

Lorsque la section Styles par défaut est choisie, il est possible :

La liste des styles s’affiche et présente :

Par défault 8 modèles de style sont proposés :

Ces 8 styles sont modifiables mais ne peuvent pas être supprimés.

Editer un modèle de style :

Seuls les aspects graphiques des modèles de styles peuvent être modifiés

Les paramètres disponibles varient en fonction du type de style :

Ponctuel

Linéaire

Surfacique

Le bouton OK enregistre la création ou l'édition d’un style. Pour annuler, il faut soit utiliser Revenir soit sélectionner la section Styles ou tout autre section du module d’administration.

Le bouton Supprimer permet de supprimer le style courant.

L’administrateur doit réaliser cette étape en ayant déjà une idée du nombre d'« états » / de « status », qu’il souhaite créer pour les notes. Pour créer ses styles, l’utilisateur doit aller dans l’onglet Administration, puis dans les menus Couches ▸ Couches vecteurs ▸ Styles et enfin cliquer sur Ajouter. Une nouvelle interface permet :

Pour l’administrateur, il s’agit de créer les différents statuts de traitement que la Note pourra avoir. Par exemple, il peut créer 3 états qui sont :

Ainsi, lorsqu’un utilisateur du portail cartographique créé une note, cette dernière indiquera que son statut est « Nouveau », puisque cette remontée d’information vient tout juste de paraitre. Si l’administrateur traite cette Note, il pourra faire passer son statut de « Nouveau » à « En cours d’analyse » ou directement à « Traité ».

Afin de créer les différents statuts des futures notes, cliquer sur l’onglet Designer, puis dans les menus Notes ▸ Etats et enfin cliquer sur Ajouter.

L’administrateur peut alors définir :

Les valeurs des champs sujet et texte sont utilisées lors de l’envoi des méls (cf. paragraphe ci-après).

Une fois que le style et les états ont été créés, l’administrateur peut mettre en place une série d'actions que l’utilisateur pourra choisir lors de la création d’une note. Il n’y a pas de limite dans la création du nombre d’actions et il est possible de hiérarchiser l’affichage de ces dernières.

Pour créer les différentes actions qui seront proposées à la création d’une nouvelle note, cliquer sur l’onglet Designer, puis dans les menus Notes ▸ Actions et enfin cliquer sur Ajouter.

L’administrateur peut alors définir :

Une fois cette préparation réalisée, l’administrateur peut peaufiner les réglages de ce widget en allant voir les propriétés de ce dernier dans le Composer.

Mise à jour du cache

Cette fonction permet de mettre à jour le cache des méta-données d’une carte. Il est recommandé de l’utiliser en cas modification de la structure d’une carte (ajout de Type ou Sous-type, onglets, emprise, …).

Gérer une clé d’application

Permet d’associer une clé d’application à un projet afin de le protéger. La clé d’application doit être créé au-préalable depuis le Administration ▸ Outils ▸ Services.

Geoconcept web fournit un éditeur permettant la création de widgets.

Le bouton Liste des widgets permet d’accéder au tableau listant les widgets créés et stocké en base de données.

L’édition de widgets nécessite des connaissances en programmation (JavaScript et CSS). Un widget s’appuie sur les technologies YUI et / ou JQuery. Les dépendances peuvent être chargées via le module require.js. L’ensemble des widgets de Geoconcept Web se base le module principal WidgetBase. Ils héritent tous de méthodes permettant la manipulation de la carte ou de l’objet. Une API ainsi qu’un tutorial est disponible ici et ils fournissent la liste de l’ensemble des méthodes proposés par défaut.

Les widgets manipulent la carte, dont l’api est disponible ici.

Liste des widgets

Chaque widget créé est ainsi listé dans le tableau. On peut distinguer les informations suivantes :

Il existe 2 états de version concernant un widget. La version TEMP concerne l’état en cours de modification d’un widget. La version représentée par une valeur numérique correspond à la valeur sauvegardée du widget.

Le versionning des widgets est fait de façon automatique lorsque de chaque sauvegarde.

Pour créer un nouveau widget, il est nécessaire de cliquer sur « Ajouter ».

Pour mettre à jour un widget existant, il faut cliquer sur le nom associé à ce widget.

Afin de déployer les widgets sur le serveur et ainsi les utiliser dans les portails, il faut cliquer sur le bouton Publier. Cette opération génère un fichier externalWidgets.jar qui est placé dans le répertoire utilisé pour les widgets externes. Le chemin du répertoire est défini dans les paramètres de l’administration de Geoconcept web par la clé easy.widgets.path.

Le bouton Publier reprend tous les widgets listés dans le tableau. Cette fonctionnalité se base sur les dernières versions définitives enregistrées pour les placer dans le fichier jar.

Ecran de création

Par défaut, Geoconcept Web propose un template afin de débuter la création d’un widget. Celui-ci se nomme MyWidget. Il s’agit d’un simple bouton qu’il convient d’enrichir.

L’écran d’édition se défini de la façon suivante :

Le bouton Exécuter permet de tester son widget dans une interface. Suite au clic de ce bouton, une sauvegarde est faite en base de données et la version utilisée est alors TEMP. La version TEMP est obligatoirement la dernière version du widget.

L’interface d’édition permet de renseigner le « JavaScript », le « CSS », le « XML ». Ces trois éléments définissent le comportement du widget dans un portail.

Les éléments « HTML for test » et « JS for test » permettent de définir ou d’appeler des méthodes à exécuter dans la page de test.

Par exemple dans Geoconcept Web, un bouton est défini dans une DIV. Il convient alors de créer cette DIV dans la partie « HTML for test » puis de l’utiliser dans la « JS for test ». Le template par défaut de création pré renseigne déjà ces 2 éléments.

Afin de finaliser la création du widget, il faut cliquer sur le bouton OK. L’action de sauvegarde incrémente le versionning du widget en cours d’édition et affichera donc ce numéro dans la liste des widgets. Le bouton Revenir permet de retourner à l’écran précédent.

Ecran de test

L’écran de test met à disposition une carte que l’on peut manipuler. Dans notre cas, le bouton est ajouté par la suite car une DIV a été définie lors de l’édition.

Des tests peuvent aussi être ajoutés dans la partie édition, dans l’espace « JS for test ».

Si le comportement correspond à ce que l’on attend, le widget peut être sauvegardé via le bouton OK. Sinon le bouton Revenir permet de basculer sur l’écran d’édition.