Un cas d’usage est celui d’une famille qui souhaite \u00e9diter un petit journal destin\u00e9 \u00e0 des personnes peu connect\u00e9es sur internet et pour qui le support papier reste un m\u00e9dia pr\u00e9f\u00e9rable. Il peut s’agir aussi d’un document rassemblant des reportages sportifs r\u00e9alis\u00e9s par les membres d’une association. Par extension, les principes expos\u00e9s peuvent \u00eatre utilis\u00e9s par tout utilisateur Facebook pour la constitution d’un magazine imprim\u00e9 \u00e0 partir de ses publications, ou tout simplement pour exporter son contenu vers un syst\u00e8me externe. <\/p>\n\n\n\n
Approche<\/h3>\n\n\n\n
Le proc\u00e9d\u00e9 qui a \u00e9t\u00e9 choisi est le suivant:<\/p>\n\n\n\n
Extraire les publications d’un groupe de fa\u00e7on programmatique en s’appuyant sur l’API Graph de Facebook<\/a> afin de r\u00e9cup\u00e9rer le texte, les images associ\u00e9es ainsi que l’auteur et la date.<\/p>\n\n\n\n Enregistrer les informations dans une database de fa\u00e7on \u00e0 pouvoir effectuer un post-traitement (filtrage, corrections orthographiques, mise \u00e0 l’\u00e9cart de certaines publications selon des crit\u00e8res)<\/p>\n\n\n\n Retraiter \u00e9ventuellement les images de type paysage afin d’obtenir un ratio diff\u00e9rent de celui utilis\u00e9 par Facebook qui est de 1,3 environ.<\/p>\n\n\n\n Produire un document au format XML ou JSON et leur appliquer un gabarit de mise en page \u00e0 l’aide d’un moteur d’\u00e9dition. <\/p>\n\n\n\n Les appels REST vers l’api Graph sont lanc\u00e9es depuis du code PL\/SQL. C’est donc une proc\u00e9dure stock\u00e9e dans la database qui coordonne les appels n\u00e9cessaires pour rassembler les articles contenant la description ainsi que le lien vers l’image associ\u00e9e.<\/p>\n\n\n\n Dans le sch\u00e9ma d’architecture ci-dessus, les services sont identifi\u00e9s par la couleur bleue. On constate qu’il y en a trois. Dans mon cas, j’ai group\u00e9 les services de traitement d’image et Apache FOP sur une m\u00eame instance cloud de type compute <\/em>tandis que l’interface de pilotage (Application Oracle APEX) fonctionne sur une autre instance cloud. Il est bien sur possible de tout faire fonctionner sur un simple PC en local.<\/p>\n\n\n\n Pour m\u00e9moire: Cr\u00e9er un groupe Facebook ou en utiliser un d\u00e9j\u00e0 existant, indiquer une visibilit\u00e9 de type \u00ab\u00a0priv\u00e9\u00a0\u00bb et enr\u00f4ler les membres. Seul un administrateur de groupe peut inviter d’autres membres, sous r\u00e9serve qu’il ait d\u00e9j\u00e0 une connexion individuelle avec ceux-ci. Il est cependant possible de constituer un groupe avec des membres qui ne poss\u00e8dent pas de connexion entre eux. <\/p>\n\n\n\n Cr\u00e9er une nouvelle application Facebook \u00e0 partir de la console de d\u00e9veloppement<\/a>. Dans le cadre du prototype, l’application a \u00e9t\u00e9 gard\u00e9e dans un mode \u00ab\u00a0en cours de d\u00e9veloppement\u00a0\u00bb et n’a pas \u00e9t\u00e9 publi\u00e9e.<\/p>\n\n\n\n Tester le bon fonctionnement des APIs en se connectant \u00e0 la console de d\u00e9veloppement API Explorer<\/a> (API Graph). Tout appel doit \u00eatre accompagn\u00e9 d’un jeton d\u2019acc\u00e8s (Access Token<\/em>) obtenu apr\u00e8s identification puis consentement quant aux privil\u00e8ges accord\u00e9s \u00e0 l’application. cf annexes<\/a><\/p>\n\n\n\n Tant que l’application n’a pas fait l’objet d’une demande de certification aupr\u00e8s de Facebook, l’appel \u00e0 certaines m\u00e9thodes n’est pas possible. C’est le cas en particulier de la r\u00e9cup\u00e9ration du nom de l’auteur d’un article. Cela est \u00e9videmment tr\u00e8s g\u00eanant pour la fabrication de notre magazine, puisque il s’agit d’une information \u00e9ditoriale essentielle. Pour contourner cette limitation et puisque il n’\u00e9tait pas dans mon intention d’aller jusqu’au bout du processus de d\u00e9claration de l’application, j’ai demand\u00e9 aux contributeurs du groupe d’ajouter syst\u00e9matiquement leur pr\u00e9nom sur la derni\u00e8re ligne de l’article. Les pr\u00e9noms et les photos de profil sont g\u00e9r\u00e9s manuellement dans une table.<\/p>\n\n\n\n Cr\u00e9er une application Oracle APEX \u00e0 partir d’une instance APEX existante (depuis une instance Oracle Free Tiers<\/em> par exemple, qui est gratuite). L’instance https:\/\/apex.oracle.com risque d\u2019\u00eatre inadapt\u00e9e car il y a un quota d’appels de services web qui est assez bas. Chaque extraction g\u00e9n\u00e8re un nombre d’appels repr\u00e9sentant le double environ du nombre d’articles<\/p>\n\n\n\n Cette contrainte est li\u00e9e au choix de pouvoir disposer deux articles sur une page A4. Il s’agit d’un choix de mise en page purement arbitraire. (cf plus loin sur la partie Design et mise en page<\/a>) On utilise Apache FOP<\/a>. Il faut t\u00e9l\u00e9charger le logiciel sous Windows ou Linux. Il est possible de le faire fonctionner en mode commande, standalone<\/em>. <\/p>\n\n\n\n Il est important de bien param\u00e9trer FOP afin de disposer des polices de caract\u00e8res souhait\u00e9es. Pour cela, on param\u00e8tre le fichier de configuration avec la directive auto-detect (fichier de configuration fop.xconf) et on copie les polices de caract\u00e8res sur le serveur Linux, si n\u00e9cessaire. <\/p>\n\n\n\n Une tache importante de r\u00e9alisation a consist\u00e9 \u00e0 mettre au point le gabarit de mise en page automatique. Ce template<\/em> se pr\u00e9sente sous la forme d’un fichier contenant des d\u00e9clarations XSLT de formatage. Les donn\u00e9es extraites depuis Facebook sont pr\u00e9sent\u00e9es en format XML \u00e0 Apache FOP qui les fusionne avec le template XSL.<\/p>\n\n\n\n Je me suis largement inspir\u00e9 du design<\/a> utilis\u00e9 par le service payant Famileo<\/a> et j’ai utilis\u00e9 les m\u00eames principes de formatage. Il faut faire un choix sur le format de papier et cette d\u00e9cision entra\u00eene un type de reliure correspondant. Le plus simple est de partir sur du format A4 \u00ab\u00a0portrait\u00a0\u00bb et d’imprimer en recto-verso. Les feuilles sont ensuite agraf\u00e9es en cinq points sur le bord gauche et un ruban adh\u00e9sif opaque (blanc ou fantaisie) et plac\u00e9 par dessus les agrafes.<\/p>\n\n\n\n L’autre solution consiste \u00e0 partir sur du format A3 \u00ab\u00a0Paysage\u00a0\u00bb en mode recto\/verso et d’imprimer sur deux colonnes. La reliure sera effectu\u00e9e par deux points de couture au milieu des deux colonnes. L’avantage est de procurer de meilleures sensation \u00e0 la manipulation puisque les pages A3 seront pli\u00e9es et le magazine pourra se maintenir en position ouverte sur une table. Le probl\u00e8me \u00e0 r\u00e9soudre concerne le \u00ab\u00a0chemin de fer\u00a0\u00bb car les pages devront \u00eatre assembl\u00e9es dans un ordre qui n’est pas s\u00e9quentiel:<\/p>\n\n\n\n Par exemple la premi\u00e8re feuille physique comprend 4 pages:<\/p>\n\n\n\n Je n’ai pas encore \u00e9tudi\u00e9 cette option A3.<\/p>\n\n\n\n La r\u00e9alisation automatis\u00e9e d’un journal aboutit \u00e0 un r\u00e9sultat qui peut \u00eatre consid\u00e9r\u00e9 comme correct mais qui n’est peut-\u00eatre pas aussi attractif que lorsque la composition est r\u00e9alis\u00e9e manuellement. <\/p>\n\n\n\n L’avantage d\u2019utiliser Facebook est de pouvoir constituer ais\u00e9ment un pool de participants, ind\u00e9pendamment de la tranche d’age car FB est tr\u00e8s populaire \u00e0 la fois chez les jeunes et moins jeunes. Il n’est donc pas n\u00e9cessaire de r\u00e9aliser un r\u00e9seau social priv\u00e9 avec les inconv\u00e9nients de changement d’habitude, confidentialit\u00e9, perte de mot de passe que cela aurait pu entra\u00eener.<\/p>\n\n\n\n La destination des publications Facebook sur un support imprim\u00e9 impose une discipline dans la r\u00e9daction des articles et notamment une exigence quant \u00e0 la quantit\u00e9 minimum du texte associ\u00e9 \u00e0 l’image. Or, sur FB, les usages donnent une plus grande importance \u00e0 l’image qu’au texte. Cela implique donc une coordination \u00e9ditoriale pour inciter les participants \u00e0 contribuer diff\u00e9remment de leurs habitudes.<\/p>\n\n\n\n D’un point de vue budget, il faut :<\/p>\n\n\n\n Par comparaison, l’abonnement mensuel \u00e0 Famileo et de 5,90\u20ac\/mois par destinataire, ce qui en faite une solution comp\u00e9titive s’il n’y a qu’un seul destinataire.<\/p>\n\n\n\n Sera mis \u00e0 disposition plus tard sur Github. <\/p>\n\n\n\n Remarque: si la publication Facebook est issue d’un partage depuis un espace personnel ou bien une page ou un autre groupe, il faut effectuer un appel suppl\u00e9mentaire car l’\u00e9l\u00e9ment est consid\u00e9r\u00e9 comme une story. cf subattachments <\/em><\/p>\n\n\n <\/p>\n\n\n <\/p>\n","protected":false},"excerpt":{"rendered":" Objectif L’objectif est de produire, \u00e0 partir des articles d’un groupe Facebook, un magazine PDF destin\u00e9 \u00e0 \u00eatre imprim\u00e9 . Un cas d’usage est…<\/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-4702","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\/4702","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=4702"}],"version-history":[{"count":36,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/posts\/4702\/revisions"}],"predecessor-version":[{"id":4776,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/posts\/4702\/revisions\/4776"}],"wp:attachment":[{"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/media?parent=4702"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/categories?post=4702"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/tags?post=4702"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/gpmfactory.com\/index.php\/wp-json\/wp\/v2\/ppma_author?post=4702"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Principe et Architecture<\/h3>\n\n\n\n
Architecture simplifi\u00e9e<\/h4>\n\n\n\n
![\"\"](\"http:\/\/gpmfactory.com\/wp-content\/uploads\/2020\/02\/Image2-1024x546.png\")
<\/figure>\n\n\n\nR\u00e9alisation<\/h3>\n\n\n\n
Cr\u00e9er un groupe Facebook<\/h4>\n\n\n\n
Cr\u00e9er une application Facebook<\/h4>\n\n\n\n
![\"\"](\"http:\/\/gpmfactory.com\/wp-content\/uploads\/2020\/02\/image-7.png\")
<\/figure><\/div>\n\n\n\nCr\u00e9er une application de pilotage<\/h4>\n\n\n\n
Appliquer un traitement d’image<\/h4>\n\n\n\n
Les images de type paysage doivent \u00eatre retrait\u00e9es afin d’obtenir un ratio 1,7 au lieu de 1,3. Pour cela on a recourt \u00e0 un traitement de recadrage pour aplatir l’image tout en gardant les proportions d’origine. Le choix technique est d’installer un service \u00e9crit en php avec le module php_imagemagick<\/a>.
Il aurait \u00e9t\u00e9 possible d’utiliser les packages Oracle ORD_IMAGE, mais ceux-ci n’\u00e9taient pas disponibles dans l’instance Oracle Free Tiers<\/em> que j’ai utilis\u00e9e. <\/p>\n\n\n\nFabriquer le document PDF<\/h4>\n\n\n\n
<fonts>\n... \n <directory>C:\\Windows\\Fonts<\/directory>\n\n <!-- auto-detect fonts -->\n <auto-detect\/>\n<\/fonts><\/code><\/pre>\n\n\n\nDesign et mise en page<\/h3>\n\n\n\n
Leur choix de mise en page consiste \u00e0 assembler deux articles sur une m\u00eame page A4. Si l’image est verticale, le texte est plac\u00e9 \u00e0 droite, sinon au-dessous dans le cas d’une image horizontale. La quantit\u00e9 de texte est, d’apr\u00e8s leur FAQ, arbitrairement limit\u00e9e \u00e0 300 caract\u00e8res.
Une des cons\u00e9quences est que le rapport de forme (Largeur divis\u00e9e par hauteur) pour les images horizontales est de l’ordre de 1,7 au minimum alors qu’il est de 1,3, voire moins pour les images enregistr\u00e9es dans Facebook. Cela explique que dans ce cas, il faut rogner les images en hauteur (cela fait l’objet du traitement de recadrage qui est effectu\u00e9 \u00e0 la vol\u00e9e par le module PHP).
Pour le texte, j’ai fix\u00e9 une limite plus haute que 300, quitte \u00e0 r\u00e9duire dans une certaine limite la taille des images selon l’article.<\/p>\n\n\n\n![\"\"](\"http:\/\/gpmfactory.com\/wp-content\/uploads\/2020\/02\/image-8.png\")
Fa\u00e7onnage du magazine imprim\u00e9<\/h3>\n\n\n\n
Conclusions et enseignements<\/h3>\n\n\n\n
environ 50 c \/feuille, soit 4 \u20ac pour un magazine de 8 pages<\/li>Annexes<\/h3>\n\n\n\n
Mat\u00e9riel, Code, templates<\/h4>\n\n\n\n
Manipulations simples sur l’API Graph<\/h4>\n\n\n\n
\/me\/groups<\/li>
\/<group_id>\/feed?since=<date_depart au format YYYY-MM-DD><\/li>
\/<feed_id\/attachments<\/li><\/ul>\n\n\n\n