ValidateScanTicketRequest elemento

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.

Utilização

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

Atributos

Não há atributos.

Elementos filhos

Elemento
ScanTicket

Elementos principais

Não há elementos pai.

Observações

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

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 suportados no Serviço de Verificação WSD.

Se o Serviço de Verificação 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 deve retornar os códigos de erro apropriados.

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

Esta 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 o atributo MustHonor definido como true. Usar 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 este conflito, pelo que o ScanTicket é considerado inválido.

    Propriedade de falha Definição
    [Código] sabão:Remetente
    [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 do 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>

Ver também

ScanTicket

  • Last updated on