.. include:: vars.rst

.. _section-define-participants:

Define Participants and Entities
--------------------------------

The **Participant** tab allows you to add Participants, DataReaders, and
DataWriters. You have to organize them into Participant Libraries.

To add a new Participant Library to your model, click the
|add_library_icon| button while Participant Libraries is selected or
right-click Participant Libraries in the tree and select **Add Library**:

.. figure:: static/add_participant_library_from_tab.png
    :alt: Adding a participant library  
    :name: Figure_add_participant_library_from_tab
    :align: center
    :figwidth: 50%
    :width: 402px
    :height: 197px

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

.. figure:: static/enter_participant_library_name.png
    :alt: Adding participant library details 
    :name: Figure_enter_participant_library_name
    :align: center
    :figwidth: 80%
    :width: 619px
    :height: 217px

You can then add a Participant to the newly created Library by using the
|add_participant_icon| button or by right-clicking on the 
Participant Library in the tree and selecting **Add Participant**:

.. figure:: static/add_participant_to_library.png
    :alt: Adding a participant to a library
    :name: Figure_add_participant_to_library
    :align: center
    :figwidth: 50%
    :width: 400px
    :height: 175px

A dialog will guide you to pick a name and select one of the existing
domains as the Domain Reference. You can also view and edit the QoS and
select a file where the new participant will be stored:

.. figure:: static/participant_properties.png
    :alt: Setting participant properties 
    :name: Figure_participant_properties
    :align: center
    :figwidth: 90%

Now you can configure Publications and Subscriptions in the
structured view:

.. figure:: static/configure_pubs_subs.png
    :alt: Configuring publications and subscriptions 
    :name: Figure_configure_pubs_subs
    :align: center
    :figwidth: 100%

To add a new Publisher, select the |add_participant_icon| button in the 
Publishers table. You can then select Name, Multiplicity, and 
QoS Policies in the presented dialog:

.. figure:: static/add_publisher_properties.png
    :alt: Setting publisher properties 
    :name: Figure_add_publisher_properties
    :align: center
    :figwidth: 90%

Once you click **OK**, the new Publisher will be available in the Structured
view and in the tree on the left:

.. figure:: static/new_publisher.png
    :alt: Seeing the existing publishers 
    :name: Figure_new_publisher
    :align: center
    :figwidth: 100%

Now you can add DataWriters to the selected Publisher. Use the
|add_participant_icon| button and in the pop-up window, select the topic reference, 
the name of the DataWriter, Multiplicity, and QoS:

.. figure:: static/add_datawriter_properties.png
    :alt: Setting DataWriter properties  
    :name: Figure_add_datawriter_properties
    :align: center
    :figwidth: 100%

Follow the same logic to add Subscribers and DataReaders in the
Subscriptions tab.

As always, you can see and modify the XML file directly in the XML view:

.. figure:: static/see_xml_file.png
    :alt: Seeing the resulting XML   
    :name: Figure_see_xml_file
    :align: center
    :figwidth: 100%