CreateScanJobResponse-Element

Artikel
05/03/2023

Das erforderliche CreateScanJobResponse-Element enthält die Antwort des WSD-Scandiensts auf die Scananforderung eines Clients.

Verbrauch

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

Attribute

Es gibt keine Attribute.

Untergeordnete Elemente

Element
DocumentFinalParameters
ImageInformation
Jobid
JobToken

Übergeordnete Elemente

Es gibt keine übergeordneten Elemente.

Hinweise

Der WSD-Scandienst muss das CreateScanJobResponse-Vorgangselement unterstützen.

Der WSD-Scandienst sendet ein CreateScanJobResponse-Vorgangselement als Reaktion auf die CreateScanJobRequest eines Clients an den Client.

Wenn der Client eine gültige Scananforderung gestellt hat, muss der WSD-Scandienst die folgenden Informationen zurückgeben:

Eine eindeutige JobId zum Identifizieren des Auftrags. Der Scanner generiert JobId in implementierungsdefinierter Weise innerhalb der definierten Bereiche. Der Scan-Dienst darf werte, die kürzlich zugewiesen wurden, nicht wiederverwenden, damit Clients Aufträge nicht mit älteren Aufträgen verwechseln.
Ein eindeutiger Bezeichner in JobToken. JobToken wird mit JobId gekoppelt, um den Scanauftrag eindeutig darzustellen. JobToken wird im Vorgangselement RetrieveImageRequest an den Scandienst übergeben, um das Scangerät zu aktivieren, um zu überprüfen, ob der Scan-Anforderer den Scanauftrag tatsächlich erstellt hat.
ImageInformation, das Informationen zu den resultierenden Bilddaten einer Überprüfung enthält, die mit dem ScanTicket durchgeführt wurde, das derzeit überprüft wird.
DocumentFinalParameters, das das tatsächliche DocumentParameters-Element enthält, das der Scan-Dienst für diesen Scanauftrag verwendet.

Der Client muss die tatsächlichen Bilddaten aus dem Scandienst abrufen, indem mindestens ein RetrieveImageRequest-Vorgangselement gesendet wird. Der Client hat 60 Sekunden Zeit, um ein RetrieveImageRequest-Vorgangselement zu senden, nachdem der Scan-Dienst auf die CreateScanJobRequest des Clients geantwortet hat. Wenn der Scan-Dienst innerhalb dieser Zeit keine RetrieveImageRequest empfängt, sollte er den Auftrag mit einem JobStateReason of JobTimedOut abbrechen. Wenn der Auftrag aus mehreren Dokumenten besteht, gilt dieses Timeout zwischen jedem aufeinander folgenden RetrieveImageRequest/Response-Vorgang .

Beispiele

Im folgenden Codebeispiel wird eine WSD-Scandienstantwort auf eine CreateScanJobRequest veranschaulicht.

<?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>