plcm-dial-rule-v2.xsd Documentation

Imported Namespaces

Target Namespace

Elements

plcm-dial-rule-v2  PlcmDialRuleV2

Dial rules specify how the Polycom RealPresence DMA system Call Server uses the dial string to determine where to route the call. This dial string may include an IP address, a string of numbers that begin with a prefix associated with a service, a string that begins with a country code and city code, or a string that matches a particular alias for a device. Content-Type: application/vnd.plcm.plcm-dial-rule-v2+xml. All attributes are used in ETag calculation except for entity-tag and atom-link.


Complex Types

PlcmDialRuleV2 Fields

NameTypeDescriptionAttributes
atomLinkList List of linkSee Definition of link
dial-rule-identifierxs:string The unique identifier of this dial rule. This a read-only field that is assigned by the DMA.
order-numberxs:int The order of the dial rule. If a current dial rule exists with this order, it and all existing dial rules with lower orders will be moved down by one.
dial-plan-namexs:string Name of dial plan this rule belongs to Mandatory
descriptionxs:string A description of the dial rule. Mandatory
actionxs:string The action to be performed. Some actions come with additional settings. See the choices that follow for more information. Valid values and their description are list below: BLOCK - Blocks the call RESOLVE_IP - Tries to treat the dial string as an IP address, and if it can, assumes it’s the address (and port, if included) of an unregistered endpoint. If no port is specified, it uses the default port of the signaling protocol. RESOLVE_REGISTERED_EP - Looks for a registered endpoint (active or inactive) that has the same alias or signaling address. RESOLVE_LYNC_ID - Queries an integrated Lync SIP peer for a Lync AVMCU-based conference with a matching conference ID. This dial rule action enables Polycom RealConnectTM functionality. RESOLVE_LYNC_ID_AUTO_ATTENDANT RESOLVE_SERVICE_PREFIX - Looks for a service prefix that matches the beginning of the dial string (not counting the URI scheme, if present). RESOLVE_EXT_SIP_PEER - Checks the domain of the dial string against all of the rule’s selected peers, looking for a peer proxy responsible for that domain. If the dial string matches the domain of one of the selected SIP peers, this rule will either successfully route the call, or the call will be aborted; no subsequent dial rules will be attempted. RESOLVE_EXT_POLY_EVO_PEER RESOLVE_EXT_GK - If the dial string appears to be an H.323 alias, simultaneously sends LRQ messages to all of the rule’s selected gatekeepers. RESOLVE_EXT_ADDR - Determines if the dial string is a well-formed instance of an external address type to which the rule applies, and if so, uses the resolution procedures specified in the applicable standard for that address type. RESOLVE_CONF_ROOM - Looks for a conference room (virtual meeting room, or VMR) that matches the dial string. RESOLVE_VEQ - Looks for a shared-number entry queue that matches the dial string. RESOLVE_CONTENT_SERVER - If the call is a content sharing request from Lync client, forward the call to a content server. RESOLVE_CONF_ROOM_WITH_AUTODIAL - If a dial string matches the specified format, start the conference and dialout to the designated system. Mandatory
enabledxs:boolean This allows the user to turn off a rule without deleting it. Mandatory
script-enabledxs:boolean Flag indicating that the preliminary script is enabled.
scriptxs:string An executable Javascript script that defines filtering and/or transformation actions applied to a VEQ.
relay-mediaxs:boolean If the media relay system is enabled this indicates that all calls using this dial rule to resolve should have their media relayed/hair-pinned if possible.
entity-tagEntityTag The unique value generated from the server object instance. This value is the same value that MUST be applied to the HTTP Entity Tag (ETag) header for a single instance of this object. Client modification of this field is not allowed for this instance.
override-default-conference-template-namexs:boolean This field has false value if default value is set for conference template name.
override-default-mcu-pool-order-namexs:boolean This field has false value if default value is set for MCU pool order.
override-default-first-caller-mcu-affinityxs:boolean This field has false value if default value is set for MCU selection.
conference-templatexs:string For use with the RESOLVE_LYNC_ID action: The conference template used to start the conference. If one is not specified, the Default conference template configured in Admin > Conference Manager > Conference Settings will be used. Keep in mind that the conference template must specify a Conference mode of AVC only, or the conference will not start.
mcu-pool-orderxs:string For use with the RESOLVE_LYNC_ID action: The MCU pool order to use for MCUs that provide Lync AVMCU cascade functionality. If one is not specified, the dial rule will use the default pool order configured in the Default MCU pool order field on the Admin > Conference Manager > Conference Settings page.
mcu-affinityxs:string For use with the RESOLVE_LYNC_ID action: MCU_POOL tells the DMA to prefer the MCU in the first MCU pool. CALLER_SITE tells the DMA to prefer the MCU in the first caller's site
lync-sip-peerList of xs:string For use with the RESOLVE_LYNC_ID action: External SIP Peers that are of type Microsoft and are setup to use RealConnect conferences.
external-lync-systemList of xs:string For use with the RESOLVE_LYNC_ID_AUTO_ATTENDANT action: External lync systems to use.
devices-belong-every-domainxs:boolean For use with the RESOLVE_SERVICE_PREFIX action: Prefix devices belong to every domain.
routing-policyxs:string For use with the RESOLVE_EXT_SIP_PEER action: The policy affects the way the system resolves dial strings to SIP peers: PARALLEL - The system uses all SIP peers simultaneously to try to resolve the dial string. WEIGHTED_ROUND_ROBIN - You can assign each SIP peer a weight in the range 1-100, with a higher weight giving a SIP peer higher priority; the system tries each SIP peer sequentially according to the SIP peer’s assigned weight. You can assign a SIP peer different weights in different dial rules. Mandatory
external-sip-peerList of ExternalSipPeer For use with the RESOLVE_EXT_SIP_PEER action: The list of sip peers for the dial rule to use.
external-gatekeeperList of xs:string For use with the RESOLVE_EXT_GK action: External gatekeepers to use.
ext-poly-evo-peerxs:string External Poly EVO peer to use.
use-sip-urixs:boolean For use with the RESOLVE_EXT_ADDR action: Apply this rule for SIP URI: RFCs 3261 and 3263
use-h323-url-idxs:boolean For use with the RESOLVE_EXT_ADDR action: Apply this rule for H.323 url-ID: H.323 specification, Annex O
use-h323-email-idxs:boolean For use with the RESOLVE_EXT_ADDR action: Apply this rule for H.323 Email-ID: H.225.0 specification, Appendix IV
resolve-ext-addr-override-sip-transport_enabledxs:boolean For use with the RESOLVE_EXT_ADDR action: Override inbound callers origional transport method
resolve-ext-addr-override-sip-transportResolveExtAddrOverrideSipTransport Override the SIP transport from the origional caller
resolve-conference-room-idxs:boolean For use with the RESOLVE_CONF_ROOM action: Apply this rule for conference room ids
resolve-conference-room-aliasxs:boolean For use with the RESOLVE_CONF_ROOM action: Apply this rule for conference room aliases
conf-room-autodial-dial-typeConfRoomAutodialDialType For use with the RESOLVE_CONF_ROOM_WITH_AUTODIAL action: The type of autodial that will be done. Default is URL_TOPO_H323.
conf-room-autodial-matching-typeConfRoomAutodialMatchingType For use with the RESOLVE_CONF_ROOM_WITH_AUTODIAL action: Type of dial string format being used. Values are TEAMS, GENERIC, and OTHER.
conf-room-autodial-sip-peersList of xs:string For use with the RESOLVE_CONF_ROOM_WITH_AUTODIAL action: External SIP Peers to use for conference with autodial.
conf-room-autodial-gk-peersList of xs:string For use with the RESOLVE_CONF_ROOM_WITH_AUTODIAL action: External Gatekeeper Peers to use for conference with autodial.
autodial-namexs:string For use with the RESOLVE_CONF_ROOM_WITH_AUTODIAL action: Name value to set for the auto dialed out participant or the default name, VMR-Cascade, will be selected if none is specified.
conf-room-autodial-conference-templatexs:string For use with the RESOLVE_CONF_ROOM_WITH_AUTODIAL action: The conference template used to start the conference. If one is not specified, the Default conference template configured in Admin > Conference Manager > Conference Settings will be used. Keep in mind that the conference template must specify a Conference mode of AVC only, or the conference will not start.
conf-room-autodial-mcu-pool-orderxs:string For use with the RESOLVE_CONF_ROOM_WITH_AUTODIAL action: The MCU pool order to use for MCUs that provide Lync AVMCU cascade functionality. If one is not specified, the dial rule will use the default pool order configured in the Default MCU pool order field on the Admin > Conference Manager > Conference Settings page.
conf-room-autodial-mcu-affinityxs:string For use with the RESOLVE_CONF_ROOM_WITH_AUTODIAL action: MCU_POOL tells the DMA to prefer the MCU in the first MCU pool. CALLER_SITE tells the DMA to prefer the MCU in the first caller's site
resolve-ip-override-sip-transport-enabledxs:boolean For use with the RESOLVE_EXT_ADDR action: Override inbound callers origional transport method
resolve-ip-override-sip-transportResolveIpOverrideSipTransport Override the SIP transport from the origional caller

