Compartilhar via

Elemento ValidateScanTicketRequest

O elemento de operação ValidateScanTicketRequest necessário permite que um cliente determine se as configurações para futuras operações de verificação 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.

Observações

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

ScanTicket contém todas as configurações que o cliente deseja enviar em uma operação de verificação futura. O ScanTicket pode conter apenas os elementos de processamento que o cliente deseja substituir no scanner 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 com êxito ValidateScanTicketRequest, 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 O Relatório de Erros da Operação de 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 cada um tem o atributo MustHonor definido como true. O uso de todas as configurações fornecidas com o conjunto MustHonor true causa um conflito no dispositivo. O Serviço de Verificação não pode resolver esse conflito, portanto, o ScanTicket é considerado inválido.

    Propriedade Fault Definição
    [Código] soap:Sender
    [Subcodificar] 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 de 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>

Consulte também

ScanTicket

  • Last updated on