Elemento ScanAvailableEvent
O elemento ScanAvailableEvent necessário informa a um cliente que um dispositivo de verificação no qual o cliente está inscrito está pronto para verificar um trabalho.
Uso
<wscn:ScanAvailableEvent>
child elements
</wscn:ScanAvailableEvent>
Atributos
Não há atributos.
Elementos filho
Elemento |
---|
ClientContext |
ScanIdentifier |
Elementos pai
Não há elementos pai.
Comentários
O Serviço de Verificação do WSD envia um elemento ScanAvailableEvent para um cliente registrado quando um usuário seleciona um destino de verificação e inicia uma verificação no dispositivo de verificação.
Um cliente deve criar uma assinatura com o Serviço de Verificação do WSD para receber eventos ScanAvailableEvent . O cliente cria uma assinatura enviando uma mensagem de solicitação para o Serviço de Verificação por meio do <elemento de operação de solicitação wse:Subscribe> .
A solicitação de assinatura contém um ou mais destinos no elemento de extensão ScanDestinations . O Serviço de Verificação usará esses destinos para filtrar para um único cliente sempre que enviar uma notificação ScanAvailableEvent . Esse filtro impede que o Serviço de Verificação notifique todos os clientes quando um usuário pressiona o botão de verificação. Os elementos de extensão são definidos no namespace do Serviço de Verificação do WSD e, em seguida, adicionados ao corpo da <solicitação wse:Subscribe> .
Se o Serviço de Verificação do WSD aceitar a solicitação do cliente para criar uma assinatura, o serviço deverá responder com um <elemento de operação de resposta wse:SubscribeResponse> . A resposta de assinatura contém uma ou mais respostas de destino no elemento de extensão DestinationResponses , que ajuda a conectar a assinatura ao dispositivo de verificação que a aceitou.
Os <elementos wse:Subscribe> e <wse:SubscribeResponse> são descritos na especificação.
Exemplos
O exemplo de código a seguir mostra como um cliente assina para receber eventos ScanAvailableEvent do Serviço de Verificação do WSD.
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
xmlns:wse="https://schemas.xmlsoap.org/ws/2004/08/eventing"
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.xmlsoap.org/ws/2004/08/eventing/Subscribe
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:ReplyTo>
<wsa:Address>https://www.example.com/MyEventSink</wsa:Address>
</wsa:ReplyTo>
</soap:Header>
<soap:Body>
<wse:Subscribe>
<wse:Delivery>
<wse:NotifyTo>
<wsa:Address>
https://www.example.com/MyEventSink/OnScanAvailableForMe
</wsa:Address>
</wse:NotifyTo>
</wse:Delivery>
<wse:Expires>P0Y0M0DT30H0M0S</wse:Expires>
<wse:Filter xmlns:wscn="https://schemas.microsoft.com/windows/2006/01/wdp/scan">
ScanAvailableEvent
</wse:Filter>
<wscn:ScanDestinations>
<wscn:ScanDestination>
<wscn:ClientDisplayString>Den Computer</wscn:ClientDisplayString>
<wscn:ClientContext>App1ScanID2345</wscn:ClientContext>
</wscn:ScanDestination>
</wscn:ScanDestinations>
</wse:Subscribe>
</soap:Body
</soap:Envelope>
O exemplo de código a seguir mostra a resposta do Serviço de Verificação do WSD à solicitação de assinatura de um cliente.
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
xmlns:wse="https://schemas.xmlsoap.org/ws/2004/08/eventing"
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>https://schemas.xmlsoap.org/ws/2003/03/addressing/role/anonymous</wsa:To>
<wsa:Action>
https://schemas.xmlsoap.org/ws/2004/08/eventing/SubscribeResponse
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:RelatesTo>uuid:MsgIdOfTheSubscribe</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<wse:SubscribeResponse>
<wse:SubscriptionManager>
<!-- Elements removed for clarity -->
</wse:SubscriptionManager>
<wse:Expires>P0Y0M0DT30H0M0S</wse:Expires>
<wscn:DestinationResponses>
<wscn:DestinationResponse>
<wscn:ClientContext>App1ScanID2345</wscn:ClientContext>
<wscn:DestinationToken>Client3478</wscn:DestinationToken>
</wscn:DestinationResponse>
</wscn:DestinationResponses>
</wse:SubscribeResponse>
</soap:Body
</soap:Envelope>
O exemplo de código a seguir mostra como o Serviço de Verificação do WSD envia um ScanAvailableEvent para um cliente.
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
xmlns:wse="https://schemas.xmlsoap.org/ws/2004/08/eventing"
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>AddressofEventSink</wsa:To>
<wsa:Action>
https://schemas.microsoft.com/windows/2006/01/wdp/scan/ScanAvailableEvent
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:ScanAvailableEvent>
<wscn:ClientContext>App1ScanID2345</wscn:ClientContext>
<wscn:ScanIdentifier>AnyUniqueIdentifierSuchAsAGUID</wscn:ScanIdentifier>
</wscn:ScanAvailableEvent>
</soap:Body
</soap:Envelope>