Introduzione
L'attuale sistema di gestione dei manuali di Sme.UP è stato esteso per permettere ai clienti di scaricarli dalla rete internet.
Generazione e pubblicazione dei manuali
La generazione di un documento/book crea un file in formato PDF. Questo file può essere inviato in FTP su una oppure due destinazioni.
Le destinazioni FTP sono facoltative e possono essere specificate entrambe contemporaneamente.
La generazione/pubblicazione dei manuali può essere eseguita in vari modi differenti. Alla generazione/pubblicazione di un documento corrisponde una specifica richiesta (identificata da una F). Questa richiesta può essere eseguita sul client dell'utente o essere eseguita da un server Loocup. Questa richiesta può essere inserita anche in una sequenza di generazione (flusso).
Abbiamo quindi le seguenti possibilità di generare/pubblicare documenti:
- Manuale di un singolo documento
- Automatica di un singolo documento
- Manuale di tutti i book delle applicazioni
- Automatica di tutti i book delle applicazioni
Posto che la generazione automatica di un singolo documento è poco significativa, illustreremo le altre funzionalità.
Pubblicazione manuale di un singolo documento La pubblicazione dei documenti può avvenire contestualmente alla generazione oppure in una fase successiva. Se la pubblicazione è contestuale è possibile indicare due destinazioni. La prima sull'AS400A, la seconda sul server al Mix (demo.smeup.com). N.B.: la pubblicazione differita avviene solo in modalità manuale usando un client FTP.
![]() |
![]() |
![]() |
![]() |
NOTA: La generazione automatica scandisce la lista delle applicazione, poi verifica l'esistenza dei vari tipi di membri di documentazione (operativa, applicativa, tecnica, di sviluppo) e procede alla generazione/pubblicazione. Non vi è nessun controllo sulla validità del contenuto. La scelta del metodo è a totale discrezione del responsabile dei manuali, anche se di default l'opzione usata è la prima illustrata.
Consultazione dei manuali
Per consultare la documentazione il cliente deve "loggarsi" all' "Area Riservata" di www.smeup.com, accedere alla sezione "Documentazione" del sito (link nel menu principale in alto a destra) sottosezione "Manuali" e cliccare sul link a fondo pagina ("LINK PER ACCEDERE ALLA LISTA").
A questo punto l'utente può consultare e scaricare i manuali a cui è autorizzato ad accedere.
Il controllo dei documenti accessibili al cliente è effettuato dal server as400 in Smea, a cui il sito smeup.com accede con l'utente specifico WU2_SME, come mostrato dall'immagine che segue.
![]() |
Autorizzazione ai documenti
In fase di registrazione del cliente al sito di Sme.UP il server web richiede al sistema AS400 (attraverso un web service) un codice SMEUP (codice di 15 caratteri max) che sarà memorizzato assieme agli altri dati dell'utente (quelli immessi al momento della registrazione: nome, mail, P.IVA ecc).
Quando in seguito il cliente si loggherà al sito per visionare i manuali online il server invierà il suo codice SMEUP all' as400 per ottenere l' elenco dei manuali disponibili.
![]() |
Gestione autorizzazioni ai documenti in AS/400
In AS/400 le autorizzazioni sono contenute nel membro C_USR del file DOC_BOK di SMEDEV, dove:
- esiste un legame tra il dominio e-mail ed un tipo / codice soggetto: es. ..BOK.DOM Dom="smea.it" Tso="CLI" Sog="001"
- esiste un legame tra il tipo / codice soggetto e applicazioni, aree, tipi manuale a cui è autorizzato: es. ..BOK.SOG Tso="CLI" Sog="003" AutApp="**" AutAre="**" AutMan="VIS;OPE;APP;TEC"
- esiste un legame tra un indirizzo e-mail ed un tipo / codice soggetto: es. ..BOK.USR Mai="abcdflu@alice.it" Tso="CLI" Sog="003"
Procedura di accesso all'area riservata
Il flusso di registrazione/accesso è quello che segue:
![]() |
Note tecniche
I documenti sono generati tramite il componente di Loocup FRM. Il componente riceve i dati da elaborare dal servizio B£SER_22, poi richiama il motore Latex utilizzando il setup ricevuto.
Il motore latex genera un pdf che può essere salvato oppure inviato in FTP ad una delle destinazioni.
Vediamo in dettaglio la funzione che genera i documenti in Latex: F(FRM;B£SER_22;LAT.PRE) 1(MB;DOC_XXX;YYYY) P(...)
Il campo P ammette i seguenti parametri:
- Parametro Show:
- Yes: apre la finestra di gestione setup con il setup corrente
- No: non apre la finestra di gestione Setup
- Yes: apre la finestra di gestione setup con il setup corrente
- Parametro Edit:
- Yes: l'utente può modificare il setup (se presentato nel gestore)
- No: l'utente non può modificare il setup
- Yes: l'utente può modificare il setup (se presentato nel gestore)
- Parametro Sav:
- Yes o non definito: salva nella cartella
SMEA.IT\DFS_ROOT\SMEUP\SMEDOC\DOC_xxx
- No: non salva una copia del file generato
- Yes o non definito: salva nella cartella
- Tmp: salva nella cartella di installazione di LoocUp, cartella LOOCUP_TMP\DOC_xxx.
- Parametro Snd:
- Yes: invia il documento generato in FTP sul server AS400A.SMEA.IT.
- No o non definito: Non viene inviato
- Yes: invia il documento generato in FTP sul server AS400A.SMEA.IT.
- Parametro Snd2:
- Yes: invia il documento generato in FTP sul server DEMO.SMEUP.COM. NOTA: l'encoding utilizzato per l'invio dei comandi è UTF-8, pertanto solo server che implementano questa funzionalità sapranno gestire correttamente i nomi dei file se contengono caratteri non ASCII.
- No o non definito: non viene inviato
- Yes: invia il documento generato in FTP sul server DEMO.SMEUP.COM. NOTA: l'encoding utilizzato per l'invio dei comandi è UTF-8, pertanto solo server che implementano questa funzionalità sapranno gestire correttamente i nomi dei file se contengono caratteri non ASCII.
- Parametro Mod:
- BAT: specifica la modalità di generazione BATCH. Questa modalità forza i seguenti valori: Show = No, Edit = NO, Opn = No, Sav = Yes.
- Altro o non definito: vengono utilizzati i parametri passati nel P
- BAT: specifica la modalità di generazione BATCH. Questa modalità forza i seguenti valori: Show = No, Edit = NO, Opn = No, Sav = Yes.
N.B. Affinchè il file generato venga inviato via FTP è necessario che sia specificata una cartella di destinazione. Per evitare di sovrascrivere book già generati o per effettuare dei test è consigliato indicare Tmp come valore del parametro Sav.
La gestione dei file contengono caratteri non ascii (ad es. il simbolo £) richiedono che il server sia in grado di ricevere comandi in UTF-8. Questa modalità è gestita sulla seconda destinazione FTP. Sulla prima destinazione no in quanto l'AS400 non gestisce i comandi in UTF-8.
Caching dei dati
- Da Internet Explorer viene lanciata funzione richiesta manuali (con la conseguente apertura della pagina).
- La richiesta viene intercettata dal Programma Java che sottomette la Fun all'iSeries attraverso delle connessioni di tipo Looc.Up (come es. il job LO_E140607 sottosistema QBATCHUI).
- iSeries: esegue la Fun nel Job sopra indicato, mette in cache i dati (sempre nel Job) e li restituisce come XML al programma Java.
- Dalla stessa sessione di Internet Explorer o da una nuova, viene fatta la stessa richiesta fatta al punto 1 e i dati restituiti non vengono filtrati secondo le nuove autorizzazioni.
Per evitare questo meccanismo ci sono 2 modi:
- Forzo la Fun a non utilizzare la cache;
- Individuo od elimino il Job in questione sull'iSeries in modo che la richiesta fatta ne crei uno nuovo;