Partager via


Élément ValidateScanTicketRequest

L’élément d’opération ValidateScanTicketRequest requis permet à un client de déterminer si les paramètres des futures opérations d’analyse sont valides.

Utilisation

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

Attributs

Il n’y a pas d’attributs.

Éléments enfants

Élément
ScanTicket

Éléments parents

Il n’y a pas d’éléments parents.

Remarques

Un client peut utiliser l’élément ValidateScanTicketRequest pour valider diverses modifications et combinaisons de paramètres.

ScanTicket contient tous les paramètres que le client souhaite envoyer lors d’une prochaine opération d’analyse. ScanTicket peut contenir uniquement les éléments de traitement que le client souhaite remplacer dans le scanneur, ou il peut contenir tous les éléments possibles pris en charge dans le service d’analyse WSD.

Si le service d’analyse WSD traite correctement ValidateScanTicketRequest, il retourne ses informations de validation dans une opération ValidateScanTicketResponse . Sinon, le service d’analyse doit retourner les codes d’erreur appropriés.

Cette opération peut retourner tous les codes d’erreur courants de l’opération WSD Scan Service. Pour plus d’informations sur la façon de signaler des erreurs, consultez WSD Scan Service Error Reporting.

Cette opération peut également retourner le code d’erreur suivant :

  • ClientErrorConflictingRequiredParameters

    Il existe un conflit entre deux éléments DocumentParameters ou plus dont l’attribut MustHonor est défini sur true. L’utilisation de tous les paramètres fournis avec MustHonor set true provoque un conflit dans l’appareil. Le service d’analyse ne peut pas résoudre ce conflit, de sorte que le ScanTicket est considéré comme non valide.

    Propriété Fault Définition
    [Code] soap :Sender
    [Sous-code] wscn :ClientErrorConflictingRequiredParameters
    [Raison] Plusieurs éléments de l’élément DocumentParameters ont MustHonor défini sur true, mais l’application de tous les paramètres sur true provoque un conflit dans l’appareil scanneur.
    [Détail] None

Exemples

L’exemple de code suivant montre une demande de validation pour un ticket d’analyse valide.

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

L’exemple de code suivant montre une demande de validation pour un ticket d’analyse non valide.

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

Voir aussi

ScanTicket

ValidateScanTicketRequest