Configurazione di proprietà XMLport diverse
Le proprietà XMLport definiscono le caratteristiche di base dei file di input o output a cui XMLport accederà. Le proprietà dei nodi XMLport descrivono l'origine dati e definiscono il comportamento di XMLport durante le operazioni di importazione ed esportazione.
Proprietà
In genere, le proprietà XMLport descrivono XMLport. Diverse proprietà, come Direction e FileName possono essere impostate e ripristinate dinamicamente. Ad esempio, gli sviluppatori possono creare un oggetto XMLport dove l'utente può eseguire una delle seguenti azioni:
Scegliere se eseguire l'importazione o l'esportazione.
Selezionare l'origine esterna da cui leggere o su cui scrivere.
Generare automaticamente un nome di file quando viene eseguito XMLport.
La proprietà FileName può essere usata solo in un ambiente locale perché non è possibile accedere ai file locali in un ambiente software come un servizio (SaaS).
Proprietà Direction
La proprietà Direction definisce se XMLport può gestire l'importazione, l'esportazione o entrambe. Sono disponibili le seguenti opzioni proprietà:
Importa
Esporta
Entrambe
L'impostazione predefinita per la proprietà Direction è Entrambe.
La proprietà Direction definisce rigorosamente in che modo può essere usato XMLport. Se la direzione è impostata esplicitamente su Importa o Esporta, XMLport non può essere usato per gestire i documenti nella direzione opposta. Se si desidera che sia XMLport a gestire l'importazione e l'esportazione di documenti, assicurarsi che questa proprietà specifichi la direzione Entrambe.
Proprietà DefaultFieldsValidation
La proprietà DefaultFieldsValidation determina se i campi verranno convalidati durante l'importazione o assegnati. Questa impostazione può essere sovrascritta per un campo specifico specificando la proprietà FieldValidate nel campo.
Proprietà UseRequestPage
La proprietà UseRequestPage specifica se XMLport visualizzerà una pagina di richiesta con opzioni e filtri. Se questa proprietà è impostata su false, XMLport continuerà direttamente a eseguire l'importazione o l'esportazione, a seconda del valore della proprietà Direction. Se questa proprietà è impostata su Entrambe, la pagina di richiesta offrirà la possibilità di selezionare Importa o Esporta e il valore predefinito è Importa.
Trigger
I trigger sono funzioni predefinite che vengono eseguite quando si verificano determinati eventi. I corpi di queste funzioni sono inizialmente vuoti e possono essere definiti da uno sviluppatore. Scrivere codice AL nei trigger consente agli sviluppatori di modificare il comportamento predefinito del sistema.
I seguenti tipi di trigger sono specifici per XMLports:
XMLport
Nodo
Pagina di richiesta
Formato
Per quanto riguarda lo scambio di dati tra applicazioni, XML offre molti vantaggi rispetto al formato testo. I dati strutturati XML assicurano integrità, maggiore flessibilità e migliore leggibilità. Il formato XML fornisce anche estensibilità, come il collegamento di schemi per ottenere la convalida dei dati o l'applicazione di fogli di stile per trasformare i dati in una struttura XML completamente diversa.
Nonostante queste potenti funzionalità, potrebbero verificarsi situazioni in cui i dati devono essere scambiati in un formato di testo normale. Diversi sistemi legacy non supportano il formato XML o non possono gestire facilmente i dati in questo formato. Inoltre, molte applicazioni esterne, come ad esempio Microsoft Excel, possono produrre o leggere dati in formato testo. Per semplificare questo scambio, XMLports può anche esportare e importare dati in formato testo oltre al formato XML.
Sebbene le regole di formattazione del testo non siano così rigide come quelle imposte dal formato XML, i dati nei file di testo devono essere strutturati in modo tale da poter essere facilmente manipolati da un computer.
Due modi per strutturare i dati in testo normale sono:
Testo variabile
Larghezza fissa
Con il formato di testo variabile, le colonne vengono separate usando un delimitatore come una virgola, due punti o un carattere di tabulazione. Il formato a larghezza fissa richiede che ogni colonna di dati abbia una lunghezza fissa per i caratteri.
La proprietà Format di un oggetto XMLport determina il tipo di file che si desidera importare o esportare. Ha tre possibili valori:
FixedText
VariableText
XML
Proprietà per la gestione dei file di testo
Molte proprietà dell'oggetto XMLport e del nodo XMLport sono specifiche per la gestione dei file di testo:
Width: determina la larghezza del campo a larghezza fissa. Se FixedText è selezionato nella proprietà Format, tutti gli elementi e gli attributi dei tipi di testo e di campo devono avere il valore della proprietà Width impostato su maggiore di zero, altrimenti verranno generati errori di compilazione.
FieldDelimiter: determina il delimitatore di testo per un campo. Il valore predefinito è una virgoletta doppia (").
FieldSeparator: determina il separatore di campo per i campi. Il valore predefinito è una virgola (,).
RecordSeparator: determina il separatore di record per i record. Il valore predefinito è <NewLine\>.
TableSeparator: determina il separatore di tabella per le tabelle. XMLports può importare o esportare i dati da o verso diverse tabelle contemporaneamente. Le tabelle sono separate nel file dal separatore tabella. Il valore predefinito è <NewLine><NewLine\>.
Quando si usano formati di testo o a larghezza fissa, non importa se si usano elementi o attributi come i tipi di nodo. Tuttavia, è comunque necessario ordinare tutti gli attributi sopra tutti gli elementi e non si può usare più di un livello di gerarchia sotto un elemento del tipo di origine Tabella.