acge-k09 teamsystem enterprise power-i connettore ts
TRANSCRIPT
Guida Installazione
ACGE-K09 TeamSystem Enterprise
Power-I Connettore TS Analytics
ACGE-K09 TeamSystem Power-I
Connettore TS Analytics
Guida dâinstallazione
Guida Installazione
ACGE-K09 TeamSystem Enterprise Power-I Connettore TS Analytics
Prima Edizione (Settembre 2019)
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 3 di 17
Š Copyright TeamSystem S.p.A. 2019. Tutti i diritti riservati
Nota: Prima di utilizzare questo prodotto e le relative informazioni, consultare la sezione âNote e
Trademarksâ a pagina 4.
Indice Indice ............................................................................................................................... 3
Note e Trademarks .......................................................................................................... 4
Introduzione ..................................................................................................................... 6
Prerequisiti software ........................................................................................................ 7
Installazione prodotti ....................................................................................................... 8
Aggiornamento web-application acgent .................................................................................................... 8
Importazione certificato di sicurezza su WebSphere ..............................................................................10
Setup dei dati ...........................................................................................................................................12
Avviamento dellâapplicazione ........................................................................................ 13
Impostazione codice di autorizzazione allâuso del prodotto ....................................................................13
Rigenerazione albero dei menu ...............................................................................................................13
Impostazione parametri di collegamento .................................................................................................14
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 4 di 17
Note e Trademarks
Š Copyright TeamSystem S.p.A. 2019. Tutti i diritti riservati.
TeamSystem Enterprise Power-I è un marchio di TeamSystem S.p.A. società con socio unico soggetta
allâattivitĂ di direzione e coordinamento di TeamSystem Holding S.p.A. - Cap. Soc. ⏠24.000.000 i.v. -
C.C.I.A.A. di Pesaro e Urbino - P.I. 01035310414 - Sede Legale: Via Sandro Pertini, 88 - 61122 Pesaro
(PU) (di seguito âTeamSystemâ) - Tutti i diritti riservati.
I marchi e loghi riportati nel presente documento diversi da TS Enterprise Power-I (ivi inclusi, a mero titolo
esemplificativo e non esaustivo, IBM, il logo IBM, Adobe, il logo Adobe, PostScript, il logo PostScript,
Intel, il logo Intel, Intel Inside, il logo Intel Inside, Intel Centrino, il logo Intel Centrino, Celeron, Intel
Xeon, Intel SpeedStep, Itanium e Pentium, Linux, Microsoft, Windows, Windows NT e il logo di Windows,
UNIX, Java, Novell, il logo Novell, openSUSE e il logo openSUSE, AS/400, BladeCenter, Cognos, DB2,
DB2 Universal Database, eServer, i5/OS, iSeries, OpenPower, OS/400, POWER, Power Systems, pSeries,
Rational, System i, System i5, System p, System p5, System Storage, System x, WebSphere, etc.) sono di
titolaritĂ di soggetti terzi. TeamSystem rispetta i diritti di proprietĂ intellettuale di terzi.
Tutti i contenuti del presente documento e i diritti ad essi correlati sono riservati. Tali contenuti pertanto
possono essere consultati esclusivamente per finalitĂ dâinformazione personale, essendo espressamente
vietato ogni diverso utilizzo senza il preventivo consenso scritto di TeamSystem.
Sebbene sia stata usata ogni ragionevole cura nel raccogliere e presentare le informazioni contenute nel
presente documento, nessuna garanzia è prestata in ordine alla loro esattezza, completezza, utilità , nÊ ai loro
possibili impieghi da parte degli utenti; è pertanto esclusa ogni responsabilità di TeamSystem per errori,
inesattezze od omissioni relative a dette informazioni. I contenuti del presente documento sono soggetti a
continuo aggiornamento e sono da ritenersi puramente indicativi e suscettibili di eventuali errori e/o
imprecisioni.
TeamSystem può introdurre miglioramenti e/o variazioni ai prodotti e/o programmi descritti nel presente
documento in qualsiasi momento e senza preavviso.
Il presente documento può contenere informazioni che riguardano programmi e propositi futuri, che
vengono descritti di volta in volta mediante lâutilizzo di termini come "attendersi", "stimare", "prevedere",
"prospettare" e "programmare". Tali dichiarazioni per loro natura non comportano alcun impegno a carico
di TeamSystem, che pertanto non assume in relazione ad essi alcuna responsabilitĂ di realizzazione.
Qualunque riferimento a siti web diversi da www.teamsystem.com è fornito a solo titolo esemplificativo e
non costituisce invito allâutilizzo e/o navigazione. I contenuti dei siti web referenziati non sono parte dei
prodotti TeamSystem e il loro eventuale utilizzo da parte dellâutente è effettuato a suo esclusivo rischio. Le
informazioni relative a prodotti non TeamSystem contenute nel presente documento sono fornite dai
rispettivi fornitori, dagli annunci pubblicitari e da informazioni liberamente disponibili. TeamSystem non
ha collaudato tali prodotti e non può confermarne lâaccuratezza delle prestazioni, la compatibilitĂ con i
prodotti TeamSystem o qualunque altra caratteristica. Qualunque richiesta sulle caratteristiche operative
dei prodotti non TeamSystem deve essere rivolta direttamente ai rispettivi fornitori.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 5 di 17
Fatti salvi i danni causati da dolo o colpa grave, TeamSystem non assume nessuna responsabilitĂ circa i
contenuti del presente documento. In particolare, tali contenuti non rappresentano una promessa o garanzia
relativa allâidoneitĂ a determinati scopi dei prodotti TeamSystem oppure alla non violazione, da parte dei
prodotti TeamSystem stessi, di leggi di qualsivoglia natura.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 6 di 17
Introduzione
Lo scopo di questa guida è descrivere i passi di installazione del prodotto TeamSystem Enterprise
Power-I Connettore TS Analytics Versione 1 Rilascio 1 Livello di modifica 0, destinato ad
ambienti con installazione dei prodotti TeamSystem Enterprise Power-I.
Lâinstallazione del prodotto richiede preliminarmente il completamento dei passi di installazione
del prodotto ACGE-X99 Enterprise Hub aggiornato a livello ENT110022D o successivo.
Lâinstallazione del Connettore TS Analytics richiede i seguenti oggetti:
⢠TSA110.zip Contiene il modulo web da installare nella web application acgent
Per attivare le funzionalitĂ del prodotto sono richieste le seguenti operazioni:
⢠Aggiornamento della Web Application acgent
⢠Aggiornamento della base dati
⢠Avviamento dellâapplicazione.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 7 di 17
Prerequisiti software
Si fa presente che il prodotto può essere fruito allâinterno di unâapplicazione web installata su
piattaforma WebSphere con livello Java 1.7 o superiore. Diversamente lâapplicazione non è
installabile su piattaforma WebSphere a livello Java 1.6.
ACG Versione 3.8.0
Il modulo TeamSystem Enterprise Power-I Connettore TS Analytics ha come prerequisito i
prodotti ACG Versione 3.8.0 installati su sistema IBM i a livello di aggiornamento di S.O.
Versione 5.4 minimo al seguente livello di PTF:
⢠GBP80422 Gestione Archivi
⢠CA380086 Contabilità Aziendale (per KPI ambito Contabilità finanziaria escluso
Cashflow)
⢠TE380025 Tesoreria (per KPI Cashflow)
⢠FTP80592 Vendite (per KPI ambito Ciclo attivo)
⢠MGP80109 Magazzino (per KPI ambito Magazzino)
⢠AQP80139 Acquisti (per KPI ambito Ciclo passivo)
TeamSystem Enterprise Power-I
Il modulo Connettore TS Analytics ha come prerequisito il modulo ACGE-X99 Enterprise Hub
V1.1.0 a livello di ENT110023D o successiva.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 8 di 17
Installazione prodotti Il Connettore TS Analytics richiede lâinstallazione dei programmi ACG Versione 3.8.0 e
lâaggiornamento delle web application acgent
Aggiornamento web-application acgent
Lâaggiornamento della web application acgent consiste nellâapplicare le modifiche contenute nel
file TSA110.zip.
Tale aggiornamento richiede lâesecuzione dei seguenti passi:
1. Aprire la console di amministrazione di WebSphere Application Server, nel seguito
referenziato con l'acronimo WAS, digitando nella barra degli indirizzi del browser l'URL
http://ipserver:porta/ibm/console, essendo ipserver l'indirizzo IP del server su cui è
installato WAS. Immettere un identificativo utente, la password (se richiesta) e premere
Invio.
2. Dalla Home Page della console di amministrazione, fare clic sull'opzione Applicazioni
nella barra di navigazione laterale e quindi cliccare sulla voce Applicazioni Enterprise.
3. Selezionare l'applicazione installata "acgent" come in figura, premere pulsante il pulsante
Arresta.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 9 di 17
4. Selezionare nuovamente lâapplicazione acgent e premere il pulsante Aggiorna. Viene cosĂŹ
visualizzata una pagina che consente di aggiornare i file dell'applicazione distribuiti nella
cella. Ă possibile aggiornare tutta l'applicazione, un singolo modulo, un singolo file o parte
dell'applicazione.
Se un nuovo file o modulo ha lo stesso percorso relativo di un file o un modulo giĂ esistente
nellâapplicazione web, il nuovo file o modulo sostituisce quello esistente; se, invece, il
nuovo file o modulo non esiste sul server, viene aggiunto all'applicazione web 5. Nella
pagina relativa alle opzioni di aggiornamento dell'applicazione "Preparazione per
l'installazione dell'applicazione", occorre selezionare l'opzione Applicazione parziale e
specificare il percorso completo del file TSA110.zip, scegliendo l'opportuno file system
(locale o remoto) su cui risiede if file stesso. Nellâesempio, si suppone di aver salvato il
file TSA110.zip nel percorso C:\ nel caso di WAS installato su server Windows
7. Nella successiva pagina premere OK
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 10 di 17
8. Cliccare il link âSalvaâ nella pagina per salvare lâaggiornamento dellâapplicazione nella
configurazione di WAS
9. Ritornare alla pagina delle applicazioni installate e riavviare lâapplicazione web acgent
Importazione certificato di sicurezza su WebSphere
Successivamente allâinstallazione dellâapplicazione è necessario importare il certificato di
sicurezza dallâhost api.analytics.incloudts.com per la comunicazione con il portale TeamSystem
Analytics. Per effettuare queste operazioni:
1. Accedere alla console di gestione.
2. Espandere Sicurezza e fare clic su Certificato SSL e gestione chiavi. Sotto Impostazioni
della configurazione, fare clic su Gestisci configurazioni di sicurezza dell'endpoint.
3. Selezionare la configurazione in uscita appropriata per giungere all'ambito di gestione
(cella/nodo)
4. Sotto Elementi correlati, fare clic su Keystore e certificati e selezionare il keystore
NodeDefaultTrustStore.
5. Sotto Ulteriori proprietĂ , fare clic su Certificati firmatario
6. selezionare âRichiama da portaâ
7. Indicare:
- api.analytics.incloudts.com nei campi âHostâ e âAliasâ
- 443 nel campo âPortaâ
8. Fare clic su Richiama informazioni firmatario.
9. Verificare che le informazioni sul certificato siano relative ad un certificato affidabile.
10. Fare clic su Applica e Salva. Se si ricevesse l'errore "Certificate already exists in key store.
May be under a different alias name (âil certificato esiste nel Key store con un diverso
nome aliasâ), proseguire col punto 11.
11. Riavviare il WAS
Attenzione: prima di effettuare i passi descritti in questo paragrafo verificare che effettuando
dalla linea comandi del server dove è installato Websphere Application Server il comando
descritto di seguito si ottenga un IP valido e che questo IP sia raggiungibile:
Per AS400: NSLOOKUP HOSTNAME(api.analytics.incloudts.com)
Per Win/Linux: nslookup api.analytics.incloudts.com
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 11 di 17
In caso negativo controllare e modificare opportunamente le impostazioni TCP/IP del server
che ospita WAS per far sĂŹ che la verifica sopra indicata abbia esito positivo prima di proseguire
nellâesecuzione dei passi di configurazione descritti qui di seguito.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 12 di 17
Setup dei dati
La procedura di setup dei dati crea e popola, laddove previsto, le tabelle SQL di prodotto nella
libreria ACGGAA per il sistema informativo ACGGAA e nelle librerie/schemi cosiddetti âdi
gruppoâ, âcomuneâ ed âaziendaleâ dei Sistemi Informativi sui quali si intendono attivare le
funzionalitĂ del Connettore TS Analytics.
La procedura di setup per il prodotto TeamSystem Enterprise Power-I Connettore TS Analytics su
qualsiasi sistema informativo richiede preliminarmente lâesecuzione del setup per il prodotto
ACGE-X99 ACG Enterprise Hub al livello minimo ENT110022D sullo stesso sistema
informativo. Le due procedure possono essere eseguite in successione per ciascun sistema
informativo, cosÏ come è possibile aggiornare prima tutti i sistemi informativi eseguendo il setup
dei dati per Enterprise Hub e successivamente ripetendo lâoperazione per ACG Enterprise
Connettore TS Analytics.
Il setup per il prodotto Connettore TS Analytics deve essere eseguito su tutti i sistemi informativi
utilizzati, compreso ACGGAA.
Per effettuare la procedura di setup è necessario indicare i seguenti valori
⢠Acronimo TSA
⢠Versione V1R1M0
⢠PTF lasciare vuoto
⢠Sistema informativo <nome_sistema_informativo>
Terminata lâoperazione di setup, occorre arrestare e riavviare lâapplicazione web.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 13 di 17
Avviamento dellâapplicazione
Impostazione codice di autorizzazione allâuso del prodotto
Lâattivazione del prodotto Connettore Analytics richiede lâimmissione da parte
dellâamministratore del sistema del codice di autorizzazione allâuso, secondo la procedura
illustrata nella guida dâinstallazione del prodotto Enterprise Hub, indicando il codice prodotto
ACGE-K09.
Ă possibile scaricare tale codice dal sito TeamUpdate, selezionando la licenza avente:
Sigla: ACGE-K09
Descrizione: TeamSystem Enterprise Power-I Connettore TS Analytics
Rigenerazione albero dei menu
Lâoperazione di setup della base dati aggiunge una serie di codici operazione e di menu,
contrassegnati dallâarea applicativa HBP, per cui si rende necessario per ciascun utente:
- accedere allâapplicazione acgent
- eseguire lâoperazione âRicarica albero dei menuâ
- attendere la visualizzazione del messaggio di completamento dellâoperazione
- premere il pulsante OK per ricaricare il desktop.
Dopo queste operazioni, nel menu âEnterprise Hubâ comparirĂ la voce di menu âConnettore TS
Analyticsâ.
Successivamente è necessario rieseguire il setup dei menu in Polyedro.
Visualizzazione menu Crediti in Polyedro
La visualizzazione del menu Connettore TS Analytics in TeamSystem Experience richiede
lâexport dei menu come descritto nella guida di installazione di ACGE-X99 Enterprise Hub.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 14 di 17
Impostazione parametri di collegamento
La funzione di attivazione e configurazione dellâintera procedura è posizionata nel menu
âConnettore TS Analyticsâ e presuppone la presenza di una connessione internet attiva e
funzionante.
Fig. 1 â Finestra di attivazione/configurazione
Al richiamo della voce di menu Configurazione viene presentata la finestra evidenziata in figura
2. Lâattivazione è necessaria solo per la prima volta che si accede al servizio.
Fig. 2 â Finestra di attivazione/configurazione
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 15 di 17
In sede di prima attivazione dovranno essere compilati i seguenti campi:
⢠E-mail: va indicato lâindirizzo mail del sottoscrittore che diventa anche il proprietario del
servizio, assume cioè il ruolo di amministratore principale
⢠Nome: indicare il nome del sottoscrittore
⢠Cognome: indicare il cognome del sottoscrittore
Per completare lâoperazione è necessario cliccare il tasto âSalvaâ, in alternativa è possibile uscire
senza effettuare alcuna operazione tramite il tasto di chiusura finestra.
Allâatto della sottoscrizione, la funzione si connette automaticamente al servizio in cloud: questo
raccoglie i dati compilati, crea lâambiente di fruizione in coerenza con la ditta attiva in quel
momento sul gestionale e restituisce la cosiddetta chiave tecnica.
Questa viene registrata automaticamente dallâapplicazione, senza alcuna necessitĂ di intervento da
parte dellâoperatore, e verrĂ utilizzata da questa per effettuare, sempre automaticamente, la
connessione necessaria per il caricamento dei dati di sintesi elaborati al servizio in cloud per la
visualizzazione dei KPI.
La presenza di questa chiave univoca, insieme con lâutilizzo di una connessione sicura (https),
garantisce la piena protezione e riservatezza dei dati scambiati.
Fig. 3 â Visualizzazione della chiave di attivazione
Da questa form è inoltre possibile richiamare la funzione standard per la schedulazione
dellâesecuzione automatica dellâattivitĂ di estrazione, elaborazione e invio dei dati di sintesi
necessari per la visualizzazione dei KPI. Per lâutilizzo di questa funzione si rimanda al relativo
manuale.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 16 di 17
Invito ed attivazione proprietario del servizio
A seguito dellâattivazione della procedura dalla precedente funzione lato ERP, il servizio in cloud
provvederĂ a predisporre ed inviare, allâindirizzo mail associato al proprietario del servizio
dichiarato in sede di configurazione, lâinvito per il primo accesso al servizio. Il formato della mail
risulta essere quello mostrato in figura 4.
Fig. 4 â Template della mail di invito al proprietario del servizio
Cliccando il link contenuto nel tasto âAccedi a TeamSystem Analyticsâ si viene collegati alla
pagina di login del servizio.
N.B. Lâaccesso al servizio, sia per il proprietario che per gli altri utenti del servizio, richiede
obbligatoriamente lâutilizzo del TeamSystem ID.
Š Copyright TeamSystem S.p.a. Tutti i diritti riservati. Pagina 17 di 17
Questo, se non giĂ posseduto, può essere richiesto sia direttamente dal link âregistrati
gratuitamente quiâ presente nel testo della mail, che tramite la specifica funzione presente nella
pagina di login.
Fig. 5 Pagina di login al servizio TeamSystem Analytics
Vanno inseriti lâindirizzo mail e la password dichiarati in sede di registrazione al TeamSystem ID.
Nel caso non si possieda ancora alcun TeamSystem ID è possibile richiederlo direttamente da
questa pagina, utilizzando il tasto âRegistratiâ.