Compartilhar via


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>

Confira também

CreateScanJobRequest

DocumentFinalParameters

ImageInformation

JobId

JobStateReason

JobToken

RetrieveImageRequest