Share via

2.2.2.5.7 Data Model for locationPolicy provisionGroup

  • Article

The locationPolicy provisionGroup follows the behavior described in product behavior note <131>.

provisionGroup (name='locationPolicy')
     |
     |-- propertyEntryList
     |   |-- property
     |   |   |-  name

The following XSD schema fragment defines the requirements to which a locationPolicy provisionGroup element XML document SHOULD conform.

 <?xml version="1.0" encoding="utf-16"?>
 <xs:schema xmlns:tns="http://schemas.microsoft.com/2006/09/sip/provisiongrouplist-notification" targetNamespace="http://schemas.microsoft.com/2006/09/sip/provisiongrouplist-notification" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  
     <xs:complexType name="propertyEntryType">
       <xs:simpleContent>
         <xs:extension base="xs:string">
           <xs:attribute name="name" type="xs:string" use="required" />
         </xs:extension>
       </xs:simpleContent>
     </xs:complexType>
     <xs:complexType name="propertyEntryListType">
       <xs:sequence>
         <xs:element name="property" type="tns:propertyEntryType" maxOccurs="unbounded"/>
       </xs:sequence>
     </xs:complexType>
     <xs:element name="propertyEntryList" type="tns:propertyEntryListType" />
  
 </xs:schema>

EnhancedEmergencyServicesEnabled: If "true", the client acquires location information and sends PIDF-LO with an emergency call. The value MUST be "true" or "false".

LocationPolicyTagID: If this element is present, the client MUST insert this value into the PIDF-LO of every emergency call. [MS-SIPRE] section 3.17.5.2 specifies the usage of this field in detail.

LocationRequired: Triggers the client to request alternate location sources from the user if the lisInternalUrl (section 2.2.2.5.1) is not populated or the Location Information Service does not return a location. Valid values are "yes", "no", or "disclaimer".

  • "yes" – triggers the client to show an alert indicator and text about entering a location.

  • "no" – do nothing.

  • "disclaimer"– show an alert indicator and text about entering a location, and if the user clicks through then show the EmergencyServiceDisclaimer (section 2.2.2.5.7).

    UseLocationForE911Only: If "true", the location is sent only in a 911 call. The value MUST be "true" or "false".

    PstnUsage: Ignored.

    EmergencyDialString: The dial string or URI that triggers the client to send PIDF-LO and initiates the E911-related UI capability.

    EmergencyDialMask: Dial strings or URIs that, if entered by a user, are translated into the emergency dial string. If there are multiple values, they are separated by a semicolon (;). For example, a European employee, while visiting the United States, might dial 112 in an emergency and this property helps route the call correctly.

    EmergencyNumbers<132>: A string of semicolon (;) separated emergency dial string and dial mask(s) combinations. In each combination the emergency dial string and dial mask(s) are separated by a hyphen (-). To support multiple dial masks per emergency dial string, the string representing the dial mask(s) is comma (,) separated. An example of multiple emergency strings with one having a dial mask is 112-911;999.  An example of multiple emergency strings with no dial mask is 100;101;102.  An example of an emergency dial string with multiple dial masks is 911-112,100,101,102.  And finally an example of multiple emergency numbers each with a dial mask 112-911;117-100;118-101;144-102.

    When a client supports this property, it takes precedence over "EmergencyDialString" and the value specified in "EmergencyDialString" is ignored.

    NotificationUri: URIs that the emergency notification will be sent to. The notification URI MAY be one SIP URI or list of comma separated SIP URIs. Group and DL URIs are not supported.

    ConferenceUri: URI of the person or group that is conferenced-in in the emergency call.

    ConferenceMode: Toggle setting of one-way or two-way audio for an emergency conference. Valid values are "oneway" or "twoway".

    EmergencyServiceDisclaimer: Text entered by the administrator for the client to display an emergency services disclaimer if it could not fetch a location from the Location Information Service, as specified in [MS-E911WS] section 3.1.4.1.

    LocationRefreshInterval: The interval in hours for Location Information Service requests from the client.

For a detailed example, see section 4.2.2.