Definizione dei nodi e delle relative proprietà

  • 6 minuti

I nodi formano la struttura di XMLports e quella del documento XML o del file di testo da cui eseguire l'importazione o verso cui eseguire l'esportazione. A ogni nodo sono associate alcune proprietà importanti a cui è possibile accedere direttamente da Visual Studio Code. Le sezioni seguenti descrivono ogni nodo e le relative proprietà.

XMLName

XMLName consente di specificare il nome del nodo XML dell'elemento o dell'attributo XML. I nomi dei nodi devono essere immessi nell'ordine in cui sono presentati nel documento XML e gli elementi padre devono precedere gli elementi figlio. Indentare i nomi dei nodi degli elementi figlio sotto i relativi elementi padre con un rientro per ogni livello. Elencare gli attributi sotto gli elementi che definiscono e indentarli a livello figlio.

TextElement, TableElement e FieldAttribute

I nodi TextElement, TableElement e FieldAttribute consentono di specificare se il nome nel tipo di origine nome del nodo rappresenta i dati dei tipi Element e Attribute. Questo tipo di origine viene usato con il tipo Data Source per specificare l'origine dati per la struttura dati.

Altre informazioni sulle opzioni relative al tipo Data Source:

  • TextElement: selezionare questa opzione quando i dati XML non possono essere mappati direttamente al database o quando il file esterno ha bisogno di informazioni che il database non richiede né contiene. Il valore del campo Text viene inserito in una variabile di testo specificata nella proprietà VariableName. Se non si specifica la proprietà XMLName, per impostazione predefinita viene usato il nome del nodo. È possibile modificare il tipo della variabile in un tipo BigText impostando la proprietà TextType su BigText.

  • TableElement: selezionare questa opzione per indicare che un nodo è mappato a una tabella. Simile all'opzione Text, consente di specificare un nome di variabile per la tabella che funziona anche come una variabile di record globale.

  • FieldAttribute: selezionare questa opzione per indicare che un nodo è mappato a una campo della tabella. Affinché questa selezione sia valida, è necessario dichiarare una tabella come elemento padre del campo. Se non si completa questa azione, la compilazione dell'oggetto XMLport non viene eseguita.

AutoSave, AutoUpdate e AutoReplace

Le proprietà AutoSave, AutoUpdate e AutoReplace del nodo descrivono il nodo XMLport che definisce la struttura di XMLport. In base al tipo di nodo, sono disponibili proprietà diverse.

Quando il tipo di nodo è impostato su Table, altre tre proprietà specificano il comportamento di XMLport durante le operazioni di importazione:

  • Salvataggio automatico: specifica se i record importati vengono scritti automaticamente nella tabella.

  • AutoUpdate: specifica se un record nel database con la stessa chiave primaria di un record nel file di importazione viene aggiornato in base ai valori del record importato. I valori dei campi del database non presenti nel file di importazione non vengono modificati da XMLport.

  • AutoReplace: specifica se i record importati sostituiscono automaticamente i record esistenti con la stessa chiave primaria. I valori dei campi del database non presenti nel file di importazione vengono ripristinati sul proprio valore iniziale in base alla proprietà InitValue.

Queste tre proprietà determinano il modo in cui vengono gestiti i record letti dal file esterno e consentono inoltre di risolvere il conflitto che si verifica quando un record letto dal file esterno durante l'importazione ha la stessa chiave primaria di un record già esistente nella tabella del database.