Elemento CreateScanJobResponse
L'elemento CreateScanJobResponse richiesto contiene la risposta del servizio di analisi WSD alla richiesta di analisi di un client.
Utilizzo
<wscn:CreateScanJobResponse>
child elements
</wscn:CreateScanJobResponse>
Attributi
Non ci sono attributi.
Elementi figlio
Elemento |
---|
DocumentFinalParameters |
ImageInformation |
Jobid |
JobToken |
Elementi padre
Non ci sono elementi padre.
Commenti
Il servizio di analisi WSD deve supportare l'elemento dell'operazione CreateScanJobResponse .
Il servizio di analisi WSD invia un elemento dell'operazione CreateScanJobResponse al client in risposta a CreateScanJobRequest di un client.
Se il client ha effettuato una richiesta di analisi valida, il servizio di analisi WSD deve restituire le informazioni seguenti:
JobId univoco per identificare il processo. Lo scanner genera JobId in modo definito dall'implementazione all'interno degli intervalli definiti. Il servizio di analisi non deve riutilizzare i valori assegnati di recente, in modo che i client non confondono i processi con i processi meno recenti.
Identificatore univoco in JobToken. JobToken è associato a JobId per rappresentare in modo univoco il processo di analisi. JobToken viene passato al servizio di analisi nell'elemento dell'operazione RetrieveImageRequest per consentire al dispositivo di analisi di verificare che il richiedente di analisi ha effettivamente creato il processo di analisi.
ImageInformation, che contiene informazioni sui dati dell'immagine risultanti da un'analisi eseguita con ScanTicket attualmente in fase di convalida.
DocumentFinalParameters, che contiene l'elemento DocumentParameters effettivo usato dal servizio di analisi per questo processo di analisi.
Il client deve recuperare i dati effettivi dell'immagine dal servizio di analisi inviando uno o più elementi dell'operazione RetrieveImageRequest . Il client ha 60 secondi per inviare un elemento dell'operazione RetrieveImageRequest dopo che il servizio di analisi ha risposto alla richiesta CreateScanJobRequest del client. Se il servizio di analisi non riceve un oggetto RetrieveImageRequest entro questo periodo, deve interrompere il processo con JobStateReason di JobTimedOut. Se il processo è costituito da più documenti, questo timeout viene applicato tra ogni operazione RetrieveImageRequest/Response successiva.
Esempio
L'esempio di codice seguente illustra una risposta del servizio analisi WSD a una richiesta CreateScanJobRequest.
<?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: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/CreateScanJob
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:RelatesTo>uuid:MsgIdOfTheCreateScanJobRequest</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<wscn:CreateScanJobResponse>
<wscn:JobId>1</wscn:JobId>
<wscn:JobToken>Job9876TokenString</wscn:JobToken>
<wscn:ImageInformation>
<wscn:MediaFrontImageInfo>
<wscn:PixelsPerLine>900</wscn:PixelsPerLine>
<wscn:NumberOfLines>1500</wscn:NumberOfLines>
<wscn:BytesPerLine>113</wscn:BytesPerLine>
</wscn:MediaFrontImageInfo>
</wscn:ImageInformation>
<wscn:DocumentFinalParamters>
<wscn:Format>jfif</wscn:Format>
<wscn:CompressionQualityFactor>45</wscn:CompressionQualityFactor>
<wscn:ImagesToTransfer>0</wscn:ImagesToTransfer>
<wscn:InputSource>Platen</wscn:InputSource>
<wscn:ContentType>Auto</wscn:ContentType>
<wscn:InputSize>
<wscn:InputMediaSize>
<wscn:Width wscn:Override="true">8500</wscn:Width>
<wscn:Height wscn:Override="true">11000</wscn:Height>
</wscn:InputMediaSize>
</wscn:InputSize>
<wscn:Exposure>
<wscn:ExposureSettings>
<wscn:Contrast wscn:UsedDefault="true">0</wscn:Contrast>
<wscn:Brightness wscn:UsedDefault="true">0</wscn:Brightness>
<wscn:Sharpness wscn:UsedDefault="true">0</wscn:Sharpness>
</wscn:ExposureSettings>
</wscn:Exposure>
<wscn:Scaling>
<wscn:ScalingWidth>125</wscn:ScalingWidth>
<wscn:ScalingHeight>125</wscn:ScalingHeight>
</wscn:Scaling>
<wscn:Rotation wscn:UsedDefault="true">0</wscn:Rotation>
<wscn:MediaSides>
<wscn:MediaFront>
<wscn:ScanRegion>
<wscn:ScanRegionXOffset wscn:UsedDefault="true">
0
</wscn:ScanRegionXOffset>
<wscn:ScanRegionYOffset wscn:UsedDefault="true">
0
</wscn:ScanRegionYOffset>
<wscn:ScanRegionWidth wscn:UsedDefault="true">
8500
</wscn:ScanRegionWidth>
<wscn:ScanRegionHeight wscn:UsedDefault="true">
11000
</wscn:ScanRegionHeight>
</wscn:ScanRegion>
<wscn:ColorProcessing wscn:UsedDefault="true">
RGB24
</wscn:ColorProcessing>
<wscn:Resolution>
<wscn:Width>300</wscn:Width>
<wscn:Height>300</wscn:Height>
</wscn:Resolution>
</wscn:MediaFront>
</wscn:MediaSides>
</wscn:DocumentFinalParamters>
</wscn:CreateScanJobResponse>
</soap:Body>
</soap:Envelope>