topic Smart folders tutorial - prima parte in Alfresco Archive

topic Smart folders tutorial - prima parte in Alfresco Archive https://connect.hyland.com/t5/alfresco-archive/smart-folders-tutorial-prima-parte/m-p/158576#M112673 <HTML><HEAD></HEAD><BODY>La metafora "cartelle e file" è stata introdotta nella preistoria dell'informativa (nei mitici laboratori Xerox di Palo Alto) ed è risultata tanto efficace, intuitiva e universalmente riconoscibile che ancora oggi è utilizzata praticamente da tutti i sistemi operativi... ...però... ...quando viene applicata in ambito documentale mostra più di qualche limite. Il problema è che un albero di cartelle esprime solo uno dei tanti modi di classificare un insieme di documenti. E' per questo che chi gestisce grandi archivi si trova spesso a dover ricorrere alla funzionalità di ricerca, per trovare i file che gli interessano. Le smart-folders nascono per superare (o almeno mitigare) questi limiti.<H2>Ma cosa sono?</H2>Quello alla base delle smart-folders non è certo un concetto nuovo. Semplificando all'estremo, possiamo dire che sono delle cartelle virtuali che contengono documenti risultanti da una ricerca. Il fatto che siano "virtuali" è rilevante: non possono essere trattate alla stregua delle folder tradizionali(!) di Alfresco. Ad esempio, non è possibile copiare in esse dei file (ok, in effetti sotto determinate condizioni questo è possibile... ma il comportamento è diverso da quello standard).In Alfresco le smart-folders possono essere di tre tipi:<OL><LI>System</LI><LI>Custom</LI><LI>Type-based</LI></OL>System e Custom sono molto simili tra loro e più semplici da capire. Le Type-based sono più versatili ma un po' più complesse.In questo post ci occuperemo dei primi due metodi. In un post successivo parleremo anche del terzo.<H2>Cominciamo...</H2>Per prima cosa bisogna abilitare le smart-folders in Alfresco perchè di default sono disattivate. Nel solito alfresco-global.properties settate:<PRE class="language-none"><CODE>smart-folders-enabled = true‍</CODE></PRE>Naturalmente ci sarà bisogno di riavviare l'applicazione per recepire le nuove impostazioni. Fatelo... e mentre aspettate che Alfresco torni su, potrete ingannare il tempo creando un nuovo template, che altro non è che un file json con una sintassi ben definita (nella <A class="jive-link-external-small" href="http://docs.alfresco.com/5.1/concepts/sf-ref-template-guidance.html" rel="nofollow noopener noreferrer" target="_blank">pagina ufficiale della documentazione sulle smart-folders</A> trovate i dettagli).Ecco un semplice esempio:<PRE class="language-javascript"><CODE>{ "name" : "Virtual Folders Test", "nodes" : [{    "id" : "101",    "name" : "Documenti pdf",    "description" : "I documenti pdf dell'utente contenuti nel sito",    "search" : {     "language" : "fts-alfresco",     "query" : "(PATH:'/app:company_home/st:sites//*') AND =cm:content.mimetype:application/pdf AND (=cm:modifier:%CURRENT_USER% OR =cm:creator:%CURRENT_USER%)"     }    }, {    "id" : "102",    "name" : "Immagini",    "description" : "Le immagini dell'utente contenute nel sito",    "search" : {     "language" : "fts-alfresco",     "query" : "(PATH:'/app:company_home/st:sites//*') AND =cm:content.mimetype:image/jpeg AND (=cm:modifier:%CURRENT_USER% OR =cm:creator:%CURRENT_USER%)"    }   }] }‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍‍</CODE></PRE>Il significato delle sue parti è intuitivo: definiamo un oggetto che contiene una lista di nodi (due nel nostro caso). Ciascun nodo è a sua volta un oggetto con alcune proprietà: id, name, description, search. Tra queste:<UL><LI>le uniche obbligatorie sono search con le sue (sotto)proprietà language e query.</LI><LI>Id, name, description sono opzionali. Id però è meglio specificarlo per generare un nodeRef più corto.</LI><LI>Language potrebbe accettare altri valori... ma per ora è consigliabile usare solo fts-alfresco.</LI></UL>Il template appena creato va salvato in Alfresco nella cartella "<repository>/Dizionario dati/Modelli di cartella intelligente" ("smart folder templates" in inglese). Potete dargli nome -ad esempio- smartFolder_tutorial.json. Ora bisogna dire ad Alfresco che quello non è un file json qualunque ma rappresenta un template di smart-folders. Per farlo dobbiamo attribuire al documento un tipo speciale. Cliccate sul nome del file per aprire la vista di dettaglio, poi sulla destra selezionate "Cambia tipo" e tra quelli proposti scegliete: "modello di cartella intelligente" (smartFolderTemplate).Ci siamo quasi... L'ultimo passo è attribuire il nostro template ad una cartella. Questo si fa associandole un aspetto ben preciso e valorizzando alcuni suoi metadati. Dal menu delle azioni a destra selezionate "Gestisci aspetti" e poi scegliete quello di nome "Cartella intelligente di sistema". Poi, sempre nel menu delle azioni sulla destra, cliccate su "Modifica proprietà" per veder comparire la finestra di dialogo con il form di modifica.  Assicuratevi di mostrare tutte le proprietà (con il pulsante in alto a destra). Se avete seguito correttamente le istruzioni dovreste veder comparire in basso un ulteriore campo di nome "Modello di cartella intelligente" con una casella a discesa. Selezionate il template che avete creato in precedenza (smartFolder_tutorial.json) e salvate le modifiche.Ora accadrà la magia: se aprite la cartella, scoprirete che ciascun oggetto node dichiarato nel template è stato  trasformato in una smart-folder. Il contenuto della smart-folder è il risultato della query specificata nella property query. Il nostro esempio genererà quindi due smart-folders:<UL><LI>la prima conterrà tutti i documenti di tutti i siti (PATH:'/app:company_home/st:sites//*') che siano pdf (=cm:content.mimetype:application/pdf) creati o modificati dall'utente corrente (=cm:modifier:%CURRENT_USER% OR =cm:creator:%CURRENT_USER%).</LI><LI>La seconda è analoga ma selezionerà solo i file di tipo jpg.</LI></UL>Una paio di cose prima di chiudere<UL><LI>Notate che in tutte e due le query abbiamo filtrato i risultati per utente corrente. Questo non perché per le smart-folders non valgano le regole di accesso (se non potete vedere un file, non lo vedrete!) ma per ottimizzare le performance ed evitare di recuperare documenti inutili.</LI><LI>Perché le smart-folders funzionino correttamente, bisogna aver cura di scegliere solr4 come servizio di ricerca e di configurare la Full Text Search in modo da usare il database ("Use Database if possibile" oppure "Always use Database").</LI></UL>PS: Vi state ancora chiedendo che differenza c'è tra i due tipi di smart-folders: System e Custom? Ecco soddisfatta la vostra curiosità. Se usate l'aspect "Cartella intelligente di sistema" potrete scegliere solo i template presenti nella directory "<repository>/Dizionario dati/Modelli di cartella intelligente". Se invece avete optato per "Cartella intelligente personalizzata" il template potrà essere posizionato ovunque nel repository... tutto qui.(<A _jive_internal="true" href="https://community.alfresco.com/groups/italian-user-group/blog/2016/12/07/smart-folders-parte-seconda" rel="nofollow noopener noreferrer">Smart folders tutorial - seconda parte</A>)</BODY></HTML> Mon, 14 Nov 2016 17:33:58 GMT davidciamberlan 2016-11-14T17:33:58Z Smart folders tutorial - prima parte https://connect.hyland.com/t5/alfresco-archive/smart-folders-tutorial-prima-parte/m-p/158576#M112673 La metafora "cartelle e file" è stata introdotta nella preistoria dell'informativa (nei mitici laboratori Xerox di Palo Alto) ed è risultata tanto efficace, intuitiva e universalmente riconoscibile che ancora oggi è utilizzata praticamente da tutti i sistemi operativi......però......quando viene app Mon, 14 Nov 2016 17:33:58 GMT https://connect.hyland.com/t5/alfresco-archive/smart-folders-tutorial-prima-parte/m-p/158576#M112673 davidciamberlan 2016-11-14T17:33:58Z