Design do Server-Side
As funções do lado do servidor se comunicam com o assistente do cliente por meio do objeto windows.external. O script do lado do servidor fornece essas funções para responder a eventos do assistente e recuperar informações sobre o assistente.
Os tópicos a seguir são abordados neste documento.
-
implementando funções de script de navegação
- OnBack()
- OnNext()
- OnCancel()
- outros métodos e propriedades
- tópicos relacionados
Implementando funções de script de navegação
O script do lado do servidor em cada página HTML responde aos botões de navegação por meio de funções para OnBack, OnNexte OnCancel. Essas funções devem ser acessíveis por meio de IHTMLDocument::get_Script no cliente e não usar parâmetros.
OnBack()
- Responde quando o usuário clica em Voltar no assistente.
- Se a página atual do lado do servidor for a primeira página do lado do servidor, chame window.external.FinalBack para instruir o cliente a navegar até a página anterior do lado do cliente.
- Se a página atual do lado do servidor não for a primeira página do lado do servidor, navegue até a página anterior do lado do servidor.
- Essa função deve ser implementada para cada página. Qualquer página que não faça isso é considerada inválida e exibe uma página de erro.
OnNext()
- Responde quando o usuário clica Próximo no assistente.
- Se a página atual do lado do servidor for a última página do lado do servidor, chame window.external.FinalNext para instruir o cliente a navegar até a próxima página do lado do cliente ou concluir o assistente.
- Se a página atual do lado do servidor não for a última página do lado do servidor, navegue até a próxima página do lado do servidor.
OnCancel()
- Responde quando o usuário clica Cancelar no assistente.
- A interface do usuário deve ser projetada para que o usuário possa cancelar a qualquer momento.
- Depois que qualquer processamento na função OnCancel for processado, o cliente fechará o assistente.
Outros métodos e propriedades
As funções implementadas pelo cliente são acessadas por meio de windows.external, assim como as propriedades. Os serviços disponíveis são os seguintes:
Métodos
- SetHeaderText
- SetWizardButtons
- passportAuthenticate
Propriedades
- legenda
- propriedade
O exemplo de código a seguir mostra o código do lado do servidor para uma página de assistente simples que implementa a página de erros do serviço Web.
<html>
<head>
<script language="JavaScript">
function window.onload()
{
window.external.SetWizardButtons(1, 0, 0);
<!-- Back button enabled -->
}
function window.onback()
{
window.external.FinalBack();
}
</script>
</head>
.
.
.
</html>
Tópicos relacionados
-
registrando um de serviço