Procedura dettagliata: Creazione di uno schema di file flat da un'istanza di documento
In questa procedura dettagliata viene illustrato come creare uno schema di file flat da un'istanza di documento utilizzando la Procedura guidata Schema file flat BizTalk in base all'ordine di acquisto di esempio riportato di seguito. Per un'introduzione alla Creazione guidata schema file flat BizTalk, vedere Procedura guidata per l'uso dello schema di file flat BizTalk.
Ogni riga dell'ordine di acquisto termina con caratteri di ritorno a capo e nuova riga, contrassegnato in verde. L'ordine di acquisto inizia con un tag PO visualizzato in rosso e seguito da una data. Due campi posizionali fissi ripetuti contengono le informazioni del cliente e sono visualizzate in viola. Dopo il campo del commento, è presente un campo ripetuto che inizia con un tag ITEMS contenente più record delimitati da virgole (,) e valori di dati separati da barre verticali (|), visualizzati in blu.
Prerequisiti
Prima di eseguire questa procedura dettagliata, verificare che i prodotti software seguenti siano installati e configurati nel server:
Microsoft Visual Studio
Microsoft BizTalk Server con il Strumenti di sviluppo installato
Per preparare l'istanza del documento per la procedura dettagliata, copiare il codice seguente in un editor di testo e salvarlo come file di testo. Assicurarsi di copiare tutti i feed di riga e i ritorni a capo.
PO1999-10-20
US Alice Smith 123 Maple Street Mill Valley CA 90952
US Robert Smith 8 Oak Avenue Old Town PA 95819
ITEMS,ITEM872-AA|Lawnmower|1|148.95|Confirm this is electric,ITEM926-AA|Baby Monitor|1|39.98|Confirm this is electric
Avviare la procedura guidata
In Visual Studio aprire il Esplora soluzioni.
Per aggiungere il nuovo schema di file flat, fare clic con il pulsante destro del mouse sul progetto e scegliere Aggiungi. Fare clic su Nuovo elemento.
Nella finestra Aggiungi nuovo elemento eseguire le operazioni seguenti:
Nella sezione Categorie selezionare File di schema.
Nella sezione Modelli selezionare Creazione guidata schema file flat.
Nel campo Nome immettere PurchaseOrder.xsd per il nuovo schema.
Fare clic su Aggiungi.
All'avvio della Procedura guidata Schema file flat BizTalk viene visualizzata la pagina di benvenuto.
Per ignorare questa schermata durante l'esecuzione della procedura guidata in futuro, selezionare la casella Di nuovo Non visualizzare questa pagina introduttiva . Fare clic su Avanti per continuare.
Selezione dell'istanza dell'ordine di acquisto
Nella schermata Informazioni schema file flat selezionare l'istanza e immettere le informazioni seguenti. Al termine dell'operazione, scegliere Avanti per continuare.
File istanza: fare clic sul pulsante Sfoglia per trovare il file flat da cui verrà generato lo schema. Passare alla cartella contenente il file di testo creato nella sezione Prerequisiti di Procedura dettagliata: Creazione di uno schema di file flat da un'istanza di documento.
Nome record: Digitare l'ordine di acquisto in quanto sarà il nome radice dello schema.
Spazio dei nomi di destinazione: Tipo http://Flat_File_Project.PurchaseOrder per lo spazio dei nomi di destinazione dello schema.
Tabella codici: Selezionare UTF-8 (65001) nell'elenco a discesa.
Conteggio delle posizioni in byte: Selezionare questa casella se si desidera contare i campi dati posizionale per byte. Per impostazione predefinita i campi di dati posizionali sono contati in caratteri. In questa procedura dettagliata lasciare deselezionata la casella di controllo Conteggio posizioni in byte .
Selezionare i dati degli ordini di acquisto
Nella schermata Seleziona dati del documento verrà visualizzato il contenuto del file flat. Selezionare i dati necessari per la creazione dello schema, quindi fare clic su Avanti.
Nota
Se si desidera utilizzare l'intera istanza del documento, è possibile premere CTRL+A per selezionare tutto.
Nota
Se si desidera visualizzare l'intero contenuto dell'istanza del documento di cui è stato eseguito il wrapping nella casella di modifica, selezionare La casella di riepilogo lungo la procedura guidata.
Nota
Se si crea lo schema dall'istanza di un interscambio, selezionare solo la parte che rappresenta la struttura del singolo documento.
Delimita il record degli ordini di acquisto
- Quando ogni riga dell'ordine di acquisto termina con un avanzamento riga di ritorno a capo (CRLF), selezionare Per simbolo delimitatore e quindi fare clic su Avanti nella schermata Seleziona formato record .
Specificare la proprietà del record dell'ordine di acquisto
Nella schermata Record delimitato immettere gli elementi seguenti per definire il primo livello dello schema e al termine fare clic su Avanti.
Delimitatore figlio: Selezionare {CR}{LF}.
Nota
La proprietà Delimitatore figlio è una casella modificabile con un elenco di selezione a discesa contenente un set di valori predefiniti. È possibile specificare la proprietà Delimitatore figlio come un carattere o un valore esadecimale, ad esempio, \{ o {0x0D0A}.
Carattere di escape: un carattere di escape è un singolo carattere che elimina qualsiasi significato speciale del carattere che lo segue. Per altre informazioni, vedere Caratteri di escape . Lasciarlo vuoto per la procedura dettagliata.
Nota
Quando si utilizza \, { e } per delimitatore figlio o carattere escape, è necessario usare una barra rovesciata. ad esempio \\ e \{.
Selezionare Record con una casella di identificatore di tag e digitare PO in Tag. In un file di record multipli, l'ordine di acquisto verrà usato per identificare ogni singolo record. Fare clic su Avanti per continuare.
Definire l'elemento nel record dell'ordine di acquisto
Poiché nella procedura guidata sono stati identificati quattro elementi nel record dell'ordine di acquisto, è necessario definire le proprietà degli elementi. Nella prima riga eseguire le operazioni seguenti:
Digitare la data per il nome dell'elemento.
Selezionare l'elemento Field per Tipo di elemento.
Selezionare data dall'elenco a discesa per Tipo di dati.
Ripetere i passaggi da 'a' a 'c' per gli elementi seguenti. Al termine dell'operazione, scegliere Avanti.
Nome dell'elemento Tipo di elemento Tipo di dati Cliente Record ripetuto Ignora items Record 
Nota
È possibile selezionare più righe e impostare il Tipo di elemento sullo stesso tipo usando il mouse e il tasto MAIUSC o CTRL.
Nota
Dopo aver fatto clic su Avanti nella schermata Elementi figlio non sarà possibile fare clic su Indietro per ridefinire o apportare modifiche agli elementi figlio. Potrebbe essere necessario chiudere e riavviare la procedura guidata per definire lo schema file flat.
Al termine dei passaggi di questa procedura dettagliata viene generato il primo livello dello schema, come illustrato nella schermata seguente. Sono definiti tre elementi univoci e si continuerà a definire ulteriormente gli elementi figlio degli elementi del record dell'ordine di acquisto. Fare clic su Avanti.
Definire il record del cliente
Poiché l'elemento customer è stato definito come tipo di record repeating e l'elemento items come tipo Record , la Creazione guidata schema file flat BizTalk continua ora a definire ulteriormente questi due elementi. Nella schermata Visualizzazione schema selezionare cliente e quindi fare clic su Avanti per continuare.
Per usare il record customer, è necessario selezionare i dati che rappresentano l'elemento. Poiché si tratta di un record ripetuto, è possibile usare entrambe le righe per definire il record. Selezionare la prima riga relativa ai dati del cliente e fare clic su Avanti per continuare.
Nella pagina Selezione formato record selezionare Mediante posizioni relative, quindi fare clic su Avanti.
Nella procedura guidata è disponibile uno strumento visivo che consente di visualizzare e calcolare la distanza tra i campi. Nella pagina Record posizionale utilizzare il pulsante sinistro del mouse per fare clic sul marcatore di posizione 10 per rappresentare dove inizia il campo del nome. Fare clic sugli indicatori di posizione seguenti per indicare la posizione degli altri campi di dati:
Nome campo Indicatore posizione street 30 city 50 state 65 postalcode 68 Fare clic su Avanti per continuare.
Nella pagina Elementi figlio specificare le proprietà degli elementi figlio. Selezionare la prima riga e digitare country come Nome elemento. Per le altre colonne, lasciare i valori predefiniti. Digitare i valori seguenti per le altre proprietà per Nome elemento:
Nome dell'elemento Valore customer_Child2 Fullname customer_Child3 via customer_Child4 Città customer_Child5 state customer_Child6 Postalcode Fare clic su Avanti per continuare.
Gli elementi figlio del record customer vengono creati come illustrato nella schermata seguente. Fare clic su Avanti per definire gli elementi figlio per i record "items".
Definire il record di elementi
Nella pagina Visualizzazione schema selezionare items, quindi fare clic su Avanti.
Nella pagina Seleziona dati documento selezionare l'intera riga inizia con ITEMS e quindi fare clic su Avanti per definire i relativi elementi figlio.
Nella pagina Selezione formato record selezionare Mediante simbolo delimitatore, quindi fare clic su Avanti.
Nel record Items vengono usate le virgole per delimitare i singoli elementi. Di conseguenza, nella pagina Record delimitato immettere quanto segue per definire il record items. Al termine dell'operazione, scegliere Avanti.
Selezionare , dall'elenco di selezione a discesa Delimitatore figlio.
Lasciare vuota la casella di testo Carattere escape.
Selezionare Record ha un identificatore di tag e digitare ITEMS in Tag.
In un record di più elementi , ITEMS viene usato per identificare ogni singolo record.
Usando i valori della pagina Record delimitato la procedura guidata identifica due elementi figlio. Poiché uno di essi è un record ripetuto, selezionare il primo elemento e immettere item per Nome elemento, quindi selezionare Record ripetuto dall'elenco di selezione a discesa per Tipo di elemento. Accettare i valori predefiniti nelle colonne rimanenti. Selezionare la seconda riga e selezionare Ignore dall'elenco Tipo di elemento. Quando si fa clic su Avanti, nello schema viene creato il livello successivo per il record items. Ora verrà definita la parte finale dello schema dell'ordine di acquisto.
Selezionare l'elemento e quindi fare clic su Avanti per continuare nella pagina Visualizzazione schema .
Nella pagina Selezione dati del documento selezionare ITEM872-AA|Lawnmower|1|148.95|Confirm this is electric. Fare clic su Avanti per continuare.
Nella pagina Selezione formato record selezionare l'opzione Mediante simbolo delimitatore perché il singolo elemento è delimitato da una barra verticale (|).
Nella pagina Record delimitato immettere quanto segue per definire il record item. Al termine dell'operazione, scegliere Avanti.
Selezionare | dall'elenco a discesa Delimitatore figlio .
Lasciare vuota la casella di testo Carattere escape.
Nella pagina Elementi figlio la procedura guidata ha identificato cinque elementi figlio. Selezionare la prima riga e immettere productCode per Nome elemento. Accettare i valori predefiniti nelle colonne rimanenti. Per il resto delle proprietà Nome elemento, digitare quanto segue:
Nome dell'elemento Valore item_Child2 description item_Child3 quantity item_Child4 Prezzounitario item_Child5 Note Fare clic su Avanti per continuare.
A questo punto, sono stati definiti tutti i nodi per lo schema ordine di acquisto. Nella pagina Visualizzazione schema fare clic su Fine.
È ora possibile visualizzare lo schema finale dell'ordine di acquisto. È inoltre possibile migliorare lo schema utilizzando l'Editor schemi di Microsoft BizTalk. Vedere Tabella dei nomi delle proprietà del file flat e tabelle Delle proprietà in Proprietà nodo schema. Altre informazioni su questa proprietà sono disponibili nelle linee guida dell'interfaccia utente e nelle informazioni di riferimento sullo spazio dei nomi delle API per sviluppatori.
Riepilogo
In questa procedura dettagliata si è appreso come utilizzare la Procedura guidata Schema File Flat BizTalk per creare uno schema di file flat da un'istanza di documento.
Passaggi successivi
Convalidare l'istanza dell'ordine di acquisto
Per avere la certezza che lo schema PurchaseOrder.xsd sia in grado di analizzare correttamente l'istanza dell'ordine di acquisto, eseguire le operazioni seguenti:
In Esplora soluzioni fare clic con il pulsante destro del mouse su PurchaseOrder.xsd e quindi scegliere Proprietà.
Nelle pagine delle proprietà verificare che il campo Nome file istanza di input punti alla posizione dell'istanza di ordine di acquisto creata nella sezione Prerequisiti di Procedura dettagliata: Creazione di uno schema di file flat da un'istanza di documento. Fare clic su OK per chiudere la finestra di dialogo.
In Esplora soluzioni fare clic con il pulsante destro del mouse su PurchaseOrder.xsd e quindi scegliere Convalida istanza. Verrà aperto il componente di convalida.
Al termine della convalida verrà visualizzato un collegamento che consente di visualizzare l'output XML basato sul risultato dell'analisi sull'istanza dell'ordine di acquisto mediante lo schema PurchaseOrder.xsd. Per visualizzare l'output XML, premere CTRL e fare clic sul collegamento.
Creare pipeline per lo schema
È ora possibile creare una pipeline di ricezione o di trasmissione in base allo schema PurchaseOrder.xsd da utilizzare con l'applicazione BizTalk.
Per creare una nuova pipeline, vedere Come creare una nuova pipeline. Per configurare i componenti della pipeline di file flat, vedere How to Configure the Flat File Assembler Pipeline Component e How to Configure the Flat File Disassembler Pipeline Component.
Vedere anche
Come utilizzare la Procedura guidata Schema file flat BizTalk
Creazione di schemi mediante la Procedura guidata Schema file flat BizTalk