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’existe aucun attribut.

Éléments enfants

Élément
ScanTicket

Éléments parents

Il n’existe aucun élément parent.

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 dans une prochaine opération d’analyse. ScanTicket ne peut contenir que 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 WSD Scan.

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 du service d’analyse WSD. Pour plus d’informations sur la façon de signaler des erreurs, consultez WSD Scan Service Operation 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 a la valeur 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 afin que scanTicket soit 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 définis sur true provoque un conflit dans l’appareil du scanneur.
    [Détail] Aucun

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

  • Last updated on