Progettazione di XMLport
Progettare un XMLport significa creare la struttura del file esterno, sia esso un documento XML o un file di testo. Questo processo di progettazione prevede principalmente l'impostazione di varie proprietà negli oggetti XMLport, come le proprietà e le proprietà dei nodi di XMLport.
Un documento XML è una gerarchia ben strutturata di nodi che contengono simultaneamente i dati e descrivono la natura dei dati nel documento.
Per creare un XMLport per importare dati da un documento XML, specificare tutti i nodi XML (specificare i nomi dei nodi) e indicare il tipo di ciascuno, che rappresenti un elemento o un attributo. Eseguire il mapping di questi nodi alle strutture di dati corrispondenti (tabelle o campi) nel database di Business Central o alle variabili. Quando un oggetto XMLport viene chiamato per gestire un documento XML in ingresso, legge il flusso di dati in ingresso (ad esempio un file) ed esegue l'elaborazione e le azioni del database.
Per creare un XMLport per esportare i dati in un documento XML, costruire la struttura di nodi del documento XML ed eseguire il mapping dei dati.
Quando un oggetto XMLport viene chiamato per esportare i dati, legge i dati richiesti dal database o dalle variabili, aggiunge i nodi XML necessari per formare il documento XML e scrive il documento in un flusso di dati (ad esempio un file).
Per i documenti di questi tipi in ingresso, utilizzare il codice AL per eseguire la manipolazione del database necessaria a ottenere il risultato desiderato.
Modello di dati
Il modello dati esegue il mapping dei dati tra il documento esterno e le tabelle e i campi nel database. Il modello di dati è costituito da nodi che in genere rappresentano tabelle e campi.
I nodi del tipo Tabella specificano le tabelle da cui o in cui i dati verranno esportati o importati, inclusa qualsiasi relazione necessaria tra le tabelle. I nodi del tipo Campo specificano quali campi della tabella padre verranno inclusi nell'importazione o nell'esportazione.
Quando un XMLport viene usato per esportare i dati, ogni nodo della tabella nell'XMLport viene ripetuto per tutti i record nella tabella sottostante. È possibile impostare l'ordinamento, le chiavi e le viste della tabella per ottenere un ordinamento specifico dei dati esportati o per filtrare i set risultanti in base a criteri predefiniti.
Quando un XMLport viene usato per importare i dati, i record letti dal flusso esterno vengono inseriti nella tabella che corrisponde al nodo della tabella nell'XMLport.
È possibile esaminare i record prima di inserirli, specificare se vengono inseriti automaticamente e decidere se quelli già presenti nel database vengono sostituiti o aggiornati quando un record viene letto con la stessa chiave primaria dal file esterno. Si può anche decidere di saltare completamente i record dall'importazione.
File esterno
Il layout del file esterno viene definito impostando le proprietà, inclusa l'impostazione delle proprietà di XMLport e delle proprietà dei nodi di XMLport.
I file esterni gestiti tramite XMLports possono essere in formato XML o testo normale. In entrambi i casi, la definizione dei nodi in XMLport Designer deve corrispondere alla struttura del file esterno che viene esportato o importato.
Quando un XMLport viene usato per esportare i dati, la definizione XMLport descrive il modo in cui i campi e i record verranno mappati alla struttura del file esterno e risulteranno nel file esterno contenente la struttura esatta definita nell'XMLport. Un XMLport non può esportare più campi o informazioni di quelli specificati nella definizione dell'XMLport.
Quando un XMLport viene usato per importare i dati, la definizione dell'XMLport descrive il numero minimo di campi e, a seconda del formato dell'XMLport e della struttura del file, il file esterno potrebbe contenere più campi di quelli definiti nella definizione dell'XMLport.