Elemento RetrieveImageResponse
O elemento de operação RetrieveImageResponse necessário retorna os dados de verificação para o cliente.
Uso
<wscn:RetrieveImageResponse>
child elements
</wscn:RetrieveImageResponse>
Atributos
Não há atributos.
Elementos filho
| Elemento |
|---|
| ScanData |
Elementos pai
Não há elementos pai.
Comentários
O Serviço de Verificação do WSD deve dar suporte ao elemento de operação RetrieveImageResponse . O Serviço de Verificação envia esse elemento quando um cliente envia com êxito um elemento RetrieveImageRequest .
O Serviço de Verificação retorna os dados de verificação como um anexo binário com o pacote RetrieveImageResponse . A resposta deve ser empacotada como um mime Multipart-Related tipo de conteúdo e fazer uso do Mecanismo de Otimização de Transmissão de Mensagens SOAP [MTOM] para enviar com eficiência os dados de imagem binária.
O número de imagens que o Serviço de Verificação retorna no arquivo resultante depende da combinação do elemento ImagesToTransfer do elemento ScanTicket e do arquivo de imagem Format da seguinte maneira:
- Se Format especificar um único formato de imagem, o arquivo retornado sempre conterá uma única imagem.
- Se Format especificar um formato de várias páginas, o arquivo retornado conterá quantas imagens a origem de entrada puder verificar até o valor de ImagesToTransfer.
Se Format especificar um único formato de imagem e o valor de ImagesToTransfer for 0 ou maior que 1, o cliente enviará elementos de operação RetrieveImageRequest repetidos até que o Serviço de Verificação responda com uma falha ClientErrorNoImagesAvailable ou até que o valor ImagesToTransfer seja atendido.
O Serviço de Verificação deve anular o trabalho com um JobStateReason de ImageTransferError se houver um erro de comunicação durante a transferência dos dados da imagem.
Exemplos
O exemplo de código a seguir mostra como o Serviço de Verificação do WSD envia dados de imagem para o cliente.
mime-version: 1.0
Content-Type: multipart/related;
type=application/xop+xml;
boundary=4aa7d814-adc1-47a2-8e1c-07585b9892a4;
start="<14629f74-2047-436c-8046-5cac76d280fc@uuid>";
startinfo=application/soap+xml
--4aa7d814-adc1-47a2-8e1c-07585b9892a4
Content-Type: application/xop+xml; type="application/soap+xml"
charset=UTF-8
Content-Transfer-Encoding: binary
Content-ID: <14629f74-2047-436c-8046-5cac76d280fc@uuid>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2003/03/addressing"
xmlns:xop="https://www.w3.org/2003/12/xop/include"
xmlns:wscn="https://schemas.microsoft.com/windows/2006/01/wdp/scan"
soap:encodingStyle='https://www.w3.org/2002/12/soap-encoding' >
<soap:Header>
<wsa:To>https://schemas.xmlsoap.org/ws/2003/03/addressing/role/anonymous</wsa:To>
<wsa:Action>
https://schemas.microsoft.com/windows/2006/01/wdp/scan/RetrieveImage
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:RelatesTo>uuid:MsgIdOfTheRetrieveImageRequest</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<wscn:RetrieveImageResponse>
<wscn:ScanData>
<xop:Include href="cid:1c696bd7-005a-48d9-9ee9-9adca11f8892@uuid" />
</wscn:ScanData>
</wscn:RetrieveImageResponse>
</soap:Body>
</soap:Envelope>
--4aa7d814-adc1-47a2-8e1c-07585b9892a4
Content-Type: image/jpeg;
Content-Transfer-Encoding: binary
Content-ID: <1c696bd7-005a-48d9-9ee9-9adca11f8892@uuid >
Binary Scan Data
--4aa7d814-adc1-47a2-8e1c-07585b9892a4--