.. include:: vars.rst

.. _section-handling-domains:


Handling Domains
----------------

In the Domain tab, you can add all your domains and Topics. You can
organize them into Domain Libraries.

To start a new Domain Library, use the |add_library_icon| button while Domain
Libraries is selected or right-click Domain Libraries in the tree:

.. figure:: static/add_domain_library_from_tree.png
    :alt: Adding a domain library
    :name: Figure_add_domain_library_from_tree
    :align: center
    :figwidth: 90%
    :width: 393px
    :height: 181px

To add a Domain Library, enter the Library Name and the destination
file:

.. figure:: static/enter_domain_library_name.png
    :alt: Naming a domain library
    :name: Figure_enter_domain_library_name
    :align: center
    :figwidth: 90%

Then you can add a domain to the new library by using the
|add_domain_icon| button while a Domain Library is selected or by
right-clicking the Domain Library:

.. figure:: static/add_domain_from_tree.png
    :alt: Adding a domain to a library 
    :name: Figure_add_domain_from_tree
    :align: center
    :figwidth: 90%
    :width: 393px
    :height: 211px

A pop-up window will guide you to enter the Domain Name, the Domain ID,
and the destination file:

.. figure:: static/enter_domain_name.png
    :alt: Naming a domain 
    :name: Figure_enter_domain_name
    :align: center
    :figwidth: 90%

Once the domain is created, you can register types with the domain and
add a new Topic in the Structured view.

To register a new type, select |add_icon| in the 
**Registered types** table; a pop-up will allow you to choose a 
Type name, Type Reference, and Type Kind from a list:

.. figure:: static/add_registered_name.png
    :alt: Adding a registered name 
    :name: Figure_add_registered_name
    :align: center
    :figwidth: 90%

After you click **OK**, the new registered type will 
appear in the left tree and in the Registered types table:

.. figure:: static/registered_types.png
    :alt: Seeing the registered types 
    :name: Figure_registered_types
    :align: center
    :figwidth: 100%

To register a new Topic, click |add_icon| in the Topics table. 
A pop-up will open:

.. figure:: static/topic_definition.png
    :alt: Defining a Topic 
    :name: Figure_topic_definition
    :align: center
    :figwidth: 90%

Enter your topic name and select one of the available Registered type
names from the drop-down menu. 

After you click **OK**, the new topic will appear in the left tree and in
the main panel:

.. figure:: static/topics.png
    :alt: Seeing the defined Topics 
    :name: Figure_topics
    :align: center
    :figwidth: 100%

Of course, you can also see the XML definition in the XML tab:

.. figure:: static/xml_tab.png
    :alt: Seeing the XML for a Topic 
    :name: Figure_xml_tab
    :align: center
    :figwidth: 100%