Dans l\u2019article pr\u00e9c\u00e9dent, nous avons vu comment r\u00e9cup\u00e9rer les valeurs saisies par l\u2019utilisateur<\/strong> depuis une interface (champ texte, liste d\u00e9roulante, case \u00e0 cocher\u2026).<\/p>\n\n\n\n

Dans cet article, nous passons \u00e0 l\u2019\u00e9tape suivante : donner du sens \u00e0 ces valeurs<\/strong>.
C\u2019est ici qu\u2019intervient la logique m\u00e9tier<\/strong> du plugin.<\/p>\n\n\n\n

\n\n\n\n
<\/span>1. Qu\u2019appelle-t-on \u201clogique m\u00e9tier\u201d dans un plugin QGIS ?<\/span><\/h3>\n\n\n\n
La logique m\u00e9tier correspond \u00e0 l\u2019ensemble des r\u00e8gles, calculs et d\u00e9cisions<\/strong> qui transforment des valeurs saisies en une action concr\u00e8te.<\/p>\n\n\n\n
Dans un plugin QGIS, cela peut \u00eatre par exemple :<\/p>\n\n\n\n
\n
v\u00e9rifier que des valeurs sont coh\u00e9rentes entre elles,<\/li>\n\n\n\n
calculer un seuil, une distance, un indice,<\/li>\n\n\n\n
d\u00e9cider si une op\u00e9ration doit \u00eatre lanc\u00e9e ou refus\u00e9e,<\/li>\n\n\n\n
transformer une saisie utilisateur en param\u00e8tres exploitables par QGIS.<\/li>\n<\/ul>\n\n\n\n
\n
R\u00e8gle cl\u00e9<\/strong> : la logique m\u00e9tier ne d\u00e9pend pas de l\u2019interface graphique. Elle doit pouvoir \u00eatre comprise ind\u00e9pendamment des boutons et des champs.<\/p>\n<\/blockquote>\n\n\n\n
\n\n\n\n
<\/span>2. S\u00e9parer interface et logique (sans complexit\u00e9 inutile)<\/span><\/h3>\n\n\n\n
Un plugin bien structur\u00e9 repose sur une s\u00e9paration simple :<\/p>\n\n\n\n
\n
Interface<\/strong> : collecte des valeurs (dialog, widgets)<\/li>\n\n\n\n
Logique m\u00e9tier<\/strong> : traitement et validation des valeurs<\/li>\n\n\n\n
Action QGIS<\/strong> : modification des couches, entit\u00e9s ou projets<\/li>\n<\/ul>\n\n\n\n
M\u00eame dans un plugin simple, adopter cette s\u00e9paration \u00e9vite rapidement :<\/p>\n\n\n\n
\n
les bugs difficiles \u00e0 comprendre,<\/li>\n\n\n\n
le code dupliqu\u00e9,<\/li>\n\n\n\n
les interfaces impossibles \u00e0 faire \u00e9voluer.<\/li>\n<\/ul>\n\n\n\n
Concr\u00e8tement, cela signifie que le slot du bouton ne fait presque rien<\/strong> :<\/p>\n\n\n\n
\n
r\u00e9cup\u00e9rer les valeurs,<\/li>\n\n\n\n
appeler une fonction de logique m\u00e9tier,<\/li>\n\n\n\n
r\u00e9agir au r\u00e9sultat.<\/li>\n<\/ol>\n\n\n\n
\n\n\n\n
<\/span>3. Exemple simple de logique m\u00e9tier<\/span><\/h3>\n\n\n\n
Imaginons un plugin avec :<\/p>\n\n\n\n
\n
une valeur num\u00e9rique saisie par l\u2019utilisateur,<\/li>\n\n\n\n
un choix dans une liste d\u00e9roulante.<\/li>\n<\/ul>\n\n\n\n
Avant toute action, on souhaite :<\/p>\n\n\n\n
\n
v\u00e9rifier que la valeur est positive,<\/li>\n\n\n\n
appliquer un coefficient selon le choix utilisateur.<\/li>\n<\/ul>\n\n\n\n
La logique m\u00e9tier peut alors \u00eatre isol\u00e9e dans une fonction d\u00e9di\u00e9e :<\/p>\n\n\n
<\/div>
<\/div>
<\/div><\/div>
<\/p>\n\n\n\n
def calculer_valeur(valeur, mode):\n if valeur <= 0:\n raise ValueError(\"La valeur doit \u00eatre positive\")\n\n if mode == \"simple\":\n return valeur\n elif mode == \"double\":\n return valeur * 2\n else:\n raise ValueError(\"Mode inconnu\")\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n Cette fonction :<\/p>\n\n\n\n \nne conna\u00eet rien de QGIS,<\/li>\n\n\n\n ne conna\u00eet rien de l\u2019interface,<\/li>\n\n\n\n fait une seule chose, clairement d\u00e9finie.<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>4. G\u00e9rer les erreurs intelligemment<\/span><\/h3>\n\n\n\nUne logique m\u00e9tier robuste doit anticiper les erreurs<\/strong>.<\/p>\n\n\n\n Deux approches sont possibles :<\/p>\n\n\n\n \nretourner un r\u00e9sultat + un \u00e9tat (succ\u00e8s \/ \u00e9chec),<\/li>\n\n\n\n lever des exceptions et les intercepter c\u00f4t\u00e9 interface.<\/li>\n<\/ul>\n\n\n\nDans un plugin QGIS, la seconde approche est souvent plus lisible :<\/p>\n\n\n\n \nla logique m\u00e9tier signale un probl\u00e8me,<\/li>\n\n\n\n l\u2019interface d\u00e9cide comment l\u2019afficher \u00e0 l\u2019utilisateur.<\/li>\n<\/ul>\n\n\n\nCela permet par exemple :<\/p>\n\n\n\n \nd\u2019afficher un message clair,<\/li>\n\n\n\n de bloquer l\u2019ex\u00e9cution sans planter le plugin,<\/li>\n\n\n\n de guider l\u2019utilisateur vers une correction.<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>5. Relier la logique m\u00e9tier \u00e0 l\u2019interface<\/span><\/h3>\n\n\n\nDans le slot du bouton, le r\u00f4le est volontairement limit\u00e9 :<\/p>\n\n\n <\/div><\/div><\/div><\/div><\/p>\n\n\n\n def on_run_clicked(self):\n try:\n valeur = self.spinBoxValeur.value()\n mode = self.comboBoxMode.currentText()\n\n resultat = calculer_valeur(valeur, mode)\n\n self.appliquer_resultat(resultat)\n\n except ValueError as e:\n QMessageBox.warning(self, \"Erreur\", str(e))\n<\/code><\/pre>\n\n\n<\/div><\/div>\n\n\n\n Ce code est lisible car :<\/p>\n\n\n\n \nchaque \u00e9tape est explicite,<\/li>\n\n\n\n les responsabilit\u00e9s sont bien s\u00e9par\u00e9es,<\/li>\n\n\n\n la logique m\u00e9tier reste testable ind\u00e9pendamment.<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>Logique m\u00e9tier \u2260 code compliqu\u00e9<\/span><\/h3>\n\n\n\n\nQuand on d\u00e9bute le d\u00e9veloppement de plugins QGIS, on associe souvent la notion de logique m\u00e9tier<\/em> \u00e0 quelque chose de complexe ou r\u00e9serv\u00e9 aux d\u00e9veloppeurs exp\u00e9riment\u00e9s. En r\u00e9alit\u00e9, ce n\u2019est pas la complexit\u00e9 du code qui d\u00e9finit la logique m\u00e9tier, mais l\u2019intention derri\u00e8re le traitement<\/strong>.<\/p>\n\n\n\n Une logique m\u00e9tier simple peut se r\u00e9sumer \u00e0 :<\/p>\n\n\n\n \nv\u00e9rifier qu\u2019une valeur est valide,<\/li>\n\n\n\n appliquer une r\u00e8gle claire,<\/li>\n\n\n\n d\u00e9cider si une action est autoris\u00e9e ou non.<\/li>\n<\/ul>\n\n\n\nQuelques lignes bien structur\u00e9es, lisibles et isol\u00e9es dans une fonction valent mieux qu\u2019un long bloc de code m\u00e9lang\u00e9 \u00e0 l\u2019interface.<\/p>\n\n\n\n Si vous comprenez pourquoi<\/em> vous appliquez une r\u00e8gle, alors vous \u00eates d\u00e9j\u00e0 en train d\u2019\u00e9crire de la logique m\u00e9tier.<\/p>\n<\/blockquote>\n\n\n\n \n\n\n\n<\/span>6. Pourquoi cette \u00e9tape est essentielle<\/span><\/h3>\n\n\n\nC\u2019est \u00e0 ce stade que beaucoup de plugins deviennent :<\/p>\n\n\n\n \nsoit fragiles et difficiles \u00e0 maintenir,<\/li>\n\n\n\n soit au contraire clairs, extensibles et fiables.<\/li>\n<\/ul>\n\n\n\nEn isolant la logique m\u00e9tier :<\/p>\n\n\n\n \nvous pouvez la faire \u00e9voluer sans toucher \u00e0 l\u2019interface,<\/li>\n\n\n\n vous pouvez ajouter des r\u00e8gles sans r\u00e9\u00e9crire le plugin,<\/li>\n\n\n\n vous pr\u00e9parez naturellement les articles suivants.<\/li>\n<\/ul>\n\n\n\n \n\n\n\n<\/span>\u00c0 retenir<\/span><\/h3>\n\n\n\n\nla logique m\u00e9tier donne du sens aux valeurs saisies,<\/li>\n\n\n\n elle doit \u00eatre s\u00e9par\u00e9e de l\u2019interface graphique,<\/li>\n\n\n\n elle doit g\u00e9rer les erreurs explicitement,<\/li>\n\n\n\n c\u2019est le c\u0153ur r\u00e9el de votre plugin.<\/li>\n<\/ul>\n\n\n\nDans le prochain article, nous verrons comment appliquer cette logique m\u00e9tier \u00e0 des couches et des entit\u00e9s QGIS<\/strong>, et passer enfin \u00e0 l\u2019action sur les donn\u00e9es.<\/p>\n\n\n\n \n","protected":false},"excerpt":{"rendered":"R\u00e9cup\u00e9rer des valeurs depuis une interface de plugin QGIS est une \u00e9tape importante, mais ce n\u2019est qu\u2019un d\u00e9but. La vraie question est : que faire de ces valeurs ? Dans cet article, nous allons voir comment…<\/p>\n","protected":false},"author":1,"featured_media":16306,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"sfsi_plus_gutenberg_text_before_share":"","sfsi_plus_gutenberg_show_text_before_share":"","sfsi_plus_gutenberg_icon_type":"","sfsi_plus_gutenberg_icon_alignemt":"","sfsi_plus_gutenburg_max_per_row":"","_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_newsletter_access":"","_jetpack_dont_email_post_to_subs":false,"_jetpack_newsletter_tier_id":0,"_jetpack_memberships_contains_paywalled_content":false,"_jetpack_feature_clip_id":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":"","jetpack_post_was_ever_published":false},"categories":[1945,62],"tags":[4222,4684,4204,4678,4682,4680],"class_list":["post-16313","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-pluigin","category-qgis-2","tag-developpement-plugin-qgis","tag-interface-qgis","tag-plugin-builder-fr","tag-pyqgis","tag-valeurs-saisies-utilisateur","tag-validation-des-donnees-qgis"],"aioseo_notices":[],"aioseo_head":"\n\t\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t\n\t\t