Supporto On Line Allegato FAQ FAQ n.ro MAN-7VS9N245045 Data ultima modifica 08/04/20 Prodotto Tutti Modulo Tutti Oggetto Distribuzione aggiornamenti software in modalità Live Update In giallo sono evidenziate le modifiche/integrazioni apportate al documento rispetto alla versione del 6/03/200. Introduzione Scopo del presente documento è quello di fornire una guida per l utilizzo del servizio Live Update (ovvero un manuale operativo - lato utente). Live Update è un servizio che consente, ai clienti che utilizzano i prodotti Sistema PROFESSIONISTA / Suite Self Service / PragmaWIN, di ricevere in automatico gli aggiornamenti dei software via internet facilitandone l utilizzo nonché l installazione. Gli aggiornamenti saranno resi disponibili in modo diversificato (tra Agenti/Rivenditori e Clienti) ovvero tramite la gestione di due date (impostate sull applicativo che gestisce il servizio Live Update) di validità degli aggiornamenti. Di conseguenza il sistema è in grado di distinguere la richiesta del servizio, Live Update, proveniente dagli Agenti/Rivenditori o dai Clienti. La verifica della disponibilità degli aggiornamenti (tramite il servizio Live Update) può avvenire: in modalità manuale; ad ogni avvio della SUITE; giornalmente ad un ora predefinita. Un apposita icona (Ipsoa/Pragma Update) presente in Suite, richiamabile in qualsiasi momento, consente al cliente di personalizzare il servizio, per verificare la presenza di aggiornamenti e visualizzare l elenco di quelli disponibili. Per la realizzazione del servizio di Live Update, è stata predisposta un adeguata infrastruttura dove saranno collocati tutti gli aggiornamenti. L intero processo di download è affidato a BITS, (Background Intelligent Transfer Service) il medesimo di Windows Update, Windows Server Update Services (WSUS) e Systems Management Server (SMS), che consente:. il download in background (mentre l utente utilizza il pc per altre attività) 2. l interruzione del download e la ripresa dello stesso, dal punto esatto in cui si è interrotto, in un momento successivo. I SO Windows 2000/XP/ Vista/ Windows7/Server 2003-2008 hanno già a bordo, il componente BITS (%windir%\system32\ QMgr.dll) nella ver. 2.0 o successive. N.B. In Windows Server 2008, BITS deve essere aggiunto come Ruolo all interno del Server Manager BITS è un servizio di Windows. Al momento della chiamata al servizio Live Update (dal Client), sono effettuati i seguenti controlli: Wolters Kluwer Italia Srl Help Desk Software Pagina di 6
connessione Internet attiva presenza del componente BITS (Ver. 2.0 o successive) servizio BITS avviato (Pannello di controllo > Strumenti di Amministrazione > Servizi) N.B. Se il servizio BITS non risultasse avviato, in Suite verrà proposto il seguente messaggio: Altri Client già attivi alla richiesta del servizio Qualora una delle seguenti condizioni non dovesse essere soddisfatta, sarà segnalato con apposito messaggio. Poiché il servizio effettua una serie di controlli per verificare eventuali utenti attivi all interno degli applicativi, è fondamentale che tutti i software siano richiamati dalla SUITE, pertanto non da collegamenti diretti posti, ad esempio, sul desktop. In caso contrario si potrebbero manifestare blocchi durante l esecuzione dei setup. Al momento, tramite il servizio Live Update, si prevede la distribuzione dei soli aggiornamenti e non quella dei rilasci completi (ovvero le versioni distribuite tramite DVD o che devono essere installate in modalità Prima installazione/aggiornamento manuale ). Wolters Kluwer Italia Srl Help Desk Software Pagina 2 di 6
Gli aggiornamenti distribuiti tramite tale servizio, saranno sempre comprensivi anche delle versioni precedentemente rilasciate, quindi installabili sulla versione completa (presente sul/i computer del cliente). Da ciò emerge che i rilasci degli aggiornamenti pubblicati e scaricabili tramite il servizio Live Update, saranno incrementali delle versioni precedentemente rilasciate (in passato le PATCH NON sempre erano comprensive di quelle distribuite prima). Le versioni degli agg.ti avranno una numerazione univoca (ovvero non potranno esserci numeri di versioni uguali a fronte di contenuti diversi e/o che possono essere installate su versioni diverse). Un esempio esplicativo è riportato nel seguente prospetto: Live Update Descrizione DVD (Ver. completa) 6.00 6. D.F. 6.2 D.F. 6.2 comprensiva di 6. 6.3 D.F. 6.3 comprensiva di 6. e 6.2 6.4 D.F. 6.4 comprensiva di 6., 6.2 e 6.3 7.00 La Ver. 6. potrà essere installata sulla Ver. 6.00 (Ver. precedentemente installata sul computer del cliente tramite il DVD 06/20XX). La Ver. 6.2 sarà comprensiva della Ver. 6. (come anche le Ver. 6.3 e Ver. 6.4 saranno comprensive delle versioni precedenti) e potrà essere installata sulla Ver. 6.00 (Ver. precedentemente installata sul computer del cliente tramite il DVD 06/20XX). Gli aggiornamenti sono previsti per i seguenti prodotti: Anagrafica Unica Contabilità, Cespiti e Ritenute Dichiarazioni Fiscali Studi di Settore 730 Parcelle & Fatture Suite Bilancio Basilea Oltre a: Componenti Condivisi (se necessari) Tali aggiornamenti saranno disponibili al cliente quando risulti attivo un abbonamento (es. per il codice prodotto IPSOA 83577 - Sistema [Dichiarazioni Fiscali + Contabilità] sarà consentito il servizio sui due software). Componenti Condivisi ed Anagrafica Unica saranno sempre disponibili (a condizione che vi sia un prodotto attivo in abbonamento per i software sopra esposti). Nel paragrafo che segue sarà illustrato il funzionamento del servizio. Wolters Kluwer Italia Srl Help Desk Software Pagina 3 di 6
Live Update guida operativa ATTENZIONE Non è consentito l esecuzione del Servizio Live Update tramite Connessione Desktop remoto ed in modalità Terminal Server. Occorre che lo stesso venga avviato direttamente sulla macchina remota (nel caso di Terminal Server, sul Server) Tramite una serie di parametri, inseriti all interno delle Impostazioni della SUITE, si avrà la possibilità di decidere come utilizzare il servizio di Live Update (Figura ). Impostando tale flag, come spiegato, verrà utilizzata tutta la banda internet disponibile, al fine di velocizzare i tempi di download. Senza il flag, le prestazioni di download rimarranno invariate Figura Le modalità al momento previste sono: Manuale : l utente autonomamente eseguirà la chiamata al servizio a sua discrezione (tramite il bottone IPSOA/PRAGMA Update ribbon della SUITE) Wolters Kluwer Italia Srl Help Desk Software Pagina 4 di 6
Ad ogni avvio della Suite : il computer Client, ad ogni accesso alla SUITE, eseguirà una chiamata al servizio Giornaliero, alle : il computer Client, ad una determinata ora, eseguirà una chiamata al servizio. Si precisa che indipendentemente dalle impostazioni della SUITE indicate, il servizio Live Update potrà essere richiamato in qualsiasi momento, da parte dell utente, premendo il bottone IPSOA Update / PRAGMA Update (ribbon della SUITE). Inoltre si ha la possibilità di definire: Visualizza aggiornamenti : dopo aver chiamato il servizio, qualora vi fossero degli aggiornamenti disponibili, il Client sarà avvisato tramite la visualizzazione di una FORM di dialogo (Figura 5); Scarica ed avvisa : il servizio sarà chiamato in modo silente effettuando (qualora vi fossero i prerequisiti) il download dei setup e, prima dell esecuzione degli stessi, l utente sarà avvisato tramite la visualizzazione di una FORM di dialogo (Figura ). Si precisa che durante la fase di download sarà attivato un pop-up di avviso per l utente; Scarica ed esegui : il servizio sarà chiamato in modo silente effettuando (qualora vi fossero i prerequisiti) il download dei setup che, una volta scaricati, saranno eseguiti automaticamente (lato server). Durante le fasi di download ed installazione sarà attivato un pop-up per avvisare l utente dell operazione in corso. (Figura 2). Le impostazioni di default saranno: Ad ogni avvio della Suite Visualizza aggiornamenti N.B.: Per rendere attive le modifiche delle impostazioni del servizio Live Update è necessario chiudere e riaprire la SUITE. La figura 2 mostra la procedura di ottenimento degli aggiornamenti dal server Live Update. Wolters Kluwer Italia Srl Help Desk Software Pagina 5 di 6
Server 2 Client 3 Client 2 Client Live Update Service Figura 2: come ottenere un aggiornamento Preventivamente (prima di effettuare la chiamata al servizio Figura 2 punto ) sono verificate (in Figura 2 punto 2) tutte le procedure installate lato server e le rispettive versioni. Le informazioni delle procedure installate (oltre al Codice cliente all interno delle Impostazioni SUITE ), sono passate al servizio Live Update Service per verificare se, per le procedure installate, sono disponibili degli aggiornamenti. Il servizio elabora le informazioni ricevute e restituisce al Client, qualora fosse attivo il servizio per il cliente (previe una serie di verifiche dei prodotti attivi del Cliente / morosità e quant altro), l elenco degli aggiornamenti disponibili (sempre che sia stata richiesta la modalità Visualizza aggiornamenti ). Nel caso di assenza di aggiornamenti disponibili, l utente riceverà, in un pop-up, il messaggio Non ci sono aggiornamenti disponibili e la form di visualizzazione degli aggiornamenti disponibili (Figura 5) non sarà visualizzata. Ad ogni accesso al servizio sono memorizzate (sul Server che gestisce il servizio Live Update - le informazioni del Cliente che ha effettuato la richiesta del servizio (Codice Cliente / data completa della richiesta del servizio). Qualora tutte le condizioni sopra citate siano soddisfatte, è scritto un file di lock (in Figura 2 punto 2), (ovvero lato server [Path di rete]\ipsoware/pragmaw\liveupdate\filelock.xml, per impedire, agli altri Client, d interrogare il web service Live Update Service (sempre che siano abilitati a farlo) poiché è già in corso il servizio. Questo file contiene i dati dell utente che sta cercando di eseguire le operazioni che interessano Live Update; queste informazioni sono importanti in quanto prima di eseguire qualsiasi richiesta a Live Update Service viene controllata l esistenza del file di lock, nel caso in cui questo file fosse già stato creato, l attributo User permette all applicazione di sapere se è l utente stesso che lo ha creato permettendogli quindi di continuare con l operazione richiesta. Lo stato, definito tra i tag State può assumere i seguenti valori: Information: se il file di lock si trova in questo stato vuol dire che qualche utente sta effettuando solo delle richieste a Live Update Service di informazioni sugli aggiornamenti e quindi chiunque può a sua volta richiedere informazioni o anche scaricare ed installare gli aggiornamenti; Wolters Kluwer Italia Srl Help Desk Software Pagina 6 di 6
Downloading: se il file di lock si trova in questo stato vuol dire che qualche utente sta effettuando il download di un qualsiasi file di setup e quindi nessun altro utente può eseguire alcuna delle operazioni fornite da Live Update; DownloadingSuspended: se il file di lock si trova in questo stato vuol dire che qualche utente ha momentaneamente sospeso il download, che potrà essere ripreso in un momento successivo anche in questo caso nessun altro utente può eseguire alcuna operazione riguardante Live Update; Download completed: se il file di lock si trova in questo stato vuol dire che qualche utente ha terminato il download dei file di setup: anche in questo caso nessun altro utente può eseguire alcuna operazione riguardante Live Update; Installing: se il file di lock si trova in questo stato vuol dire che qualche utente sta effettuando l installazione di un setup e quindi nessun altro utente può dialogare con il servizio Live Update; il file di lock è definito in questo stato solo se non vi sono altri utenti che stanno utilizzando la SUITE. Quello che segue è un esempio di filelock.xml: Il resto del file di lock fornisce l elenco degli aggiornamenti disponibili per l applicazione definendone tutti gli attributi ottenuti dal servizio Live Update Service. La SUITE verifica l esistenza dei setup sul Server e procede all installazione dei setup trovati. Gli altri Client non potranno accedere alla SUITE fino a quando l installazione non sarà terminata. Figura 3: impossibile effettuare il login La finestra di dialogo rappresentata in Figura 3 appare ad un utente che tenta l operazione di login alla SUITE mentre un altro utente sta già effettuando l installazione di un aggiornamento. Wolters Kluwer Italia Srl Help Desk Software Pagina 7 di 6
Figura 4: avviso della presenza di altri utenti che stanno utilizzando la Suite L avviso () informa l utente che altri client stanno utilizzando la SUITE e cioè che è presente il file di lock e che si trova in uno stato diverso da Information. NOMENCLATURA DEI FILE I setup scaricati saranno salvati (Figura 2 punto 2), lato server, nel seguente percorso: [Path di rete]\liveupdate\[nome dell applicazione] Il nome del file temporaneo assegnato durante il download è gestito da BITS Si precisa che i setup salvati, lato server, assumono una nomenclatura appropriata in funzione dell aggiornamento che si sta rilasciando; il nome del file viene creato secondo la seguente logica: [Nome dell applicazione]#s[numero Versione]#A[Numero di Versione aggiornamento server]#d[numero di aggiornamento dati].exe Se l applicazione non prevede un aggiornamento dati la sezione #D[Numero di aggiornamento dati] è omessa. Esempio (aggiornamento dell anagrafica unica Ver. 9.6.0): Aggiornamento inerente al modulo di Anagrafica Unica Ver. 9.6 + aggiornamento Server Ver. 0 + aggiornamento dati Ver. 0. Avrà la seguente nomenclatura: Anagrafica Unica#S9_6#A0.EXE Esempio 2 (aggiornamento del anagrafica unica Ver. 9.6.0.): Aggiornamento inerente al modulo di Anagrafica Unica Ver. 9.6 + aggiornamento Server Ver. 0 + aggiornamento dati Ver.. Avrà la seguente nomenclatura: Anagrafica Unica#S9_6#A0#D.EXE Qualora il setup dovesse essere il primo da installare (dell elenco dei setup messi a disposizione), sarà aggiunto, come ultimo parametro, #O(lettera o significa obbligatorio) (es. Anagrafica Unica#S9_6#A0#0#O.EXE). In caso di errori presenti nei setup è possibile eliminare direttamente i file in base alle informazioni appena fornite. Wolters Kluwer Italia Srl Help Desk Software Pagina 8 di 6
VISUALIZZA AGGIORNAMENTI In questo paragrafo sarà illustrata l operatività dell elaborazione del servizio con la modalità Visualizza aggiornamenti ; le altre (Scarica ed Avvisa e Scarica ed Esegui) opereranno, ma in modo silente. 3 2 Figura 5: visualizza aggiornamenti La Form rappresentata in Figura 5 ha lo scopo di mostrare tutti gli aggiornamenti disponibili per l applicazione. L utente può decidere di iniziare il download () oppure di annullare l operazione (2). Qualora un aggiornamento fosse legato ad un documento (ad esempio Figura 5 Anagrafica unica 9.6.2 (3)), cliccando col mouse sulla descrizione sul link Doc (3), l utente verrà reindirizzato su una specifica pagina web contenente la relativa documentazione. A partire dalla versione 3/20 la dicitura Doc sarà sostituita da Wolters Kluwer Italia Srl Help Desk Software Pagina 9 di 6
Una volta scelta l opzione Inizia downloads () apparirà la seguente Form: 2 Figura 6: download aggiornamenti La Form rappresentata in Figura 6 offre la possibilità di: 3 interrompere momentaneamente il download Sospendi download (); annullare il download Annulla Download (2) annullando / cancellando tutto ciò che è stato già scaricato parzialmente oltre ad eliminare il file lock (filelock.xml ) lasciando però nelle apposite cartelle i file già scaricati in modo completo. Se si dovesse avere la necessità di annullarli si potrà intervenire manualmente. Si precisa che qualora ci si trovasse in tale situazione e si dovesse richiamare nuovamente il servizio Live Update, saranno ri-eseguiti tutti i controlli precedentemente esposti oltre ad effettuare il download dei setup. Se i setup di aggiornamento dovessero essere gli stessi di quelli già precedentemente salvati lato server, non sarà avviato il download e si avrà la possibilità di avviare direttamente il setup; nascondere la FORM di dialogo Nascondi (3) permettendo al cliente di continuare il proprio lavoro. Wolters Kluwer Italia Srl Help Desk Software Pagina 0 di 6
Una volta completati gli aggiornamenti verrà mostrata la seguente Form: 2 Figura 7: avvio dei Setup Cliccando il pulsante Nascondi (2) scomparirà la Form di riepilogo dei setup; cliccando sul pulsante degli aggiornamenti Ipsoa Update presente all interno della Form principale della SUITE apparirà la seguente Form: Figura 8: ripristino dell avvio dei Setup Cliccando su Avvia setup () sia in Figura 7 che in Figura 8 il sistema controllerà che nessun altro client abbia la SUITE aperta. Wolters Kluwer Italia Srl Help Desk Software Pagina di 6
Nel caso in cui anche solo un altro client stia utilizzando la SUITE, presente in Figura 4; altrimenti sarà visualizzata la seguente Finestra: all utente sarà mostrato l avviso Figura 9: finestra di wizard per l installazione dei setup degli aggiornamenti Come mostra la Figura 9 l installazione di un setup è affidata a Wizard (); sarà però possibile sospendere il setup cliccando su Sospendi setup (2). Pertanto, una volta terminata l installazione del setup attuale non verrà eseguito nessun altro eventuale aggiornamento successivo finché l utente non cliccherà su Riprendi setup. 2 Figura 0: riscontro di un errore La maschera in Figura 0 mostra all utente che l installazione di un setup è stata interrotta a causa di un errore; ogni genere di errore provoca in ogni caso l eliminazione del file di lock precedentemente creato. Permettendo ad altri utenti di ritentare l installazione in un secondo momento. Wolters Kluwer Italia Srl Help Desk Software Pagina 2 di 6
Nel caso in cui non si sia verificato alcun errore e quindi il download e l installazione dei setup sia andato a buon fine apparirà: Figura SCARICA ED AVVISA Se l utente sceglie l opzione Scarica ed avvisa all interno della form rappresentata in Figura una volta terminato il download dei setup verrà mostrato il seguente avviso: 2 Figura 2 Wolters Kluwer Italia Srl Help Desk Software Pagina 3 di 6
L avviso () in Figura 2 informa l utente che il download è stato effettuato e, cliccando su di esso oppure su IPSOA Update (2), si aprirà la Form rappresentata in Figura 7 e le operazioni di installazioni proseguiranno come spiegato nella sezione precedente. SCARICA ED ESEGUI Se l utente sceglie l opzione Scarica ed Esegui all interno della Form rappresentata in Figura, il download dei setup verrà effettuato in modo silente. Al termine del download, l installazione sarà avviata automaticamente; se tuttavia un altro client sta utilizzando la SUITE sarà mostrato all utente il messaggio in Figura 4, altrimenti sarà visualizzato il seguente avviso: 2 Figura 3: termine del download dei setup ed inizio installazione L avviso () mostra all utente che il download è stato completato e che sta iniziando la fase di installazione, infatti viene aperta la finestra di Wizard (2) che procederà all installazione del setup dell aggiornamento. INSTALLAZIONE SETUP SUI CLIENT Al termine dell installazione saranno eliminati tutti i setup dal Server (ovvero lato server [Path di Rete]\LiveUpdate\[Nome applicazione]) ed eliminato il file di lock (ovvero lato server [Path di Rete]\ LiveUpdate\\fileLock.xml) (Figura 2 punto 2). Da questo momento in poi si attivano i consueti processi d installazione (ovvero tutti i controlli che già avvengono normalmente quando il cliente ha scaricato gli aggiornamenti da Internet, li ha salvati sul proprio P.C. e ha effettuato l installazione lato Server). Wolters Kluwer Italia Srl Help Desk Software Pagina 4 di 6
Terminata l installazione degli aggiornamenti apparirà la seguente finestra: Figura 4 Dopo aver cliccato su Ok la Suite verrà chiusa automaticamente. A seguire sarà necessario eseguire l aggiornamento della Stazione Client, con la consueta funzione all interno delle Utilità, che consentirà di aggiornare tutte le procedure oggetto degli aggiornamenti (ovvero tutti i prodotti aggiornati sul server e installati sul Client). Attivazione del Servizio Live Update Il servizio Live Update sarà attivato tramite appositi parametri all interno dei file.dat (ovvero lato server [Path di rete]\bin\bin_dati\set. I file interessati contengono le seguenti stringhe di connessione: Contabilita (S_COGE20.DAT): LiveUpdate= ( significa che il servizio Live Update è abilitato, 0 che non lo è) Modulo=COGE20 (stabilisce il nome con cui verrà chiamata l applicazione durante l utilizzo di Live Update) FileIni=RETE-\cogeNET\coge20.ini (indica a Live Update dove risiede il file.ini) ItemIni=SETUP;Versione;AggiornamentoServer (indica la sezione e quali dei suoi oggetti prende in considerazione Live Update all interno del file.ini dell applicazione) Dichiarazioni Fiscali 2009 (S_UNI09.DAT): LiveUpdate=0 ( significa che il servizio Live Update è abilitato, 0 che non lo è) Modulo=UNICO-2009 (stabilisce il nome con cui verrà chiamata l applicazione durante l utilizzo di Live Update) FileIni=RETE-\dr\dr2009\unico\uni-2009.ini (indica a Live Update dove risiede il file.ini) ItemIni=SETUP;Versione;AggiornamentoServer (indica la sezione e quali dei suoi oggetti prende in considerazione Live Update all interno del file.ini dell applicazione) 730-2009 (S_73009.DAT): LiveUpdate= ( significa che il servizio Live Update è abilitato, 0 che non lo è) Modulo=730-2009 (stabilisce il nome con cui verrà chiamata l applicazione durante l utilizzo di Live Update) FileIni=RETE-\dr\dr2009\730\730-2009.ini (indica a Live Update dove risiede il file.ini) ItemIni=SETUP;Versione;AggiornamentoServer (indica la sezione e quali dei suoi oggetti prende in considerazione Live Update all interno del file.ini dell applicazione) Parcelle & Fatture (S_PARCFAT.DAT): LiveUpdate= ( significa che il servizio Live Update è abilitato, 0 che non lo è) Modulo=PARC (stabilisce il nome con cui verrà chiamata l applicazione durante l utilizzo di Live Update) FileIni=RETE-\Parc\Parc.ini (indica a Live Update dove risiede il file.ini) ItemIni=SETUP;Versione;AggiornamentoServer (indica la sezione e quali dei suoi oggetti prende in considerazione Live Update all interno del file.ini dell applicazione) Componenti Condivisi (S_SETUP.DAT): LiveUpdate= ( significa che il servizio Live Update è abilitato, 0 che non lo è) Wolters Kluwer Italia Srl Help Desk Software Pagina 5 di 6
Modulo=SHARED (stabilisce il nome con cui verrà chiamata l applicazione durante l utilizzo di Live Update) FileIni=RETE-\Shared\Shared.ini (indica a Live Update dove risiede il file.ini) ItemIni=SETUP;Versione;AggiornamentoServer (indica la sezione e quali dei suoi oggetti prende in considerazione Live Update all interno del file.ini dell applicazione) Anagrafica Unica (S_ANANEW.DAT): LiveUpdate= ( significa che il servizio Live Update è abilitato, 0 che non lo è) Modulo=ANAGRA (stabilisce il nome con cui verrà chiamata l applicazione durante l utilizzo di Live Update) FileIni=RETE-\ANAGRA\ANAGRA.ini (indica a Live Update dove risiede il file.ini) ItemIni=SETUP;Versione;AggiornamentoServer;AggiornamentoDati (indica la sezione e quali dei suoi oggetti prende in considerazione Live Update all interno del file.ini dell applicazione) La sezione SETUP dei file.ini di ogni applicazione, che si trovano all interno di [Path di rete]\[nome applicazione], indicano a Live Update qual é il numero di versione attualmente installato: [Setup] Versione=9.6 AggiornamentoServer=2 AggiornamentoLocale=2 (questa impostazione è ignorata da Live Update) Per l applicazione Anagrafica unica sarà presente la riga AggiornamentoDati in quanto prevede l esistenza di aggiornamenti per la sola parte di dati. Wolters Kluwer Italia Srl Help Desk Software Pagina 6 di 6