diff --git a/administration/annexes/annexes.rst b/administration/annexes/annexes.rst new file mode 100644 index 0000000000000000000000000000000000000000..c40c322031d7280792caf9d9ae39b57e7fb5d0ea --- /dev/null +++ b/administration/annexes/annexes.rst @@ -0,0 +1,151 @@ + +========================================================================= +Syntaxe des expressions CRON pour la définition des périodes d'abonnement +========================================================================= + + Le code à saisir doit respecter la syntaxe : **mm hh jj MMM JJJ tâche** +Où + +- **mm** représente les minutes (de 0 à 59) +- **hh** représente l’heure (de 0 à 23) +- **jj** représente le numéro du jour du mois (de 1 à 31) +- **MMM** représente l’abréviation du nom du mois (jan, feb,…) ou le numéro du mois (de 1 à 12) +- **JJJ** représente l’abréviation du nom du jour ou bien le numéro du jour dans la semaine (0 = dimanche, 6 = samedi) + +*Signifie à chaque unité (0,1,2,3,4…) +5,8 signifie les unités 5 et 8 +2-5 signifie les unités de 2 à 5 +*/3 signifie toutes les 3 unités (0,3,6,9…) + +*Exemples de syntaxe :* +Tous les jours à 12 h : 0 12 *** +Tous les lundis à 22h15 : 15 22 * *1 +Toutes les heures passées de 15 min : 15 * * * * +Tous les premiers du mois à 4h42 : 42 4 1 * * +Du 2 au 5 de chaque mois à 10h12 : 12 10 2-5 ** + +========================== +Services web et privilèges +========================== + + L'accès à un service web dépend du profil du compte connecté. Ainsi par exemple, un utilisateur ayant pour privilège gtf_user, ne peut pas accéder à la ressource 'Workspaces' qui retourne la liste des projets puisqu'un privilège gtf_author est requis. +Le tableau ci-dessous présente les privilèges requis pour pouvoir accéder aux différents services de l'API : + +.. csv-table:: + + service, Ressource, Privileges requis + gtf, Categories, gtf_user + gtf, EmailContexts, gtf_user + gtf, EmailOptions, gtf_user + gtf, EmailTemplates, gtf_author + gtf, FMEEngines, gtf_admin + gtf, GtfEngines, gtf_admin + gtf, GTFGroups, vitis_admin + gtf, Inboxes, gtf_author + gtf, License, gtf_author + gtf, MessageClasses, gtf_user + gtf, MessageClassTypes, gtf_user + gtf, Messages, gtf_user + gtf, Orders, gtf_author + gtf, OrderStatutes, gtf_user + gtf, Periods, gtf_user + gtf, Priorities, gtf_user + gtf, Servers, gtf_admin + gtf, Statistics, gtf_author + gtf, Subscriptions, gtf_author + gtf, SupervisionStatues, gtf_author + gtf, Surveys, gtf_author + gtf, SurveyType, gtf_user + gtf, Tags, gtf_user + gtf, UserOrders, gtf_user + gtf, UserSubscriptions, gtf_user + gtf, UserSurveys, gtf_user + gtf, Versions, gtf_user + gtf, Workspaces, gtf_author + vitis, Domains, vitis_user + vitis, GenericQuerys, vitis_user + vitis, Groups, vitis_user + vitis, Logs, vitis_admn + vitis, Modes, vitis_user + vitis, Phpinfo, vitis_admin + vitis, Privileges, vitis_user + vitis, Properties, vitis_user + vitis, Ressources, vitis_user + vitis, Tabs, vitis_user + vitis, Users, vitis_admin + vitis, Versions, vitis_user + vitis, VitisSections, vitis_user + + + ======================= + Liste des contrôles GTF + ======================= + +.. csv-table:: + + **Nom du contrôle GTF** + Bouton radio + Carte Bing + Carte OSM + Carte vMap + Champ caché + Couleur + Curseur + Date et Heure + Décimal + Entier + Fichier local + Interface - Ligne de séparation + Label + Label Titre + Liste + Liste déroulante + Texte en édition 1 ligne + Texte en édition Mot de passe + Texte en édition Multiligne + Texte en édition URL + + ==================== + Projets FME intégrés + ==================== + + 3 projets FME sont intégrés initialement à GTF : + + Projet Admin-Export + ------------------- +Le projet Admin export permet d'exporter des projets FME au format d'échange de gtf : .gex. +On peut exporter 1 à n projets FME. + + Projet Admin Import + ------------------- +Le projet Admin-Import permet l'import dans GTF de traitements FME contenus dans un répertoire gex. + Un projet FME dans GTF est identifié de façon unique par une clé. Le projet d'import permet, en cas d'import de projet dont la clé est existante en base de données, de choisir que faite de ce dernier : +- Remplacer le projet existant : le projet est mis à jour et son nom, sa clé et son identifiant sont conservés. +- Ne pas importer le projet +- Importer le projet avec une nouvelle clé et un nouveau nom. On ajoute de la sorte un nouveau projet en base. +Un rapport d'import est généré au format html. Il indique le nom et la clé du projet importé et le statut de l'import, c'est à dire "Mis à jour dans GTF", "Non mis à jour dans GTF" ou "inséré dans GTF". + +.. image:: ../images/attention.png L'import de projets au format gex, issus d'une version antérieure à GTF 2016 ne permet pas la création des formulaires au format json. Directement après avoir importé des projets via Admin-Import, lancer le traitement Vérification des formulaires pour permettre la génération des formulaires au format json. + + Projet Vérification des formulaires + ----------------------------------- + + Ce traitement permet la vérification et/ou la génération des formulaires des traitements. + Les formulaires des traitements importés depuis une version antérieure à GTF 2016 ne sont pas directement créés au format json. Ce traitement permet de définir les conditions de génération des formulaires par défaut et des formulaires publiés. + +Tous les traitements sont parcourus. + +2 options sont possibles : + +- Ne pas forcer la régénération des formulaires par défaut pour tous les traitements : Ne sont traités que les traitements ne disposant pas de formulaire publié de type subform.json. Leurs formulaires sont donc invalides + .. image:: ../images/formilaire_invalide_58x43.png + + si le type de formulaire publié indiqué en base est de type 'par défaut', alors les 3 formulaires sont générés. + Sinon, si le formulaire source indiqué en base est de type 'personnalisé', alors un rapport indique que le traitement est invalide et que l'auteur doit créer lui même le formulaire. + +- Forcer la régénération des formulaires par défaut pour tous les traitements. Un formulaire par défaut est regénéré pour tous les traitements. Les formulaires par défaut sont publiés Si le formulaire en base de données est de type Défaut. Sinon les formulaires publiés personnalisés sont conservés. + +En savoir plus sur les formulaires dans GTF. + + + diff --git a/administration/annexes/annexes_.md b/administration/annexes/annexes_.md new file mode 100644 index 0000000000000000000000000000000000000000..37029a41f8b644dad3388f8bc6a7fbe9af96fff5 --- /dev/null +++ b/administration/annexes/annexes_.md @@ -0,0 +1,358 @@ +# Syntaxe des expressions CRON pour la définition des périodes d'abonnement + + Le code à saisir doit respecter la syntaxe : **"mm hh jj MMM JJJ tâche"** où + +- **mm** représente les minutes (de 0 à 59) +- **hh** représente l’heure (de 0 à 23) +- **jj** représente le numéro du jour du mois (de 1 à 31) +- **MMM** représente l’abréviation du nom du mois (jan, feb,…) ou le numéro du mois (de 1 à 12) +- **JJJ** représente l’abréviation du nom du jour ou bien le numéro du jour dans la semaine (0 = dimanche, 6 = samedi) + + +* ***** : signifie à chaque unité (0,1,2,3,4…) +* **5,8** : signifie les unités 5 et 8 +* **2-5** : signifie les unités de 2 à 5 +* **/3** : signifie toutes les 3 unités (0,3,6,9…) + +## Exemples de syntaxe +* Tous les jours à 12h : **0 12 ***** +* Tous les lundis à 22h15 : **15 22 * *1** +* Toutes les heures passées de 15 min : **15 * * * *** +* Tous les premiers du mois à 4h42 : **42 4 1 * *** +* Du 2 au 5 de chaque mois à 10h12 : **12 10 2-5 **** + +--- + +# Services web et privilèges + + L'accès à un service web dépend du profil du compte connecté. Ainsi par exemple, un utilisateur ayant pour privilège gtf_user, ne peut pas accéder à la ressource 'Workspaces' qui retourne la liste des projets puisqu'un privilège gtf_author est requis. +Le tableau ci-dessous présente les privilèges requis pour pouvoir accéder aux différents services de l'API : + +<div class="wy-table-responsive"> + +<table class="docutils" border="1"> +<thead valign="middle" align="center"> + <tr> + <td style="font-weight: bold;">Service</td> + <td style="font-weight: bold;">Ressource</td> + <td style="font-weight: bold;">Privilèges requis</td> + </tr> + + <tr> + <td>GTF</td> + <td>Catégories</td> + <td>gtf_user</td> + <tr> + + <tr> + <td>GTF</td> + <td>EmailContexts</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>EmailOptions</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>EmailTemplates</td> + <td>gtf_author</td> + </tr> + + <tr> + <td>GTF</td> + <td>FMEEngines</td> + <td>gtf_admin</td> + </tr> + + <tr> + <td>GTF</td> + <td>GtfEngines</td> + <td>gtf_admin</td> + </tr> + + <tr> + <td>GTF</td> + <td>GTFGroups</td> + <td>vitis_admin</td> + </tr> + + <tr> + <td>GTF</td> + <td>Inboxes</td> + <td>gtf_author</td> + </tr> + + <tr> + <td>GTF</td> + <td>License</td> + <td>gtf_admin</td> + </tr> + + <tr> + <td>GTF</td> + <td>MessageClasses</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>MessageClassTypes</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>Messages</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>Orders</td> + <td>gtf_author</td> + </tr> + + <tr> + <td>GTF</td> + <td>OrderStatutes</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>Periods</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>Priorities</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>Servers</td> + <td>gtf_admin</td> + </tr> + + <tr> + <td>GTF</td> + <td>Statistics</td> + <td>gtf_author</td> + </tr> + + <tr> + <td>GTF</td> + <td>Subscriptions</td> + <td>gtf_author</td> + </tr> + + <tr> + <td>GTF</td> + <td>SupervisionStatues</td> + <td>gtf_author</td> + </tr> + + <tr> + <td>GTF</td> + <td>Surveys</td> + <td>gtf_author</td> + </tr> + + <tr> + <td>GTF</td> + <td>SurveyType</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>Tags</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>UserOrders</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>UserSubscriptions</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>UserSurveys</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>Versions</td> + <td>gtf_user</td> + </tr> + + <tr> + <td>GTF</td> + <td>Workspaces</td> + <td>gtf_author</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Domains</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>GenericQuerys</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Groups</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Logs</td> + <td>vitis_admn</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Modes</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Phpinfo</td> + <td>vitis_admin</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Privileges</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Properties</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Ressources</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Tabs</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Users</td> + <td>vitis_admin</td> + </tr> + + <tr> + <td>Vitis</td> + <td>Versions</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>VitisSections</td> + <td>vitis_user</td> + </tr> + + <tr> + <td>Vitis</td> + <td>WebServices</td> + <td>vitis_user</td> + </tr> + +</table> +</div> + +--- + +# Liste des contrôles GTF + +Nom du contrôle GTF + +- [Bouton radio](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#contrôle-gtf-de-type-bouton-radio--contrôle-de-type-bouton-radio) +- [Carte Bing](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md##carte-bing) +- [Carte OSM](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#contrôles-gtf-de-type-carte-osm-carte-bing-et-carte-vmap) +- [Carte vMap](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#carte-vmap) +- [Champ caché](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#contrôle-gtf-de-type-champ-caché) +- [Couleur](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md/#paramètre-publié-de-type-choix-de-couleur---contrôle-de-type-couleur) +- [Curseur](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md) +- [Date et Heure](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#paramètre-publié-de-type-dateheure---contrôle-de-type-date-et-heure) +- [Décimal](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#paramètre-publié-de-type-flottant---contrôle-de-type-décimal) +- [Entier](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#paramètre-publié-de-type-entier---contrôle-de-type-entier) +- [Fichier local ](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#paramètre-publié-de-type-nom-de-fichier-multiple---contrôle-de-type-fichier-local) +- [Interface - Ligne de séparation](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md##contrôle-gtf-de-type-interface---ligne-de-séparation) +- [Label](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#contrôles-gtf-de-type-label) +- [Label Titre](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#contrôles-gtf-de-type-label) +- [Liste](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#gestionnaire-de-sources-de-données) +- [Liste déroulante](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#gestionnaire-de-sources-de-données) +- [Texte en édition 1 ligne](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#paramètre-publié-de-type-répertoire-en-sortie---contrôle-de-type-texte-en-édition-1-ligne) +- [Texte en édition Mot de passe](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#paramètre-publié-de-type-mot-de-passe---contrôle-de-type-texte-en-édition-mot-de-passe) +- [Texte en édition Multiligne](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#paramètre-publié-de-type-texte-multiligne---contrôle-de-type-texte-en-édition---multiligne) +- [Texte en édition URL](../publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md#paramètre-publié-de-type-url---contrôle-de-type-texte-en-édition-url) + +--- +# Projets FME intégrés + + 3 projets FME sont intégrés initialement à GTF : "Admin Export", "Admin Import" et "Vérification des formulaires". + +## Projet "Admin Export" + +Le projet "Admin Export" permet d'exporter des projets FME au format d'échange de gtf : .gex. +On peut exporter 1 à n projets FME. + +## Projet "Admin Import" + +Le projet Admin-Import permet l'import dans GTF de traitements FME contenus dans un répertoire gex. Un projet FME dans GTF est identifié de façon unique par une clé. Le projet d'import permet, en cas d'import de projet dont la clé est existante en base de données, de choisir que faire de ce dernier : +- Remplacer le projet existant : le projet est mis à jour et son nom, sa clé et son identifiant sont conservés. +- Importer le projet avec une nouvelle clé et un nouveau nom :on ajoute de la sorte un nouveau projet en base. +- Ne pas importer le projet + +Un rapport d'import est généré au format HTML. Il indique le nom et la clé du projet importé et le statut de l'import, c'est à dire "Mis à jour dans GTF", "Inséré dans GTF" ou "Non mis à jour dans GTF". + + L'import de projets au format gex, issus d'une version antérieure à GTF 2016, ne permet pas la création des formulaires au format json. Directement après avoir importé des projets via "Admin Import", lancer le traitement "Vérification des formulaires" pour permettre la génération des formulaires au format json. + +## Projet Vérification des formulaires + +Ce traitement permet la vérification et/ou la génération des formulaires des traitements. Les formulaires des traitements importés depuis une version antérieure à GTF 2016 ne sont pas directement créés au format JSON. Ce traitement permet de définir les conditions de génération des formulaires par défaut et des formulaires publiés. + +Tous les traitements sont parcourus. + +2 options sont possibles : + +- **Ne pas forcer la régénération des formulaires par défaut pour tous les traitements** : ne sont traités que les traitements ne disposant pas de formulaire publié de type subform.json. Leurs formulaires sont donc invalides si le type de formulaire publié indiqué en base est de type 'par défaut', alors les 3 formulaires sont générés. + Sinon, si le formulaire source indiqué en base est de type 'personnalisé', alors un rapport indique que le traitement est invalide et que l'auteur doit créer lui même le formulaire. +  + +- **Forcer la régénération des formulaires par défaut pour tous les traitements** : un formulaire par défaut est regénéré pour tous les traitements. Les formulaires par défaut sont publiés si le formulaire en base de données est de type "Défaut". Sinon les formulaires publiés personnalisés sont conservés. + +En savoir plus sur les formulaires dans GTF. diff --git a/administration/annexes/index.rst b/administration/annexes/index.rst new file mode 100644 index 0000000000000000000000000000000000000000..807a105be169e56c1aed92934a1e0c820fc06b26 --- /dev/null +++ b/administration/annexes/index.rst @@ -0,0 +1,8 @@ + +Annexes +========================================== + +.. toctree:: + :maxdepth: 2 + + annexes_.md diff --git a/administration/statistiques.md b/administration/statistiques.md new file mode 100644 index 0000000000000000000000000000000000000000..de7ccb8e13d7c095b9eb9bde478bcbc7585ed618 --- /dev/null +++ b/administration/statistiques.md @@ -0,0 +1,52 @@ +# Statistiques + +Le mode "Statistiques" permet aux administrateurs d'avoir une vision graphique et synthétique de l'utilisation des ressources de GTF (moteur, traitement, temps machine, par date et/ou utilisateur) à travers des graphiques et des tableaux de synthèse. + +L'affichage des statistiques peut être graphique ou tabulaire (export dans Excel) et il est possible d'obtenir une représentation journalière, hebdomadaire, mensuelle et annuelle de l'activité sur le serveur à partir d'une date spécifiée en paramètre. + +La liste déroulante "Variable" permet de choisir la variable devant être représentée dans les tableaux ou graphiques : + +- Nombre de traitements exécutés +- Temps total des traitements +- Durée des traitements par projet FME + +Pour les deux dernières variables, le temps total des traitements et le temps par projet peuvent être représentés par : + +- Seconde +- Minute +- Heure +- Pourcentage du temps total d'utilisation + +L'administrateur choisit ensuite de regrouper ces variables par : + +- Utilisateur +- Projet FME +- Etat du traitement (traitement en erreur ou traité) +- Moteur utilisé + +Puis il choisit la période d'analyse et la date à partir de laquelle produire les statistiques : + +- Jour +- Semaine +- Mois +- Année + +Le "Nombre d'éléments max" permet de n'afficher que les éléments les plus importants en termes de durée ou de nombre, les autres étant regroupés dans la classe "Autres". Dans l'exemple ci-dessous, il a été choisi de n'afficher que deux éléments maximum : les traitements "Conversion de fichier" et "Extraction ZI" sont les deux traitements les plus longs, ils sont donc affichés et détaillés ; tous les autres traitements sont regroupés dans la classe "Autres". + +  + + + +Il est possible de tronquer les libellés pour réduire la taille de la légende et des info-bulles. + +  +Il est possible d’augmenter le niveau de détail directement dans le graphique, en cliquant sur une barre d’histogramme. Le niveau d’analyse s’affine, passant, selon les cas, de l’année au mois, à la semaine, au jour et aux heures. Inversement, un **clic droit \> Zoom out**, sur une barre d’histogramme permet de passer à une analyse statistique plus large passant, selon les cas, des heures, au jour, au mois et à l’année. + + +  + +  + +  + +  diff --git a/administration/supervision.md b/administration/supervision.md new file mode 100644 index 0000000000000000000000000000000000000000..232f218bc1ddb14c074cb21ad7fd39559b6be703 --- /dev/null +++ b/administration/supervision.md @@ -0,0 +1,58 @@ +# Supervision + +On entend par « supervision » le suivi des demandes de traitements, des abonnements et des surveillances de tous les utilisateurs GTF. A tout moment, l'administrateur doit pouvoir consulter la liste des demandes de projets émises par tous les utilisateurs, en supprimer certaines, identifier les erreurs et obtenir une vision synthétique de l'utilisation de l'application. + +Il dispose pour cela du mode "Supervision" dans lequel est listé l'ensemble des traitements demandés, des abonnements et des surveillances. + +## Supervision des demandes + +L'onglet "Demandes" offre à l'administrateur une vision de l'état du serveur. Il a une connaissance fine de l'ensemble des traitements demandés par utilisateur, des dates de demandes, des priorités ainsi que le numéro de moteur ayant traité chaque projet. Il peut télécharger les résultats des traitements, consulter les paramètres des traitements et consulter les logs FME associés. + +Le champ "Supprimé" lui permet d'être informé de la suppression d'une demande par un utilisateur. + +Enfin, le champ "Etat" permet, via un code couleur, d'identifier si une demande est en attente, en erreur, traitée, non traitable, en cours de traitement ou non autorisée. + +  + +L'administrateur dispose de différents boutons d'administration : le bouton **Réinitialiser** lui permet de relancer un (ou des) traitement(s) sélectionné(s). + +## Suppression des demandes + +L'administrateur est responsable de la suppression définitive des demandes une fois que ces dernières ont été supprimées par les utilisateurs. Il existe ainsi deux niveaux de suppression : + +- La suppression utilisateurs +- La suppression définitive par l'administrateur + +Le bouton **Purger les demandes** permet à l'administrateur de procéder à la suppression définitive d'une demande de traitement préalablement supprimée par un utilisateur. + +Le bouton **Supprimer les demandes** permet de supprimer les demandes des traitements sélectionnés. + +## Modification des moteurs + +L'administrateur peut choisir de modifier le moteur d'exécution d'un (ou des) traitement(s) préalablement sélectionné(s) en cliquant sur le bouton **Modifier le moteur**. En cas d'échec de traitement, modifier le moteur est une bonne méthode pour identifier l'origine du problème et comprendre si la configuration des versions de moteurs FME en est à l'origine. + +  + +## Supervision des abonnements + +L'onglet "Abonnement" permet à l'administrateur de consulter la liste des abonnements aux projets FME et d'identifier ceux étant actifs et inactifs. Il peut choisir de supprimer définitivement un abonnement en cliquant sur **Supprimer les abonnements**. + +## Supervision des surveillances + +De la même façon, l'onglet Surveillance permet à l'administrateur de consulter la liste des demandes de surveillance créées par les utilisateurs. + +Il peut choisir de supprimer définitivement une surveillance : après avoir sélectionné le ou les abonnements à supprimer, il clique sur le bouton **Supprimer les abonnements**. + +## Gestion des messages + +Le projet "GTFMessageSender", disponible sur notre site de téléchargement [http://download.veremes.com](http://download.veremes.com/) (répertoire gtf/gex) permet à un traitement FME d'envoyer un message à GTF, et de déclencher des actions via l'application [WAB, Workflow Application Builder for FME](http://www.veremes.com/produits/wab). + +Les messages sont destinés à être exploités par WAB mais ils sont consultables dans le mode Supervision de GTF. + +### Exemple + +"GTFMessageSender" peut être utilisé pour envoyer des messages suite à un contrôle des géométries d'un fichier source. En fin de traitement, un message est envoyé à GTF. + +Deux types de messages peuvent être envoyés selon la présence ou non d'erreur dans le fichier source. Deux classes peuvent être créées : "traitement ok" et "traitement Ko". Chacune enclenche des traitements spécifiques dans WAB. + +Dans GTF, l'administrateur pourrait ainsi consulter la liste des messages envoyés par "GTFMessageSender", leur classe et corps, leur date de création et l'expéditeur. diff --git a/images/0300001B.png b/images/0300001B.png new file mode 100644 index 0000000000000000000000000000000000000000..6bf998b32fb1b7012b6b75dd4cdd143ce612c30c Binary files /dev/null and b/images/0300001B.png differ diff --git a/images/0300001F_317x275.png b/images/0300001F_317x275.png new file mode 100644 index 0000000000000000000000000000000000000000..6fa95d49c72aeb1f9650b4d6f79f860c92fe5223 Binary files /dev/null and b/images/0300001F_317x275.png differ diff --git a/images/03000020_386x149.png b/images/03000020_386x149.png new file mode 100644 index 0000000000000000000000000000000000000000..a55b13b090c659427e239f18dea3d92201370fb2 Binary files /dev/null and b/images/03000020_386x149.png differ diff --git a/images/03000021_314x65.png b/images/03000021_314x65.png new file mode 100644 index 0000000000000000000000000000000000000000..f07dc41c941df145cbcecb3d079fffefe8325463 Binary files /dev/null and b/images/03000021_314x65.png differ diff --git a/images/0300003B_314x129.png b/images/0300003B_314x129.png new file mode 100644 index 0000000000000000000000000000000000000000..138257e3606f015ed9fce81947248247cd4d83d5 Binary files /dev/null and b/images/0300003B_314x129.png differ diff --git a/images/0300003C_299x181.png b/images/0300003C_299x181.png new file mode 100644 index 0000000000000000000000000000000000000000..0da8d12350bc8166db5569d83f289a29a84a5fe1 Binary files /dev/null and b/images/0300003C_299x181.png differ diff --git a/images/0300003D_298x170.png b/images/0300003D_298x170.png new file mode 100644 index 0000000000000000000000000000000000000000..8b99e7ab504af0cc32c9f73cb8f9bed032be6b0b Binary files /dev/null and b/images/0300003D_298x170.png differ diff --git a/images/0300003E_602x294.png b/images/0300003E_602x294.png new file mode 100644 index 0000000000000000000000000000000000000000..8d1e84a01e90d5e27d98d355e246bd817a2aee7d Binary files /dev/null and b/images/0300003E_602x294.png differ diff --git a/images/0300003F_313x151.png b/images/0300003F_313x151.png new file mode 100644 index 0000000000000000000000000000000000000000..d3c7c4012f4fd40ee36b084d36af3ba37e31e8ac Binary files /dev/null and b/images/0300003F_313x151.png differ diff --git a/images/03000044_507x271.png b/images/03000044_507x271.png new file mode 100644 index 0000000000000000000000000000000000000000..fef58c9e86b191e320d4bee107642bb77dff0dae Binary files /dev/null and b/images/03000044_507x271.png differ diff --git a/images/03000045_603x228.png b/images/03000045_603x228.png new file mode 100644 index 0000000000000000000000000000000000000000..343b923c38a8b2707881a543fb057af2fee1f245 Binary files /dev/null and b/images/03000045_603x228.png differ diff --git a/images/03000046_602x214.png b/images/03000046_602x214.png new file mode 100644 index 0000000000000000000000000000000000000000..336d290e7cf52772580aa8b4c552304a58caca62 Binary files /dev/null and b/images/03000046_602x214.png differ diff --git a/images/03000047_602x213.png b/images/03000047_602x213.png new file mode 100644 index 0000000000000000000000000000000000000000..cf734f09914a9921ff879190c711d0a30f56231f Binary files /dev/null and b/images/03000047_602x213.png differ diff --git a/images/03000048_602x222.png b/images/03000048_602x222.png new file mode 100644 index 0000000000000000000000000000000000000000..f70691186a00806fc852c6f45b37cae92626f2a7 Binary files /dev/null and b/images/03000048_602x222.png differ diff --git a/images/03000049_503x169.png b/images/03000049_503x169.png new file mode 100644 index 0000000000000000000000000000000000000000..f5e2795539541ea01a90fc48d66076e392fe9366 Binary files /dev/null and b/images/03000049_503x169.png differ diff --git a/images/10modes.png b/images/10modes.png new file mode 100644 index 0000000000000000000000000000000000000000..6595a167b9e74a1979c6cbd587fa10f8b7ff6675 Binary files /dev/null and b/images/10modes.png differ diff --git a/images/CN_Texte.png b/images/CN_Texte.png new file mode 100644 index 0000000000000000000000000000000000000000..0379687948c10d5378b7f491f4316c19c5df5787 Binary files /dev/null and b/images/CN_Texte.png differ diff --git a/images/CN_lie.png b/images/CN_lie.png new file mode 100644 index 0000000000000000000000000000000000000000..767f6aa6f62961253146582f788fdd28a9c86923 Binary files /dev/null and b/images/CN_lie.png differ diff --git a/images/Cld.png b/images/Cld.png new file mode 100644 index 0000000000000000000000000000000000000000..04edad74f6aca9dc709469075f6fbc9faf65d0b8 Binary files /dev/null and b/images/Cld.png differ diff --git a/images/FLECHE.png b/images/FLECHE.png new file mode 100644 index 0000000000000000000000000000000000000000..e31406e7c4834bf75d219fb4eeb69ff908549ace Binary files /dev/null and b/images/FLECHE.png differ diff --git a/images/GSD_externe.png b/images/GSD_externe.png new file mode 100644 index 0000000000000000000000000000000000000000..321992250bab7eaae757b0abcc60057d254c805c Binary files /dev/null and b/images/GSD_externe.png differ diff --git a/images/GSD_services.png b/images/GSD_services.png new file mode 100644 index 0000000000000000000000000000000000000000..6a2bbc99ccb5b736bcb5729c7bc7951b1a795daf Binary files /dev/null and b/images/GSD_services.png differ diff --git a/images/Gestionnaire_source_donnees.png b/images/Gestionnaire_source_donnees.png new file mode 100644 index 0000000000000000000000000000000000000000..858df72f249ac0aa2017fc3c76f3eebb372895f9 Binary files /dev/null and b/images/Gestionnaire_source_donnees.png differ diff --git a/images/add_droits_projet.png b/images/add_droits_projet.png new file mode 100644 index 0000000000000000000000000000000000000000..deaa9bdc0e6721c801ad2ef4e95fc642e1269c4a Binary files /dev/null and b/images/add_droits_projet.png differ diff --git a/images/ajout_demande_621x337.png b/images/ajout_demande_621x337.png new file mode 100644 index 0000000000000000000000000000000000000000..d1f10224a399106c79f92b583e2632a667ae2ec4 Binary files /dev/null and b/images/ajout_demande_621x337.png differ diff --git a/images/ajout_depot.png b/images/ajout_depot.png new file mode 100644 index 0000000000000000000000000000000000000000..42bacc5bcb12304f0adb4e02a7346c035d74f6a2 Binary files /dev/null and b/images/ajout_depot.png differ diff --git a/images/ajout_parametre.png b/images/ajout_parametre.png new file mode 100644 index 0000000000000000000000000000000000000000..f4cc91f40036f60ccf443b9536e2f49cecaedb83 Binary files /dev/null and b/images/ajout_parametre.png differ diff --git a/images/ajout_projet1.png b/images/ajout_projet1.png new file mode 100644 index 0000000000000000000000000000000000000000..49630de52cdb4919449260c133cc88f6336215fa Binary files /dev/null and b/images/ajout_projet1.png differ diff --git a/images/ajout_projet_583x353.png b/images/ajout_projet_583x353.png new file mode 100644 index 0000000000000000000000000000000000000000..bf9d25d6015e1ac74cc54437697c2734f71cd2c3 Binary files /dev/null and b/images/ajout_projet_583x353.png differ diff --git a/images/ajout_serveur.png b/images/ajout_serveur.png new file mode 100644 index 0000000000000000000000000000000000000000..3687bb9f5fc864f51f6389eb47ffc91e3881d411 Binary files /dev/null and b/images/ajout_serveur.png differ diff --git a/images/appel_externe.png b/images/appel_externe.png new file mode 100644 index 0000000000000000000000000000000000000000..4f60eb8d7f124984e021d953380830acd5b13484 Binary files /dev/null and b/images/appel_externe.png differ diff --git a/images/arr.png b/images/arr.png new file mode 100644 index 0000000000000000000000000000000000000000..9dbc13bae33d0672d0b06050ee69cb811003a400 Binary files /dev/null and b/images/arr.png differ diff --git a/images/attention.png b/images/attention.png new file mode 100644 index 0000000000000000000000000000000000000000..2f384c218cb1dcd53e7728f198b421017b6c285e Binary files /dev/null and b/images/attention.png differ diff --git a/images/b_radio.png b/images/b_radio.png new file mode 100644 index 0000000000000000000000000000000000000000..b2050c691907c06f8f5c6f9f4aa70ea3da89536b Binary files /dev/null and b/images/b_radio.png differ diff --git a/images/b_radio_options.png b/images/b_radio_options.png new file mode 100644 index 0000000000000000000000000000000000000000..b9e358001bf29d45596c0dd20b1f6b0886ad02e7 Binary files /dev/null and b/images/b_radio_options.png differ diff --git a/images/bouton_defaut.png b/images/bouton_defaut.png new file mode 100644 index 0000000000000000000000000000000000000000..99d2d2b4766c130bcab722e68cd5555ee74c295c Binary files /dev/null and b/images/bouton_defaut.png differ diff --git a/images/bouton_perso.png b/images/bouton_perso.png new file mode 100644 index 0000000000000000000000000000000000000000..38d6121a8ea0f40296c4ecee36a125d6bf4c9670 Binary files /dev/null and b/images/bouton_perso.png differ diff --git a/images/bouton_publie.png b/images/bouton_publie.png new file mode 100644 index 0000000000000000000000000000000000000000..af9f49c79238270449c700a8f0ce6d7181d3553b Binary files /dev/null and b/images/bouton_publie.png differ diff --git a/images/bouton_puiblication_19x19.png b/images/bouton_puiblication_19x19.png new file mode 100644 index 0000000000000000000000000000000000000000..e49c21e53b8d335592cde4524737e4984cd5801d Binary files /dev/null and b/images/bouton_puiblication_19x19.png differ diff --git a/images/bouton_recharger.png b/images/bouton_recharger.png new file mode 100644 index 0000000000000000000000000000000000000000..6509b043e0291a9e016331ff507d2a3ba287501f Binary files /dev/null and b/images/bouton_recharger.png differ diff --git a/images/bouton_sauvegarde_20x18.png b/images/bouton_sauvegarde_20x18.png new file mode 100644 index 0000000000000000000000000000000000000000..62d842b9a970941eaca22d34175c74fe6cf81b28 Binary files /dev/null and b/images/bouton_sauvegarde_20x18.png differ diff --git a/images/bouton_tables.png b/images/bouton_tables.png new file mode 100644 index 0000000000000000000000000000000000000000..64d67584cddf175b57ba9deb709d23e4559aa2e8 Binary files /dev/null and b/images/bouton_tables.png differ diff --git a/images/c-pwd.png b/images/c-pwd.png new file mode 100644 index 0000000000000000000000000000000000000000..140fc43a4e5aa9ecf0ed02569d190f1748a548ca Binary files /dev/null and b/images/c-pwd.png differ diff --git a/images/c_chargement_cle_libelle.png b/images/c_chargement_cle_libelle.png new file mode 100644 index 0000000000000000000000000000000000000000..4e63bc40c6f2a947a485cbddb4d7702aa89b7604 Binary files /dev/null and b/images/c_chargement_cle_libelle.png differ diff --git a/images/c_couleur.png b/images/c_couleur.png new file mode 100644 index 0000000000000000000000000000000000000000..4ae570f6707153b6c2ffb486166bf4ec83232091 Binary files /dev/null and b/images/c_couleur.png differ diff --git a/images/c_curseur.png b/images/c_curseur.png new file mode 100644 index 0000000000000000000000000000000000000000..eaa3bb4a89645057ca2356b0054669294684f8fb Binary files /dev/null and b/images/c_curseur.png differ diff --git a/images/c_date.png b/images/c_date.png new file mode 100644 index 0000000000000000000000000000000000000000..6923372e4fc191c52762ac5477261896db24c1a6 Binary files /dev/null and b/images/c_date.png differ diff --git a/images/c_entier.png b/images/c_entier.png new file mode 100644 index 0000000000000000000000000000000000000000..9238279c955ec5ec45317fe13df67f5352a3e61d Binary files /dev/null and b/images/c_entier.png differ diff --git a/images/c_fichier_sources.png b/images/c_fichier_sources.png new file mode 100644 index 0000000000000000000000000000000000000000..357dcd80e61a6bbab6f03f065add3def94f5dfc7 Binary files /dev/null and b/images/c_fichier_sources.png differ diff --git a/images/c_float.png b/images/c_float.png new file mode 100644 index 0000000000000000000000000000000000000000..c1a77f95ac5252fc06c7a5774f6caf252780de0b Binary files /dev/null and b/images/c_float.png differ diff --git a/images/c_liste.png b/images/c_liste.png new file mode 100644 index 0000000000000000000000000000000000000000..b569b5755388f807c2e6b555dcb109ed8300ad5d Binary files /dev/null and b/images/c_liste.png differ diff --git a/images/c_options_avancees.png b/images/c_options_avancees.png new file mode 100644 index 0000000000000000000000000000000000000000..19543dc94f17a368bd92ff727be7bc8dd344c6c3 Binary files /dev/null and b/images/c_options_avancees.png differ diff --git a/images/c_rep_ex.png b/images/c_rep_ex.png new file mode 100644 index 0000000000000000000000000000000000000000..0bb443d4a75d8509949e4b945096a483f1b88356 Binary files /dev/null and b/images/c_rep_ex.png differ diff --git a/images/c_service_web.png b/images/c_service_web.png new file mode 100644 index 0000000000000000000000000000000000000000..b538116d3fedf99c613c6f5fd7cd2923b3fa2bfa Binary files /dev/null and b/images/c_service_web.png differ diff --git a/images/c_syst_coord.png b/images/c_syst_coord.png new file mode 100644 index 0000000000000000000000000000000000000000..427360dd0380201eb4f62cb244e8503916c0b11a Binary files /dev/null and b/images/c_syst_coord.png differ diff --git a/images/c_txt_1l.png b/images/c_txt_1l.png new file mode 100644 index 0000000000000000000000000000000000000000..3c3c68bad190c0d2cde87c1679644eb8b30a592c Binary files /dev/null and b/images/c_txt_1l.png differ diff --git a/images/c_txt_1l_2.png b/images/c_txt_1l_2.png new file mode 100644 index 0000000000000000000000000000000000000000..4c48bc0c984171a6965ade56bfc36822f7834b35 Binary files /dev/null and b/images/c_txt_1l_2.png differ diff --git a/images/c_txt_multi.png b/images/c_txt_multi.png new file mode 100644 index 0000000000000000000000000000000000000000..a49f1816c7ad952293dcb4952531cc41d0c6d38e Binary files /dev/null and b/images/c_txt_multi.png differ diff --git a/images/c_url.png b/images/c_url.png new file mode 100644 index 0000000000000000000000000000000000000000..fd3e1f3504fe111acf895dce5228d26d2f6ccbab Binary files /dev/null and b/images/c_url.png differ diff --git a/images/c_vmap.png b/images/c_vmap.png new file mode 100644 index 0000000000000000000000000000000000000000..35284fd99c38fb9bd372b21cbb110be763a2c562 Binary files /dev/null and b/images/c_vmap.png differ diff --git a/images/c_vmap2.png b/images/c_vmap2.png new file mode 100644 index 0000000000000000000000000000000000000000..f34ac319b3376569ab004764f86a08d7f7592416 Binary files /dev/null and b/images/c_vmap2.png differ diff --git a/images/carteBing_valeur.png b/images/carteBing_valeur.png new file mode 100644 index 0000000000000000000000000000000000000000..66fc23c050670e860b964a8523faf7dd4e69d3aa Binary files /dev/null and b/images/carteBing_valeur.png differ diff --git a/images/carte_valeur_par_dafaut.png b/images/carte_valeur_par_dafaut.png new file mode 100644 index 0000000000000000000000000000000000000000..21c2e204ac694350900a9044877f06abff068501 Binary files /dev/null and b/images/carte_valeur_par_dafaut.png differ diff --git a/images/cascade.png b/images/cascade.png new file mode 100644 index 0000000000000000000000000000000000000000..10d6b0858367f240af046edddcb7151e9e30c03b Binary files /dev/null and b/images/cascade.png differ diff --git a/images/cascade2.png b/images/cascade2.png new file mode 100644 index 0000000000000000000000000000000000000000..e55dfe31e29f78b95b149da8775d2ba0aadc7de1 Binary files /dev/null and b/images/cascade2.png differ diff --git a/images/choix.png b/images/choix.png new file mode 100644 index 0000000000000000000000000000000000000000..64d195f03ca83ffe10fd62f5b3c04f9efb094e89 Binary files /dev/null and b/images/choix.png differ diff --git a/images/choix_multi.png b/images/choix_multi.png new file mode 100644 index 0000000000000000000000000000000000000000..031679795b1a82d2048c831c33969c77ace6761d Binary files /dev/null and b/images/choix_multi.png differ diff --git a/images/choixaliasmultpile.png b/images/choixaliasmultpile.png new file mode 100644 index 0000000000000000000000000000000000000000..d9d2e75f1ffb6a4b95f39ff825481c07508d417d Binary files /dev/null and b/images/choixaliasmultpile.png differ diff --git a/images/composants/gtf_composants.png b/images/composants/gtf_composants.png new file mode 100644 index 0000000000000000000000000000000000000000..b8d171b708b99297550ebfe0a335befa5c323dc2 Binary files /dev/null and b/images/composants/gtf_composants.png differ diff --git a/images/config_admin.png b/images/config_admin.png new file mode 100644 index 0000000000000000000000000000000000000000..b684c0dbcf437b70a996d0c77ffbafff2bfb3a21 Binary files /dev/null and b/images/config_admin.png differ diff --git a/images/couleur_fond.png b/images/couleur_fond.png new file mode 100644 index 0000000000000000000000000000000000000000..b273340ee9c3e2fcce6ecc52323e110af27a2d12 Binary files /dev/null and b/images/couleur_fond.png differ diff --git a/images/curseur.png b/images/curseur.png new file mode 100644 index 0000000000000000000000000000000000000000..cd017dc541248fbbd6ff2510f197044d37b7d801 Binary files /dev/null and b/images/curseur.png differ diff --git a/images/demo1-demande_projet_541x324.png b/images/demo1-demande_projet_541x324.png new file mode 100644 index 0000000000000000000000000000000000000000..94c73f8b71fc1cd21791a58f74c2ff2058cb4733 Binary files /dev/null and b/images/demo1-demande_projet_541x324.png differ diff --git "a/images/demo1-fme_edition_param_publi\303\251_324x177.png" "b/images/demo1-fme_edition_param_publi\303\251_324x177.png" new file mode 100644 index 0000000000000000000000000000000000000000..f9b928a0d66fc85136179b05d8d7495175c79d4e Binary files /dev/null and "b/images/demo1-fme_edition_param_publi\303\251_324x177.png" differ diff --git a/images/demo1-previsualisation_619x209.png b/images/demo1-previsualisation_619x209.png new file mode 100644 index 0000000000000000000000000000000000000000..435265a85bfe6bb6e712cd26bb4111777ff34d71 Binary files /dev/null and b/images/demo1-previsualisation_619x209.png differ diff --git a/images/demo1_ajout_projet_616x394.png b/images/demo1_ajout_projet_616x394.png new file mode 100644 index 0000000000000000000000000000000000000000..5676a40d41ac99c9a4be2a806f3f777f01f3193e Binary files /dev/null and b/images/demo1_ajout_projet_616x394.png differ diff --git a/images/demo1_resultat_624x105.png b/images/demo1_resultat_624x105.png new file mode 100644 index 0000000000000000000000000000000000000000..64a79495354b21748b0cf7aee95484a22c2ef9e4 Binary files /dev/null and b/images/demo1_resultat_624x105.png differ diff --git a/images/demo2-fme-supprssion_lien_423x117.png b/images/demo2-fme-supprssion_lien_423x117.png new file mode 100644 index 0000000000000000000000000000000000000000..1bddfe92b72756367f4b6ef2304bf10f2fb02236 Binary files /dev/null and b/images/demo2-fme-supprssion_lien_423x117.png differ diff --git a/images/demo2-gtf-ajout_projet_528x319.png b/images/demo2-gtf-ajout_projet_528x319.png new file mode 100644 index 0000000000000000000000000000000000000000..85a92522df56b386d1a722373dd78ded395d1860 Binary files /dev/null and b/images/demo2-gtf-ajout_projet_528x319.png differ diff --git a/images/demo2_donnee_source_s.png b/images/demo2_donnee_source_s.png new file mode 100644 index 0000000000000000000000000000000000000000..0d48359e098626a25bc7bf9b8a83c508bed3ee5c Binary files /dev/null and b/images/demo2_donnee_source_s.png differ diff --git a/images/demo2_fme_399x347.png b/images/demo2_fme_399x347.png new file mode 100644 index 0000000000000000000000000000000000000000..92ec79fa5a3ab597bb0b3af5b5c7509467a1958f Binary files /dev/null and b/images/demo2_fme_399x347.png differ diff --git a/images/demo2_gtf_formulaire_626x203.png b/images/demo2_gtf_formulaire_626x203.png new file mode 100644 index 0000000000000000000000000000000000000000..6e30278f0bbefda9e663ce2c5394d538761d05fb Binary files /dev/null and b/images/demo2_gtf_formulaire_626x203.png differ diff --git "a/images/demo2_r\303\251pertoire_projet_458x335.png" "b/images/demo2_r\303\251pertoire_projet_458x335.png" new file mode 100644 index 0000000000000000000000000000000000000000..b07f779937cbf0314c737d03ee2d31186c672cc4 Binary files /dev/null and "b/images/demo2_r\303\251pertoire_projet_458x335.png" differ diff --git a/images/demo4_fme_ajout_generic_381x214.png b/images/demo4_fme_ajout_generic_381x214.png new file mode 100644 index 0000000000000000000000000000000000000000..b831941d63863b3660092aeed683972ed2358f75 Binary files /dev/null and b/images/demo4_fme_ajout_generic_381x214.png differ diff --git a/images/demo4_fme_param_generic.png b/images/demo4_fme_param_generic.png new file mode 100644 index 0000000000000000000000000000000000000000..b9182394eff97176e05c64e9fd655c756bd6ed8a Binary files /dev/null and b/images/demo4_fme_param_generic.png differ diff --git a/images/demo4_fme_param_lien_param_format_356x301.png b/images/demo4_fme_param_lien_param_format_356x301.png new file mode 100644 index 0000000000000000000000000000000000000000..742766283894dfd568ea7220b5923e756da8eecc Binary files /dev/null and b/images/demo4_fme_param_lien_param_format_356x301.png differ diff --git a/images/demo4_fme_params_publies.png b/images/demo4_fme_params_publies.png new file mode 100644 index 0000000000000000000000000000000000000000..8af7b09723123b2fa73cb7e02fca749dc254e87f Binary files /dev/null and b/images/demo4_fme_params_publies.png differ diff --git a/images/demo4_fme_result_503x470.png b/images/demo4_fme_result_503x470.png new file mode 100644 index 0000000000000000000000000000000000000000..7dc1132005621f2d25195e60ffb9bb1f7f6f5f0b Binary files /dev/null and b/images/demo4_fme_result_503x470.png differ diff --git a/images/demo4_formulaire_par_defaut_585x293.png b/images/demo4_formulaire_par_defaut_585x293.png new file mode 100644 index 0000000000000000000000000000000000000000..ee2dba0a78abb98f861e45dcdc0cf36a3167880e Binary files /dev/null and b/images/demo4_formulaire_par_defaut_585x293.png differ diff --git a/images/demo4_gtf_ajout_demande_529x350.png b/images/demo4_gtf_ajout_demande_529x350.png new file mode 100644 index 0000000000000000000000000000000000000000..9dea283a52be46e7f1459f8e3d339244412e4c88 Binary files /dev/null and b/images/demo4_gtf_ajout_demande_529x350.png differ diff --git a/images/demo4_gtf_formaulire_depaut_625x316.png b/images/demo4_gtf_formaulire_depaut_625x316.png new file mode 100644 index 0000000000000000000000000000000000000000..a44e1a2aca0be02346d6f44ce2aa1d3b151eaa62 Binary files /dev/null and b/images/demo4_gtf_formaulire_depaut_625x316.png differ diff --git a/images/demo4bis_gtf_ajout_projet_619x367.png b/images/demo4bis_gtf_ajout_projet_619x367.png new file mode 100644 index 0000000000000000000000000000000000000000..6a10048e66c1e3ff9161f55f9c8b9af0f5b8e700 Binary files /dev/null and b/images/demo4bis_gtf_ajout_projet_619x367.png differ diff --git "a/images/depalcment_param\303\250tre.png" "b/images/depalcment_param\303\250tre.png" new file mode 100644 index 0000000000000000000000000000000000000000..7551658f13a9ae449b4c331afe66d3fa3271a40e Binary files /dev/null and "b/images/depalcment_param\303\250tre.png" differ diff --git a/images/destinatairecc.png b/images/destinatairecc.png new file mode 100644 index 0000000000000000000000000000000000000000..571d1792db6eb85656b16b8f61f47409663c0454 Binary files /dev/null and b/images/destinatairecc.png differ diff --git a/images/esi_cle.png b/images/esi_cle.png new file mode 100644 index 0000000000000000000000000000000000000000..a28314e2fb6e9ecc77deb6e21698605ad38619e9 Binary files /dev/null and b/images/esi_cle.png differ diff --git a/images/esi_previsualisation.png b/images/esi_previsualisation.png new file mode 100644 index 0000000000000000000000000000000000000000..30d0fa55e5166f5b7cea9d651927dd1326b36f33 Binary files /dev/null and b/images/esi_previsualisation.png differ diff --git a/images/f_b_radio.png b/images/f_b_radio.png new file mode 100644 index 0000000000000000000000000000000000000000..67eed7c3318943f71e480d1f8d5bcc9d1ed25d46 Binary files /dev/null and b/images/f_b_radio.png differ diff --git a/images/f_cn_import_nouvellesconnexions.png b/images/f_cn_import_nouvellesconnexions.png new file mode 100644 index 0000000000000000000000000000000000000000..6ab4edbbd3a4bed865671c5028fb3280be62211b Binary files /dev/null and b/images/f_cn_import_nouvellesconnexions.png differ diff --git a/images/f_multlignesss.png b/images/f_multlignesss.png new file mode 100644 index 0000000000000000000000000000000000000000..3f120a48a453403d0effcd0672c87e323a0e36f8 Binary files /dev/null and b/images/f_multlignesss.png differ diff --git a/images/f_p_txt.png b/images/f_p_txt.png new file mode 100644 index 0000000000000000000000000000000000000000..0c58542820f887511d989ca2dbd73ae9e30aa948 Binary files /dev/null and b/images/f_p_txt.png differ diff --git a/images/f_param_entier.png b/images/f_param_entier.png new file mode 100644 index 0000000000000000000000000000000000000000..17e79568fe38e23dadd91ddac16c8dedfa1b16f6 Binary files /dev/null and b/images/f_param_entier.png differ diff --git a/images/f_repSortie.png b/images/f_repSortie.png new file mode 100644 index 0000000000000000000000000000000000000000..23830a04f633825a375768318c50adf5168d1726 Binary files /dev/null and b/images/f_repSortie.png differ diff --git a/images/f_rep_existant.png b/images/f_rep_existant.png new file mode 100644 index 0000000000000000000000000000000000000000..5dad57b21008272df4d33098277cb62196ab83ab Binary files /dev/null and b/images/f_rep_existant.png differ diff --git a/images/f_txt_multi.png b/images/f_txt_multi.png new file mode 100644 index 0000000000000000000000000000000000000000..acd49ef2aa77fe8f259e5cd88ee2f524fe6f12b7 Binary files /dev/null and b/images/f_txt_multi.png differ diff --git a/images/f_url.png b/images/f_url.png new file mode 100644 index 0000000000000000000000000000000000000000..90305a4d1b11d43ac05fc90a08ba565a8f1da40a Binary files /dev/null and b/images/f_url.png differ diff --git a/images/fichier_local_otpions.png b/images/fichier_local_otpions.png new file mode 100644 index 0000000000000000000000000000000000000000..6e3fea85079aa7be5b8d324522832690f449aed1 Binary files /dev/null and b/images/fichier_local_otpions.png differ diff --git a/images/fme_CN_CN.png b/images/fme_CN_CN.png new file mode 100644 index 0000000000000000000000000000000000000000..dac7951d8d068f31c1750dbfc2575a3991e17637 Binary files /dev/null and b/images/fme_CN_CN.png differ diff --git a/images/fme_CN_IMPORT.png b/images/fme_CN_IMPORT.png new file mode 100644 index 0000000000000000000000000000000000000000..d721d5bf376fe43f8dcfdf0f0e14cf0fcd86c394 Binary files /dev/null and b/images/fme_CN_IMPORT.png differ diff --git a/images/fme_connexion_nommeenouveaureprroiredesconnexionsnomees.png b/images/fme_connexion_nommeenouveaureprroiredesconnexionsnomees.png new file mode 100644 index 0000000000000000000000000000000000000000..6ac3a33bd9ccbb90f673582f2633a00cf035cd59 Binary files /dev/null and b/images/fme_connexion_nommeenouveaureprroiredesconnexionsnomees.png differ diff --git a/images/fme_connexionnommeeExport.png b/images/fme_connexionnommeeExport.png new file mode 100644 index 0000000000000000000000000000000000000000..add58db823e3dc559b3fc34be788bdff713b7cb0 Binary files /dev/null and b/images/fme_connexionnommeeExport.png differ diff --git a/images/fme_connexionnommee_messageexport.png b/images/fme_connexionnommee_messageexport.png new file mode 100644 index 0000000000000000000000000000000000000000..fbd2d1e5280f78983c23bee41d216f9cb1e278f1 Binary files /dev/null and b/images/fme_connexionnommee_messageexport.png differ diff --git a/images/fme_connexionsnommees.png b/images/fme_connexionsnommees.png new file mode 100644 index 0000000000000000000000000000000000000000..4a24fc6f6b7e0feb36a5107ef679a4984ca62764 Binary files /dev/null and b/images/fme_connexionsnommees.png differ diff --git a/images/formilaire_invalide_58x43.png b/images/formilaire_invalide_58x43.png new file mode 100644 index 0000000000000000000000000000000000000000..fa8ec1cb044c0d931d46da58baa76164fe0ad720 Binary files /dev/null and b/images/formilaire_invalide_58x43.png differ diff --git a/images/formulaire_carte_bing.png b/images/formulaire_carte_bing.png new file mode 100644 index 0000000000000000000000000000000000000000..d40762998a9645c99ff22d7531a89837e489b348 Binary files /dev/null and b/images/formulaire_carte_bing.png differ diff --git a/images/formulaire_demande_liste.png b/images/formulaire_demande_liste.png new file mode 100644 index 0000000000000000000000000000000000000000..bb4ff9c5214e3fd412770a0b70e09c6ed622152e Binary files /dev/null and b/images/formulaire_demande_liste.png differ diff --git a/images/formulaire_import.png b/images/formulaire_import.png new file mode 100644 index 0000000000000000000000000000000000000000..5e1ed29c4c428038aed2be43b1df89cabe42d4b5 Binary files /dev/null and b/images/formulaire_import.png differ diff --git a/images/formulaire_par_defaut_365x189.png b/images/formulaire_par_defaut_365x189.png new file mode 100644 index 0000000000000000000000000000000000000000..4f6130b15fe3a65b2569a0a2172a7377f260cae9 Binary files /dev/null and b/images/formulaire_par_defaut_365x189.png differ diff --git a/images/gtf_composants.png b/images/gtf_composants.png new file mode 100644 index 0000000000000000000000000000000000000000..7f649f39840cb072cc6da79ac261ba6554dd1fbc Binary files /dev/null and b/images/gtf_composants.png differ diff --git a/images/gtf_publication_projet_570x340.png b/images/gtf_publication_projet_570x340.png new file mode 100644 index 0000000000000000000000000000000000000000..f5b4b8ac25af301533c7c97dd76d832cbd36eb23 Binary files /dev/null and b/images/gtf_publication_projet_570x340.png differ diff --git a/images/icones/check.png b/images/icones/check.png new file mode 100644 index 0000000000000000000000000000000000000000..6cc9e9eed01d3c51a21edd18eb2f016011274b5a Binary files /dev/null and b/images/icones/check.png differ diff --git a/images/icones/check_small.png b/images/icones/check_small.png new file mode 100644 index 0000000000000000000000000000000000000000..6aad0be5c62978af62f7b18573e33f9297451b53 Binary files /dev/null and b/images/icones/check_small.png differ diff --git a/images/icones/idea.png b/images/icones/idea.png new file mode 100644 index 0000000000000000000000000000000000000000..3903fc24de7f3cbcfd3ef65b39c2ed826cde55ad Binary files /dev/null and b/images/icones/idea.png differ diff --git a/images/icones/idea_small.png b/images/icones/idea_small.png new file mode 100644 index 0000000000000000000000000000000000000000..ee78c320a9c5f51bc678e1419882427d769012e1 Binary files /dev/null and b/images/icones/idea_small.png differ diff --git a/images/icones/question.png b/images/icones/question.png new file mode 100644 index 0000000000000000000000000000000000000000..027b5adca14344878794fd41f2780e0e0b7186f9 Binary files /dev/null and b/images/icones/question.png differ diff --git a/images/icones/question_small.png b/images/icones/question_small.png new file mode 100644 index 0000000000000000000000000000000000000000..a3c3133cda38ba5c5c40648d4d3db1fe2952ece9 Binary files /dev/null and b/images/icones/question_small.png differ diff --git a/images/icones/warning.png b/images/icones/warning.png new file mode 100644 index 0000000000000000000000000000000000000000..3f84a52d89c71bec37e3c797930dbab44e24e2fc Binary files /dev/null and b/images/icones/warning.png differ diff --git a/images/icones/warning_small.png b/images/icones/warning_small.png new file mode 100644 index 0000000000000000000000000000000000000000..941f591019832bfa932f7bdd92dc12e7733fb69d Binary files /dev/null and b/images/icones/warning_small.png differ diff --git a/images/import_projets.png b/images/import_projets.png new file mode 100644 index 0000000000000000000000000000000000000000..bdcefc0d67e1d1092f02d153d665cead9a8a2261 Binary files /dev/null and b/images/import_projets.png differ diff --git a/images/jeton.png b/images/jeton.png new file mode 100644 index 0000000000000000000000000000000000000000..956f30fb175d3ca2840e23e671552c4526357496 Binary files /dev/null and b/images/jeton.png differ diff --git a/images/liste_deroulante_alias.png b/images/liste_deroulante_alias.png new file mode 100644 index 0000000000000000000000000000000000000000..6a975c25d61c1af49ba75369869482a276a6fe8e Binary files /dev/null and b/images/liste_deroulante_alias.png differ diff --git a/images/liste_esi.png b/images/liste_esi.png new file mode 100644 index 0000000000000000000000000000000000000000..85cd676c1322d7976a68c98aca4b33326a67017f Binary files /dev/null and b/images/liste_esi.png differ diff --git a/images/logos/GTF.png b/images/logos/GTF.png new file mode 100644 index 0000000000000000000000000000000000000000..85439db9b6f206633280cb60ba7ba4e11e35fa81 Binary files /dev/null and b/images/logos/GTF.png differ diff --git a/images/metadata.png b/images/metadata.png new file mode 100644 index 0000000000000000000000000000000000000000..ed037e6e9c5df61e2ff86ef5c52df1f8a8353666 Binary files /dev/null and b/images/metadata.png differ diff --git a/images/mode_supervision_622x180.png b/images/mode_supervision_622x180.png new file mode 100644 index 0000000000000000000000000000000000000000..0316775779aa2e79061b313c309e1f9b86b487c8 Binary files /dev/null and b/images/mode_supervision_622x180.png differ diff --git a/images/modif_moteur_486x151.png b/images/modif_moteur_486x151.png new file mode 100644 index 0000000000000000000000000000000000000000..b7c4ba95219a5638e31f4ef88d1e4f98a195432c Binary files /dev/null and b/images/modif_moteur_486x151.png differ diff --git a/images/moteur.png b/images/moteur.png new file mode 100644 index 0000000000000000000000000000000000000000..609e3dce63035a031bbf25d270ccecca12a43f7f Binary files /dev/null and b/images/moteur.png differ diff --git a/images/moteur_gtf.png b/images/moteur_gtf.png new file mode 100644 index 0000000000000000000000000000000000000000..e0234ca525c7501d880da67b492854ab93078d97 Binary files /dev/null and b/images/moteur_gtf.png differ diff --git a/images/onglet_edition.png b/images/onglet_edition.png new file mode 100644 index 0000000000000000000000000000000000000000..8d673ddeac7886edfc4a45a84d6df440f4ccc516 Binary files /dev/null and b/images/onglet_edition.png differ diff --git a/images/onglets.png b/images/onglets.png new file mode 100644 index 0000000000000000000000000000000000000000..20aec3875516f14cafa8eb1ba4dcd2fcf717c2f7 Binary files /dev/null and b/images/onglets.png differ diff --git a/images/onglets2.png b/images/onglets2.png new file mode 100644 index 0000000000000000000000000000000000000000..686aefdcc552b160ffc5c965c4e716f218a2a05a Binary files /dev/null and b/images/onglets2.png differ diff --git a/images/p_date.png b/images/p_date.png new file mode 100644 index 0000000000000000000000000000000000000000..b918a437cfb5ec6ae5de4d2c63b93e4144e207c1 Binary files /dev/null and b/images/p_date.png differ diff --git a/images/param_choix_alias.png b/images/param_choix_alias.png new file mode 100644 index 0000000000000000000000000000000000000000..a32b70e57542f385074f819ec435058bc9f4adc4 Binary files /dev/null and b/images/param_choix_alias.png differ diff --git a/images/param_p_fichiers_multi.png b/images/param_p_fichiers_multi.png new file mode 100644 index 0000000000000000000000000000000000000000..2fc2abc6cbeaba394fc4083539e35f5238054eb0 Binary files /dev/null and b/images/param_p_fichiers_multi.png differ diff --git a/images/param_pub_flottant.png b/images/param_pub_flottant.png new file mode 100644 index 0000000000000000000000000000000000000000..5a53e427bbb0adad4142a639f1b984695678b8c3 Binary files /dev/null and b/images/param_pub_flottant.png differ diff --git a/images/param_pub_sys_coord.png b/images/param_pub_sys_coord.png new file mode 100644 index 0000000000000000000000000000000000000000..5702846098fe89c18002abf259fbd217447be94b Binary files /dev/null and b/images/param_pub_sys_coord.png differ diff --git a/images/parma_alias_multi.png b/images/parma_alias_multi.png new file mode 100644 index 0000000000000000000000000000000000000000..a3503919ba9e280e3d86fb1c49128311c9a77932 Binary files /dev/null and b/images/parma_alias_multi.png differ diff --git a/images/personnalisation_formulaire_627x316.png b/images/personnalisation_formulaire_627x316.png new file mode 100644 index 0000000000000000000000000000000000000000..48a34f26697a3da3105216613b6233a51ba994fb Binary files /dev/null and b/images/personnalisation_formulaire_627x316.png differ diff --git a/images/picto_firmulaire.png b/images/picto_firmulaire.png new file mode 100644 index 0000000000000000000000000000000000000000..1d3d633797f6b22371e83b52f0cc5998786db5ae Binary files /dev/null and b/images/picto_firmulaire.png differ diff --git a/images/previsualisation.png b/images/previsualisation.png new file mode 100644 index 0000000000000000000000000000000000000000..836eafd1789f1a7764d7b1eeddd7128c212a662d Binary files /dev/null and b/images/previsualisation.png differ diff --git a/images/projets_exemples.png b/images/projets_exemples.png new file mode 100644 index 0000000000000000000000000000000000000000..505a6d30bcdf7195c168289b916fcb510435ed66 Binary files /dev/null and b/images/projets_exemples.png differ diff --git a/images/pwd.png b/images/pwd.png new file mode 100644 index 0000000000000000000000000000000000000000..d0d7fec6ac8409ba3cec5bedd687b76f00585869 Binary files /dev/null and b/images/pwd.png differ diff --git a/images/rep_projet.png b/images/rep_projet.png new file mode 100644 index 0000000000000000000000000000000000000000..8c84f1f044f3ce9151bfdba1740335e78dcb2354 Binary files /dev/null and b/images/rep_projet.png differ diff --git a/images/selection_source_donnees.png b/images/selection_source_donnees.png new file mode 100644 index 0000000000000000000000000000000000000000..6ba15ca8a7b2bd77bd3e9c38983f49546b431809 Binary files /dev/null and b/images/selection_source_donnees.png differ diff --git a/images/studio.png b/images/studio.png new file mode 100644 index 0000000000000000000000000000000000000000..a36232a0bb8c5c62d2db3ca6f059fb1dba6dea34 Binary files /dev/null and b/images/studio.png differ diff --git a/images/suppression_parametre.png b/images/suppression_parametre.png new file mode 100644 index 0000000000000000000000000000000000000000..a6ffe94bf63ab841a865f82f64f27e2f016e5982 Binary files /dev/null and b/images/suppression_parametre.png differ diff --git a/images/sw_cle_libelle.png b/images/sw_cle_libelle.png new file mode 100644 index 0000000000000000000000000000000000000000..b9f3c083ca0404077e7dc7f0377278d96b0e0771 Binary files /dev/null and b/images/sw_cle_libelle.png differ diff --git a/images/sw_previsualisation.png b/images/sw_previsualisation.png new file mode 100644 index 0000000000000000000000000000000000000000..712803df3bbbfadb75ee70450c9350ebbca7806a Binary files /dev/null and b/images/sw_previsualisation.png differ diff --git a/images/widget.png b/images/widget.png new file mode 100644 index 0000000000000000000000000000000000000000..e3a0ad9db764ef187a8932d36ec7911266840adc Binary files /dev/null and b/images/widget.png differ diff --git a/utilisation/exemples/exemples.md b/utilisation/exemples/exemples.md new file mode 100644 index 0000000000000000000000000000000000000000..0bf0b2c83bd32cf03910f6a334db4b50a41e3d48 --- /dev/null +++ b/utilisation/exemples/exemples.md @@ -0,0 +1,315 @@ + +## Traitement de conversion d'un fichier statique sur le serveur + +### Objectif + +Création d'un traitement simple de conversion d'un fichier Shape, disponible sur le serveur, en fichier MapInfo, avec publication du répertoire destination à créer. + +Le fichier source est statique (toujours le même) et il se trouve à un emplacement quelconque du serveur. L'emplacement du jeu de données sur le serveur est défini dans le paramètre source dans FME et ce paramètre est dépublié. + +### Création du projet FME + +- Lancer FME Workbench +- Cliquer sur Fichier \>Nouveau\> Générer un projet +- Indiquer le fichier Shape en source et le format Mapinfo en sortie. Cocher Schéma statique puis cliquer sur OK. + +  + +Après validation, un projet simple de conversion d'un fichier Shape vers un fichier MapInfo est généré. + +  + +Par défaut, deux paramètres sont publiés : "sourceDataset\_SHAPE" et "DestDataSet\_MAPINFO". + +  + + + +**Chaque paramètre publié d'un projet FME génère une entrée dans le formulaire GTF.** +Dans cet exemple, le formulaire GTF permet de modifier le répertoire source et le répertoire destination. Or nous souhaitons que GTF ignore la publication des données sources, empêchant les utilisateurs finaux de sélectionner et modifier les fichiers sources. + +- Supprimer la publication du paramètre [SourceDataset\_SHAPE] pour forcer les utilisateurs à utiliser le fichier Shape mis à disposition sur le serveur. +- Editer, si désiré, le paramètre publié DestDaraset\_MAPINFO + +  + +- Enregistrer le projet, par exemple sous le nom "extraction\_departements.fm". + +Avant de publier ce projet dans GTF, il convient de le tester localement. +* Lancer le traitement depuis FME Workbench +* Vérifier le bon déroulement du traitement +* S'assurez que le résultat soit correctement généré. + +--- + + +### Publication du traitement dans GTF + +- Se connecter à GTF. +- Dans le menu Publication, cliquer sur **Ajouter Projet FME**. Donner un nom au traitement (par exemple, "Conversion\_dept\_shp2mapinfo"). +- Cliquer sur **Parcourir** et charger le projet FME. Choisir de ne pas rendre ce traitement disponible sur abonnement et ni pour une surveillance. Sélectionner le mot-clé associé au moteur GTF désiré. Cliquer sur **Créer**. + +  + + +- Dans la section "Droits", associer un groupe au traitement et cliquer sur **Mettre à jour**. +- Dans la section "Formulaire", visualiser le formulaire publié par défaut. Constater que le paramètre publié source du projet FME n'est pas publié et que seul le paramètre "Nom du dossier Destination MapInfo" est publié. La valeur par défaut configurée dans FME a été importée. + +  + + +### Exécution du traitement + +- Dans le Mode 'Mon travail' cliquer sur **Ajouter demande**, et choisir le traitement préalablement publié "Extraction Départements". + +  + + +- Cliquer sur **Demander**. La demande de traitement est créée et celle-ci est en attente de traitement. + +- Une fois traité, le voyant passe au vert. Le résultat est téléchargeable. + +  + + + +Le fichier .zip généré contient un répertoire "Mon résultat" contenant les fichiers MapInfo générés par le traitement. + +--- + +## Ajout de Paramètres publiés supplémentaires + +### Objectif + +Compléter le projet exemple n°1. Publication d'un paramètre publié supplémentaire pour spécifier une emprise d'extraction de données. + +### Création du projet FME + +- Ouvrir le précédent projet "extraction-departements.fmw" dans FME Workbench. Dans le Navigateur, publier les 4 paramètres : X minimum, Y minimum, X maximum et Y maximum des données sources. Entrer les valeurs par défaut correspondant à l'emprise de l'ensemble des données, par exemple : X minimum = 50000 ; X maximum = 1 200 000 ; Y minimum = 1 700 000 ; et Y maximum = 2 700 000. + +  + +- Enregistrer le projet "extraction\_depts\_emprise.fmw". + +### Publication du traitement dans GTF + +- Se connecter à GTF. +- Dans le menu Publication, cliquer sur **Ajouter Projet FME**. Donner un nom au traitement GTF, par exemple, "extraction depts emprise". Aucune ressource complémentaire ne doit être chargée puisque la donnée source est intégrée dans le projet FME. Choisir de ne pas rendre ce traitement disponible sur abonnement ni pour une surveillance. Sélectionner le mot-clé associé au moteur GTF désiré. Cliquer sur **Créer**. Dans la section "Droits", associer un groupe au traitement et cliquer sur **Mettre à jour**. + +  + + + +- Dans la section "Formulaire", visualiser le formulaire publié par défaut. Constater que les 4 paramètres de l'emprise apparaissent dans le formulaire avec les valeurs par défaut définies dans le projet FME. + +  + +### Exécution du traitement + +- Dans le mode "Mon travail" cliquer sur **Ajouter demande**, et choisir le traitement préalablement publié "Extraction Département emprise". +- Indiquer comme valeurs d'emprise X min = 500 000, Y min = 2 000 000, X max = 1 000 000 et Y max = 2 500 000, et "Mon\_résultat\_emprise" comme nom de répertoire destination. + +  + +- Cliquer sur **Créer la Demande**. +- Une fois la demande traitée (voyant vert), télécharger le .zip généré. + +  Remarquer que le nom du fichier ZIP correspond à l’identifiant de la demande de traitement : par exemple 19.zip pour la demande n°19. Ce numéro est unique car issu d’une séquence PostgreSQL. + + +- Ouvrir le fichier MapInfo généré dans FME Data Inspector et constater que les données ont été extraites selon l'emprise spécifiée. + +  + +--- + +## Conversion de fichiers sources statiques chargés sur le serveur lors du chargement du projet FME + +### Objectif + +Le fichier source est statique et il est chargé sur le serveur par GTF comme ressource du projet FME. Les utilisateurs finaux n'uploadent pas de fichiers sources, ils se trouvent sur le serveur au même endroit que le projet FME. + +Il s'agit ainsi de reconstituer la même arborescence que celle du poste de développement. + +### Création du projet FME + +- Créer un nouveau projet FME pour convertir un fichier Shape vers un fichier MIF/MID. + +  + +- Deux paramètres doivent être publiés : la source et la destination. La source pointe vers un fichier Shape en local. Pour que GTF puisse accéder à ce fichier, il faut uploader le shapefile et ses dépendances sur le serveur GTF. Ces données seront stockées dans le même répertoire que le projet FME lors de la création du traitement dans GTF. +- Modifier le chemin de la source comme tel : + +  + +  +**$(FME_MF_DIR_UNIX)** est une variable FME qui indique l’emplacement d’un projet FMW. Le fichier source (dpt2.shp et fichiers dépendants) est uploadé à cet emplacement. Il sera directement utilisable dans GTF (sans avoir à l’uploader à chaque demande de traitement). + + +- Les données sources étant fixes, il convient de dépublier ce paramètre, en cliquant sur **Supprimer le lien du paramètre publié**. + +  + +- Enregistrer le projet. + +### Publication du traitement dans GTF + +- Se connecter à GTF. +- Dans le menu "Publication", cliquer sur **Ajouter Projet FME**. Donner un nom au traitement GTF, par exemple "Conversion\_dept\_shp2mif". +- Charger le projet FME. Choisir de ne pas rendre ce traitement disponible sur abonnement ni pour une surveillance. Sélectionner le mot-clé associé au moteur GTF désiré puis dans la section Droits associer un groupe au projet. +- Pour uploader le fichier Shape et ses dépendances, compresser les fichiers dans un fichier ZIP. Dans le champ **Ressources complémentaires**, cliquer sur **Parcourir** et chercher le fichier ZIP précédemment créé. Cliquer sur **Créer**. + +  + + + **Ces ressources complémentaires sont décompressées dans le répertoire contenant le projet .fmw.** L'arborescence du poste de développement est ainsi reconstituée sur le serveur. + + La section "Répertoire Projet" permet de visualiser l'intégralité du répertoire projet du serveur : + +  + + +- Dans la section Formulaire, visualiser le formulaire publié par défaut. Constater que seul le fichier destination est paramétrable. Le fichier des départements dpts.shp est automatiquement associé au projet. + +  + +### Exécution du traitement + +- Dans le Mode "Mon travail" cliquer sur **Ajouter une demande**, et choisir le traitement préalablement publié conversion\_dept\_shp2mif". +- Indiquer le nom répertoire à créer en destination. Cliquer sur Créer la demande. +- Une fois la demande traitée (voyant vert), télécharger le .zip généré. + +  Remarquer que le nom du ZIP correspond à l’identifiant de la demande de traitement : par exemple 19.zip pour la demande n°19. Ce numéro est unique car issu d’une séquence PostgreSQL. + +--- + +## Traitement de conversion avec sortie générique + +### Objectif + +Publication d'un traitement de conversion d'un fichier dont le format destination est générique. L'utilisateur final choisit le format destination. Le fichier source au format Shape est statique. + +### Création du projet FME + +- Ouvrir le traitement créé dans l'exercice n°2 "extraction\_depts\_emprise.fmw" dans FME Workbench. Supprimer le jeu de données destination MapInfo et ajouter un nouveau jeu de données au format "Generic". Indiquer une destination temporaire. + +  + + + +- Cliquer sur **Paramètres** et choisir le format de sortie MapInfo : + +  + + + +- Dupliquer le type d'entités source, par un clic droit en choisissant l'option "Dupliquer"; +- Publier le paramètre "Système de coordonnées" du jeu de données Generic. + +  + + +Le format Generic permet de spécifier le format de destination via un paramètre. Le paramètre "GENERIC\_OUT\_FORMAT\_GENERIC" est publié par défaut. GTF ne supporte pas ce paramètre car tous les formats supportés par FME devraient être listés. + +- Dans un premier temps, il faut donc dépublier ce paramètre par un **clic droit \> Supprimer**. + +  + + + +- Il faut ensuite créer sa propre liste de formats dans un nouveau paramètre publié : ajouter un nouveau paramètre publié que vous nommerez "FORMAT" de type "Choix" et saisir les formats destination désirés. + +  + +  Le nom des formats doit correspondre aux noms courts tels qu’ils sont listés dans la galerie des formats de FME Workbench ("Outils" \> "Consulter la galerie des formats"). Il est également possible de choisir un type "Choix avec alias" pour afficher un texte plus explicite dans la liste. + +- Associer ensuite le paramètre 'FORMAT' au jeu de données générique. Faire un **clic droit sur le paramètre "Format en sortie"** et choisir **Lier au paramètre publié**. + +  + +- Enregistrer le projet, par exemple « shape2generic.fmw » + +### Publication du traitement dans GTF + +- Se connecter à GTF. +- Dans le menu Publication, cliquer sur **Ajouter Projet FME**. Donner un nom au traitement GTF, par exemple "Extraction départements avec choix de l'emprise et du format destination". Aucune ressource complémentaire ne doit être chargée puisque la donnée source est intégrée dans le projet FME. Choisir de ne pas rendre ce traitement disponible sur abonnement et ni pour une surveillance. Sélectionner le mot-clé associé au moteur GTF désiré. Cliquer sur **Créer**. Dans la section "Droits", associer un groupe au traitement et cliquer sur **Mettre à jour**. + +  + +- Dans la section "Formulaire", visualiser le formulaire publié par défaut. Constater que le paramètre Format destination est bien associé au projet. + +  + +### Exécution du traitement + +- Dans le mode "Mon travail", cliquer sur **Ajouter demande**, et choisir le traitement préalablement publié "Extraction départements avec choix de l'emprise et du format destination". +- Indiquer le fichier ZIP source et le répertoire destination. Cliquer sur **Créer la demande**. +- Une fois la demande traitée (voyant vert), télécharger le .zip généré. + +  Remarquer que le nom du fichier ZIP correspond à l’identifiant de la demande de traitement : par exemple 19.zip pour la demande n°19. Ce numéro est unique car issu d’une séquence PostgreSQL. + +---- + +## Personnalisation de formulaire : exploitation du contrôle de type Carte OSM + +### Objectif + +Extraction de types d'entités à partir d'une zone d'emprise saisie graphiquement sur une carte OSM par l'utilisateur final. Modification du formulaire directement dans GTF. + +### Création du projet FME + +Créer un nouveau projet FME pour extraire un fichier GeoFla au format Esri Shape avec un paramètre qui permet de choisir une zone d'extraction sous la forme d'un polygone décrit par une chaîne WKT. + +  + +Dans FME, 3 paramètres sont publiés : + +- Zone d'extraction WKT : chaîne de caractères WKT pour définir la zone d'extraction. Paramètre publié de type Texte. +- Couches à extraire : choix du type d'entités à extraire ("COMMUNES", "CANTONS", "DEPARTEMENTS"…). Paramètre publié de type Choix. +- Nom du Répertoire Destination à créer. Paramètre publié de type Répertoire en sortie. + +  + +### Publication du traitement dans GTF + +- Se connecter à GTF. +- Dans le menu Publication, cliquer sur **Ajouter Projet FME**. Donner un nom au traitement GTF, par exemple "Extraction GeoFla". Entrer ensuite une description et attribuer une catégorie. Choisir de ne pas rendre ce traitement disponible sur abonnement et ni pour une surveillance. +- Pour uploader les fichiers GeoFla au format Shape, compresser les fichiers dans un fichier ZIP. Dans le champ 'Ressources complémentaires' cliquer sur Parcourir et chercher le fichier ZIP précédemment créé. Cliquer sur **Créer**. Dans la section "Droits", associer un groupe au traitement et cliquer sur **Mettre à jour**. + +  + +- Dans la section "Formulaire", visualiser le formulaire publié par défaut. Constater que les 3 paramètres sont bien affichés. + +  + + +### Personnalisation du formulaire + +La saisie de la zone d'extraction sous la forme d'une chaîne de caractères WKT n'est pas simple. Une alternative serait de proposer à l'utilisateur final la possibilité de saisir manuellement la zone d'extraction de son choix en dessinant ses contours directement sur une carte. GTF permet l'exploitation de contrôles de type carte : + +- Carte OSM +- Carte Bing +- Carte Veremap + +Dans notre exemple, nous proposons d'exploiter la carte OSM qui ne nécessite pas de clé. + +Il est donc nécessaire de personnaliser le formulaire en cliquant sur le bouton  + + +- Dans la fenêtre Paramètres publiés, sélectionner ensuite le paramètre "wktPolygon" de type Texte que vous souhaitez convertir en contrôle de type Carte OSM. +- Dans la fenêtre Définition, sélectionner dans la liste, le contrôle de type "Carte OSM". + +  + +- Ajuster les paramètres d'affichage de la carte en définissant un libellé, par exemple "Dessiner la zone d'extraction", la largeur/hauteur de la carte, son échelle et projection, les coordonnées de son centre, ainsi que les outils qui seront affichés dans le formulaire de demande. + +- Cliquer ensuite sur le bouton **Sauvegarder le formulaire personnalisé**  puis sur le bouton de **Publication** de ce dernier . +- S'assurer que le formulaire a bien été mis à jour et que le paramètre "Zone d'extraction WKT" a été remplacé par un paramètre permettant la saisie du périmètre d'extraction directement sur une carte OSM. + +### Exécution du traitement + +- Dans le Mode "Mon travail" cliquer sur **Ajouter demande**, et choisir le traitement préalablement publié "Extraction GeoFla". +- Indiquer les couches à extraire, le répertoire destination et saisir directement sur la carte la zone d'extraction. Cliquer ensuite sur **Créer la demande**. +- Une fois la demande traitée (voyant vert), télécharger le .zip généré. + +  diff --git a/utilisation/exemples/index.rst b/utilisation/exemples/index.rst new file mode 100644 index 0000000000000000000000000000000000000000..1dcc97e9e6869398f662246b9c21f0b4f6bfc962 --- /dev/null +++ b/utilisation/exemples/index.rst @@ -0,0 +1,7 @@ +Exemples de publication de traitements +====================================== + +.. toctree:: + :maxdepth: 2 + + exemples diff --git a/utilisation/publication_traitements/ajout_projet_fme/ajout_de_projets_par_lot.md b/utilisation/publication_traitements/ajout_projet_fme/ajout_de_projets_par_lot.md new file mode 100644 index 0000000000000000000000000000000000000000..f74ba856f1a27e504cde9ea2674abdce94d50806 --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/ajout_de_projets_par_lot.md @@ -0,0 +1,10 @@ +# Import de projets FME par lot # + +GTF offre des fonctionnalités de catalogage et de gestion du patrimoine de projets FME disponibles dans un organisme. A cette fin et pour faciliter la création de plusieurs projets en même temps, la fonction d'ajout par lot a été créée permettant le chargement de plusieurs projets FME en une seule fois. + +Après avoir cliqué sur le bouton **Ajout par lot**, l'auteur clique sur le bouton **Parcourir**, et sélectionne les projets FME qu'il souhaite intégrer à GTF. Il clique ensuite sur le bouton **Transférer**;. + + +Une fois chargés, les projets FME apparaissent dans la liste des projets FME du mode "Publication". L'auteur est ensuite en charge de nommer ou renommer les fichiers, de gérer leur métadonnées et de leur associer les groupes et droits désirés. + +Tous les visualiseurs contenus dans un projet FME sont désactivés lors du processus d'import ou d'ajout de projets dans GTF. diff --git a/utilisation/publication_traitements/ajout_projet_fme/ajout_projet_fme.md b/utilisation/publication_traitements/ajout_projet_fme/ajout_projet_fme.md new file mode 100644 index 0000000000000000000000000000000000000000..7d404f9b35e44964d992f070438577f6d2768f33 --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/ajout_projet_fme.md @@ -0,0 +1,30 @@ +Il existe deux façons dans GTF de créer des Projets FME : l'ajout de projet et l'[Import de projets par lot](ajout_de_projets_par_lot.html). + +# Ajout de projet FME # + +Le bouton **Ajouter un Projet FME** de l’onglet Projets FME permet d’accéder au formulaire de création de projet. +  + + *Formulaire de création de projet* + + La première étape consiste à attribuer un nom au traitement. + +**Règles de nommage des projets** + +Plusieurs options sont possibles : +- L'auteur nomme le projet directement dans GTF. Dans l'exemple, ci-dessus, le projet se nomme "Zone_inondable". +- L'auteur choisit d'utiliser le nom du script FME et laisse dans GTF le champ "Nom du traitement" vide. Le nom du traitement est le nom du script FME sans son extension. Dans l'exemple ci-dessus, le projet se nommerait "zone_inondableswfs2kml". +- Si le nom du traitement existe déjà, alors le nom du nouveau projet est suffixé par la date du jour. Dans l'exemple ci-dessus, le nouveau projet serait nommé "Zone_inondable_jjmm.aaaa". +L’auteur charge ensuite le projet FME dans lequel il aura pris soin de publier certains paramètres comme par exemple le répertoire destination. Le paramètre "Ressources complémentaires" permet d’associer les ressources nécessaires pour l'exécution du projet FME, comme par exemple des données sources. + +  GTF détecte les formats de types multifichiers (Shape File, EDIGEO…) contenus dans un fichier compressé ZIP que l’utilisateur uploade sur le serveur. Les fichiers sont automatiquement décompressés dans le répertoire projet. + +Il définit ensuite la disponibilité du traitement sur [abonnement](../gestion_periodes.html) et pour [Surveillance](../gestion_depots.html). + +Le [modèle d'email](../modeles_emails.hmtl) à associer au traitement doit ensuite être défini, ainsi que le moteur GTF auquel rattacher le traitement. La stratégie d'affiliation se fait à partir de la liste des [mots clés/moteurs](../../installation/initialisation_admin.hmtl), définis au préalable par l'administrateur de l'application. +Le bouton **Créer** permet ensuite de finaliser la première étape du processus de création de traitement en générant le formulaire correspondant. + + +  La création d'un projet génère ensuite un attribut "Clé" qui correspond à un identifiant unique universel du projet. Il s'agit d'une clé unique qui permet par exemple en cas de réinstallation de GTF, d'assurer l'unicité et le référencement du projet. Sa valeur est conservée en cas d'installation du projet sur un nouveau serveur contrairement à l'identifiant système ID. + +  Tous les visualiseurs contenus dans un projet FME sont désactivés lors du processus d'import ou d'ajout de projets dans GTF. diff --git a/utilisation/publication_traitements/ajout_projet_fme/appel_externe.md b/utilisation/publication_traitements/ajout_projet_fme/appel_externe.md new file mode 100644 index 0000000000000000000000000000000000000000..6e934dee12bad76679d04647601ddbeef408aabd --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/appel_externe.md @@ -0,0 +1,45 @@ +# Appel externe + +La section "Appel externe" permet l'intégration dans une page HTML d'un formulaire GTF. C'est un moyen de donner accès à un projet GTF depuis une quelconque page web, sans avoir GTF installé sur son poste. +La section "Appel externe" du mode Projet permet de définir la façon dont l'utilisateur final aura accès au formulaire GTF puis génère le code à intégrer directement dans la page html désirée. + +L'administrateur définit le type d'accès souhaité au formulaire GTF : +- soit via un bouton intégré dans la page Internet, +- soit via l'insertion telle quelle du formulaire GTF dans la page web. + +Il associe ensuite un titre au formulaire et, dans le cas d'un bouton, il spécifie le texte associé au bouton d'accès du formulaire dans le champ "Texte du bouton". La hauteur et largeur du formulaire peuvent également être paramétrées. + + + +*Appel externe* + +## Jetons de connexion + +Un jeton agit comme une clé permettant d'accéder à un formulaire GTF. Un jeton ne peut être donné qu'à un utilisateur authentifié. +L'administrateur a la possibilité d'associer à un traitement un jeton privé ou un jeton public permettant l'accès et l'utilisation du formulaire GTF : +- Le jeton public est l'identifiant de connexion du compte public défini au préalable par l'administrateur dans le mode "Configuration". +- Fournir un jeton privé est un moyen de donner accès à un compte de connexion à un traitement GTF particulier. Pour générer une clé privée, l'administrateur saisit le login et mot de passe de l'utilisateur pour lequel il souhaite générer un jeton privé puis définit une date de fin de validité de cette dernière. Après avoir cliqué sur le bouton **Clé privée**, la clé est retournée et intégrée dans le code à utiliser. + + + +## Utilisation de CAPTCHA + +Il est possible d'intégrer un captcha au formulaire pour s'assurer que la demande de traitement est bien générée par un être humain et non par un ordinateur. + + L'insertion d'un captcha, nécessite l'obtention d'une clé sur le service Web de Google à l'adresse [https://www.google.com/recaptcha/admin](). Une fois la clé obtenue, l'administrateur saisit la clé fournie dans le champ "Clé Recaptcha". + + La clé est directement intégrée dans le code généré par GTF. Le motif captcha est généré automatiquement à chaque demande de traitement. + +### Insertion du code généré + +Le bouton **Générer le code** retourne le code à copier dans la page HTML permettant d'accéder au formulaire GTF. Le code contient le jeton de connexion défini au préalable (public ou privé), ainsi que le cas échéant la clé captcha. + +Exemple de code: +  +*Jeton de connexion public / Clé captcha* + +Ce code est à insérer directement dans la page HTML à l'emplacement désiré. + +L'exemple ci-dessous illustre l'insertion d'une fenêtre de demande de création de gex (traitement administration "admin_export") dans une page HTML : + + diff --git a/utilisation/publication_traitements/ajout_projet_fme/attribution_droits_traitement.md b/utilisation/publication_traitements/ajout_projet_fme/attribution_droits_traitement.md new file mode 100644 index 0000000000000000000000000000000000000000..0bc6895282fca4e683c67243e3f25a7c7e3d32e8 --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/attribution_droits_traitement.md @@ -0,0 +1,9 @@ + +# Attribution de droits au traitement # + +Pour pouvoir être exploité, un traitement doit être associé à un groupe. Dans la section "Droits", l’auteur associe un groupe au projet nouvellement créé en faisant glisser le groupe choisi dans la partie de Groupes associés au traitement. Il clique ensuite sur le bouton **Mettre à jour**. + +<center> + +*Attribution de droits à un traitement* +</center> diff --git a/utilisation/publication_traitements/ajout_projet_fme/gestion_connexions_nommees.md b/utilisation/publication_traitements/ajout_projet_fme/gestion_connexions_nommees.md new file mode 100644 index 0000000000000000000000000000000000000000..1c1df48fb28ad5a663d19bd2dabaece5573c5480 --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/gestion_connexions_nommees.md @@ -0,0 +1,116 @@ + +# Gestion des connexions nommées + +Les connexions nommées stockent les informations de connexions aux bases de données et services web. De la même manière que les formats et transformers personnalisés, les connexions nommées sont stockées dans des répertoires propres à chaque utilisateur. +Elles sont ainsi stockées dans un fichier crypté "namedConnections.data" situé dans le répertoire + + %userprofile%\AppData\Roaming\Safe Software\FME\ + +Ce fichier doit pouvoir être accessible par un utilisateur réel via FME Workbench pour créer et gérer les connexions, mais il doit également pouvoir être utilisé par le compte système local, compte qui, dans GTF, exécute le service Pycron pour lancer un traitement FME. + +Or, contrairement aux utilisateurs classiques, le compte système local ne dispose pas de répertoire personnel <code>%userprofile%</code>. Il ne peut donc pas exploiter les connexions nommées d'un projet FME publié sur un serveur GTF. + +Pour pouvoir exploiter les connexions nommées dans GTF, le fichier crypté des connexions nommées doit donc être localisé, puis une clé de registre doit ensuite être créée : elle indiquera l'emplacement du fichier crypté, de sorte à en assurer son utilisation par tout compte ne disposant pas de répertoire personnel tel que le compte Système local. +- Rendre publiques les connexions nommées désirées +- Exporter les connexions nommées désirées dans un répertoire spécifique +- Créer une clé de registre contenant le chemin du répertoire par défaut, stockant le fichier des connexions nommées +- Tester + +## Rendre publiques les connexions nommées + +Dans un premier temps, pour pouvoir être exploitables par d'autres utilisateurs, les connexions nommées doivent être rendues publiques. +Dans FME, dans le Menu "Outils" > "Options FME" > "Connexions aux bases de données", sélectionner les connexions nommées que vous souhaitez exporter (et les attribuer ensuite à un compte système local) puis cocher la case Public. + + +*Connexions nommées dans FME.* + + + + La possibilité de rendre publique une connexion nommée a été implémentée dans la version FME 2016. Or, FME exploite des connexions nommées créées dans d'anciennes versions. Dans ce cas, la colonne "Public" n'apparaît pas dans la fenêtre des connexions. Pour contourner ce problème et afficher la colonne "Public", exporter les connexions nommées dans un nouvel emplacement, supprimer les connexions initiales, puis les réimporter (cf. "procédure 6.1.9.2"). + +## Exporter des connexions nommées + +Sélectionner la ou les connexions nommées que vous souhaitez exporter puis dans le menu contextuel, choisir **Exporter**. + + +*Export des connexions nommées.* + + +Les connexions sélectionnées sont exportées dans un fichier XML : "exportConnectionData_x.xml". Choisir ensuite son emplacement. + + + + +Dans FME, il est alors possible de modifier l'emplacement du fichier des connexions nommées en indiquant le nouveau répertoire dans le menu "Outils" > "Options FME" > "Chemins par défaut". + + +*Spécification du répertoire des connesions nommées.* + +Vous pouvez, par exemple, supprimer les connexions nommées d'origine, puis importer celles que vous venez d'exporter et remplacer de la sorte les connexions initiales. +Retourner dans le menu "Outils" > "Options FME" > "Connexions aux bases de données" et sélectionner **Importer** dans le menu contextuel dans la liste des connexions. + + +*Import de connexions nommées* + +Sélectionner les connexions que vous souhaitez importer : + + +*Sélection des connexions nommées à importer* + +Les connexions nommées précédemment exportées sont à nouveau importées. + +Dorénavant, 5 connexions nommées sont listées dans le menu "Outils" > "Options FME" > "Connexions aux bases de données" : + + +*Nouvelles connexions nommées* + +## Création des clés de registre + +Pour pouvoir attribuer au compte système local le répertoire par défaut des connexions nommées (nouvellement importées), un fichier de registre "cn32.reg" (ou "cn64.reg" selon les versions de FME) doit être créé et contenir le chemin du répertoire stockant le fichier crypté des connexions. + +``` +Windows Registry Editor Version 5.00 +\\[HKEY_LOCAL_MACHINE\\SOFTWARE\\WOW6432Node\\Safe Software Inc.\\Feature Manipulation Engine\\Settings] +"Named Connection Db Type"=dword:00000000 +"Named Connection Directory"="E:\\tmp\\connexion" +``` +*Clé de registre cn32.reg à créer.* + + +## Import de la clé de registre + +Importer la clé de registre via la commande "Regedit" > "Import" ou par un double clic sur le fichier .reg. + +- "cn32.reg" contient la clé de registre pour FME 32 bits +- "cn64.reg" contient la clé de registre pour FME 64 bits + + Il est possible d'importer les deux clés. + +## Test + +Veremes met à disposition sur son [site de téléchargement](http://download.veremes.net/) le projet "ListSettings.fmw" qui génère un fichier texte ("settings.txt") dans lequel sont listés les paramètres système FME du serveur tels que les builds, l'interpréteur Python utilisé... +Pour vérifier l'emplacement du répertoire des connexions nommés, exécuter le projet "ListeSettings.fmw" et s'assurer que dans le fichier texte généré, le répertoire spécifié soit bien rajouté et correct : + +``` +Settings: + +Python: +Use Custom Python: false +Named Connection Db Type: 0 +Named Connection Directory: E:\tmp\connexion +Statistics: +enabled: no +``` + + +## Publier une connexion nommée + +Un auteur de projet peut publier une connexion nommée. Avec GTF 2015 et 2016.0, pour publier une connexion nommée il est nécessaire de créer un paramètre publié de type "TEXTE". + + + +Puis il faut associer ce paramètre publié au paramètre du Reader ou du Transformer concerné : + + + + Avec GTF 2016.1, les paramètres publiés de type Connexion Nommée sont automatiquement reconnus et transformés en paramètre de type Texte. diff --git a/utilisation/publication_traitements/ajout_projet_fme/gestion_metadonnees.md b/utilisation/publication_traitements/ajout_projet_fme/gestion_metadonnees.md new file mode 100644 index 0000000000000000000000000000000000000000..0fd847d04767e577e7fcba4938a097b8ce9bf599 --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/gestion_metadonnees.md @@ -0,0 +1,19 @@ +# Gestion des métadonnées # + +GTF permet la gestion des métadonnées d'un projet et l'exploitation des métadonnées natives issues des projets FME. +Les métadonnées d'un projet, définies dans FME via le Navigateur, sont chargées dans GTF. + - Les sections "Description", "Catégorie", "Conditions d'utilisation", "Utilisation", "Prérequis" et "Historique" sont directement issues du projet FME et peuvent être modifiées . + - La date de dernière sauvegarde, l'encodage et la version FME sont propres au projet FME source et sont modifiés automatiquement dans GTF en cas de rechargement du projet FME. + + *Une catégorie définie dans un projet FME est importée dans GTF et créée dans le menu "Catégories" si elle n'existe pas.* + + +*Métadonnées d'un projet* + +La section "Métadonnées" du mode "Publication" permet à l'auteur, de modifier ces dernières et de les réécrire dans le projet FME. + + - Le bouton **Mettre à jour** permet d'enregistrer les modifications des métadonnées dans GTF. + - Le bouton **Relire le projet** permet de recharger les métadonnées du projet FME initial. Les champs "Description", "Utilisation", "Prérequis" et "Conditions d'utilisation" saisis dans GTF sont remplacés par les valeurs issues du projet FME source. + - Le bouton **Ecrire le projet** permet de modifier les métadonnées du projet FME source. Les valeurs des champs "Description", "Utilisation", "Prérequis" et "Conditions d'utilisation" initiales sont remplacées par les valeurs saisies dans GTF. Le projet .fmw modifié est disponible dans la section "Répertoire Projet". + + Les métadonnées d'un projet sont chargées lors du premier chargement d'un projet FME. Si les métadonnées sont ajoutées et/ou modifiées dans GTF et que l'on procède à un nouveau chargement du projet FME, alors les métadonnées du projet FME, n'écrasent pas celles éditées dans GTF. Les métadonnées sont ainsi chargées que lors du premier chargement d'un projet FME. Le bouton "Relire le projet" permet de contourner ce fonctionnement pour permettre le rechargement des du projet FME source initialement chargé. diff --git a/utilisation/publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md b/utilisation/publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md new file mode 100644 index 0000000000000000000000000000000000000000..fc451be91218dad0742589a6498375ee64060182 --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/gestion_personnalisation_formulaires.md @@ -0,0 +1,588 @@ +# Gestion et personnalisation des paramètres publiés : travailler dans le studio + +La section "Formulaire" du mode "Publication" permet de gérer l’affichage du formulaire de demande de traitement tel qu'il sera affiché lors d’une demande émise par un utilisateur. + +Le studio permet de personnaliser graphiquement chaque paramètre publié importé depuis FME, et permet la mise en page générale du formulaire de demande. + + +*Studio de personnalisation de formulaire* + +Le studio de personnalisation des formulaires est composé de quatre fenêtres : +- Une fenêtre centrale de prévisualisation du formulaire. Elle permet de prévisualiser le formulaire tel qu'il sera affiché lors d'une demande de traitement, mais il est possible d'afficher le formulaire JSON ou JavaScript en sélectionnant le type d'affichage désiré en haut de la fenêtre.  +- Une fenêtre des paramètres publiés, à droite de l'écran : elle liste l'ensemble des paramètres publiés du projet et leur ordre d'affichage. Il est possible de modifier l'ordre d'affichage des paramètres , de les supprimer  et en d'en créer de nouveaux  . +- Une fenêtre de définition des paramètres, à gauche en bas de l'écran, qui permet leur édition et configuration. +- Une fenêtre formulaire, en haut à gauche de l'écran, qui permet l'enregistrement, la publication et le nommage de chaque formulaire. Il permet d'afficher le formulaire par défaut, le formulaire publié et le formulaire personnalisé. + +## Formulaire par défaut, formulaire personnalisé, formulaire publié + +Le formulaire par défaut comporte les paramètres publiés du projet FME. Après visualisation, l'auteur peut choisir de conserver en l'état ce formulaire ou de le personnaliser. + +Chaque projet FME chargé dans GTF est stocké dans le répertoire "\workspace" du répertoire d'installation de GTF. Le sous-répertoire "workspace\fme" stocke le projet .fmw et les ressources du projet, et le répertoire "workspace\form" stocke les fichiers de gestion et de personnalisation des formulaires du traitement. + +Une fois un projet créé, GTF créé 3 fichiers identiques : + +* "DsubForm.json" : formulaire par défaut du traitement, affiché dans le studio lorsque l'on sélectionne le bouton  +* "SubForm.json" : formulaire publié par GTF, affiché dans le studio lorsque l'on sélectionne le bouton  +* "WsubForm.json" : formulaire destiné à être personnalisé, affiché dans le studio lorsque l'on sélectionne le bouton de personnalisation  + +Lors de la publication d'un formulaire personnalisé, le fichier WsubForm est modifié puis écrase le fichier SubForm. + +Lors de la création d'un projet, les 3 formulaires par défaut, personnalisé et publié sont identiques. L'auteur d'un projet peut ensuite personnaliser le formulaire par défaut. Il choisit de publier ou pas le formulaire personnalisé. +A tout moment il peut revenir au formulaire par défaut et le publier à nouveau. + +  +En cas de re chargement d'un projet FME, si le formulaire publié est identique au formulaire par défaut alors les 3 formulaires sont écrasés. En revanche, lorsque le formulaire publié est identique au formulaire personnalisé, alors seul le formulaire par défaut est écrasé. Dans ce cas de figure, les formulaires personnalisés et publiés sont donc conservés. + +  +Dans la liste des projets, on peut distinguer les projets publiés exploitant un formulaire par défaut, des projets exploitant un formulaire personnalisé par la couleur du pictogramme du champ Formulaire : un pictogramme vert signifie que le formulaire par défaut est publié. Un pictogramme bleu indique que le formulaire publié est un formulaire personnalisé. + + *Liste des projets et formulaires exploités* + +### Création d'onglets dans un formulaire + +L'auteur d'un projet peut choisir d'agencer le formulaire de demande de traitement sous forme d'onglets. Il peut ainsi répartir les paramètres sur plusieurs onglets. + +Le bouton "Edition" > **Gestion des onglets** de la fenêtre des formulaires personnalisés permet d'accéder à la fenêtre de gestion de ces derniers. + + + +  + +Après avoir édité et nommé un onglet, cocher les paramètres devant le composer. Le bouton **Ajouter un onglet** en bas de la fenêtre permet la création d'un nouvel onglet. +Un aperçu des onglets nouvellement créés s'affiche dans la partie de droite de la fenêtre. +Cliquer sur **Valider** pour revenir au studio. + + + +  Les onglets ne sont pas apparents dans le studio mais uniquement dans la fenêtre de gestion de ces derniers. + +  Un paramètre peut apparaître sur deux onglets différents. Lors de la demande d'un tel projet, l'édition d'un paramètre dans un onglet est automatiquement reportée dans le deuxième onglet. + +## Paramètres publiés FME et contrôles GTF + +Les paramètres publiés de FME sont importés dans GTF et peuvent être modifiés dans le studio via des contrôles GTF. Un contrôle GTF est converti en paramètre publié FME lors du traitement du projet. +Certains contrôles GTF ne sont pas issus de paramètres publiés de FME et correspondent à des composants de mise en page (interface) destinés à personnaliser l'interface du formulaire de demande de projet. + +Il existe 20 types de contrôles GTF paramétrables dans la fenêtre de Définition des Paramètres : + +Nom du contrôle GTF + +- [Bouton radio](#controle-gtf-de-type-bouton-radio-controle-de-type-bouton-radio) +- [Carte Bing](#carte-bing) +- [Carte OSM](#contrôles-gtf-de-type-carte-osm-carte-bing-et-carte-vmap) +- [Carte vMap](#carte-vmap) +- [Champ caché](#contrôle-gtf-de-type-champ-caché) +- [Couleur](#paramètre-publié-de-type-choix-de-couleur---contrôle-de-type-couleur) +- [Curseur](#paramètre-publié-et-contrôle-de-type-curseur) +- [Date et Heure](#paramètre-publié-de-type-dateheure---contrôle-de-type-date-et-heure) +- [Décimal](#paramètre-publié-de-type-flottant---contrôle-de-type-décimal) +- [Entier](#paramètre-publié-de-type-entier---contrôle-de-type-entier) +- [Fichier local ](#paramètre-publié-de-type-nom-de-fichier-multiple---contrôle-de-type-fichier-local) +- [Interface - Ligne de séparation](#contrôle-gtf-de-type-interface---ligne-de-séparation) +- [Label](#contrôles-gtf-de-type-label) +- [Label Titre](#contrôles-gtf-de-type-label) +- [Liste](#gestionnaire-de-sources-de-données) +- [Liste déroulante](#gestionnaire-de-sources-de-données) +- [Texte en édition 1 ligne](#paramètre-publié-de-type-répertoire-en-sortie---contrôle-de-type-texte-en-édition-1-ligne) +- [Texte en édition Mot de passe](#paramètre-publié-de-type-mot-de-passe---contrôle-de-type-texte-en-édition-mot-de-passe) +- [Texte en édition Multiligne](#paramètre-publié-de-type-texte-multiligne---contrôle-de-type-texte-en-édition---multiligne) +- [Texte en édition URL](#paramètre-publié-de-type-url---contrôle-de-type-texte-en-édition-url) + + *Un nom de paramètre ne peut pas contenir d'espace.* + + *Les valeurs par défaut d'un paramètre publié FME sont importées dans GTF.* + +### Paramètre publié de type "Choix" - Contrôle de type "Liste déroulante" + +Un paramètre publié FME de type "Choix" est importé dans un GTF en contrôle de type "Liste déroulante". +La configuration de la liste se fait via le [Gestionnaire de source de données](#gestionnaire-de-sources-de-donnees). +L'auteur du projet nomme le paramètre et son libellé tel qu'il sera affiché dans le formulaire de demande et définit le nombre de lignes. Il indique si le paramètre est obligatoire en cochant ou pas la case "Requis". + +Il est possible de faire de cette liste une [liste en cascade](), en définissant la liste parent et les attributs sur lesquels doit reposer l'ascendance. + +   + +*Paramètre publié de type Choix et Contrôle GTF de type Liste déroulante* + +### Paramètre publié de type "Choix multiple" - Contrôle de type "Liste" + +Un paramètre publié FME de type Choix multiple est importé dans GTF en contrôle de type Liste. Le [Gestionnaire de source de données]() permet de configurer la liste importée. + +L'auteur du projet nomme le paramètre et le libellé tel qu'il sera affiché dans le formulaire de demande et définit la valeur par défaut. Il paramètre le nombre de lignes à afficher. Il définit si le paramètre est obligatoire en cochant ou pas la case "Requis". + + + +   + +*Paramètre publié de type Choix multiple et contrôle GTF de Type Liste* + +Il est possible de faire de cette liste une [liste en cascade](), en définissant la liste parent et les attributs sur lesquels doit reposer l'ascendance. + +### Paramètre publié de type "Choix avec alias" - Contrôle de type "Liste déroulante" + +Un paramètre publié de type "Choix avec alias" est importé dans GTF en contrôle de type "Liste déroulante". +La configuration de la liste se fait dans le Gestionnaire de source de données. +L'auteur du projet nomme le paramètre et son libellé tel qu'il sera affiché dans le formulaire de demande et définit sa valeur par défaut. Il paramètre le nombre de lignes à afficher. Il définit si le paramètre est obligatoire en cochant ou pas la case "Requis". + +   + +*Paramètre publié de type Choix avec alias et Contrôle GTF de type Liste déroulante.* + +Il est possible de faire de cette liste une [liste en cascade](), en définissant la liste parent et les attributs sur lesquels doit reposer l'ascendance. + +### Paramètre publié de type "Choix avec alias multiple" - Contrôle de type "Liste" + +Un paramètre pubié de type "Choix avec alias multiple" est importé dans GTF en contrôle de type "Liste". +La configuration de la liste se fait dans le +[Gestionnaire de source de données](). +L'auteur du projet nomme le paramètre et le libellé qui sera affiché dans le formulaire de demande, définit le nombre de lignes à afficher. Il définit si le paramètre est obligatoire en cochant ou pas la case "Requis". + +   + +*Paramètre publié de type Choix avec alias multiple et contrôle GTF de type Liste* + +Il est possible de faire de cette liste une [liste en cascade](), en définissant la liste parent et les attributs sur lesquels doit reposer l'ascendance. + + +### Paramètre publié de type "Choix de couleur" - Contrôle de type "Couleur" + +Un paramètre publié de tye "Choix de couleur" est importé dans GTF en contrôle de type "Couleur" . L'auteur nomme le paramètre et le libellé qui sera affiché dans le formulaire de demande, définit la couleur par défaut. Il peut choisir la largeur du contrôle et définir si ce paramètre est obligatoire ou pas. + +   + +### Paramètre publié et contrôle de type "Curseur" + +Un paramètre publié de type "Curseur" est importé sous la forme de contrôle de type "Curseur". L'auteur du projet nomme le paramètre et le libellé tel qu'il sera affiché dans le formulaire de demande et définit les valeurs minimales et maximales ainsi que la valeur par défaut du curseur. + +   + +### Paramètre publié de type "Date/heure" - Contrôle de type "Date et Heure" + +Un paramètre publié de type "Date/Heure" est importé dans GTF sous la forme de contrôle "Date et Heure". +L'auteur nomme le paramètre et le libellé qui sera affiché dans le formulaire de demande. Il peut définir la date et heure affichées par défaut. Il définit si le paramètre est obligatoire en cochant ou pas la case "Requis". + +   + +### Paramètre publié de type "Entier" - Contrôle de type "Entier" + +Un paramètre publié de type "Entier" est importé dans GTF en contrôle de type "Entier". L'auteur nomme le paramètre et le libellé qui sera affiché dans le formulaire de demande et définit la valeur par défaut . Il peut définir si ce paramètre est obligatoire ou pas en cochant la case "Requis". + +   + +*Paramètre publié et contrôle de type "Entier"* + +### Paramètre publié de type "Flottant" - Contrôle de type "Décimal" + +Un paramètre publié de type "Flottant" est importé dans GTF en contrôle de type "Décimal". L'auteur nomme le paramètre et le libellé qui sera affiché dans le formulaire de demande et définit la valeur par défaut. Il peut définir si ce paramètre est obligatoire ou pas en cochant la case "Requis". + +   + +*Paramètre publié de type "Flottant" et contrôle de type "Décimal"* + +### Paramètre publié de type "Mot de passe" - Contrôle de type "Texte en édition mot de passe" + +Un paramètre publié FME de type "Mot de passe "est importé dans GTF sous la forme de contrôle de type "Texte en édition - mot de passe". +L'auteur nomme le paramètre et le libellé qui sera affiché dans le formulaire de demande. +Il peut définir un motif sous la forme d'expression régulière, pour contrôler l'affichage du mot de passe et s'assurer que la valeur respecte bien un modèle. +Il peut définir si ce paramètre est obligatoire ou pas en cochant la case "Requis", et choisit la largeur du contrôle. + +   + +*Paramètre publié de type "Mot de passe" et Contrôle de type "Texte en édition - mot de passe"* + +### Paramètre publié de type "Nom de fichier multiple" - Contrôle de type "Fichier Local" + +Un paramètre publié FME de type "Nom de fichier (Multiple)" est importé dans GTF sous la forme de contrôle de type "Fichier Local". +L'auteur du projet nomme le paramètre et le libellé qui sera affiché dans le formulaire de demande, définit la largeur du contrôle et indique si le paramètre est obligatoire ou pas. + +   + +*Paramètre publié de type "Nom de fichier Multiple" et Contrôle de type "Fichier local"* + +#### Options avancées + +Les options avancées permettent d'affiner l'affichage du formulaire lors du chargement de fichiers en faisant apparaître ou pas la prévisualisation des fichiers, ainsi que les boutons de chargement et de suppression des fichiers. + +### Paramètre de type "Nom de fichier en sortie" - Contrôle de type "Fichier Local" + +Le paramètre publié de type "Fichier en sortie" est importé sous la forme de contrôle de type "Texte en édition - 1 ligne". L'auteur du projet nomme le paramètre et définit le libellé tel qu'il sera affiché dans le formulaire de demande. Il peut insérer une expression régulière dans le champ "Motif" pour assurer un contrôle de la valeur saisie. Il peut définir une valeur par défaut, la largeur du contrôle à afficher et indique si le paramètre est obligatoire ou pas. + +   + +*Paramètre publié de type "Nom de fichier en sortie" et Contrôle GTF de type "Texte en édition" - 1 ligne* + +### Paramètre publié de type "Nom de système de coordonnées" - Contrôle de type "Liste déroulante" + +Un paramètre publié de type "Nom de Système de coordonnées" est importé dans GTF sous la forme d'une "Liste déroulante". Les valeurs de la liste sont automatiquement importées et visibles dans le gestionnaires de source de données. + +   + +*Paramètre publié de type "Nom de système de coordonnées" et Contrôle de type "Liste déroulante".* + +La configuration de la liste se fait via le [Gestionnaire de source de données](). +L'auteur du projet nomme le paramètre et le libellé qui sera affiché dans le formulaire de demande et définit le nombre de lignes à afficher ainsi que la largeur du contrôle. Il indique si le paramètre est obligatoire en cochant ou pas la case "Requis". + +### Paramètre publié de type "Répertoire existant" - Contrôle de type "Fichier local" + +Un paramètre publié de type "Répertoire existant" est importé sous la forme d'un contrôle de type "Fichier local". L'auteur du projet nomme le paramètre et le libellé tel qu'il sera affiché dans le formulaire de demande, il définit la largeur du contrôle et indique si ce paramètre est obligatoire ou pas. + +Les [options avancées]() permettent d'affiner les paramètres d'affichage lors du téléchargement du fichier. + +   + +*Paramètre publié de type "Répertoire (Existant)" et contrôle de type "Fichier Local"* + +### Paramètre publié de type Répertoire en sortie - Contrôle de type Texte en édition 1 ligne + +Un paramètre publié de type "Répertoire" en sortie est importé sous la forme d'un contrôle de type "Texte en édition 1 ligne". L'auteur du projet nomme le paramètre et le libellé tel qu'il sera affiché dans le formulaire de demande. Il peut définir la valeur par défaut du nom de répertoire à créer, et il peut saisir une expression régulière dans le champ "Motif" pour assurer un contrôle du nom créé. +Il peut définir la largeur du contrôle et indiquer si le paramètre est obligatoire en cochant ou pas la case "Requis". + +   + +*Paramètre publié de type Répertoire en sortie et contrôle de type Texte en édition- 1 ligne* + +### Paramètre publié de type "Texte" - Contrôle de type "Texte en édition 1 ligne" + +Un paramètre publié de type "Texte" est importé sous la forme d'un contrôle de type "Texte en édition- 1 ligne". L'auteur du projet nomme le paramètre et le libellé tel qu'il sera affiché dans le formulaire de demande. Il peut définir la valeur par défaut à créer, et peut saisir une expression régulière dans le champ "Motif" pour assurer un contrôle de la valeur saisie. +Il peut définir la largeur du contrôle et indiquer si le paramètre est obligatoire en cochant ou pas la case "Requis". + +   + +*Paramètre publié de type "Texte" et Contrôle GTF de type "Texte en édition - 1 ligne"* + +### Paramètre publié de type "Texte multiligne" - Contrôle de type "Texte en édition - Multiligne" + +Un paramètre publié de type "Texte multiligne" est importé sous la forme d'un contrôle de type "Texte en édition-multiligne". L'auteur du projet nomme le paramètre et le libellé tel qu'il sera affiché dans le formulaire de demande. Il peut définir la valeur par défaut et la largeur du contrôle et indiquer si le paramètre est obligatoire en cochant ou pas la case "Requis". + +   + +*Paramètre publié de type "Texte multiligne" et contrôle de type "Texte en édition - Multiligne"* + +### Paramètre publié de type "Texte Multiligne ou Nombre" - Contrôle de type "Texte en édition - Multiligne" + +Un paramètre publié de type "Texte Multiligne ou Nombre" est importé sous la forme d'un contrôle de type Texte en édition-Multiligne. L'auteur du projet nomme le paramètre et le libellé tel qu'il sera affiché dans le formulaire de demande. Il peut définir la valeur par défaut et la largeur du contrôle et indiquer si le paramètre est obligatoire en cochant ou pas la case "Requis". + +   + +*Paramètre publié de type Texte multiligne ou Nombre et contrôle de type Texte en édition - Multiligne* + +#### Paramètre publié de type "URL" - Contrôle de type "Texte en édition URL" + +Un paramètre publié de type "URL" est importé sous la forme d'un contrôle de type "Texte en édition-URL". L'auteur du projet nomme le paramètre et le libellé tel qu'il sera affiché dans le formulaire de demande. Il peut insérer un motif via une expression régulière pour assurer un contrôle sur la valeur saisie (type de protocole spécifique), définir la valeur par défaut et la largeur du contrôle et indiquer si le paramètre est obligatoire en cochant ou pas la case "Requis" + +   + +*Paramètre publié de type "URL" et contrôle de type "Texte en édition - URL"* + +### Contrôle GTF de type "Bouton radio" - Contrôle de type "Bouton Radio" + +Un paramètre publié FME de type "Choix" est importé dans GTF en tant que contrôle de type "Liste Déroulante", mais il est possible de modifier ce dernier en exploitant un contrôle de type "Bouton radio". +L'auteur du projet nomme le paramètre et son libellé tel qu'il sera affiché dans le formulaire de demande. +Il définit la valeur par défaut et détermine si les boutons radios seront désactivés ou pas. Il définit ensuite les options possibles en entrant le libellé du bouton et la valeur envoyée en base. +Le bouton  permet de rajouter des boutons au paramètre. + +   + +*Contrôle de type "Bouton Radio"* + +### Contrôles GTF de type "Carte OSM", "Carte Bing" et "Carte vMap" + +GTFpermet d'exploiter les services web OSM, Bing Maps ou Vitis vMap pour personnaliser un formulaire en exploitant leurs ressources cartographiques. +Par exemple, dans FME, on peut définir une géométrie dans un champ de type texte définie par une chaîne de caractère WKT. +Dans GTF, Il est plus simple de personnaliser le formulaire de saisie en exploitant une carte OSM comme support de saisie de la géométrie plutôt que de rentrer une chaîne WKT dans un contrôle de type "Texte". + +#### Carte OSM + +L'auteur du projet qui insère un élément (ou qui modifie un paramètre existant) de type "Carte OSM", nomme le paramètre, et définit le libellé qui sera affiché dans le formulaire de demande. Il définit la hauteur et la largeur de la carte et indique si ce paramètre est obligatoire ou pas en cochant la case "Requis". + + + +Il définit ensuite les options spécifiques aux éléments de type carte : + + + +- La projection de la carte : WGS84 ou Lambert 93. En Lambert 93, l’étendue par défaut correspond à l'ensemble de la France métropolitaine. +- Méthode de centrage de la carte : l'auteur choisit si le centre de la carte est défini par un point défini via des coordonnées X/Y et une échelle d'affichage, ou si le centre de la carte est paramétrée par son étendue définie par les coordonnées X et Y Min et Max. + +L'auteur choisit ensuite les éléments de dessin et de navigation qui seront affichés sur la carte du formulaire de demande : +- Position de la souris : affichage dynamique des coordonnées de la souris selon la projection définie. +- Boutons de zoom : affichage des boutons de navigation classique zoom avant, zoom arrière et retour à l'étendue par défaut. +- Echelle : affichage de l'échelle. +- Projection de la carte : affichage de la projection Lambert 93 ou WGS 84. +- Multiples géométries : possibilité ou pas de saisir des géométries de type différent (point, ligne et polygone). +- Plein écran : permet d'afficher la carte en mode plein écran. +- Suppression générale : suppression de toutes les géométries saisies sur la carte. +- Edition : modification de la géométrie sélectionnée. +- Dessiner un point. +- Dessiner une ligne. +- Dessiner un polygone. + +Le champ "Valeur" permet à l'auteur de définir une géométrie qui sera affichée par défaut dans le formulaire de demande. Cette géométrie est décrite via une chaîne WKT. + + + +*Contrôle "Carte OSM". Exemple de valeur par défaut* + + + +*Formulaire de demande d'un contrôle de type "Carte OSM" - Géométrie saisie par défaut* + +##### Carte Bing +Tous les paramètres de personnalisation d'une carte Bing Maps sont identiques à ceux des cartes OSM. Il faut fournir en plus, une clé d'accès pour pouvoir exploiter ce service web cartographique. + +Générer une clé Bing Maps sur le site https://www.bingmapsportal.com/ +Une fois obtenue, entrer la clé dans le champs "Clé" et sélectionner la carte à afficher dans le formulaire de demande : +- Aerial +- Aerial WithLabels +- Road + + + + + +*Formulaire de demande de traitement avec contrôle de type "Carte Bing".* + +##### Carte vMap +Pour pouvoir exploiter une carte vMap dans GTF, Il faut au préalable, dans vMap, exporter la définition de la carte. L'export d'une carte vMap génère un fichier map.json que l'auteur du formulaire doit télécharger (champ "Fichier local") pour pouvoir l'intégrer dans un formulaire. Il procède ensuite de la même façon qu'avec les autres ressources de type carte, en nommant le paramètre et son libellé, puis en paramétrant l'affichage des [outils propres aux cartes](). + + + + + +*Formulaire de demande de traitement avec contrôle de type "Carte vMap".* + +### Contrôle GTF de type "Interface" - "Ligne de séparation" + +Un contrôle de type Interface-Ligne de séparation permet d'améliorer l'affichage d'un formulaire de demande d'un traitement en y insérant des lignes et accroître de la sorte son organisation et sa lisibilité. + + +### Contrôles GTF de type "Label" + +Il existe 2 contrôles de type Label : + +#### Label + +Un contrôle GTF de type Label permet d'insérer un champ et sa valeur dans un formulaire de demande de projet, sans qu'il puisse être modifié. L'auteur nomme le paramètre et son libellé tel qu'il sera affiché dans le formulaire. Il définit ensuite la valeur à afficher, ainsi que la largeur du contrôle. + +#### Label - Style titre + +Un contrôle "Label Style Titre" permet d'insérer un titre dans le formulaire de demande. L'auteur définit le nom du paramètre et son libellé, puis définit la classe html à associer au titre. + +### Contrôle GTF de type "Champ caché" + +Un contrôle GTF de type "Champ caché" permet de masquer un paramètre publié. Le paramètre est exploité dans le traitement mais n'est pas apparent. +L'auteur nomme le paramètre et définit la valeur à exploiter. + +  Un paramètre publié FME caché, c'est-à-dire que son nom est par préfixé par H_, est directement importé dans GTF en contrôle de type Champ caché. + +    + + *Contrôle de type "Champ caché"* + +### Gestionnaire de sources de données + +Le gestionnaire de sources de données permet la création, l’édition et la suppression des sources de données à associer aux contrôles GTF de type +"Liste" et "Liste déroulante" + +Le Gestionnaire de sources de données permet d'exploiter des données : +* Texte : valeurs saisies directement dans le gestionnaire ou importées depuis un paramètre FME de type Choix. +* Valeurs de table locale : valeurs issues d'une table de base de données installée sur le même serveur que GTF. +* Base de données externe : valeurs importées d'une table de base de données externe à GTF. +* Service web Vitis : permet d'exploiter un service web pour en récupérer les ressources. + +Le gestionnaire de source de données est accessible en cliquant sur le bouton  en bas à droite de la fenêtre des paramètres publiés. + + + +*Fenêtre du Gestionnaire de source de données* + +On peut ajouter, éditer ou supprimer une source de données. +Le bouton 'Ajouter' permet de créer une nouvelle source de données. +Le type de source détermine les paramètres de connexion devant être définis pour pouvoir importer les valeurs. + +##### Ajout de source de données de type texte + +Cette option permet de saisir directement des valeurs de type texte qui s'afficheront dans le formulaire sous forme de liste déroulante. + +##### Paramétrer la source de données + + + +*Gestionnaire de source de données. Source de données de type Texte.* + +Après avoir nommé la source de données, saisir les libellés et les clés (stockées en base) séparés par le caractère |. +Le bouton 'Aperçu', permet de visualiser la liste en cours de création. +Le bouton 'Valider' permet de valider la création de la liste, de fermer la fenêtre en cours et de revenir à la liste des sources de données. +Cliquer à nouveau sur 'Valider' pour fermer le gestionnaire de source de données et revenir au studio. + +##### Lier la source de données au paramètre publié + +Pour associer la source de données créée à un paramètre de type liste , sélectionner le paramètre dans la fenêtre Paramètres publiés, puis l'éditer dans la fenêtre de Définition. + + + +*Sélection du paramètre publié dans le studio.* + +Sélectionner ensuite la source de données nouvellement créée dans le champs Source de données : + + + +*Sélection de la source de données.* + +Cliquer ensuite sur le bouton 'Recharger les sources de données  en haut à droite de la fenêtre de prévisualisation, pour pouvoir visualiser la liste. + +Vous pouvez paramétrer le nombre de lignes à afficher dans la liste, sa largeur et définir si ce paramètre est obligatoire ou pas, en cochant le paramètre 'Requis'. + +##### Ajout d'une source de données de type Valeurs d'une table locale + +Le Gestionnaire de source de données permet d'importer les valeurs d'une table de base de données installée sur le même serveur que GTF. + +##### Paramétrer la source de données + + + +*Gestionnaire de source de données. Source de données de type Valeurs de table locale.* + +Saisir le nom à attribuer à la source de données à créer, puis la base de données (facultatif). Appuyer sur le bouton Schémas pour obtenir la liste des schémas de la base, puis sur le bouton Tables pour sélectionner celles contenant les valeurs à utiliser. Le bouton ' Test' permet de tester la connexion en affichant la table dans la fenêtre Aperçu. + +Il est possible de filtrer les données à importer via une clause de type Where, définie dans le champs 'Filtre'. Dans l'exemple ci-dessus, on peut choisir de n'afficher que les bâtiments d'une commune et saisir dans le champs filtre la clause : id_com='340003'. + +Le bouton 'Valider' permet de fermer la fenêtre en cours et de revenir à liste des sources de données. +Cliquer à nouveau sur Valider pour fermer le gestionnaire de source de données et revenir au studio. + +##### Lier la source de données au paramètre publié + +Pour lier cette liste à un paramètre publié, sélectionner le paramètre désiré dans la fenêtre des Paramètres publiés à droite de l'écran, pour pouvoir ensuite l'éditer dans la fenêtre de Définition : + + + +*Sélection de la source de données.* + +Nommer le paramètre, éditer son libellé puis sélectionner dans la liste déroulante la source de données nouvellement créée, dans l'exemple ci-dessus : 'liste_moteurs". + +Définir ensuite la clé ainsi que le libellé qui sera affiché dans le formulaire : pour cela cliquer sur le bouton  pour charger les valeurs et sélectionner celles à définir comme clé puis comme libellé : + + + +*Définition de l'attribut clé.* + +Dans la fenêtre de prévisualisation, cliquer ensuite sur le bouton 'Recharger les sources de données' , pour pouvoir prévisualiser la liste, telle qu'elle s'affichera dans le formulaire de demande : + + + +*Prévisualisation du paramètre de type Liste.* + +Vous pouvez paramétrer le nombre de lignes à afficher dans la liste, sa largeur et définir si ce paramètre est obligatoire ou pas, en cochant le paramètre 'Requis'. + +Vous pouvez faire de cette liste une [liste en cascade]() en cochant la case Cascade. + + + +##### Options avancées = affiner l'affichage des listes + +Il est possible d'affiner l'affichage des éléments de la liste via des commandes de tri (order_by et sort_order) sur les attributs dont on spécifie les noms dans le champs Attributs. Ils doivent êtres séparés par le caractère |. Pour distinguer les valeurs identiques, on peut définir une clause distinct. +On peut également filtrer les valeurs à afficher via une clause Where dont on spécifie les arguments dans le champ ' filter'. Dans l'exemple ci-dessous, on choisit de n'afficher que le moteur n° 1 en insérant une clause Where sur l'attribut gtf_engine_id : + + + +* Gestionnaire de source de données. Source de données de type Base de données externe. + +Après avoir saisi le nom de la nouvelle source de données, saisir les paramètres de connexion à la base de données (serveur, port, sgbd, login, mot de passe et tables). Le bouton  permet d'afficher la liste des tables de la base et de la sorte de s'assurer de la réussite de la connexion. +Il est également possible de filtrer les données à importer via une clause de type Where, saisie dans le champs Filtre. +Dans l'exemple ci-dessus, seuls les ESI en instruction et inscrits seront listés dans le formulaire. + +Le bouton 'Valider' permet de fermer la fenêtre en cours et revenir à liste des sources de données. +Cliquer, à nouveau, sur Valider pour fermer le gestionnaire de source de données et revenir au studio. + +##### Lier la source de données au paramètre publié + +Pour lier cette liste à un paramètre publié, sélectionner le paramètre désiré dans la fenêtre des Paramètres publiés à droite de l'écran, pour pouvoir ensuite l'éditer dans la fenêtre de Définition : + + + +Nommer le paramètre, éditer son libellé puis sélectionner dans la liste déroulante la source de données nouvellement créée, dans l'exemple ci-dessus : 'esi'. + +Définir ensuite la clé ainsi que le libellé : pour cela, cliquer sur le bouton  pour charger les valeurs et sélectionner celles à définir comme clé puis comme libellé : + + + +Cliquer ensuite sur le bouton 'Recharger les sources de données'  dans la fenêtre de prévisualisation, pour pouvoir prévisualiser la liste, telle qu'elle s'affichera dans le formulaire de demande : + + + +Vous pouvez paramétrer le nombre de lignes à afficher dans la liste, sa largeur et définir si ce paramètre est obligatoire ou pas, en cochant le paramètre 'Requis'. + +Vous pouvez faire de cette liste une [liste en cascade]() en cochant la case Cascade. + + + +##### Options avancées + +##### Ajout d'une source de données de type Service web + +Il est possible d'exploiter les ressources des services web Vitis et Gtf pour configurer les paramètres de type liste. + + + +* Gestionnaire de source de données. Source de données de type Service Web.* + +Après avoir sélectionné le service à exploiter (Vitis ou Gtf), sélectionner la ressource dont vous voulez importer les données. +Dans l'exemple ci-dessus, on exploite la ressource Groups du service Vitis. Les groupes d'utilisateurs de Vitis seront importés dans le paramètre publié de type liste, en cours de création. + + *L’accès aux services web diffère selon les privilèges liés à l’utilisateur. Il faut donc s'assurer que le compte connecté ait bien les droits requis pour accéder au service web de son choix. Consulter la liste des droits par service.* + +Le bouton 'Valider' permet de fermer la fenêtre en cours et revenir à liste des sources de données. +Cliquer à nouveau sur Valider pour fermer le gestionnaire de source de données et revenir au studio. + +##### Lier la source de données au paramètre publié + +Pour lier cette liste à un paramètre publié, sélectionner le paramètre désiré dans la fenêtre des Paramètres publiés à droite de l'écran, pour pouvoir ensuite l'éditer dans la fenêtre de Définition : + + + +Nommer le paramètre, éditer son libellé puis sélectionner dans la liste déroulante la source de données nouvellement créée, dans l'exemple ci-dessus : 'groupes'. +Définir ensuite la clé ainsi que le libellé. Pour cela cliquer sur le bouton  pour charger les valeurs et sélectionner celles à définir comme clé puis comme libellé : + + + +Cliquer ensuite sur le bouton 'Recharger les sources de données'  dans la fenêtre de prévisualisation, pour pouvoir visualiser la liste, telle qu'elle s'affichera dans le formulaire de demande : + + + +Vous pouvez paramétrer le nombre de lignes à afficher dans la liste, sa largeur et définir si ce paramètre est obligatoire ou pas, en cochant le paramètre 'Requis'. + +Vous pouvez faire de cette liste une [liste en cascade]() en cochant la case cascade. + +#### Options avancées + +#### Créer des listes en cascade + +On peut choisir d'afficher une liste dont le contenu varie en fonction des valeurs sélectionnées dans une autre liste. L'option Cascade permet le paramétrage de telles listes en spécifiant le paramètre publié parent et l'attribut enfant sur lequel effectuer le filtre d'affichage. + +**Attributs de filtrage et Signe de comparaison** +Après avoir défini quel est l'élément parent, il faut définir le champ enfant sur lequel repose l'ascendance ainsi que le signe de comparaison sur lequel doit reposer la comparaison entre les champs liant la table parent à la table enfant. +Les signes de comparaison sont : +- = Egalité parfaite entre le champ parent et le champ enfant +- \> Ne seront affichés dans la liste enfant que les enregistrements dont la valeur est supérieure à l'attribut de filtre parent. +- < Ne seront affichés dans la liste enfant que les enregistrements dont la valeur est inférieure à l'attribut de filtre parent. + +**Attendre le parent** +Pour forcer l'affichage de la liste des éléments enfants uniquement lorsqu'un élément parent est sélectionné, il faut cocher la case 'Attendre le parent'. Ainsi, si aucun élément parent n'est sélectionné, aucun élément enfant n'apparaîtra dans la liste. + +**Exemple** +On veut faire apparaître les sections d'une commune sélectionnée préalablement. +Un premier paramètre nommé 'commune' est créé. Il exploite les valeurs d'une table 'commune' d'une base de données. Un deuxième paramètre nommé 'section' est créé. Il exploite les valeurs d'une table 'section' de la même base. +Dans la fenêtre de la définition du paramètre 'section', après avoir lié le paramètre à la source de données, sélectionner la boîte à cocher 'cascade' puis sélectionner le paramètre parent 'commune' : + + + +Seules les 2 sections de la commune sélectionnée d'Abeilhan apparaissent désormais dans la liste Section : + + diff --git a/utilisation/publication_traitements/ajout_projet_fme/gestion_transformers_formats_personnalises.md b/utilisation/publication_traitements/ajout_projet_fme/gestion_transformers_formats_personnalises.md new file mode 100644 index 0000000000000000000000000000000000000000..7eabf22e047fcc4b29b6f404500ce374c858bc49 --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/gestion_transformers_formats_personnalises.md @@ -0,0 +1,14 @@ +# Gestion des Transformers et formats personnalisés + +FME stocke les formats et Transformers personnalisés dans des répertoires propres à chaque utilisateur identifiés par la variable d'environnement %userprofile%. +- Les Transformers personnalisés sont stockés dans le répertoire %userprofile%\Mes documents\FME\Transformers. +- Les formats personnalisés sont stockés dans le répertoire %userprofile%\Mes documents\FME\Formats + +De la sorte, chaque utilisateur dispose de son propre environnement de travail. + +Dans GTF, un traitement FME est exécuté par le compte qui exécute le service Pycron, en général 'système local'. Ce dernier ne dispose pas de répertoire utilisateur %userprofile% . FME ne peut donc pas localiser les fichiers des Transformers et des formats personnalisés. Le traitement ressortira en erreur. + +Pour pouvoir être exploités, les formats et Transformers personnalisés doivent donc être installés manuellement (copiés) sur le serveur GTF dans les répertoires suivants : + +- Formats personnalisés ==> $FME_HOME\datasources +- Transformers personnalisés ==> $FME_HOME\transformers diff --git a/utilisation/publication_traitements/ajout_projet_fme/index.rst b/utilisation/publication_traitements/ajout_projet_fme/index.rst new file mode 100644 index 0000000000000000000000000000000000000000..5a81548db8240506b973fe7b8976e7cf4b926a6f --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/index.rst @@ -0,0 +1,21 @@ +Ajout de projet FME +==================================== +Un utilisateur avec des droits d'auteur peut publier un traitement. Après avoir généré un projet dans FME, il crée un traitement dans GTF puis l'associe au projet. +Le mode Publication comporte l’ensemble des formulaires permettant la création et le paramétrage des traitements GTF. + + + +.. toctree:: + :maxdepth: 3 + + + ajout_projet_fme + ajout_de_projets_par_lot + appel_externe + attribution_droits_traitement + gestion_Transformers_formats_personnalises + gestion_connexions_nommees + gestion_metadonnees + gestion_personnalisation_formulaires + répertoire_projet + diff --git a/utilisation/publication_traitements/ajout_projet_fme/repertoire_projet.md b/utilisation/publication_traitements/ajout_projet_fme/repertoire_projet.md new file mode 100644 index 0000000000000000000000000000000000000000..3a811112910858372b132c2a3c79347e3b7fe2a0 --- /dev/null +++ b/utilisation/publication_traitements/ajout_projet_fme/repertoire_projet.md @@ -0,0 +1,9 @@ +# Répertoire Projet + +La section Répertoire projet permet de visualiser le contenu du répertoire contenant le projet FME ainsi que les ressourceS associées à ce dernier. Ce répertoire contient les copies systématiques des projets FME (renommés en .bak) dont les visualiseurs ont été désactivés. +En cas de chargement de projets fmw de même nom, l'ancien projet est renommé en .bak. +Les ressources sont écrasées en cas de chargement de ressources de même nom. La date de dernière modification des fichiers est indiquée et permet de contrôler la bonne mise à jour des fichiers écrasés. + + + + GTF détecte les formats de types multifichiers (Shape File, EDIGEO…) contenus dans un fichier compressé ZIP que l’utilisateur uploade sur le serveur. Les fichiers sont automatiquement décompressés dans le répertoire projet. diff --git a/utilisation/publication_traitements/gestion_categories.md b/utilisation/publication_traitements/gestion_categories.md new file mode 100644 index 0000000000000000000000000000000000000000..11d3efc1893b74d5733a2fef9d5b58a75682caf5 --- /dev/null +++ b/utilisation/publication_traitements/gestion_categories.md @@ -0,0 +1,4 @@ +# Gestion des catégories + +L’attribution de catégorie à un traitement permet à l’administrateur d’organiser par thématique les traitements disponibles. +L’onglet Catégorie du mode Publication permet d’accéder au formulaire de création de catégorie dans lequel l’administrateur nomme cette dernière et peut lui associer une description. diff --git a/utilisation/publication_traitements/gestion_depots.md b/utilisation/publication_traitements/gestion_depots.md new file mode 100644 index 0000000000000000000000000000000000000000..8f416116656569c378c264ca97924ee831342768 --- /dev/null +++ b/utilisation/publication_traitements/gestion_depots.md @@ -0,0 +1,27 @@ +# Gestion des dépôts (répertoire de surveillance) et des abonnements + +## Abonnement à un traitement + +Un abonnement permet à un utilisateur d'exécuter à fréquence régulière un projet. + +Un auteur peut décider de rendre un traitement disponible pour abonnement ou pas. +Dans le menu Mon travail, onglet Abonnements, un utilisateur peut choisir de s'abonner à un projet, à la fréquence de son choix, et peut choisir d'être notifié par mail du bon déroulement ou pas du traitement. Il peut également saisir l'adresse mail à laquelle envoyer la copie du mail. + +## Surveillance des dépôts + +Un dépôt est un répertoire de surveillance. +Une surveillance correspond à un abonnement à un traitement en ajoutant un nouveau paramètre qu’est la disponibilité d’un fichier ou d’un répertoire dans un dépôt préalablement défini par l’administrateur. +Ainsi, si un projet est rendu disponible pour surveillance, alors ce dernier est automatiquement exécuté (selon la période d’abonnement définie) dès lors que GTF détecte la présence d’un fichier dans le dépôt. + +L’onglet Dépôt permet à l’administrateur de consulter la liste des dépôts, d’en créer et d’en supprimer. +Il crée des nouveaux dépôts en spécifiant le chemin du répertoire à surveiller **qu’il aura préalablement créé sur le serveur**. + +La stratégie d’attribution de dépôt se fait à l’échelle du groupe d’utilisateurs. Un utilisateur en ayant-droit, peut alors associer à un traitement une surveillance dans un dépôt. GTF scrute la présence de fichiers dans le dépôt. Si un fichier est présent, alors le traitement est lancé en exploitant le fichier. + +Le bouton ‘Ajouter un dépôt’ permet d’accéder au formulaire de création de dépôt en spécifiant le chemin du répertoire à surveiller, un alias et les groupes y ayant accès. Il clique ensuite sur ‘Créer’ pour valider sa création et rendre le dépôt disponible pour les groupes en ayant droit. + + + +*Formulaire de création de dépôt.* + + GTF personnalise automatiquement le dépôt en fonction du compte utilisateur de connexion en suffixant le dépôt avec la variable <code> $user</code>. L’utilisateur final ne voit ainsi que son propre répertoire dans le dépôt. Au préalable, l’administrateur doit avoir créé dans chaque dépôt, un répertoire par utilisateur (des groupes ayant accès à chaque dépôt). Le nom du répertoire doit être parfaitement identique au compte de connexion qu’il s’agisse d’un utilisateur « PostgreSQL » ou importé d’Active Directory. diff --git a/utilisation/publication_traitements/gestion_periodes.md b/utilisation/publication_traitements/gestion_periodes.md new file mode 100644 index 0000000000000000000000000000000000000000..915189c37430ef539188b63efdb9ec8f947df4cb --- /dev/null +++ b/utilisation/publication_traitements/gestion_periodes.md @@ -0,0 +1,17 @@ +# Gestion des périodes + +Un abonnement permet de s’inscrire à un traitement répété au cours du temps selon une fréquence choisie. +Dans l’onglet Périodes, l’administrateur peut accéder au formulaire de définition des périodes d’abonnement. Le bouton ‘Ajouter période’ permet à l’administrateur de définir une nouvelle période d’abonnement en lui affectant un libellé puis en y insérant le code correspondant. + + +  Sur Linux, l'administrateur de GTF doit mettre à jour les périodes, définies par défaut, pour que les abonnements s'inscrivent dans le fichier contrab du serveur et qu'elles puissent, de la sorte, être exploitées par les abonnements et surveillances. + +Il est ensuite possible de tester le bon déroulement de l’ajout de Période en cliquant sur le bouton ‘Test’. Le bouton ‘Créer’ finalise le processus de création d’une période. + +Pycron est le composant assurant l’exécution des tâches à heures fixes. L’instruction à saisir doit respecter la syntaxe de la fonction contrab. Pour plus d’information sur le programme crontab et la syntaxe à respecter, consulter le site : [http://fr.wikipedia.org/wiki/Crontab](http://fr.wikipedia.org/wiki/Crontab) + + + + + + diff --git a/utilisation/publication_traitements/index.rst b/utilisation/publication_traitements/index.rst new file mode 100644 index 0000000000000000000000000000000000000000..c2eed4ce49f10f4db72dabd491f2f7b4d1a820bd --- /dev/null +++ b/utilisation/publication_traitements/index.rst @@ -0,0 +1,16 @@ +========================== +Publication de traitements +========================== + +Un utilisateur avec des droits d'auteur peut publier un traitement. Après avoir généré un projet dans FME, il crée un traitement dans GTF puis l'associe au projet. +Le mode Publication comporte l’ensemble des formulaires permettant la création et le paramétrage des traitements GTF. + +.. toctree:: + :maxdepth: 2 + + ajout_projet_fme/index.rst + gestion_categories.md + gestion_depots.md + gestion_periodes.md + modeles_email.md + diff --git a/utilisation/publication_traitements/modeles_email.md b/utilisation/publication_traitements/modeles_email.md new file mode 100644 index 0000000000000000000000000000000000000000..2fca62784a40a68a0b0029d8fbce0aa91d8b8b63 --- /dev/null +++ b/utilisation/publication_traitements/modeles_email.md @@ -0,0 +1,132 @@ +# Modèles d'E-mail + +L'onglet Modèles-email du mode Publication permet la création de modèles d'e-mails envoyés après exécution d'un traitement. Via cette onglet, l'administrateur (ou l'auteur) a la possibilité de personnaliser un e-mail, en définissant la ou les personnes destinataires, les circonstances d'envoi de ce dernier ainsi que son contenu. Il choisit ensuite pour chaque modèle, la définition à utiliser. + +Chaque traitement est associé à un modèle d'e-mail. + +L'onglet Informations générales permet de créer un nouveau modèle de mail, en le nommant et en définissant son contexte à GTF et de définir le type de définition de ce dernier : + +## Définition simple + +L'administrateur exploite les balises disponibles pour personnaliser le corps du mail. + +<div class="wy-table-responsive"> + +<table class="docutils" border="1"><colgroup><col width="20%"> <col width="20%"> <col width="19%"> <col width="19%"> <col width="22%"></colgroup> + +<thead valign="bottom"> + +<tr class="row-odd"> + <th class="head">Nom de la balise</th> + <th class="head">Descriptif</th> + <th class="head">Code correspondant</th> +</tr> + +</thead> + +<tbody valign="top"> + <tr class="row-even"> + <td>[order.order_id]</td> + <td>Identifiant de la demande de traitement</td> + <td>$properties['order.order_id']['value'] = $this->aObjects["oOrder"]->aFields['order_id'];</td> + </tr> + + <tr class="row-odd"> + <td>[order.order_date]</td> + <td>Date et heure de la demande de traitement</td> + <td>$properties['order.order_date']['value'] = $this->aObjects["oOrder"]->aFields['order_date'];</td> + </tr> + + <tr class="row-even"> + <td>[order.execution_date]</td> + <td>Date et heure de fin de traitement</td> + <td>$properties['order.execution_date']['value'] = $this->aObjects["oOrder"]->aFields['order_execution_date'];</td> + </tr> + + <tr class="row-odd"> + <td>[order.result_url]</td> + <td>Adresse de téléchargement du résultat du traitement</td> + <td>$properties['order.result_url']['value'] = $this->aObjects["oOrder"]->aFields['result_url'];</td> + </tr> + + <tr class="row-even"> + <td>[order.log_url]</td> + <td>Adresse du log du traitement </td> + <td>$properties['order.order_log']['value'] = $this->aObjects["oOrder"]->aFields[log_url'];</td> + </tr> + + <tr class="row-odd"> + <td>[order.length_sec]</td> + <td>Durée du traitement en secondes</td> + <td>$properties['order.length_sec']['value'] = $this->aObjects["oOrder"]->aFields[length_sec'];</td> + </tr> + + <tr class="row-even"> + <td> [order.email_notifications] </td> + <td>Adresse Email du destinataire en copie de mail</td> + <td>$properties['user.email']['value'] = $this->aObjects["oOrder"]->getUser()->aFields['email'];</td> + </tr> + + <tr class="row-odd"> + <td>[gtf_engine. Name] </td> + <td>Nom du moteur GTF</td> + <td>$this->aObjects["oOrder"]->getGtfEngine()->aFields['name'];</td> + </tr> + + <tr class="row-even"> + <td> [fme_engine.name] </td> + <td>Nom du moteur FME utilisé </td> + <td>$this->aObjects["oOrder"]->getFmeEngine()->aFields['name'];</td> + </tr> + + <tr class="row-odd"> + <td>[order.user.name]</td> + <td> Nom du demandeur de traitement</td> + <td>$properties['user.name']['value'] = $this->aObjects["oOrder"]->getUser()->aFields['name'];</td> + </tr> + + <tr class="row-even"> + <td> [order.user_email] </td> + <td>Adresse mail du demandeur de traitement </td> + <td>$properties['user.email']['value'] = $this->aObjects["oOrder"]->getUser()->aFields['email'];</td> + </tr> + + <tr class="row-odd"> + <td>[order.user.login]</td> + <td> Compte de connexion du demandeur</td> + <td>$properties['user.login']['value'] = $this->aObjects["oOrder"]->getUser()->aFields['login'];</td> + </tr> + + <tr class="row-even"> + <td>[order.worksapce.category.name]</td> + <td> Catégorie du traitement</td> + <td>$properties['catgory.name']['value'] = $this->aObjects["oOrder"]->getWorkspace()->getCategory()->aFields['email'];</td> + </tr> + + <tr class="row-odd"> + <td>[order.workspace.name]</td> + <td> Nom du traitement</td> + <td>$properties['order.workspace.name']['value'] = $this->aObjects["oOrder"]->getWorkspace()->aFields['name'];</td> + </tr> + + <tr class="row-odd"> + <td>[worksapce.fmw_file]</td> + <td> Nom du projet FME</td> + <td>$properties['order.workspace.fmw_file']['value'] = $this->aObjects["oOrder"]->getWorkspace()->aFields['fmw_file'];</td> + </tr> + +</tbody> +</table> + +</div> + + + *La balise [order.email_notifications] doit être insérée dans les champs CC et CCi de sorte à ce qu'une notification de traitement soit envoyée aux adresses mail définies dans le formulaire de demande de traitement dans le champ 'Envoyer une copie de l'e-mail à' :* + + + + *Lorsque plusieurs destinataires doivent être en copie du mail de notification, séparer les adresses mail par un retour charriot.* + +## Définition avancée + +L'administrateur saisit directement le code du mail. Il peut, pour cela, utiliser le code généré via l'édition simple en cliquant sur le bouton Générer le code à partir de l'édition simple. diff --git a/utilisation/publication_traitements/modeles_emails.rst b/utilisation/publication_traitements/modeles_emails.rst new file mode 100644 index 0000000000000000000000000000000000000000..329a582997f430f245e282c5b739a03aa44490f6 --- /dev/null +++ b/utilisation/publication_traitements/modeles_emails.rst @@ -0,0 +1,46 @@ +===================================================== +Modèles d'emails +===================================================== + +L'onglet Modèles-email du mode Publication permet la création de modèles d'e- mail envoyé après exécution d'un traitement. Via cette onglet, l'administrateur (ou l'auteur) a la possibilité de personnaliser un e-mail, en définissant la ou les personnes destinataires, les circonstances d'envoi de ce dernier ainsi que son contenu. Il choisit ensuite pour chaque modèle, la définition à utiliser. + +Chaque traitement est associé à un modèle d'e-mail. + +L'onglet Informations générales permet de créer un nouveau modèle de mail, en le nommant et en définissant son contexte à GTF et de définir le type de définition de ce dernier : + +Définition simple +================= + +L’administrateur exploite les balises disponibles pour personnaliser le corps du mail. + +.. csv-table:: + + Nom de la balise, descriptif, code correspondant + [order.order_id], Identifiant de la demande de traitement , $properties['order.order_id']['value'] = $this->aObjects["oOrder"]->aFields['order_id']; + [order.order_date], Date et heure de la demande de traitement, $properties['order.order_date']['value'] = $this->aObjects["oOrder"]->aFields['order_date']; + [order.execution_date], Date et heure de fin de traitement, $properties['order.execution_date']['value'] = $this->aObjects["oOrder"]->aFields['order_execution_date']; + [order.result_url], Adresse de téléchargement du résultat du traitement, $properties['order.result_url']['value'] = $this->aObjects["oOrder"]->aFields['result_url']; + [order.log_url], Adresse du log du traitement, $properties['order.order_log']['value'] = $this->aObjects["oOrder"]->aFields[log_url']; + [order.length_sec], Durée du traitement en secondes, $properties['order.length_sec']['value'] = $this->aObjects["oOrder"]->aFields[length_sec']; + [order.email_notifications], Adresse Email du destinataire en copie de mail, $properties['user.email']['value'] = $this->aObjects["oOrder"]->getUser()->aFields['email']; + [gtf_engine. Name], Nom du moteur GTF, $this->aObjects["oOrder"]->getGtfEngine()->aFields['name']; + [fme_engine.name], Nom du moteur FME utilisé, $this->aObjects["oOrder"]->getFmeEngine()->aFields['name']; + [order.user.name], Nom du demandeur de traitement, $properties['user.name']['value'] = $this->aObjects["oOrder"]->getUser()->aFields['name']; + [order.user_email], Adresse mail du demandeur de traitement, $properties['user.email']['value'] = $this->aObjects["oOrder"]->getUser()->aFields['email']; + [order.user.login], Compte de connexion du demandeur, $properties['user.login']['value'] = $this->aObjects["oOrder"]->getUser()->aFields['login']; + [order.worksapce.category.name], Catégorie du traitement, $properties['catgory.name']['value'] = $this->aObjects["oOrder"]->getWorkspace()->getCategory()->aFields['email']; + [order.workspace.name], Nom du traitement, $properties['order.workspace.name']['value'] = $this->aObjects["oOrder"]->getWorkspace()->aFields['name']; + [worksapce.fmw_file], Nom du projet FME, $properties['order.workspace.fmw_file']['value'] = $this->aObjects["oOrder"]->getWorkspace()->aFields['fmw_file']; + +.. image:: ../images/attention.png +La balise [order.email_notifications] doit être insérée dans les champs CC et CCi de sorte à ce qu'une notification de traitement soit envoyée aux adresses mail définies dans le formulaire de demande de traitement dans le champ 'Envoyer une copie de l'e-mail à' : + +.. image:: ../images/destinatairecc.png + +.. image:: ../images/attention.png +Lorsque plusieurs destinataires doivent être en copie du mail de notification, séparer les adresses mail par un retour charriot. + +Définition avancée +================== + +L’administrateur saisit directement le code du mail. Il peut, pour cela, utiliser le code généré via l’édition simple en cliquant sur le bouton Générer le code à partir de l’édition simple.