Elemento RetrieveImageResponse
L'elemento dell'operazione RetrieveImageResponse obbligatorio restituisce i dati di analisi al client.
Utilizzo
<wscn:RetrieveImageResponse>
child elements
</wscn:RetrieveImageResponse>
Attributi
Non ci sono attributi.
Elementi figlio
| Elemento |
|---|
| ScanData |
Elementi padre
Non ci sono elementi padre.
Commenti
Il servizio di analisi WSD deve supportare l'elemento dell'operazione RetrieveImageResponse . Il servizio di analisi invia questo elemento quando un client invia un elemento RetrieveImageRequest .
Il servizio di analisi restituisce i dati di analisi come allegato binario con il pacchetto RetrieveImageResponse . La risposta deve essere inserita in un pacchetto come tipo di contenuto MIME Multipart-Related e usare SOAP Message Transmission Optimization Mechanism [MTOM] per inviare in modo efficiente i dati dell'immagine binaria.
Il numero di immagini restituite dal servizio di analisi nel file risultante dipende dalla combinazione dell'elemento ImagesToTransfer dell'elemento ScanTicket e dell'elemento Image file Format come indicato di seguito:
- Se Format specifica un singolo formato di immagine, il file restituito conterrà sempre una singola immagine.
- Se Format specifica un formato a più pagine, il file restituito conterrà tutte le immagini che l'origine di input può analizzare fino al valore imagesToTransfer.
Se Format specifica un singolo formato di immagine e il valore di ImagesToTransfer è 0 o maggiore di 1, il client invierà elementi dell'operazione RetrieveImageRequest ripetuti finché il servizio di analisi non risponde con un errore ClientErrorNoImagesAvailable o fino a quando non viene soddisfatto il valore ImagesToTransfer .
Il servizio di analisi deve interrompere il processo con jobStateReason di ImageTransferError se si verifica un errore di comunicazione durante il trasferimento dei dati dell'immagine.
Esempio
Nell'esempio di codice seguente viene illustrato come il servizio di analisi WSD invia i dati dell'immagine al client.
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--