NUMBER %ATTACHCHG%
Scopo: sostituire i file allegati ad un documento.

Descrizione: Tramite l'uso di queSta funzione è possibile eseguire una sostituzione dei file precedentemente allegati ad un documento tramite la %ATTACHADD%.
I parametri richiesti individuano il riferimento all'allegato da sostituire (id ottenuto dalla precedente operazione di %ATTACHADD%) e il nome del nuovo file, completo di percorso ed estensione, da allegare (nomefile).
L'identificativo numerico che individua una allegato dovrà essere gestito dall'applicazione, quindi andrà salvato in un opportuno attributo del documento stesso.
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.
Highway Application Server non tiene traccia di questo legame, si occupa di salvare e recuperare l'allegato individuato dall' id senza conoscere a quale documento si riferisca.
Ad operazione ultimata con esito positivo, verrà eliminato il precedente file e sarà salvata una copia di del file indicato.
I file allegati saranno salvati in un sottodirettorio dell'archivio ('<nomearchivio>/000000') all'interno del quale sarano gestiti eventuali sottodiretori.
Per quanto riguarda l'eventuale indicizzazione dei file allegati, questa deve essere gestita dall'applicazione mediante l'uso delle funzionalità offerta da Highway Imaging Control; e proprio a causa delle problematiche che si incontrano nella sostituzione del testo da indicizzare, la %ATTACHCHG% non consente la sostituzione di allegati indicizzabili.
Allo scopo è definita una impostazione nel file <nomearchivio>.ini:
[ALLEGATI]
substext=<lista suffissi nomi file>
nella quale indicare i tipi di file per i quali è consentita la sostituzione (p.e. 'gif', 'jpeg', 'jpg' ...).

Valore restituito: valore numerico
Torna 0 in caso di errore generico.
Torna 1 in caso di operazione eseguita correttamente.

Vedere anche: %ATTACHADD%, %ATTACHGET%

Esempio:
%STRING%(id, "")
<!-- prelevo il pid dall'attributo predisposto a conservare l'associazione documento-allegato, che sarà multiistanza per ovvi motivi -->
%STRCPY%(id,%ATTROW%(<nomeattributo>, <riga>))
%IF%(%ATTACHCHG%(id, "c:\App32\myapp\allegati\nuovo_allegato.jpg"))
 <!-- operazioni di scrittura sul documento del id associato all'allegato -->
%ENDIF%