Add new attachment

Only authorized users are allowed to upload new attachments.

This page (revision-1) was last changed on 01-Nov-2016 11:25 by UnknownAuthor

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Difference between version and

At line 1 added 121 lines
%%(display:none)
{{{
WikiUp
}}}
/%
[{TableOfContents }]\\
!!! £H80 Gestione file di rete\\
!!! OBIETTIVO\\
Gestire (in lettura e scrittura) file e cartelle di rete da un programma RPG\\
\\
Il percorso del file o della cartella di rete è relativo allo Sme.UP Provider a cui vengono inoltrate le operazioni da eseguire: si tratta quindi di condivisioni di rete oppure di percorsi locali relativi alla macchina su cui è installato Sme.UP Provider.\\
Gli encoding attualmente supportati per i file di testo sono:\\
* Windows (CP1252)\\
* Ascii (CP850)\\
* ISO-8859-1 (Latin 1)\\
* UTF-8\\
\\
__PREREQUISITO:__ installazione di uno Sme.UP Provider V4R1M151024 "Sydney Harbour Bridge" Stable con upgrade del 25/07/2016 o successivo.\\
Per l'installazione e la configurazione del provider si rimanda alla documentazione del modulo\\
LOCSPR.\\
Si fa riferimento in questa sede ad una configurazione importante di Sme.UP Provider: l'elenco\\
delle cartelle a cui è abilitato, definite dalla variabile PROVIDER_PATHS. La H80 potrà scrivere\\
e leggere solo in queste cartelle, e solo se le stesse sono abilitate all'UTENTE WINDOWS con cui\\
Sme.UP Provider è in esecuzione.\\
\\
__ N.B.__In lettura, file di testo con dimensione maggiore di 20/30 MB possono causare l'esaurimento della memoria disponibile della Java Virtual Machine di Sme.UP Provider e quindi originare un timeout.\\
\\
__Esempio di utilizzo: generare un file pdf con G53 e spostarlo su una cartella di rete__\\
In questo caso i passaggi saranno:\\
CONFIGURAZIONE INIZIALE\\
1- Configurare l'IFS in modo che sia visibile come condivisione Windows a Sme.UP Provider\\
2- Abilitare l'utente windows all'accesso all'ifs senza autenticazione interattiva\\
RUNTIME\\
1- Generare il file in un percorso IFS temporaneo\\
2- Lanciare la funzione di copia della H80 dal percorso IFS, in notazione \\sistema\cartella\file\\
3- Eliminare, se opportuno, il file temporaneo\\
\\
!! SIGNIFICATO DEI CAMPI DI INPUT\\
__N.B.: I campi di input vengono puliti automaticamente dopo ogni esecuzione.__\\
! FUNZIONE E METODO\\
Funzioni e metodi ricalcano quelli della £G80 per la gestione dell'IFS.\\
\\
. __*BLANKS__ Controllo esistenza\\
.. __*BLANKS__ Qualsiasi oggetto\\
. __READ__ Lettura\\
.. __FILE__ Contenuto File\\
.. __DIR__ Contenuto Directory\\
. __WRITE__ Scrittura\\
.. __FILE__ File (in append) - se non esiste crea il file\\
.. __DIR__ Directory\\
. __COPY__ Copia (con sovrascrittura)\\
.. __FILE__ File\\
.. __DIR__ Directory\\
. __DELETE__ Eliminazione\\
.. __FILE__ File\\
.. __DIR__ Directory (solo vuota)\\
. __EMPTYD__ Elimina contenuto directory\\
.. __ALL__ Tutto\\
. __CLOSE__ Chiusura\\
\\
__N.B.: La funzione COPY esegue la sovrascrittura del file se già presente. In caso di copia__ __di una cartella, sovrascrive la cartella e i file eventualmente già presenti in essa _h_contenuti.__\\
__Qualora vi siano nella cartella di destinazione file non presenti nella cartella di origine__ __essi NON vengono cancellati.__\\
\\
__£H80I_PH__= Path\\
- è il path completo del file o della cartella di rete. Il percorso è relativo allo Sme.UP provider a cui vengono inoltrate le operazioni da eseguire: si tratta quindi di condivisioni di rete oppure di percorsi locali relativi alla macchina su cui è installato Sme.UP Provider.\\
\\
__£H80I_PD__= Path destinazione\\
- è il path completo del file o della cartella di destinazione della funzione di copia. Il percorso è relativo allo Sme.UP provider a cui vengono inoltrate le operazioni da eseguire: si tratta quindi di condivisioni di rete oppure di percorsi locali relativi alla macchina su cui è installato Sme.UP Provider.\\
\\
__£H80I_DQ__= Sme.UP Provider\\
- è lo Sme.UP Provider a cui viene chiesto di eseguire l'operazione su file o cartelle. (oggetto V3LSE)\\
\\
__£H80I_ST__= Stringa\\
- è la stringa (record) da scrivere con la funzione WRITE/FILE\\
\\
__£H80I_EN__= Encoding\\
- è l'encoding del file in lettura e scrittura.\\
In scrittura se non specificato assume UTF-8 con BOM (Byte Order Mark).\\
In lettura se non specificato assume cp1252 a meno che il file non cominci con il BOM (nel cui caso riconosce UTF-8)\\
Gli encoding attualmente supportati per i file di testo sono:\\
* Windows (cp1252)\\
* Ascii (Cp850)\\
* ISO-8859-1 (Latin 1)\\
* UTF-8\\
\\
__£H80I_RL__= Lunghezza record\\
- fissa la lunghezza di un record con la funzione WRITE/FILE. Se questa non viene indicata viene assunta la lunghezza della stringa trimmata a destra passata con la WRITE\\
\\
__£H80I_EO__= Caratteri fine record\\
- fissa i caratteri che vengono aggiunti alla fine record con la funzione WRITE/FILE. Se il parametro non viene passato vengono assunti i caratteri CR/LF che identificano l'"a capo".\\
Se invece voglio che non venga aggiunto alcun carattere va passata come costante '*NONE'.\\
\\
__£H80I_AT__= Timeout Attesa\\
- attesa in secondi della risposta di Sme.UP Provider prima di andare in timeout. Se 0 assume 60 secondi.\\
\\
!! SIGNIFICATO DEI CAMPI DI OUTPUT\\
\\
__£H80O_CO__= contenuto\\
- è il contenuto dell'oggetto specificato con la funzione READ.\\
.se il metodo è FILE contiene il record del file\\
.se il metodo è DIR contiene il nome dell'oggetto contenuto nella cartella\\
\\
__£H80O_OG__= oggetto\\
- è il path completo dell'oggetto letto con la funzione READ o *blanks\\
\\
__£H80O_TO__= tipo oggetto\\
- è il tipo oggetto dell'oggetto letto con la funzione READ o *blanks (J1PATHFILE o J1PATHDIR)\\
\\
__£H80O_D2/£H80O_H2__= Data e ora della modifica del contenuto dell'oggetto\\
\\
__£H80O_SZ__= size\\
- dimensione in byte dell'oggetto restituita dalla funzione *blanks\\
\\
__£H80O_SD__= Presenza Sottocartelle\\
- Se presenti sottocartelle restituisce 1 (funzione READ/DIR)\\
\\
_h_£H80O_35= indicatore di errore\\
- impostato a '1' nei seguenti casi:\\
.oggetto non trovato (funzione *blanks)\\
.fine file/file cartella (funzione READ)\\
.errore generico (tutte le funzioni)\\
This page has only one version
«