3.1.4.9 PlayOnPhoneGreeting Operation

  • Article

The PlayOnPhoneGreeting operation initiates an outbound call to play and record a greeting over the telephone. The PlayOnPhoneGreeting operation uses the endpoint specified in [MS-OXDSCLI] section 2.2.4.1.1.2.6.47.

The following is the WSDL port type specification for the operation.

   <wsdl:operation name="PlayOnPhoneGreeting">
     <wsdl:input message="tns:PlayOnPhoneGreetingSoapIn" />
     <wsdl:output message="tns:PlayOnPhoneGreetingSoapOut" />
   </wsdl:operation>

The following is the WSDL binding specification for the operation.

 <wsdl:operation name="PlayOnPhoneGreeting">
    <soap:operation soapAction="http://schemas.microsoft.com/exchange/services/2006/messages/PlayOnPhoneGreeting" style="document"/>
    <wsdl:input>
       <soap:body use="literal"/>
    </wsdl:input>
    <wsdl:output>
       <soap:body use="literal"/>
    </wsdl:output>
 </wsdl:operation>

If the operation succeeds, a PlayOnPhoneGreetingResponse element is returned.

If the operation fails, a SOAP fault response, as specified in [SOAP1.1], is returned that contains information about the failure.

A SOAP fault is returned if the PlayOnPhoneGreeting operation specifies an invalid dial string in the DialString element. The following XML specifies the SOAP fault response that SHOULD<20> be returned if an invalid DialString element is provided as an argument to a PlayOnPhoneGreeting operation request.

 <?xml version="1.0" encoding="utf-8"?>
 <s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Body>
     <s:Fault>
       <faultcode xmlns:a="http://schemas.microsoft.com/exchange/services/2006/errors">a:DialingRulesException</faultcode>
       <faultstring xml:lang="en-US">Dialing restrictions are preventing the phone number that was entered from being dialed.</faultstring>
       <detail>
         <m:ExceptionType xmlns:m="http://schemas.microsoft.com/exchange/services/2006/messages">DialingRulesException</m:ExceptionType>
       </detail>
     </s:Fault>
   </s:Body>
 </s:Envelope>
 

The faultcode element SHOULD<21>contain a text value of "a:DialingRulesException" if an invalid dial string is sent in the request.

The faultstring element SHOULD<22> contain a text value of "Dialing restrictions are preventing the phone number that was entered from being dialed." if an invalid dial string is sent in the request.

The contents of the SOAP fault detail element are specified by the ExceptionType element, as specified in section 2.2.3.1.