~~NOTOC~~
====== Sequence Diagram Window ======

There are two main elements shown in this window: device boxes on top and message snippets underneath.

Note: The position of device boxes can be locked on top when checking the option **[[projects:sdf:Menu_Settings#Pin_Devices|Pin Devices]]** in the View menu.

<WRAP center box 620px>
{{ :projects:sdf:sdf4.png?600&nolink |Device boxes}}
Device boxes
</WRAP>

<WRAP center box 620px>
{{ :projects:sdf:sdf5.png?600&nolink |Message snippets}}
Message snippets
</WRAP>

<WRAP center info 100%>
Note: The default arrangement of device boxes can be changed by clicking on the menu items **[[projects:sdf:Menu_Settings#Overview_menu|Overview]]**, **[[projects:sdf:Menu_Settings#Compact_menu|Compact]]**, or **[[projects:sdf:Menu_Settings#Wide_menu|Wide]]**.
</WRAP>


===== Device boxes =====

Device boxes are visual representations of network elements involved in  VoIP call flows and therefore automatically detected when sending and/or receiving VoIP messages. Typical VoIP devices are phones, gateways, proxies, etc.
Device boxes are unambiguously labeled by the preassigned device name, its IP address, and its MAC address. If no device name was assigned the IP address is used instead.

<WRAP center box 620px>
{{ :projects:sdf:sdf6.png?600&nolink |Name, IP address, MAC address}}
Name, IP address, MAC address
</WRAP>

By default, device boxes may appear duplicated (see example above: Load Balancer). This intended behavior simplifies the readability of the message flow, i.e. message snippets are placed exactly between two device boundaries.

<WRAP center info 100%>
Note: This behavior can be switched off when unchecking the option **[[projects:sdf:Menu_Settings#Unwind_Messages|Unwind Messages]]** in the **[[projects:sdf:Menu_Settings#View_menu|View menu]]**.
</WRAP>


===== Message snippets =====

Message snippets are simplified raw VoIP messages displayed as sequentially numbered text blocks.

<WRAP center box 620px>
{{ :projects:sdf:sdf5.png?600&nolink |Message snippets}}
Message snippets
</WRAP>

They are placed between device boundaries (vertical grid lines) in order to visualize the relationship between sending and receiving VoIP devices.

According to their chronological occurrence all message snippets are shown subsequently underneath each other.
Colored arrows inside each message snippet indicate the direction of the VoIP message flow, same colors identify messages which were sent and/or received by the same VoIP devices.

The following text fields of a message snippet are shown by default:

| {{ :projects:sdf:sdf7.png?200&nolink |Message snippet text fields}} |[Sequence Nr] MESSAGE **[[projects:sdf:Menu_Settings#Protocols|Protocol]]** |
|:::|Source **[[projects:sdf:Menu_Settings#IPs|IP]]** ==> Destination **[[projects:sdf:Menu_Settings#IPs|IP]]** |
|:::|Source **[[projects:sdf:Menu_Settings#MACs|MAC]]** ==> Destination **[[projects:sdf:Menu_Settings#MACs|MAC]]** |
|:::|**[[projects:sdf:Menu_Settings#Codecs|Codec]]
** |

<WRAP center info 100%>
Note: Text fields of message snippets can be hidden or shown using the options from the **[[projects:sdf:Menu_Settings#View_menu|View menu]]**.
</WRAP>


More detailed information can be obtained by placing the mouse over the first message snippet line which will open up a new window.

<WRAP center box 620px>
{{ :projects:sdf:sdf8.png?600&nolink |Example: SIP INVITE message with SDP header - Important message details are marked by distinct colors (feature syntax highlighting)}}
Example: SIP INVITE message with SDP header - Important message details are marked by distinct colors (feature syntax highlighting)
</WRAP>