Sommario
Nel presente articolo viene descritto che cosa è un profilo di esportazione di un documento di Perfetto, la sua struttura, il suo utilizzo e le modalità di creazione.
Profilo di esportazione
Un profilo di esportazione è uno schema, formato da un'insieme di file xml, che contiene la struttura del documento da esportare e i parametri di esportazione.
Mediante un profilo di esportazione è possibile:
- definire le tabelle che devo essere esportate
- specificare per ogni tabella i campi da esportare
- impostare i riferimenti esterni e le loro proprietà
- definire i filtri della query di esportazione
I file che compongono un profilo di esportazione sono "Document.xml", "ExternalReferences.xml", "Field.xml" e "UserExportCriteria.xml".
Il file Document.xml contiene le informazioni relative al documento da esportare.
Nel file ExternalReferences.xml sono elencati i DBT, oggetti che rappresentano le tabelle di un documento, e gli eventuali riferimenti esterni. Nel processo di esportazione di un documento, avente dei riferimenti esterni, sono esportati anche i documenti relazionati al documento.
Nel file Field.xml sono mostrati i campi del documento da esportare. Il file è presente solo se, durante il processo di creazione del profilo di esportazione, si è deciso di esportare il documento in modo parziale.
Il file UserExportCriteria.xml contiene i criteri di filtro da applicare in fase di esportazione. Il file è presente solo se sono stati definiti i criteri di filtro in fase di creazione del profilo di esportazione.
Ogni profilo di esportazione ha associato uno schema xsd, che descrive la struttura del documento da esportare.
Che cos'è un riferimento esterno?
In Perfetto un riferimento esterno di un documento è un collegamento logico tra il documento stesso e un altro documento. Un esempio di riferimento esterno del documento Fattura di Vendita è rappresentato dal legame tra il documento Fattura e il documento Cliente, la seguente immagine mostra graficamente tale legame:
Come creare un profilo di esportazione?
Per creare un profilo di esportazione è necessario:
- accedere al prodotto Perfetto
- selezionare "Ambiente" dalla barra del Menu
- scegliere la voce "Amministrazione" dal Menu sulla sinistra
- fare click su "Configurazione Profili di Esportazione"
- scegliere l'applicazione nel riquadro a sinistra
- selezionare il modulo dalla tendina "Cerca in:" in alto
- impostare il filtro per tipologia profilo di esportazione
- scegliere il documento per il quale si vuole creare il profilo di esportazione
- premere il pulsante "Nuovo"
- inserire il nome del profilo di esportazione
- specificare il nome del file che sarà generato nel processo di esportazione
- impostare le proprietà "Postable", "PostBack" e "Escludi i Riferimenti Esterni ..." per gestire le modalità di invio e ricezione dei dati mediante Web Service
- scegliere i componenti del documenti da esportare
- impostare i parametri per la definizione degli elementi da esportare (campi, riferimenti esterni, criteri di selezione)
- selezionare i campi da esportare, se è stato deciso di dettagliare i singoli campi da esportare
- abilitare o inserire un riferimento esterno, se è stato scelto di definire o modificare i riferimenti a altri documenti
- definire i criteri di selezione, se è stato deciso di filtrare l'insieme dei dati da esportare.
I profili di esportazione possono essere creati anche dal documento, premendo il pulsante "Personalizza" e selezionando la scheda "Profili di esportazione".
Con questa modalità è possibile gestire solo i profili di esportazione per l'utente connesso.
Nota: La proprietà “Permetti invio dei dati (Postable)”, che se deselezionata non consente l’invio e il salvataggio dei dati, non ha effetto se si utilizza Magic Link.
Tipologie dei profili di esportazione
Le tipologie dei profili di esportazione sono:
- "Standard"
- "Tutti gli utenti"
- "Uno specifico utente"
I profili di esportazione "Standard" sono quelli forniti di base con il prodotto. Il percorso, dove è possibile trovare i profili di esportazione Standard, è <cartella installazione>/<nome prodotto>/Standard/ Applications/<nome applicazione>/<nome modulo>/ModuleObjects/<nome documento>/ExportProfiles.
I profili di esportazione con le altre due tipologie sono definiti profili utente. La tipologia "Tutti gli utenti" specifica che il profilo di esportazione è visibile a tutti gli utenti dell'azienda, mentre la tipologia "Uno specifico utente" definisce che il profilo è di competenza solo dell'utente specificato. Il percorso, dove è possibile trovare i profili di esportazione utente, è <cartella installazione>/<nome prodotto>/Custom/ Companies/<nome azienda>/Applications/<nome applicazione>/<nome modulo>/ModuleObjects/<nome documento>/ExportProfiles/Users/<nome utente>.
Profili di esportazione Standard di Perfetto
I profili di esportazione Standard presenti nel prodotto Perfetto sono:
- "DefaultLigh", contiene i dati minimi affinché il documento risulti consistente;
- "Default", esporta il documento escludendo le informazioni accessorie;
- "Default_SRC", definito come il profilo Default ad eccezione di riferimenti esterni non presenti;
- "DefaultFull", esporta il documento nella forma più completa;
- "DefaultFull_NR", definito come il profilo DefaultFull ad eccezione del parametro PostBack, nelle operazioni di inserimento e modifica non ritorna i valori all'applicazione esterna.
Solo il profilo di esportazione Default è contenuto in tutti i documenti esportabili.
Per comprendere meglio i dati presenti nei diversi profili di esportazione è possibile analizzare i profili di esportazione del documento Richiesta d’Offerta:
- DefaultLigh espone tutti i campi presenti in testa del documento, nella scheda "Generale" e nella scheda "Altri Dati";
- Default include tutti i valori del profilo di esportazione DefaultLigh e i campi relativi alla scheda "Fattibilità";
- DefaultFull espone tutti i campi del documento, ad eccezione dei "Riferimenti".
Commenti