Architecting and designing > XML schema design > The XML diagram > Definition and symbol properties > XML text entity (DTDs only)
  
XML text entity (DTDs only)
A text entity is a simple text substitution consisting of a finite sequence of characters. A text entity typically takes the form of a sequence of octets with some associated character encoding scheme, transmitted over the network or stored in a file.
A text entity is represented solely by a definition within the encyclopedia; there are no graphical symbols on a diagram that represent it.
Within DTDs, the general steps for modeling and generating a DTD for a text entity are:
1 Create the text entity and associate it to a DTD design (by specifying the name of its XML Schema within the text entity's definition).
2 Generate DTD for an XML Diagram that references the same XML Schema as the text entity.
Within BizTalk, the Element Entity is expanded in every place where it is referenced. Definition replacement must be done manually when a BizTalk file is created.
Definition properties
Text
Put the text that will be associated with the text entity in this field. Do not put quotation marks around the text: when generating a DTD, the system will put the proper quotations around the text.
Comments
Text in the Comments field will be generated into the schema file but will be formatted as shown below:
<!--your comments go here-->
Processing Instructions
Processing Instructions are passed to an application. They typically contain a declaration of the target application and whatever instructions the application needs to process the XML schema.
Description
Text in the Description field does not get generated to a DTD, but is generated to a BizTalk schema. You can enter a description of the modeling element, or its use in the schema. The description can be included in a report. By default, it is included in HTML reports.
XML Schema
Specifies one and only one schema (see What is an XML schema?) that will be used throughout the diagram, and/or the XML Schema definition that XML element and attributes are keyed to. Note that all elements and element attributes created on the diagram will default to this schema name. Attribute and element symbols can be keyed to one and only one schema. If the schema is renamed, all elements and attributes that use it will be rekeyed to the new name. “Names” can be the same as long as they are keyed to different schemas.
The attribute and element instances will use the diagram’s schema by default, however, this is not required. Element and attribute symbols using schema outside that of the diagram will display with dotted borders.
See also
Definition and symbol properties