In questo argomento viene descritta la procedura di creazione di una nuova definizione del messaggio da un file DTD XML utilizzando la
procedura guidata Nuovo file di definizione del messaggio del workbench.
Prima di iniziare:
Per completare tale attività, terminare le procedure riportate di seguito:
Prima di iniziare l'operazione è necessario essere a conoscenza dei punti riportati di seguito.
- Per creare un nuovo file di definizione dei messaggi da un file DTD XML, è necessario che il file DTD sia già presente nel
workbench, ad esempio nel progetto della serie di messaggi. Ciò consente di selezionare il file DTD
nella procedura guidata Nuovo file di definizione dei messaggi.
- Se la serie di messaggi alla quale si aggiunge il nuovo file di definizione dei messaggi non dispone di un livello XML Wire Format (XML), nel modello verranno visualizzate solo le informazioni logiche. E' possibile aggiungere il livello fisico alla serie di messaggi prima o dopo l'importazione di un file DTD XML ma è necessario aggiungere il livello fisico prima di
importare il file per accertarsi che contenga le impostazioni dal file DTD XML.
- E' inoltre possibile importare un file DTD XML utilizzando mqsicreatemsgdefs nella riga comandi.
- E' necessario che l'estensione di file sia .dtd, in minuscolo.
Nella procedura riportata di seguito sono trattate sia la creazione di un file di definizione dei messaggi completamente nuovo che
la sovrascrittura del contenuto di un file esistente.
Per creare una nuova definizione del messaggio da un file DTD XML, effettuare la procedura
riportata di seguito:
- Passare alla Prospettiva Sviluppo dell'applicazione
broker.
- Aprire la procedura guidata Nuovo file di definizione dei messaggi facendo clic su File > Nuovo > File di definizione dei messaggi dal menu diworkbench.
- Nell'elenco delle opzioni visualizzato fare clic su File DTD XML per selezionarlo, quindi su Avanti.
- Completare la procedura guidata compilando i campi come richiesto.
Al termine dell'importazione del file DTD XML mediante la procedura guidata, effettuare quanto segue.
- Verificare che non siano presenti errori nel prospetto creato durante l'importazione del file. E' possibile trovare tale prospetto nella directory
log all'interno del progetto che contiene la definizione del messaggio per la quale è stato effettuato il tentativo di
creazione. Il prospetto dispone di un'estensione file .dtd.report.txt, il cui prefisso è il nome specificato per il nuovo file di definizione dei messaggi.
- Esaminare i messaggi visualizzati nell'elenco delle attività del workbench
per verificare se sono state visualizzate nuove avvertenze o errori.
Il file di definizione dei messaggi viene creato dal file DTD XML e viene aperto nell'editor Definizione dei messaggi consentendo di
verificare le informazioni importate ed effettuare le modifiche richieste. Durante la verifica del nuovo file di definizione del messaggio creato,
stabilire se è necessario effettuare correzioni per risolvere errori o avvertenze relativi al nuovo file, esaminando i messaggi visualizzati
nell'elenco delle attività del workbench.