routing/preamble

Article
01/20/2015

Contains specific routing rules to forward incoming calls.

<ro:preamble xmlns:ro="https://schemas.microsoft.com/2006/09/sip/routing">
    <ro:flags>...</ro:flags>
    <ro:wait>...</ro:wait>
    <ro:list>...</ro:list>
</ro:preamble>

ro:preamble-type

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

None

Child Elements

Element	Occurrence	Description
routing/preamble/flags	0 or more	Specifies the names of routing rules.
routing/preamble/list	0 or more	Specifies the targets to which incoming calls are routed according to the specified policy.
routing/preamble/wait	0 or more	Specifies the time period in which the specified routing rules are applied before the calls are forwarded to the voicemail of the called party.

Parent Elements

Element	Description
routing	The value of a routing category instance.

Text Value

None

Remarks

Microsoft Lync 2010 publishes a routing category instance to a container to enact the specified call forwarding policy on the incoming calls made by any members of the container. Unlike the publications of other presence category instances, the container members will not receive such publications of the routing category instance in subscription or query.

Example

The following XML code snippet shows a routing rule that simultaneously ring another number when an incoming call is received.

<routing xmlns="https://schemas.microsoft.com/02/2006/sip/routing" 
         name="rtcdefault" version="2" minSupportedClientVersion="2.0.0.0">
    <preamble>
       <flags name="clientflags" value="simultaneous_ring work_hours"/>
       <wait name="total" seconds="30"></wait>
       <list name="simultaneous_ring">
          <target uri="sip:+12223334444@contoso.com;user=phone"></target>
       </list>
    </preamble>
</routing>

The <flags> element specifies the action (simultaneous_ring) to be taken during the callee’s working-hours period (work_hours). The target of the forwarded call is listed under the <list> element. The <wait> element specifies the time duration the ringing will last before the call is forwarded to the voicemail.

Element Information

Namespace	https://schemas.microsoft.com/2006/09/sip/routing
Schema Name	routing
Validation File	routing.xsd
Can be Empty	True

Share via