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_url
Utilisation 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_placeholders
Exemples 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éfautapi/user
.store_style_service
: URL vers le service (API) à utiliser pour sauvegarder un style. Valeur par défautapi/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.