Compartir a través de


Elemento CreateScanJobResponse

El elemento CreateScanJobResponse necesario contiene la respuesta del servicio de examen de WSD a la solicitud de examen de un cliente.

Uso

<wscn:CreateScanJobResponse>
  child elements
</wscn:CreateScanJobResponse>

Atributos

No hay atributos.

Elementos secundarios

Elemento
DocumentFinalParameters
ImageInformation
JobId
JobToken

Elementos primarios

No hay elementos primarios.

Comentarios

El servicio de examen de WSD debe admitir el elemento de operación CreateScanJobResponse .

El servicio de examen de WSD envía un elemento de operación CreateScanJobResponse al cliente en respuesta a CreateScanJobRequest de un cliente.

Si el cliente ha realizado una solicitud de examen válida, el servicio de examen de WSD debe devolver la siguiente información:

  • Un jobId único para identificar el trabajo. El analizador genera JobId de forma definida por la implementación dentro de los intervalos definidos. El servicio Scan no debe reutilizar los valores asignados recientemente para que los clientes no confundan trabajos con trabajos anteriores.

  • Identificador único en JobToken. JobToken se empareja con JobId para representar de forma única el trabajo de examen. JobToken se pasa al servicio scan en el elemento de operación RetrieveImageRequest para permitir que el dispositivo de examen compruebe que el solicitante de examen creó realmente el trabajo de examen.

  • ImageInformation, que contiene información sobre los datos de imagen resultantes de un examen realizado con scanTicket que se está validando actualmente.

  • DocumentFinalParameters, que contiene el elemento DocumentParameters real que usa el servicio scan para este trabajo de examen.

El cliente debe recuperar los datos de imagen reales del servicio scan enviando uno o varios elementos de operación RetrieveImageRequest . El cliente tiene 60 segundos para enviar un elemento de operación RetrieveImageRequest después de que el servicio scan haya respondido a CreateScanJobRequest del cliente. Si el servicio Scan no recibe retrieveImageRequest en este momento, debe anular el trabajo con un JobStateReason de JobTimedOut. Si el trabajo consta de varios documentos, este tiempo de espera se aplica entre cada operación RetrieveImageRequest/Response sucesiva.

Ejemplos

En el ejemplo de código siguiente se muestra una respuesta de WSD Scan Service a 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>

Consulte también

CreateScanJobRequest

DocumentFinalParameters

ImageInformation

JobId

JobStateReason

JobToken

RetrieveImageRequest