Partilhar via

Elemento ValidateScanTicketRequest

  • Artigo

O elemento de operação ValidateScanTicketRequest necessário permite que um cliente determine se as configurações para operações de verificação futuras são válidas.

Uso

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

Atributos

Não há atributos.

Elementos filho

Elemento
ScanTicket

Elementos pai

Não há elementos pai.

Comentários

Um cliente pode usar o elemento ValidateScanTicketRequest para validar várias alterações e combinações de configuração.

ScanTicket contém todas as configurações que o cliente deseja enviar em uma operação de verificação futura. ScanTicket pode conter apenas os elementos de processamento que o cliente deseja substituir no verificador ou pode conter todos os elementos possíveis com suporte no Serviço de Verificação do WSD.

Se o Serviço de Verificação do WSD processar ValidateScanTicketRequest com êxito, ele retornará suas informações de validação em uma operação ValidateScanTicketResponse . Caso contrário, o Serviço de Verificação deverá retornar os códigos de erro apropriados.

Essa operação pode retornar todos os códigos de erro comuns de operação do Serviço de Verificação do WSD. Para obter mais informações sobre como relatar erros, consulte Relatório de erros de operação do serviço de verificação do WSD.

Essa operação também pode retornar o seguinte código de erro:

  • ClientErrorConflictingRequiredParameters

    Há um conflito entre dois ou mais elementos DocumentParameters que têm cada um o atributo MustHonor definido como true. O uso de todas as configurações fornecidas com MustHonor definido como true causa um conflito no dispositivo. O Serviço de Verificação não pode resolve esse conflito, portanto, o ScanTicket é considerado inválido.

    Propriedade Fault Definição
    [Código] soap:Sender
    [Subcódigo] wscn:ClientErrorConflictingRequiredParameters
    [Motivo] Vários elementos no elemento DocumentParameters têm MustHonor definido como true, mas aplicar todas as configurações definidas como true causa um conflito no dispositivo scanner.
    [Detalhe] Nenhum

Exemplos

O exemplo de código a seguir mostra uma solicitação de validação para um tíquete de verificação válido.

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

O exemplo de código a seguir mostra uma solicitação de validação para um tíquete de verificação inválido.

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

Confira também

ScanTicket

ValidateScanTicketRequest