Geoconcept Web Reference Guide  -  Utilisation

(fr) 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 :

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

(fr) 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 :

(fr) Ajouter une couche ou Editer une couche

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

(fr) Onglet Définition

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

(fr) Onglet Information

(fr) 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 :

(fr) 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.

(fr) 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.

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

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

(fr) Le bouton Supprimer permet de supprimer la couche courante.

(fr) Calculer le cache d’une couche :

(fr) 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).

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

(fr) 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.

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

(fr) 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.

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

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

(fr) Temps de génération

(fr) 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.

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

(fr) 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.

(fr) 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.

(fr) 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>

(fr) 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.

(fr) 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.

(fr) Paramètres obligatoires :

(fr) Paramètres optionnels :

(fr) Sources webmaps (fr) Lorsque la section Sources webmaps est choisie, il est possible :

(fr) 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 :

(fr) Ajouter ou Editer une source de données

(fr) Est définit ici :

(fr) 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.

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

(fr) 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é.

(fr) Les paramètres sont :

(fr) 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

(fr) On définit ici :

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

(fr) 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).

(fr) 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.

(fr) 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

(fr) 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.

(fr) Actualiser la couche périodiquement (fr) 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”.

(fr) 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();

(fr) 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;

(fr) Sont également visibles cinq onglets :

(fr) Style (fr) 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.

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

(fr) Ponctuel

(fr) Linéaire

(fr) Surfacique

(fr) Champs (fr) 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é.

(fr) Fiche (fr) 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 :

(fr) Filtre (fr) 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.

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

(fr) 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.

(fr) 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.

(fr) Sources

(fr) 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;

(fr) Sont également visibles deux onglets :

(fr) et éventuellement :

(fr) 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.

(fr) Styles par default

(fr) 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 :

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

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

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

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

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

(fr) Editer un modèle de style :

(fr) 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

(fr) 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.

(fr) Le bouton Supprimer permet de supprimer le style courant.

The administrator must perform this step with an idea in mind of the number of “states” / or “statuses”, they want to create. To create their own styles, the user should go into the Administration tab, and then into the Layers ▸ Vector layers ▸ styles menus, and finally click on Add. A new interface then displays allowing you to:

For the administrator, this means creating different treatment status categories that the Note might have. For example, an administrator might create 3 status categories that are:

This means that when a user of the mapping portal creates a note, they will indicate that its status is 'New', because this information upload has just appeared. If the administrator processes this Note, they could update their status from 'New' to 'Analysis in progress' or directly to 'Processed'.

In order to create the different statuses of future notes, click on the Designer tab, and then in the Notes ▸ Statuses menus, and finally click on Add.

The administrator can then define:

The values of the subject and text fields are used for sending emails (cf. the section that follows).

Once the style and the statuses have been created, the administrator can put in place a series of actions that the user can choose when creating a note. There is no limit to how many actions they can create, and it is possible to put the display of the latter in a hierarchy.

To create the different actions that will be proposed on creation of a new note, click on the Designer, then in the Notes ▸ Actions menus, and finally click on Add.

The administrator can then define:

Once this preparation stage has been accomplished, the administrator can preset and refine the settings for this widget by going to see the properties of this in the Composer.

Cache update

This function allows you to update the cache with metadata for a map. It is recommended to use this in the event of a modification made to the map structure (addition of a Class or Subclass, tabs, map footprint…).

Managing an application key

This allows association of key for the application to a project for the purpose of protecting it. The application key must be created beforehand via Administration ▸ Tools ▸ Services.

Geoconcept Web supplies an editor that allows widget creation.

The Widgets list button provides access to the table listing widgets created and stored in the database.

Composing the widgets requires some programming knowledge (JavaScript and CSS). A widget is based on YUI and /or JQuery technologies. Dependencies can be loaded via the require.js module. Geoconcept Web widgets are based on the main module WidgetBase. They inherit all the methods enabling manipulation of the map or of the object. An API as well as a tutorial is available here and they supply the list of all methods suggested by default.

The widgets handle the map, for which the api is available here.

List of widgets

Each widget created is listed in the table. We can distinguish between the following information items:

There are two version statuses that relate to a widget. The TEMP version concerns the status in the course of modification of a widget. The version represented by a numeric value corresponds to the widget’s saved value.

Versioning of widgets is applied automatically at the time of each save operation.

To create a new widget, click on «Add».

To update an existing widget, click on the name associated to the widget in question.

To deploy widgets on the server and use them in portals, you will need to click on the Publish button. This operation generates a externalWidgets.jar file that is placed in the directory used for external widgets. The directory filepath is defined in the Geoconcept Web administration parameters by the easy.widgets.path key.

The Publish button summarises all the widgets listed in the table. This functionality is based on the latest definitive version saved so they can be placed in the .jar file.

Creation screen

By default, Geoconcept Web suggest a template to use when creating a widget. This is called MyWidget. This is a single button that can be enriched as required.

The editing screen is defined in the following way:

The Execute button serves to test the widget within an interface. After clicking on this button, a save operation is performed in the database and the version used will then be TEMP. The TEMP version is necessarily the latest version of the widget.

Details of the «JavaScript», the «CSS», and the «XML» should be entered in the editing interface. These three items define the behaviour of the widget in a portal.

The «HTML for test» and «JS for test» items serve to define or call the methods to execute in the test page.

For example, in Geoconcept Web, a button is defined in a DIV. This DIV should therefore be created in the «HTML for test» section, and then used in the «JS for test». The default creation template will supply these 2 elements.

To finalise the creation of the widget, you need to click on the OK button. The save action increments the versioning of the widget in the process of creation and will then display this number in the list of widgets. The Back button takes you back to the previous screen.

Screen test

The test screen provides a map that can be manipulated. In our example, the button is added subsequently since a DIV has been defined when the widget was created.

A series of tests can also be added in the editing section, in the «JS for test» space.

If the behaviour that results matches expectations, the widget can be saved via the OK button. Otherwise, the Back button allows you to switch back to the editing screen.