{"id":87990,"date":"2015-06-25T09:12:57","date_gmt":"2015-06-25T08:12:57","guid":{"rendered":"https:\/\/artigianodelsoftware.wordpress.com\/?p=87990"},"modified":"2015-06-25T09:12:57","modified_gmt":"2015-06-25T08:12:57","slug":"user-macro-primo-esempio","status":"publish","type":"post","link":"https:\/\/artigianodelsoftware.it\/blog\/2015\/06\/25\/user-macro-primo-esempio\/","title":{"rendered":"User Macro &#8211; Primo esempio"},"content":{"rendered":"<div class=\"pdfprnt-buttons pdfprnt-buttons-post pdfprnt-top-right\"><a href=\"javascript: imageToPdf()\" class=\"pdfprnt-button pdfprnt-button-pdf\" target=\"_self\"><img src=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/plugins\/pdf-print\/images\/pdf.png\" alt=\"image_pdf\" title=\"Visualizza PDF\" \/><\/a><a href=\"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/posts\/87990?print=print\" class=\"pdfprnt-button pdfprnt-button-print\" target=\"_blank\"><\/a><\/div><blockquote>\n<h1>Hello World<\/h1>\n<\/blockquote>\n<p>In questo post, continuiamo ad esaminare le User Macro. In particolare andremo a vedere quale iter seguire per creare la prima User Macro: <b><i>HELLO WORLD \ud83d\ude42<\/i><\/b><\/p>\n<p><a href=\"http:\/\/www.adknowledge.com\/wp-content\/uploads\/2013\/10\/HelloWorld.jpg\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter\" src=\"http:\/\/www.adknowledge.com\/wp-content\/uploads\/2013\/10\/HelloWorld.jpg\" alt=\"\" width=\"730\" height=\"257\" \/><\/a><\/p>\n<blockquote>\n<h1>Premessa<\/h1>\n<\/blockquote>\n<p>Le\u00a0<em><strong>User Macro<\/strong><\/em> sono disponibili solo per le installazioni server. Sulle installazioni Cloud, non abbiamo alcuni Addon, causa motivi di sicurezza. In altri post, andremo ad esaminare pi\u00f9 in dettaglio le differenze tra le due installazioni.<\/p>\n<blockquote>\n<h1>Procediamo<\/h1>\n<\/blockquote>\n<p>Dato che si tratta di una funzionalit\u00e0 esistente nello standard, non abbiamo bisogno di preparazione o di installare alcunch\u00e9.\u00a0Come gi\u00e0 descritto nel precedente <a href=\"https:\/\/artigianodelsoftware.wordpress.com\/2015\/06\/18\/le-user-macro-queste-sconosciute\/\" target=\"_blank\">post<\/a>, andiamo a posizionarci nella sezione dedicata alla generazione delle user macro.<\/p>\n<p><a href=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-01.png\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter size-full wp-image-87995\" src=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-01.png\" alt=\"Macro-02-01\" width=\"227\" height=\"157\" \/><\/a><\/p>\n<p>Quindi, sotto la sezione delle <em><strong>C<\/strong><strong>onfiguration<\/strong><\/em>, andiamo a selezionare le <em><strong>User Macro<\/strong><\/em>.<\/p>\n<p><a href=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-02.png\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter size-large wp-image-87996\" src=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-02.png?w=660\" alt=\"Macro-02-02\" width=\"660\" height=\"319\" srcset=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-02.png 1019w, https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-02-300x145.png 300w, https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-02-768x372.png 768w\" sizes=\"(max-width: 660px) 100vw, 660px\" \/><\/a><\/p>\n<p>Procediamo quindi a generare la nostra User Macro, selezionando\u00a0<em><strong>Create a user macro<\/strong><\/em> si procede con la creazione vera e propria<\/p>\n<p><a href=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-03.png\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter size-full wp-image-87997\" src=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-03.png\" alt=\"Macro-02-03\" width=\"519\" height=\"556\" srcset=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-03.png 519w, https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-03-280x300.png 280w\" sizes=\"(max-width: 519px) 100vw, 519px\" \/><\/a><\/p>\n<p>Si impostano i primi parametri, quali:<\/p>\n<ul>\n<li><em><strong>Nome<\/strong><\/em>: assegniamo il nome alla\u00a0macro.<\/li>\n<li><em><strong>Visibilit\u00e0<\/strong><\/em>: indichiamo chi pu\u00f2 vedere\/utlizzare la macro<\/li>\n<li><em><strong>Titolo: <\/strong><\/em>Sar\u00e0 il testo che sar\u00e0 visualizzato nella lista delle macro<\/li>\n<li><em><strong>Descrizione:\u00a0<\/strong><\/em>Sar\u00e0 la descrizione che sar\u00e0 posizionata nella lista delle varie macro.<\/li>\n<li><em><strong>Categorie<\/strong><\/em> cui assegnare la macro. Le macro sono normalmente raggruppate in categorie. Si tratta solo di definire dove la macro sar\u00e0 visualizzata<\/li>\n<li><em><strong>Icona\u00a0<\/strong><\/em> da visualizzare nell&#8217;elenco delle macro. Si tratta di una URL in cui sar\u00e0 disponibile l&#8217;icona da usare.<\/li>\n<li><em><strong>Documentazione.<\/strong><\/em> URL di riferimento della documentazione associata.<\/li>\n<li><em><strong>Codice vero e proprio della macro.\u00a0<\/strong><\/em>Si tratta del codice della macro. Qui abbiamo l&#8217;azione definita.<\/li>\n<\/ul>\n<p><a href=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-04.png\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter size-large wp-image-87998\" src=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-04.png?w=660\" alt=\"Macro-02-04\" width=\"660\" height=\"379\" \/><\/a><\/p>\n<p>In questo caso abbiamo inserito il codice del nostro\u00a0<em><strong>Hello World<\/strong><\/em>. Ricordiamoci ci settare il parametro <em><strong>Macro Body Processing<\/strong><\/em> come\u00a0<em><strong>Rendered\u00a0. \u00a0<\/strong><\/em>Questo parametro \u00e8 importante in quanto indica se la macro presenta un body da trattare. Chiariamo meglio: Per body si intendono quelle macro in cui \u00e8 possibile scrivere un testo da poter poi processare. Come si vede nella figura successiva:<\/p>\n<p><a href=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-08.png\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter size-full wp-image-88006\" src=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-08.png\" alt=\"Macro-02-08\" width=\"660\" height=\"95\" srcset=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-08.png 660w, https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-08-300x43.png 300w\" sizes=\"(max-width: 660px) 100vw, 660px\" \/><\/a><\/p>\n<p>Abbiamo la visualizzazione della macro\u00a0<em><strong>Panel<\/strong><\/em>, usata per generare un Pannello dove raggruppare informazioni. Il\u00a0<em><strong>Body<\/strong><\/em> \u00e8 la sezione dove viene posizionato il cursore e dove possiamo riportare del testo.<\/p>\n<p>Chiarito questo primo concetto, vediamo le possibili alternative del parametro precedentemente indicato:<\/p>\n<ul>\n<li><strong>No macro body<\/strong>\u00a0&#8211; La macro non presenta tale body.<\/li>\n<li><strong>Escaped &#8211;\u00a0<\/strong>da usare se si vogliono visualizzare i markup HTML. In questo modo, saranno aggiunti dei codici escape per la visualizzazione dei tag<\/li>\n<li><strong>Unrendered &#8211;\u00a0<\/strong>Il codice HTML sar\u00e0 processato all&#8217;interno del codice vero e proprio.<\/li>\n<li><strong>Rendered\u00a0<\/strong>&#8211; HTML presente nel body sar\u00e0 processato e l&#8217;output sar\u00e0 visualizato. Ad esempio:\u00a0<code>&lt;b&gt;Hello World&lt;\/b&gt;<\/code>\u00a0sar\u00e0 visualizzato come:\u00a0<strong>Hello World \ud83d\ude42<\/strong><\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p>Una volta salvata, la macro \u00e8 disponibile. Creiamo una nuova pagina, come mostrato in figura:<\/p>\n<p><a href=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-05.png\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter size-full wp-image-87999\" src=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-05.png\" alt=\"Macro-02-05\" width=\"439\" height=\"357\" srcset=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-05.png 439w, https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-05-300x244.png 300w\" sizes=\"(max-width: 439px) 100vw, 439px\" \/><\/a><\/p>\n<p>Selezioniamo la macro, come una qualsiasi macro disponibile. Quindi scriviamo un qualsiasi testo all&#8217;interno<\/p>\n<p><a href=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-06.png\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter size-large wp-image-88000\" src=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-06.png?w=459\" alt=\"Macro-02-06\" width=\"459\" height=\"282\" srcset=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-06.png 459w, https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-06-300x184.png 300w\" sizes=\"(max-width: 459px) 100vw, 459px\" \/><\/a><\/p>\n<p>Quindi salviamo la pagina. Il risultato \u00e8 il seguente:<\/p>\n<p><a href=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-07.png\"><img decoding=\"async\" loading=\"lazy\" class=\"aligncenter size-large wp-image-88001\" src=\"https:\/\/artigianodelsoftware.files.wordpress.com\/2015\/06\/macro-02-07.png?w=394\" alt=\"Macro-02-07\" width=\"394\" height=\"220\" srcset=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-07.png 394w, https:\/\/artigianodelsoftware.it\/blog\/wp-content\/uploads\/2015\/06\/macro-02-07-300x168.png 300w\" sizes=\"(max-width: 394px) 100vw, 394px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<blockquote>\n<h1>Conclusioni<\/h1>\n<\/blockquote>\n<p>Abbiamo visto come si pu\u00f2 creare una semplice User Macro in Confluence.<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<p>https:\/\/confluence.atlassian.com\/display\/DOC\/Writing+User+Macros<\/p>\n<p>https:\/\/developer.atlassian.com\/confdev\/tutorials\/macro-tutorials-for-confluence\/creating-a-new-confluence-macro<\/p>\n<p>https:\/\/developer.atlassian.com\/confdev\/tutorials\/macro-tutorials-for-confluence<\/p>\n<div class=\"clearfix\"><span class='ldc-ul_cont' onclick=\"alter_ul_post_values(this,'87990','like')\" >Likes<img src=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/plugins\/like-dislike-counter-for-posts-pages-and-comments\/images\/up.png\" \/>(<span>0<\/span>)<\/span><span class='ldc-ul_cont' onclick=\"alter_ul_post_values(this,'87990','dislike')\" >Dislikes<img src=\"https:\/\/artigianodelsoftware.it\/blog\/wp-content\/plugins\/like-dislike-counter-for-posts-pages-and-comments\/images\/down.png\" \/>(<span>0<\/span>)<\/span><\/div>","protected":false},"excerpt":{"rendered":"<p>Hello World In questo post, continuiamo ad esaminare le User Macro. In particolare andremo a vedere quale iter seguire per creare la prima User Macro: HELLO WORLD \ud83d\ude42 Premessa Le\u00a0User Macro sono disponibili solo per le installazioni server. Sulle installazioni<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_editorskit_title_hidden":false,"_editorskit_reading_time":0,"_editorskit_is_block_options_detached":false,"_editorskit_block_options_position":"{}","footnotes":""},"categories":[3,7,9],"tags":[34,56,58,78,108],"_links":{"self":[{"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/posts\/87990"}],"collection":[{"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/comments?post=87990"}],"version-history":[{"count":0,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/posts\/87990\/revisions"}],"wp:attachment":[{"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/media?parent=87990"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/categories?post=87990"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/artigianodelsoftware.it\/blog\/wp-json\/wp\/v2\/tags?post=87990"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}