Configurar seu modelo de formulário para detectar o estado da conexão de um formulário

Observação:  Desejamos fornecer o conteúdo da Ajuda mais recente no seu idioma da forma mais rápida possível. Esta página foi traduzida de forma automatizada e pode conter imprecisões ou erros gramaticais. Nosso objetivo é que este conteúdo seja útil para você. As informações foram úteis? Dê sua opinião no final desta página. Aqui está o artigo em inglês para facilitar a referência.

Se você estiver criando um modelo de formulário cujos formulários dependem de uma conexão de rede para processar ou retornar dados, e você está familiarizado com a gravação de script, você pode escrever um script que detecta o estado da conexão de rede de formulários com base no seu modelo de formulário. Você pode usar este script ter o Microsoft Office InfoPath verificar se um novo formulário está conectado a uma rede e se o formulário pode se conectar a uma fonte de dados externos antes do formulário envia uma consulta para a fonte de dados externa. Este artigo fornece exemplos de Visual Basic Scripting Edition (VBScript) para determinar se baseada em formulários no seu modelo de formulário e Microsoft JScript estão conectados à rede e se esses formulários podem se conectar a uma fonte de dados externos.

Neste artigo

Visão geral

Exemplo de JScript

Exemplo do VBScript

Use o exemplo de script em um modelo de formulário

Visão geral

Para determinar o estado da conexão de rede de um formulário baseado em seu modelo de formulário, você pode usar a propriedade MachineOnlineState do objeto Application . Em seguida, você pode usar o método IsDestinationReachable do mesmo objeto aplicativo para determinar se o formulário pode encontrar a fonte de dados externa. A propriedade MachineOnlineState contém um valor que representa o estado da conexão do formulário. Essa propriedade pode ter os seguintes valores:

Valor

Descrição

0

O computador não está conectado a uma rede. A propriedade pode ter esse valor se o computador não estiver conectado a uma rede ou se a placa de rede do computador for desabilitada.

1

O computador está conectado a uma rede. Se o computador estiver conectado a uma rede usando um cabo de rede, esse valor indica que o computador está em uma rede. Se o computador tiver uma placa de rede sem fio de trabalho, esse valor indica que a placa de rede sem fio está funcionando. No entanto, o computador pode não estar conectado a uma rede sem fio.

2

O computador está conectado a uma rede, mas o Windows Internet Explorer está configurado para trabalhar offline. Quando o Internet Explorer está configurado para trabalhar offline, a conexão de dados a um banco de dados ou um serviço da Web pode não funcionar corretamente.

Após ter determinado que o computador do usuário está conectado a uma rede, você pode usar o método IsDestinationReachable para determinar se o formulário pode se comunicar com a fonte de dados externa. Este método cria o localizador de recursos uniforme (URL) ou o recurso URN (nome) da fonte de dados externos como um parâmetro e retorna um dos seguintes valores Boolianas:

True    O formulário encontrou a fonte de dados externos na rede.

Falso    O formulário não consigo encontrar a fonte de dados externa. Fonte de dados externa pode estar offline ou pode estar na rede, mas não está disponível.

Os exemplos de script neste artigo só determinam se o formulário estiver conectado à rede. Neste artigo, os exemplos de script são usados quando o usuário abre o formulário pela primeira vez. No entanto, você também pode usar esse script, sempre que você deseja verificar a conexão de rede antes de executar uma ação. Por exemplo, você pode usar este script quando um usuário clica em um determinado botão no formulário para determinar se há uma conexão de rede com a fonte de dados externos. Independentemente de quando você opta por usar esse script, você também pode adicionar script que realiza uma ação, com base em se o formulário estiver conectado à rede ou não. Por exemplo, se o computador está offline ou não consegue se conectar à fonte de dados externos, você pode ter o InfoPath exibir uma mensagem de aviso ao usuário que indica que a fonte de dados externa não está disponível. Você pode personalizar a mensagem de aviso para informar aos usuários o que fazer se a fonte de dados externa não está disponível. Por exemplo, você pode pedir que elas tente preenchendo o formulário mais tarde, ou o contato do usuário seus serviços de suporte.

Início da página

Exemplo de JScript

