Elemento CreateScanJobResponse
O elemento CreateScanJobResponse necessário contém a resposta do Serviço de Verificação do WSD à solicitação de verificação de um cliente.
Uso
<wscn:CreateScanJobResponse>
child elements
</wscn:CreateScanJobResponse>
Atributos
Não há atributos.
Elementos filho
Elemento |
---|
DocumentFinalParameters |
ImageInformation |
JobId |
JobToken |
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 CreateScanJobResponse .
O Serviço de Verificação do WSD envia um elemento de operação CreateScanJobResponse para o cliente em resposta a CreateScanJobRequest de um cliente.
Se o cliente tiver feito uma solicitação de verificação válida, o Serviço de Verificação do WSD deverá retornar as seguintes informações:
Um JobId exclusivo para identificar o trabalho. O scanner gera JobId de maneira definida pela implementação dentro dos intervalos definidos. O Serviço de Verificação não deve reutilizar valores que foram atribuídos recentemente para que os clientes não confundam trabalhos com trabalhos mais antigos.
Um identificador exclusivo no JobToken. JobToken é emparelhado com JobId para representar exclusivamente o trabalho de verificação. JobToken é passado para o Serviço de Verificação no elemento de operação RetrieveImageRequest para habilitar o dispositivo de verificação para verificar se o solicitante de verificação realmente criou o trabalho de verificação.
ImageInformation, que contém informações sobre os dados de imagem resultantes de uma verificação feita com o ScanTicket que está sendo validado no momento.
DocumentFinalParameters, que contém o elemento DocumentParameters real que o Serviço de Verificação usa para este trabalho de verificação.
O cliente deve recuperar os dados reais da imagem do Serviço de Verificação enviando um ou mais elementos de operação RetrieveImageRequest . O cliente tem 60 segundos para enviar um elemento de operação RetrieveImageRequest depois que o Serviço de Verificação responder ao CreateScanJobRequest do cliente. Se o Serviço de Verificação não receber um RetrieveImageRequest nesse período, ele deverá anular o trabalho com um JobStateReason de JobTimedOut. Se o trabalho consistir em vários documentos, esse tempo limite se aplicará entre cada operação de RecuperaçãoImageRequest/Resposta sucessiva.
Exemplos
O exemplo de código a seguir ilustra uma resposta do Serviço de Verificação do WSD a um 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>