NUMBER %ATTACHADD%
Scopo: genera un identificativo
numerico unico d'archivio relativo al file indicato.
Sintassi: | |||
%NUMBER% | %ATTACHADD% | (%STRING% | *idout, |
%STRING% | nomefile[, | ||
%STRING% | modif]) |
Descrizione: consente di ottenere un
identificativo univoco, a livello d'archivio, che potrà essere utilizzato per
associare un qualsiasi tipo di file ad un documento.
idout è una variabile, che dovrà essere
dichiarata dal chiamante, che verrà valorizzata dal server
al momento della chiamata alla %ATTACHADD%.
nomefile deve contenere percorso + nomefile +
estensione (o comunque identificare in modo non ambiguo) dell'allegato che si
intende creare.
modif, opzionale, consente di indicare la directory
nella quale Highway Server salva il file specificato da
nomefile; si tratta di un un identificativo che viene
interpretato come il nome di una directory da affiancare alla directory di default
nella quale vengono tipicamente salvate le immagini / file allegati.
Verificato il valore di ritorno della funzione, che ci conferma il buon
esito dell'operazione, salvare l'idout in un apposito
attributo del documento con il quale desideriamo eseguire l'associazione
(tipicamente idout andrebbe salvato in un attributo multiistanza che consente
la gestione di più allegati).
La chiamata alla funzione con esito positivo esegue una copia del file
allegato al documento in un sottodirettorio dell'archivio con lo stesso
nome dell'archivio.
In questo sottodirettorio saranno organizzati da
Highway Application Server gli allegati.
Il file originale potrà essere rimosso.
E' necessario che un archivio sia aperto e che il documento al quale si
intende associare i/il documenti/o sia aperto in modalità inserimento o
modifica.
Valore restituito: valore numerico
Torna 0 in caso di errore generico;
Torna 1 in caso di operazione avvenuta con successo.
Vedere anche: %ATTACHCHG%, %ATTACHGET%
Esempio:
%STRING%(idAdd, "")<br>
%IF%(%ATTACHADD%(idAdd, "c:\App32\myapp\allegati\allegato1.doc"))
<!-- operazioni di salvataggio di idAdd sul documento --br>
%ENDIF%
Esempio:
salvataggio e restituzione allegati senza l'utilizzo di Highway Imaging Control