WikiUp

Introduzione

Generazione e pubblicazione dei manuali

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

Autorizzazione ai documenti

Gestione autorizzazioni ai documenti in AS/400

• 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

Note tecniche

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
    
• Parametro Edit:
  
  • Yes: l'utente può modificare il setup (se presentato nel gestore)
    
  • No: l'utente non può modificare il setup
    
• 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
    
• 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
    
• 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
    
• 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
    

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

1. Da Internet Explorer viene lanciata funzione richiesta manuali (con la conseguente apertura della pagina).
   
2. 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).
   
3. iSeries: esegue la Fun nel Job sopra indicato, mette in cache i dati (sempre nel Job) e li restituisce come XML al programma Java.
   

1. 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;