ExternalSipPeer Fields

NameTypeDescriptionAttributes
sip-peer-namexs:string The name of the external sip peer to use. Mandatory
round-robin-weightRoundRobinWeight Used in conjunction with the WEIGHTED_ROUND_ROBIN routing policy. You can assign each SIP peer a weight in the range 1-100 , with a higher weight giving a SIP peer higher priority; the system tries each SIP peer sequentially according to the SIP peer’s assigned weight. You can assign a SIP peer different weights in different dial rules.


Simple Types


NameTypeRestrictions
EntityTagxs:string
Length of value must be >=1
Length of value must be <=64
ResolveIpOverrideSipTransportxs:string
Value must be one of:
  • UDP
  • TCP
  • TLS
  • AUTO
  • TRY_ALL
ConfRoomAutodialMatchingTypexs:string
Value must be one of:
  • TEAMS
  • GENERIC
  • OTHER
ConfRoomAutodialDialTypexs:string
Value must be one of:
  • URL_TOPO_H323
  • URL_TOPO_SIP
  • URL_TOPO_SIPS
  • SIP_PEERS
  • H323_GKS
ResolveExtAddrOverrideSipTransportxs:string
Value must be one of:
  • UDP
  • TCP
  • TLS
  • AUTO
  • TRY_ALL
RoundRobinWeightxs:int