Before you start:
To complete this task, you must
have completed the following tasks:
Also, before you begin this task, you should note the following points:
- To create a new message definition file from an XML DTD, the DTD file
must already be present in the workbench,
for example in your message set project. This allows you to select the DTD
file in the New Message Definition File wizard.
For information on adding files to your workspace, see Importing file systems into the workbench.
- If the message set to which you are adding the new message definition
file does not have an XML wire format (XML)
layer only the logical information appears in the model. You can add the physical
layer to the message set before or after importing from a XML DTD but is recommended that you add the physical layer before importing. For information on adding a
XML wire format layer, see Adding an XML wire format.
Note that the extension to the file
must be .dtd in lower case.
The following steps cover both creating a completely new message
definition file and overwriting the contents of an existing file.
To
create a message definition from an XML DTD:
- Switch to the Broker Application Development
perspective.
- Open the New Message Definition File wizard
by clicking File > New > Message Definition File from
the workbench menu.
- In the displayed list of options, click XML DTD file to
select it then click Next.
- In the displayed list of workbench files, click the XML DTD file
that you want to import then click Next.
- In the list of message sets shown under Message sets:,
click the target message set for the message definition file that you are
creating. The Message definition file name field
is automatically filled in with a default file name based on the name of the
file that you are importing. If required, you can change the displayed default
file name to a new name of your choice.
- Optional: If you want to replace the contents of an existing message
definition file:
- Type the name of the existing file in the Message
definition file name field.
- Select the Overwrite the existing file contents without
warning check box. The existing file is overwritten
without a warning being displayed.
- Click Next. Your XML DTD
is converted into XML schema and validated.
- In the displayed list of global elements, select the check boxes
for the global elements from which you want to create messages. Use
the Select All and Deselect All buttons
at the bottom of the pane to select all global elements in the list or no
global elements in the list.
- Click Finish.
The message definition file is created from the XML DTD
and is opened in the Message Definition editor so that you can check the imported
information and make any required changes. While you are checking the newly
created message definition file, review any messages that appear in the workbench task list to see whether you need to
make any corrections to resolve errors or warnings relating to the new file.