Approches<\/h3>\n\n\n\n
La premi\u00e8re approche triviale consiste \u00e0 importer la liste des communes<\/a> depuis un site officiel puis \u00e0 la charger dans une table. <\/p>\n\n\n\n La deuxi\u00e8me approche a recours \u00e0 un web service REST. Le site https:\/\/geo.api.gouv.fr\/<\/a> fournit une API<\/a> en open data qui r\u00e9pond au besoin. Le probl\u00e8me est que la liste des codes postaux pour une commune est fournie sous la forme d’un tableau (nested array<\/em>). Or dans la version 19.2, un web module<\/em> ne prend pas en compte les nested array<\/em>. Il faudrait par exemple un proxy pour aplatir<\/em> la structure json.<\/p>\n\n\n\n La poste<\/a>, \u00e0 travers son portail datanova, fournit \u00e9galement une API<\/a> en open data. le r\u00e9sultat obtenu est exploitable avec APEX et c’est ce web service que nous allons utiliser dans la suite.<\/p>\n\n\n\n Voici un exemple d’appel avec, comme crit\u00e8re de recherche, les noms de communes qui commencent par \u00ab\u00a0toul\u00a0\u00bb<\/p>\n\n\n\n Pour information, il existe un autre site https:\/\/vicopo.selfbuild.fr<\/em> qui fournit une API ne pr\u00e9sentant pas l’inconv\u00e9nient cit\u00e9 dans le site pr\u00e9c\u00e9dent. Sa forme est tr\u00e8s simple: https:\/\/vicopo.selfbuild.fr\/cherche\/{critere}<\/em><\/p>\n\n\n\n C’est la version d’APEX 19.2 qui est utilis\u00e9e dans ce qui suit. C’est \u00e0 partir de celle-ci que l’on peut baser une LOV sur un web module.<\/p>\n\n\n\n On cr\u00e9e dans Oracle APEX un web module bas\u00e9 sur le endpoint https:\/\/datanova.laposte.fr\/api\/records\/1.0\/search\/ et on ajoute deux param\u00e8trex de type Query String variable<\/em> :<\/p>\n\n\n\n Important: On pr\u00e9cise au niveau du second param\u00e8tre (q<\/strong>) que sa valeur sera pr\u00e9f\u00e9rentiellement utilis\u00e9e pour une recherche. (il s’agit d’une nouveaut\u00e9 dans la version 19.2): Use for Row Search<\/em><\/strong> <\/p>\n\n\n\n L’impact de ce r\u00e9glage est que APEX remplira automatiquement ce param\u00e8tre selon le contexte de la recherche: Si le web module est utilis\u00e9 pour un report, alors ce qui est saisi dans la zone Search <\/em>alimentera le param\u00e8tre q<\/strong>. <\/p>\n\n\n\n <\/p>\n\n\n\n On indique que la source de donn\u00e9es de la nouvelle liste de valeurs est le web module cr\u00e9\u00e9 pr\u00e9c\u00e9demment.<\/p>\n\n\n\n A partir de la version 19.2, il est possible d’afficher plusieurs colonnes dans une popup LOV et on peut \u00e9galement injecter ces valeurs de colonnes dans plusieurs champs simultan\u00e9ment. Nous mettons \u00e0 profit cette fonctionnalit\u00e9 pour alimenter \u00e0 la fois le nom de la ville et la valeur du code postal. L’alimentation du code postal se d\u00e9clare en remplissant la propri\u00e9t\u00e9 \u00ab\u00a0champs suppl\u00e9mentaire\u00a0\u00bb sous la forme de couples s\u00e9par\u00e9s par un point-virgule: <\/p>\n\n\n\n <\/p>\n\n\n\n Si la LOV est de type Popup Lov<\/em>, Il faut activer l’option Entr\u00e9e manuelle<\/em>. La cons\u00e9quence que la popup se comportera comme un combo box<\/em>. Sans cela, la lecture d’un enregistrement existant tombe en erreur. C’est dommage car cela oblige, d’un point de vue ergonomique, \u00e0 cliquer sur la fl\u00e8che vers le bas pour faire appara\u00eetre la liste de valeurs.<\/p>\n\n\n\n Sur une instance APEX install\u00e9e manuellement, il faut que le certificat du site appel\u00e9 en REST soit enregistr\u00e9 dans le wallet <\/em>de la database. Dans le cas contraire, on re\u00e7oit une erreur de ce type:<\/p>\n\n\n\n Remarque: Lors de la r\u00e9cup\u00e9ration du certificat, il a fallu que je choisisse la version du certificat encod\u00e9 en Base64, sinon cela ne fonctionnait pas sur une database Oracle 18c express.<\/p>\n\n\n\n Il est possible de r\u00e9cup\u00e9rer le certificat directement sur le serveur avec une commande openssl, ce qui \u00e9vite le recours \u00e0 un navigateur. Cependant, je n’ai pas pu obtenir un format adapt\u00e9 au wallet Oracle. Peut-\u00eatre s’agit il du format Base64 non respect\u00e9 ?<\/p>\n\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" Objectif L’objectif est de disposer d’une liste de valeurs des codes postaux\/Communes dans un formulaire afin de contr\u00f4ler la saisie du nom de la…<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"ppma_author":[150],"class_list":["post-4716","post","type-post","status-publish","format-standard","hentry","category-non-classe"],"authors":[{"term_id":150,"user_id":1,"is_guest":0,"slug":"admin8700","display_name":"Patrick","avatar_url":"https:\/\/secure.gravatar.com\/avatar\/209d5ed69b74d288390621ab4c1d3773?s=96&d=mm&r=g","0":null,"1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":""}],"_links":{"self":[{"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/posts\/4716","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/comments?post=4716"}],"version-history":[{"count":20,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/posts\/4716\/revisions"}],"predecessor-version":[{"id":4745,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/posts\/4716\/revisions\/4745"}],"wp:attachment":[{"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/media?parent=4716"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/categories?post=4716"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/tags?post=4716"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/ppma_author?post=4716"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
L\u2019int\u00e9r\u00eat est d’\u00e9viter la maintenance suppl\u00e9mentaire d’un objet dans la database. Nous allons utiliser cette m\u00e9thode.<\/p>\n\n\n\nhttps:\/\/datanova.laposte.fr\/api\/records\/1.0\/search\/?dataset=laposte_hexasmal&q=toul<\/pre>\n\n\n\n
Impl\u00e9mentation<\/h3>\n\n\n\n
Cr\u00e9ation d’un web module <\/h4>\n\n\n\n
Si le web module est utilis\u00e9 pour une LOV, alors ce qui est saisi dans le champs associ\u00e9 \u00e0 cette LOV sera utilis\u00e9 comme valeur de param\u00e8tre q<\/strong>. <\/p>\n\n\n\n![\"\"](\"http:\/\/gpmfactory.com\/wp-content\/uploads\/2020\/02\/image-4.png\")
<\/figure><\/div>\n\n\n\nCr\u00e9ation d’une liste de valeurs multi-colonnes<\/h4>\n\n\n\n
Bien v\u00e9rifier que les colonnes soient visibles dans le tableau des colonnes retourn\u00e9es par la LOV. <\/p>\n\n\n\nPrise en compte dans un formulaire<\/h4>\n\n\n\n
\"colonne LOV: champs; colonne LOV: champs; ... \"<\/pre>\n\n\n\n
Limitations<\/h4>\n\n\n\n
![\"\"](\"http:\/\/gpmfactory.com\/wp-content\/uploads\/2020\/02\/image-1.png\")
<\/figure>\n\n\n\nRemarque sur les certificats<\/h4>\n\n\n\n
![\"\"](\"http:\/\/gpmfactory.com\/wp-content\/uploads\/2020\/02\/image-2.png\")
<\/figure>\n\n\n\nAnnexes<\/h2>\n\n\n\n
openssl x509 -in cert.pem -text -noout<\/pre>\n\n\n\n