Share via

3.1.4.55 GetScaledImage

  • Article

This operation is used to return a chart image.

The following is the WSDL port type specification of the GetScaledImage WSDL operation.

 <wsdl:operation name="GetScaledImage" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://schemas.microsoft.com/office/Excel/Server/WebServices/ExcelServerInternalService/ExcelServiceSoap/GetScaledImage" message="tns:ExcelServiceSoap_GetScaledImage_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://schemas.microsoft.com/office/Excel/Server/WebServices/ExcelServerInternalService/ExcelServiceSoap/GetScaledImageResponse" message="tns:ExcelServiceSoap_GetScaledImage_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/office/Excel/Server/WebServices/ExcelServerInternalService/ExcelServiceSoap/GetScaledImageExcelServerMessageFault" name="ExcelServerMessageFault" message="tns:ExcelServiceSoap_GetScaledImage_ExcelServerMessageFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends an ExcelServiceSoap_GetScaledImage_InputMessage request message, and the protocol server responds with an ExcelServiceSoap_GetScaledImage_OutputMessage response message, as follows:

  1. The protocol server MUST return a chart image as specified in the imageId element as follows:

    1. The chart image MUST have a width, in pixels, less than or equal to the value specified in the width element.

    2. The chart image MUST have a height, in pixels, less than or equal to the value specified in the height element.

    3. Either the height of the chart image, in pixels, MUST be equal to the value in the height element, or the width of the chart element, in pixels, MUST be equal to the value in the width element.

    4. If ImageRenderingOptions.KeepAspectRatio is true, the chart image MUST have the same aspect ratio as the chart image in the workbook. ImageRenderingOptions.KeepAspectRatio MUST be specified.

In the event of an application error on the protocol server during this operation, a SOAP fault is returned, as specified in section 2.2.2. The Id element of the ExcelServerMessage SHOULD<72> be one of the values specified in section 2.2.2.1.