var machineState = Application.MachineOnlineState;
var displayMessage = machineState;
switch(machineState)
{
case 0:
{
displayMessage = "The computer is not connected to a network.";
break;
}
case 1:
{
if (!Application.IsDestinationReachable("http://example"))
{
displayMessage = "The computer is connected to a network, "
+ "but the external data source is not "
+ "available. Contact the data source "
+ "administrator for more information.";
}
else
{
displayMessage = "The computer is connected to a network.";
}
break;
}
case 2:
{
displayMessage = "The computer is connected to a network, but "
+ "Internet Explorer is in offline mode. Some "
+ "data connections may not work until you "
+ "set Internet Explorer to online mode. To "
+ "switch to online mode, on the File menu in "
+ "Internet Explorer, click Work Offline.";
break;
}
default:
{
displayMessage = "An unknown error occurred: Error: "
+ machineState;
}
}
XDocument.UI.Alert(displayMessage);

Início da página

Exemplo do VBScript

Dim machineState, displayMessage, returnValue
machineState = Application.MachineOnlineState
displayMessage = machineState
returnValue = False
Select Case machineState
Case 0
displayMessage = "The computer is not connected to a network."
Case 1
returnValue = Application.IsDestinationReachable("http://example")
If returnValue = False Then
displayMessage = "The computer is connected to a network, but "
displayMessage = displayMessage + "the external data source is "
displayMessage = displayMessage + "not available. Contact the "
displayMessage = displayMessage + "data source administrator "
displayMessage = displayMessage + "for more information."
Else
displayMessage = "The computer is connected to a network."
End If
Case 2
displayMessage = "The computer is connected to a network, but "
displayMessage = displayMessage + "Internet Explorer is in "
displayMessage = displayMessage + "offline mode. Some data "
displayMessage = displayMessage + "connections may not work "
displayMessage = displayMessage + "until you set Internet "
displayMessage = displayMessage + "Explorer to online mode. "
displayMessage = displayMessage + "To switch to online mode, "
displayMessage = displayMessage + "on the File menu in "
displayMessage = displayMessage + "Internet Explorer, click "
displayMessage = displayMessage + "Work Offline."
Case Else
displayMessage = "An unknown error occurred: Error: "
displayMessage = displayMessage + machineState + "."
End Select
XDocument.UI.Alert(displayMessage)

Início da página

Use o exemplo de script em um modelo de formulário

Se você quiser testar um exemplo de script antes de usá-lo em seu modelo de formulário, você pode usar o procedimento a seguir para criar um modelo de formulário em branco e, em seguida, copiar um dos exemplos de scripts deste artigo ao evento OnLoad . O script no evento OnLoad é executado sempre que um novo formulário baseado no modelo de formulário é criado. Em seguida, você pode visualizar seu modelo de formulário para testar o exemplo de script com o seu computador estiver conectado a uma rede, desconectado da rede ou conectado à rede, mas com o Internet Explorer definido no modo offline.

  1. Copie um dos exemplos de script listados anteriormente neste tópico e, em seguida, colá-lo em um editor de texto, como o Microsoft Notepad.

    Observação: Copiar o exemplo de script em um editor de texto antes de adicioná-lo ao seu modelo de formulário impede que o idioma da marcação de hipertexto (HTML), apareçam no script.

  2. No InfoPath, no menu arquivo, clique em Design de um modelo de formulário.

  3. Em criar um novo, na caixa de diálogo de Design de um modelo de formulário, clique em Modelo de formulário, clique em branco e, em seguida, clique em Okey.

  4. Por padrão, os novos modelos de formulário são configurados para usar JScript como a linguagem de script. Para usar VBScript como linguagem de script, altere a linguagem de script do modelo de formulário.

    Como?

    1. No menu Ferramentas, clique em Opções de formulário.

    2. Na lista categoria, clique em programação.

    3. Na lista idioma de código de modelo de formulário em linguagem de programação, clique em VBScript e clique em Okey.

  5. No menu Ferramentas, aponte para programação e clique Em evento de carga. O Editor de scripts Microsoft começa com o cursor no evento OnLoad .

  6. No evento OnLoad no Editor de scripts Microsoft, substitua o texto de ' Write your code here (VBScript) ou // Write your code here (JScript) com o exemplo de script que você copiou para o editor de texto.

  7. Modificar o exemplo de script de acordo com seu ambiente. Por exemplo, você pode modificar as mensagens e alterar http://example a URL ou URN de sua fonte de dados externos.

  8. No Editor de scripts do Microsoft, no menu arquivo, clique em Salvar.

  9. Para testar as alterações, clique Visualizar na barra de ferramentas Padrão ou pressione CTRL+SHIFT+B.

Início da página

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×