Configurer le frontend mviewerstudio

Structure du fichier de configuration

La configuration s’effectue dans le fichier config-python-sample.json localisé à la racine du projet. Ce fichier de configuration sera copié automatiquement via le script d’installation (ou à copier manuellement) dans le répertoire srv/python/mviewerstudiobackend/static/apps sous le nom config.json.

Voici le fichier d’exemple à utiliser et à adapter selon votre environnement :

https://github.com/mviewer/mviewerstudio/blob/master/config-python-sample.json

Paramètres du fichier de configuration

Paramètres généraux

Ces paramètres sont à renseigner dans tous les cas.

  • studio_title : nom de l’application tel qu’il apparaîtra dans la barre de navigation (navbar) de l’application et le titre de la page dans votre navigateur internet.

  • mviewerstudio_version: version compatible de mviewerstudio (laisser la valeur par défaut)

  • mviewer_version: version compatible mviewer (laisser la valeur par défaut)

  • mviewer_instance : URL de l’instance mviewer utilisée (par exemple http://localhost/mviewer/).

  • conf_path_from_mviewer : Chemin permettant de charger le fichier de configuration généré depuis le mviewer. Le chemin peut être relatif (par exemple ../mviewer/conf/).

  • mviewer_short_urlUtilisation du système d’URL courtes (mviewer/#monappli au lieu de mviewer/?config=apps/monappli.xml).
    • used : true | false.

    • apps_folder : chemin d’accès depuis le répertoire apps (exemple store pour apps/store).

    • public_folder : (pour backend Python seulement) - chemin d’accès depuis le répertoire apps pour les éléments publiés (exemple store pour apps/public).

  • external_themes : Utilisation du mécanisme d’import de thématiques externes (présentes dans d’autres mviewers).

  • proxy : Chemin du proxy par lequel les requêtes envoyées par mviewerstudio passeront si cette valeur est définie.

  • used : Booléen -> Utiliser "true" pour permettre le chargement et l’utilisation des thématiques externes.

  • logout_url : URL utilisée par le menu de déconnexion.

  • app_form_placeholdersExemples de valeurs présentes dans le formulaire de création de l’application.
    • app_title : Nom de l’application qui sera créée.

    • logo_url : URL du logo à afficher dans l’application.

    • help_file : Nom du fichier contenant l’aide à afficher par l’application.

    • map : Paramétrage du cadrage initial de la carte grâce aux propriétés center et zoom.

    • center : coordonnées du centre de la carte.

    • zoom : niveau de zoom.

  • baselayers : cette section concerne le paramétrage des fonds de plan.

  • data_providers : cette section concerne le paramétrage des différents fournisseurs de données.

Paramètres obligatoires

Ces paramètres sont obligatoires avec un backend Python.

  • api: URL vers le service (API) du backend Python. Valeur par défaut : api/app.

  • user_info: URL vers le service (API) permettant de récupérer les informations de l’utilisateur connecté. Valeur par défaut api/user.

  • store_style_service : URL vers le service (API) à utiliser pour sauvegarder un style. Valeur par défaut api/style.

  • publish_url : URL de publication à utiliser (par exemple https//public-map/). Si besoin, Apache devra avoir une règle pour orienter cette URL vers le répertoire de publication (voir settings.py - MVIEWERSTUDIO_PUBLISH_PATH).

  • public_folder : voir détail plus bas.