ValidateScanTicketRequest-Element

Artikel
02/02/2024

Mit dem erforderlichen ValidateScanTicketRequest-Vorgangselement kann ein Client bestimmen, ob die Einstellungen für zukünftige Scanvorgänge gültig sind.

Verbrauch

<wscn:ValidateScanTicketRequest>
  child elements
</wscn:ValidateScanTicketRequest>

Attribute

Es gibt keine Attribute.

Untergeordnete Elemente

Element
ScanTicket

Übergeordnete Elemente

Es gibt keine übergeordneten Elemente.

Hinweise

Ein Client kann das ValidateScanTicketRequest-Element verwenden, um verschiedene Einstellungsänderungen und Kombinationen zu überprüfen.

ScanTicket enthält alle Einstellungen, die der Client in einem zukünftigen Scanvorgang übermitteln möchte. ScanTicket kann nur die Verarbeitungselemente enthalten, die der Client im Scanner überschreiben möchte, oder es kann jedes mögliche Element enthalten, das im WSD-Überprüfungsdienst unterstützt wird.

Wenn der WSD-Überprüfungsdienst ValidateScanTicketRequest erfolgreich verarbeitet, gibt er seine Validierungsinformationen in einem ValidateScanTicketResponse-Vorgang zurück. Andernfalls sollte der Überprüfungsdienst die entsprechenden Fehlercodes zurückgeben.

Dieser Vorgang kann alle gängigen Fehlercodes des WSD-Scandienstvorgangs zurückgeben. Weitere Informationen zum Melden von Fehlern finden Sie unter Fehlerberichterstattung für den WSD-Scandienst.

Dieser Vorgang gibt möglicherweise auch den folgenden Fehlercode zurück:

ClientErrorConflictingRequiredParameters

Es besteht ein Konflikt zwischen zwei oder mehr DocumentParameters-Elementen, für die jeweils das MustHonor-Attribut auf true festgelegt ist. Die Verwendung aller Einstellungen, die mit MustHonor set true bereitgestellt werden, verursacht einen Konflikt auf dem Gerät. Der Scan-Dienst kann diesen Konflikt nicht beheben, sodass das ScanTicket als ungültig eingestuft wird.

Fault-Eigenschaft	Definition
[Code]	soap:Sender
[Teilcode]	wscn:ClientErrorConflictingRequiredParameters
[Grund]	Für mehrere Elemente im DocumentParameters-Element ist MustHonor auf true festgelegt, aber das Anwenden aller Einstellungen, die auf true festgelegt sind, führt zu einem Konflikt auf dem Scannergerät.
[Detail]	Keine

Beispiele

Das folgende Codebeispiel zeigt eine Validierungsanforderung für ein gültiges Scanticket.

<?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>AddressofScannerService</wsa:To>
    <wsa:Action>
      https://schemas.microsoft.com/windows/2006/01/wdp/scan/ValidateScanTicket
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:ValidateScanTicketRequest>
      <wscn:ScanTicket>
        <wscn:JobDescription>
          <wscn:JobName>Photo Scan</wscn:JobName>
          <wscn:JobOriginatingUserName>RogerSmith</JobOriginatingUserName>
        </wscn:JobDescription>
        <wscn:DocumentParameters>
          <wscn:Format>dib</wscn:Format>
          <wscn:InputSource>Platen</wscn:InputSource>
          <wscn:ContentType>Auto</wscn:ContentType>
          <wscn:InputSize>
            <wscn:InputMediaSize>
              <wscn:Width>3000</wscn:Width>
              <wscn:Height>5000</wscn:Height>
            </wscn:InputMediaSize>
          </wscn:InputSize>
          <wscn:Scaling>
            <wscn:ScalingWidth>125</wscn:ScalingWidth>
            <wscn:ScalingHeight>125</wscn:ScalingHeight>
          </wscn:Scaling>
          <wscn:MediaSides>
            <wscn:MediaFront>
              <wscn:ColorProcessing>GrayScale4</wscn:ColorProcessing>
              <wscn:Resolution>
                <wscn:Width>300</wscn:Width>
                <wscn:Height>300</wscn:Height>
              </wscn:Resolution>
            </wscn:MediaFront>
          </wscn:MediaSides>
        </wscn:DocumentParameters>
      </wscn:ScanTicket>
    </wscn:ValidateScanTicketRequest>
  </soap:Body>
  </soap:Envelope>

Das folgende Codebeispiel zeigt eine Validierungsanforderung für ein ungültiges Scanticket.

<?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>AddressofScannerService</wsa:To>
    <wsa:Action>
      https://schemas.microsoft.com/windows/2006/01/wdp/scan/ValidateScanTicket
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:ValidateScanTicketRequest>
      <wscn:ScanTicket>
        <wscn:JobDescription>
          <wscn:JobName>Photo Scan</wscn:JobName>
          <wscn:JobOriginatingUserName>RogerSmith</JobOriginatingUserName>
        </wscn:JobDescription>
        <wscn:DocumentParameters>
          <wscn:Format>jfif</wscn:Format>
          <wscn:InputSource>Platen</wscn:InputSource>
          <wscn:ContentType>Auto</wscn:ContentType>
          <wscn:InputSize>
            <wscn:DocumentSizeAutoDetect>true</wscn:DocumentSizeAutoDetect>
          </wscn:InputSize>
          <wscn:Scaling>
            <wscn:ScalingWidth>1250</wscn:ScalingWidth>
            <wscn:ScalingHeight>1250</wscn:ScalingHeight>
          </wscn:Scaling>
          <wscn:MediaSides>
          <wscn:MediaFront>
          <wscn:Resolution>
            <wscn:Width>350</wscn:Width>
            <wscn:Height>350</wscn:Height>
          </wscn:Resolution>
          <wscn:MediaFront>
          <wscn:MediaSides>
        </wscn:DocumentParameters>
      </wscn:ScanTicket>
    </wscn:ValidateScanTicketRequest>
  </soap:Body>
</soap:Envelope>

Weitere Informationen

ScanTicket

ValidateScanTicketRequest

Freigeben über