routing/preamble/list

Article
01/20/2015

Contains a list of the targets to which the specified call-forwarding policy is applied.

<ro:list xmlns:ro="https://schemas.microsoft.com/2006/09/sip/routing"
    name="list-names-type" >
     <target />
</ro:list>

ro:list-type

Attributes and Elements

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

Attributes

Attribute	Description
name	The name of a routing rule to be applied to this list of targets. Valid names are listed as follows: forwardto Forward calls to the contained list of targets. simultaneous_ring Simultaneous ring the contained list of targets. team The contained list of targets will receive team calls. delegates The contained list of targets is designated as the delegates of the caller. breakthrough Forward the call directly to designated delegates. first_delegate The contained list of targets is designated as the first delegate of the caller. add_voice Add voice to the contained list of targets. ControlledDevice The contained targets are a list of controlled devices.

name

The name of a routing rule to be applied to this list of targets. Valid names are listed as follows:

forwardto: Forward calls to the contained list of targets.
simultaneous_ring: Simultaneous ring the contained list of targets.
team: The contained list of targets will receive team calls.
delegates: The contained list of targets is designated as the delegates of the caller.
breakthrough: Forward the call directly to designated delegates.
first_delegate: The contained list of targets is designated as the first delegate of the caller.
add_voice: Add voice to the contained list of targets.
ControlledDevice: The contained targets are a list of controlled devices.

Child Elements

Element	Occurrence	Description
routing/preamble/list/target	0 or more	Specifies a target to which the specified routing rules are applied.

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