Compartilhar via

Design do Server-Side

  • Artigo

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

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, OnNext e 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 em Avançar 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 em 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

Propriedades

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

Design do lado do cliente

Registrando um serviço