{"id":36666,"date":"2024-03-26T08:59:08","date_gmt":"2024-03-26T07:59:08","guid":{"rendered":"https:\/\/help.qualiware.it\/qw-help\/?p=36666"},"modified":"2024-04-12T08:51:29","modified_gmt":"2024-04-12T06:51:29","slug":"importazione-documenti-esempio-di-archiviazione-automatica-delle-email","status":"publish","type":"post","link":"https:\/\/help.qualiware.it\/qw-help\/importazione-documenti-esempio-di-archiviazione-automatica-delle-email\/","title":{"rendered":"Importazione documenti: Esempio di archiviazione automatica delle email"},"content":{"rendered":"<p>Questa pagina vuol essere un esempio sull\u2019<strong><a href=\"https:\/\/help.qualiware.it\/qw-help\/sd-importazione-documenti\/\">Importazione dei documenti<\/a><\/strong>\u00a0attraverso la scheda di <strong>QualiWare Server Daemon<\/strong>, relativa alla configurazione per l\u2019archiviazione delle email con estrazione dei metadati tramite cartella su <strong><a href=\"https:\/\/help.qualiware.it\/qw-help\/sd-importazione-documenti\/#:~:text=della%20cartella%20specificata.-,Cartella%20su%20Exchange,-I%20campi%20in\">Exchange<\/a><\/strong> o su <strong><a href=\"https:\/\/help.qualiware.it\/qw-help\/sd-importazione-documenti\/#:~:text=l%E2%80%99errore%20%E2%80%9Cunauthorized%E2%80%9C.-,Cartella%20su%20IMAP,-I%20campi%20in\">IMAP<\/a><\/strong>.<\/p>\n<p><a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-AggiungiNuovaImportazione.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36686\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-AggiungiNuovaImportazione.jpg\" alt=\"QWSD - QualiWare Server Daemon, Importazione documenti, Nuova importazione\" width=\"768\" height=\"577\" srcset=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-AggiungiNuovaImportazione.jpg 1147w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-AggiungiNuovaImportazione-768x577.jpg 768w\" sizes=\"(max-width: 768px) 100vw, 768px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>Ipotizziamo di volere configurare <em>QualiWare Server Daemon<\/em> affinch\u00e9 monitori periodicamente la cartella <em>Assistenze risolte<\/em> dell\u2019indirizzo di posta elettronica <em>assistenza[at]qualiware.it<\/em>, eseguendo l\u2019importazione delle mail contenute in essa. Eseguita l\u2019importazione in QualiWare, i messaggi vengono spostati in una sottocartella di <em>Assistenza<\/em> denominata <em>Storico<\/em>.<\/p>\n<p><a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-parametriOffice365.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36669\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-parametriOffice365.jpg\" alt=\"QWSD - QualiWare Server Daemon, Importazione documenti, Parametri d'importazione, Cartella su Exchange, Parametri Office365\" width=\"768\" height=\"515\" srcset=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-parametriOffice365.jpg 1126w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-parametriOffice365-768x515.jpg 768w\" sizes=\"(max-width: 768px) 100vw, 768px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<h3>Parametri di importazione<\/h3>\n<p>In questo caso di esempio vengono definiti i <em>parametri d\u2019importazione<\/em> dalla <strong>Cartella su Exchange<\/strong>, dove la cartella <em>Assistenza risolte<\/em> viene monitorata da <em>QualiWare Server Daemon<\/em> per importare le nuove email, mentre la cartella <em>Storico<\/em> \u00e8 di destinazione delle email una volta che sono state importate in QualiWare.<\/p>\n<p><a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36671\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange.jpg\" alt=\"QWSD - QualiWare Server Daemon, Importazione documenti, Parametri d'importazione, Cartella su Exchange\" width=\"768\" height=\"702\" srcset=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange.jpg 926w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-768x702.jpg 768w\" sizes=\"(max-width: 768px) 100vw, 768px\" \/><\/a><\/p>\n<p>Il prerequisito per la corretta configurazione \u00e8 aver configurato l\u2019accesso applicativo al <strong><a href=\"https:\/\/help.qualiware.it\/qw-help\/configurazione-posta-con-office365\/\">Tenant di Office365<\/a><\/strong> tramite autenticazione <em>oAUTH2.0<\/em>.<\/p>\n<p>&nbsp;<\/p>\n<h3>Configurare la query<\/h3>\n<p>Una volta definiti i <em>parametri d&#8217;importazione<\/em> si <em>configura la query<\/em> per determinare i valori dai metadati di ogni email importata: oggetto, mittenti, destinatari.<\/p>\n<p><a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-Query.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36673\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-Query.jpg\" alt=\"QWSD - QualiWare Server Daemon, Importazione documenti, Parametri d'importazione, Cartella su Exchange, Query\" width=\"768\" height=\"702\" srcset=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-Query.jpg 926w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ParametriDiImportazione-CartellaSuExchange-Query-768x702.jpg 768w\" sizes=\"(max-width: 768px) 100vw, 768px\" \/><\/a><\/p>\n<p>In caso d\u2019importazione dalla <em>Cartella su Exchange<\/em> sono disponibili i seguenti parametri aggiuntivi (preceduti dal carattere \u201c:\u201d), che contengono informazioni relative al messaggio:<\/p>\n<ul>\n<li><strong>:SUBJECT<\/strong>, contiene il soggetto del messaggio;<\/li>\n<li><strong>:DATERECEIVED<\/strong>, contiene la data ricezione;<\/li>\n<li><strong>:TIMERECEIVED<\/strong>, contiene l\u2019ora ricezione;<\/li>\n<li><strong>:DATESENT<\/strong>, contiene la data d\u2019invio;<\/li>\n<li><strong>:TIMESENT<\/strong>, contiene l\u2019ora d\u2019invio;<\/li>\n<li><strong>:CATEGORY<\/strong>, contiene la categoria;<\/li>\n<li><strong>:SENDER<\/strong>, contiene l\u2019indirizzo del mittente;<\/li>\n<li><strong>:TORECIPIENTS<\/strong>, contiene gli indirizzi dei destinatari;<\/li>\n<li><strong>:CCRECIPIENTS<\/strong>, contiene gli indirizzi dei destinatari in conoscenza;<\/li>\n<li><strong>:MESSAGEID<\/strong>, contiene l\u2019ID del messaggio.<\/li>\n<\/ul>\n<p>Utilizzando i parametri aggiuntivi si crea la query come l\u2019esempio che segue.<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"sql\">select distinct ltrim(str(year(:DATERECEIVED))) as TIPO_CONT,\r\nright('000000'+ltrim(str(coalesce((select max(convert(integer,NUMERO)) from DOCUMENT where TIPO='MAIL' and TIPO_CONT=ltrim(str(year(:DATERECEIVED)))),0)+1)),6) as NUMERO,\r\ncase when :SUBJECT='' then '*' else :SUBJECT end as TITOLO,\r\n:SUBJECT as CUSTOM1,\r\n:DATESENT as DATE1,\r\nreplace(:TIMESENT,':','') as CUSTOM6,\r\n:DATERECEIVED as DATE2,\r\nreplace(:TIMERECEIVED,':','') AS CUSTOM7,\r\n:SENDER as CUSTOM2,\r\n:TORECIPIENTS as CUSTOM3,\r\n:CCRECIPIENTS as CUSTOM4,\r\n:MESSAGEID as CUSTOM27,\r\n(select min(o.CODICE+' - '+c.RAGSOC) from ORGCF o join CLIFOR c on o.CODICE=c.CODICE\r\nwhere CLIENTE=1 and left(o.CODICE,1) in ('C','R') and o.EMAIL is not null and\r\n (:SENDER like '%'+o.EMAIL+'%' or :TORECIPIENTS like '%'+o.EMAIL+'%' or :CCRECIPIENTS like '%'+o.EMAIL+'%')) as CUSTOM5,\r\ncase when patindex('%#TT%',:SUBJECT)&lt;&gt;0 then substring(:SUBJECT,patindex('%#TT%',:SUBJECT)+1,12) else '' end as CUSTOM8\r\n<\/pre>\n<p>&nbsp;<\/p>\n<h3>Commenti ad alcune parti della query<\/h3>\n<p>Di seguito vengono riportate alcune annotazioni di rilievo che commentano la query:<\/p>\n<p>&nbsp;<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"sql\">select distinct ltrim(str(year(:DATERECEIVED))) as TIPO_CONT,\r\n<\/pre>\n<p>Questa istruzione valorizza il campo <em>TIPO_CONT<\/em> estraendo l\u2019anno dal metadato <em>:DATERECEIVED<\/em> perch\u00e9 la <em>Categoria documentale<\/em> di destinazione utilizza la numerazione automatica \u201c<em>ANNO + progressivo<\/em>\u201d.<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"sql\">right('000000'+ltrim(str(coalesce((select max(convert(integer,NUMERO)) from DOCUMENT where TIPO='MAIL' and TIPO_CONT=ltrim(str(year(:DATERECEIVED)))),0)+1)),6) as NUMERO,\r\n<\/pre>\n<p>Questa istruzione valorizza il campo <em>NUMERO<\/em> col progressivo corretto, andando a prendere l\u2019ultimo valore del campo <em>NUMERO<\/em> della <em>Categoria documentale<\/em> <strong><em>\u2018<\/em><\/strong><em>MAIL<\/em><strong><em>\u2019<\/em><\/strong>, valore che viene incrementato di uno.<br \/>\nAttraverso l\u2019istruzione <em>RIGHT<\/em> si esegue la formattazione del risultato, andandolo ad adeguare al formato a sei cifre con l\u2019inserimento degli zeri partendo da destra del risultato.<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"sql\">case when :SUBJECT='' then '*' else :SUBJECT end as TITOLO,\r\n<\/pre>\n<p>Nelle archiviazioni all\u2019interno di una categoria documentale il campo <em>TITOLO<\/em> dev\u2019essere valorizzato. Attraverso questa istruzione se l\u2019oggetto dell\u2019email \u00e8 vuota, il campo <em>TITOLO<\/em> viene valorizzato con un asterisco. In caso contrario, il campo viene valorizzato con quanto contenuto nel campo dell\u2019oggetto della mail.<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"sql\">(select min(o.CODICE+' - '+c.RAGSOC) from ORGCF o join CLIFOR c on o.CODICE=c.CODICE\r\nwhere CLIENTE=1 and left(o.CODICE,1) in ('C','R') and o.EMAIL is not null and\r\n (:SENDER like '%'+o.EMAIL+'%' or :TORECIPIENTS like '%'+o.EMAIL+'%' or :CCRECIPIENTS like '%'+o.EMAIL+'%')) as CUSTOM5,\r\n<\/pre>\n<p>In questa porzione di codice viene verificata la presenza nelle email del mittente, dei destinatari e dei CC, di un indirizzo appartenente ad un cliente\/fornitore censito in anagrafica. A tal fine, vengono utilizzate le tabelle <em>ORGCF<\/em> e <em>CLIFOR<\/em>.<br \/>\nSe la mail \u00e8 presente, viene utilizzato questo valore anche per recuperare i relativi <em>codice cliente\/fornitore<\/em> e <em>ragione sociale<\/em>.<\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"sql\">case when patindex('%#TT%',:SUBJECT)&lt;&gt;0 then substring(:SUBJECT,patindex('%#TT%',:SUBJECT)+1,12) else '' end as CUSTOM8\r\n<\/pre>\n<p>In questo esempio, si ipotizza che la mail faccia riferimento a un ticket di assistenza, il cui identificativo univoco \u00e8 indicato nell\u2019oggetto, preceduto dalla stringa <em>\u2018#TT\u2019<\/em>, esempio:<\/p>\n<p><em><strong>Oggetto<\/strong>: Richiesta di Assistenza #TT202404090012 \u2013 Supporto per importazione strumenti ed attrezzature<\/em><\/p>\n<p>In questa porzione di codice \u00e8 possibile rilevare la presenza della stringa <em>\u2018#TT\u2019<\/em> selezionando solo la componente identificativa del ticket, valorizzando il campo <em>CUSTOM8<\/em> col risultato.<\/p>\n<p>&nbsp;<\/p>\n<h3>Conclusioni<\/h3>\n<p>Terminata la procedura d\u2019importazione delle email, il sistema le riporta in una categoria documentale dedicata, che \u00e8 raggiungibile dall\u2019albero documentale dove sono presenti tutti i dati richiamati dalla query.<\/p>\n<p><a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ElencoEmailImportate_.jpg\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36726\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ElencoEmailImportate_.jpg\" alt=\"QWSD - QualiWare Server Daemon, Importazione documenti, Esempio elenco email importate\" width=\"768\" height=\"431\" srcset=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ElencoEmailImportate_.jpg 1371w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-ElencoEmailImportate_-768x431.jpg 768w\" sizes=\"(max-width: 768px) 100vw, 768px\" \/><\/a><\/p>\n<p>Una volta importate, ciascuna emali pu\u00f2 essere gestita come un qualsiasi altro documento, con i rispettivi metadati che la definiscono all\u2019interno del form.<\/p>\n<p><a href=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-FormDocumentoImportato.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-36728\" src=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-FormDocumentoImportato.png\" alt=\"QWSD - QualiWare Server Daemon, Importazione documenti, Esempio Form documento importato\" width=\"650\" height=\"594\" srcset=\"https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-FormDocumentoImportato.png 944w, https:\/\/help.qualiware.it\/qw-help\/wp-content\/uploads\/QWSD-QualiWareServerDaemon-ImportazioneDocumenti-FormDocumentoImportato-768x702.png 768w\" sizes=\"(max-width: 650px) 100vw, 650px\" \/><\/a><\/p>\n<p>&nbsp;<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Questa pagina vuol essere un esempio sull\u2019Importazione dei documenti\u00a0attraverso la scheda di QualiWare Server Daemon, relativa alla configurazione per l\u2019archiviazione delle email con estrazione dei metadati tramite cartella su Exchange o su IMAP. &nbsp; Ipotizziamo di volere configurare QualiWare Server Daemon affinch\u00e9 monitori periodicamente la cartella Assistenze risolte dell\u2019indirizzo di posta elettronica assistenza[at]qualiware.it, eseguendo l\u2019importazione&hellip;<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"ngg_post_thumbnail":0,"footnotes":""},"categories":[60],"tags":[],"acf":[],"_links":{"self":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/36666"}],"collection":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/comments?post=36666"}],"version-history":[{"count":13,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/36666\/revisions"}],"predecessor-version":[{"id":36730,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/posts\/36666\/revisions\/36730"}],"wp:attachment":[{"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/media?parent=36666"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/categories?post=36666"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/help.qualiware.it\/qw-help\/wp-json\/wp\/v2\/tags?post=36666"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}