Personalizar um modelo de formulário utilizando um script

Neste artigo

• Descrição geral

• Considerações sobre compatibilidade

• Definir a linguagem de scripts para um modelo de formulário

• Apresentar uma mensagem de cada vez que ocorre um evento

• Adicionar um script que é executada quando um utilizador guarda os dados de formulário

• Adicionar um script que é executada quando um utilizador submete os dados de formulário

• Adicionar um script que é executada quando um utilizador clica num botão

• Adicionar um script que é executada quando são intercalados formulários existentes

• Adicionar um script para atualizar os formulários existentes

• Adicionar um script para outros eventos

Descrição Geral

Pode personalizar o seu modelo de formulário do InfoPath utilizando regras, fórmulas, a validação de dados e formatação condicional. Apesar destas funcionalidades são muito flexíveis e podem processar uma grande variedade de tarefas, algumas tarefas estão além das capacidades destas funcionalidades. Por exemplo, não é possível utilizar regras para enviar uma mensagem de correio electrónico quando um utilizador introduz um valor numa caixa de texto num formulário. Se precisar de personalizar o seu modelo de formulário de uma forma que está para além das capacidades destas funcionalidades e estiver familiarizado com os scripts utilizando a linguagem de scripts JScript ou VBScript, pode adicionar um script que é executada quando abre um novo formulário de um utilizador ou modifica um ex formulário de istente que é baseado no seu modelo de formulário.

Quando adiciona um script para um modelo de formulário, o InfoPath inicia o Microsoft Script Editor (MSE), que lhe permite adicionar, editar e depurar script num modelo de formulário e coloca o cursor no seu evento que selecionou. O InfoPath adiciona automaticamente um processador de eventos para o script. Um processador de eventos é o código de função num modelo de formulário do InfoPath que responde a uma acção do utilizador ou uma alteração aos dados XML de um formulário. Por exemplo, se pretender que os utilizadores para guardar os seus formulários a várias localizações de rede, pode adicionar um script para processador de eventos OnSaveRequest . Quando adiciona um script para ser executada quando o utilizador guarda um formulário baseado no seu modelo de formulário, o InfoPath inicia o editor de scripts e adiciona um dos seguintes códigos para o script.

//=======
// The following function handler is created by Microsoft Office InfoPath.
// Do not modify the name of the function, or the name and number of arguments.
//=======
function XDocument::OnSaveRequest(eventObj)
{
   // Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation();
   // Write the code to be run after saving here.
   eventObj.ReturnStatus = true;
}

'=======
' The following function handler is created by Microsoft Office InfoPath.
' Do not modify the name of the function, or the name and number of arguments.
'=======
Sub XDocument_OnSaveRequest(eventObj)
' Write the code to be run before saving here.
eventObj.IsCancelled = eventObj.PerformSaveOperation
' Write the code to be run after saving here.
eventObj.ReturnStatus = True
End Sub

Considerações sobre compatibilidade

Não pode adicionar um script um modelo de formulário compatível com o browser. Pode adicionar script apenas a um modelo de formulário serão possível preencher cujos formulários no InfoPath. Pode personalizar um modelo de formulário compatível com o browser utilizando apenas código gerido.

Início da página

Definir a linguagem de scripts para um modelo de formulário

Para personalizar um modelo de formulário utilizando script, pode utilizar o Microsoft JScript ou Microsoft Visual Basic Scripting Edition (VBScript). Por predefinição, o InfoPath está configurado para adicionar o script utilizando JScript. Se o modelo de formulário não contiver qualquer script ou código gerido e preferir utilizar VBScript como linguagem de scripts, pode alterar a linguagem de scripts para o modelo de formulário para VBScript. Não é possível utilizar ambas as linguagens de script mesmo modelo de formulário.

Se o modelo de formulário já contenha script de um idioma e que pretende utilizar o outro idioma, terá de guardar o script existente para que pode converter o script para o idioma, remova o script do modelo de formulário através das Opções de formulário caixa de diálogo caixa e, em seguida, adicione o script convertido para o modelo de formulário. O InfoPath não é possível converter scripts para um novo idioma scripting. Apenas a alteração do idioma de script na caixa de diálogo Opções de formulário afeta este modelo de formulário. Outros modelos de formulário terá JScript como predefinição linguagem de scripts.

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

2. Na lista categoria, na caixa de diálogo Opções de formulário, clique em de programação.

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

   Notas: 

   • Depois de definir a linguagem de scripts e criar um ou mais processadores de evento para um modelo de formulário, não pode alterar a linguagem de scripts para o modelo de formulário.

   • Se tiver instalado o Microsoft Visual Studio 2005 Tools for Applications, o idioma predefinido é Microsoft Visual Basic .NET. Ainda pode utilizar este procedimento para alterar a linguagem de scripts para VBScript.

Início da página

Apresentar uma mensagem de cada vez que ocorre um evento

Se pretender saber o que executar processadores de eventos no resposta a uma ação ou outro evento, pode adicionar código temporário para apresentar uma caixa de mensagem sempre que executa o processador de eventos. Deve utilizar este código apenas para determinar quando um processador de eventos é executado. Depois de adicionar este código, pode utilizar a pré-visualizar para ver um formulário baseado neste modelo de formulário ou para publicar o modelo de formulário e, em seguida, criar um novo modelo de formulário. Algum processadores de eventos apenas ser executadas se criar um formulário depois de a publicar o modelo de formulário. Em seguida, pode executar uma ação que achar que poderá ser executado o processador de eventos. Quando executa o processador de eventos, verá uma caixa de mensagem.

Depois de determinar o quê ou eventos de executar o processador de eventos, remover o código e, em seguida, continuar a estruturar o modelo de formulário. Se não remove este código e, em seguida, publicar o modelo de formulário, os utilizadores verão esta caixa de mensagem quando executa o processador de eventos.

1. Adicione o seu processador de eventos.

2. Para adicionar o código no JScript, escreva XDocument.UI.Alert ("o evento apenas executou o evento de nome"); Substitua o nome do seu processador de eventos. Por exemplo, se adicionar este código ao processador de eventos OnValidate , teria escreva XDocument.UI.Alert ("a OnValidate apenas executou o processador de eventos");

3. Para adicionar o código no VBScript, escreva XDocument.UI.Alert ("o evento apenas executou o evento de nome") por exemplo, se adicionar este código a processador de eventos OnSaveRequest , teria de escrever XDocument.UI.Alert ("a OnSaveRequest apenas executou o processador de eventos")

4. Para testar o código, clique em Pré-visualizar no menu ficheiro, ou prima CTRL + SHIFT + B e, em seguida, efetue uma ação do utilizador que pode iniciar o evento. Quando ocorre o evento com a linha de código, uma caixa de mensagem deve mostrar a sua mensagem.

   Nota: Alguns eventos podem pedir-lhe publicar o modelo de formulário e, em seguida, criar um formulário baseado neste modelo de formulário antes de poder executar uma ação do utilizador para iniciar o evento.

5. Antes de publicar o modelo de formulário e permitir que os utilizadores preencher formulários baseados neste modelo de formulário, elimine o código que utilizou para apresentar a caixa de mensagem.

Início da página

Adicionar um script que é executada quando um utilizador guarda os dados de formulário

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

2. Na lista categoria, na caixa de diálogo Opções de formulário, clique em Abrir e guardar.

3. Em comportamento de guardar, selecione a caixa de verificação Guardar utilizando código personalizado e, em seguida, clique em Editar. O Microsoft Script Editor é iniciado com o cursor no processador de eventos OnSaveRequest .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSaveRequest(eventObj)
   {
      // Write the code to be run before saving here.
      eventObj.IsCancelled = eventObj.PerformSaveOperation();
      // Write the code to be run after saving here.
      eventObj.ReturnStatus = true;
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSaveRequest(eventObj)
   ' Write the code to be run before saving here.
   eventObj.IsCancelled = eventObj.PerformSaveOperation
   ' Write the code to be run after saving here.
   eventObj.ReturnStatus = True
   End Sub
   

4. Efetue um ou ambos os procedimentos:

   • Para adicionar um script que é executada antes do InfoPath guarda o formulário, substitua o comentário Write the code to be run before saving here.seu código.

   • Para adicionar um script que é executada após o InfoPath guarda o formulário, substitua o comentário Write the code to be run after saving here. seu código.

5. Para testar as suas alterações, clique em Pré-visualizar na barra de ferramentas Padrão ou prima CTRL+SHIFT+B.

   Nota: Se o processador de eventos for executado apenas depois de criar um formulário baseado no seu modelo de formulário, publicar o modelo de formulário ao clicar em Publicar no menu ficheiro e, em seguida, conclua o Assistente de publicação. Depois de a publicar o modelo de formulário, criar um formulário e, em seguida, efetue uma ação para executar o processador de eventos.

Início da página

Adicionar um script que é executada quando um utilizador submete os dados de formulário

1. No menu Ferramentas, clique em Opções de submeter.

2. Na caixa de diálogo Opções de submeter, selecione a caixa de verificação Permitir que os utilizadores para submeter este formulário.

3. Clique em executar a ação personalizada utilizando o código e, em seguida, clique em Editar código. O Microsoft Script Editor é iniciado com o cursor no OnSubmitRequest do evento .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnSubmitRequest(eventObj)
   {
      // If the submit operation is successful, set
      // eventObj.ReturnStatus = true;
      // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnSubmitRequest(eventObj)
   ' If the submit operation is successful, set
   ' eventObj.ReturnStatus = True
   ' Write your code here
   End Sub
   

4. Substitua o comentário If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here com o seu código.

5. Para testar as suas alterações, clique em Pré-visualizar na barra de ferramentas Padrão ou prima CTRL+SHIFT+B.

Início da página

Adicionar um script que é executada quando um utilizador clica num botão

1. Adicionar um novo botão a uma vista no modelo de formulário e, em seguida, faça duplo clique no botão.

   Nota: Se estiver a adicionar script para um botão existente, faça duplo clique no botão existente em vez disso.

2. Clique no separador Geral.

3. Clique em Editar o código do formulário. O Microsoft Script Editor é iniciado com o cursor no processador de eventos de AoFazerClique para esse botão.

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function Button Name::OnClick(eventObj)
   {
   // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub Button Name_OnClick(eventObj)
   ' Write your code here
   End Sub
   

4. Substitua o comentário Write your code here com o seu código.

5. Para testar as suas alterações, clique em Pré-visualizar na barra de ferramentas Padrão ou prima CTRL+SHIFT+B.

Início da página

Adicionar um script que é executada quando são intercalados formulários existentes

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

2. Na lista categoria, na caixa de diálogo Opções de formulário, clique em Avançadas.

3. Em Intercalar formulários, selecione a caixa de verificação Ativar intercalação de formulários.

4. Selecione a caixa de verificação em série com código personalizado e, em seguida, clique em Editar. O Microsoft Script Editor é iniciado com o cursor no processador de eventos de OnMergeRequest .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnMergeRequest(eventObj)
   {
   // Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM);
   eventObj.ReturnStatus = true;
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnMergeRequest(eventObj)
   ' Write the code that handles each form being merged here.
   XDocument.ImportDOM(eventObj.DOM)
   eventObj.ReturnStatus = True
   End Sub
   

5. Substitua o comentário Write the code that handles each form being merged here. com o seu código.

6. Para testar o código neste caso, publicar o modelo de formulário, criar vários formulários baseados neste modelo de formulário e, em seguida, intercalar os modelos de formulário.

   Nota: Encontre ligações para mais informações sobre como publicar o seu modelo de formulário na secção Consulte também.

Início da página

Adicionar um script para atualizar os formulários existentes

Se tiver actualizado um modelo de formulário publicada anteriormente e que pretende atualizar os formulários existentes com base nesse modelo de formulário, pode adicionar script para o modelo de formulário actualizado que é executada quando um utilizador abre uma os formulários existentes. Quando um utilizador abre um formulário existente, o InfoPath verifica o número da versão do seu modelo de formulário associado na localização de publicação. Se o número da versão do modelo de formulário no local publicar for mais recente do que o número da versão o formulário existente, que indica que este foi atualizado, o InfoPath executa o código neste evento para atualizar o formulário existente.

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

2. Na lista categoria, na caixa de diálogo Opções de formulário, clique em controlo de versões.

3. Na lista de actualização da versão, clique em evento personalizado para utilizar e, em seguida, clique em Editar. O Microsoft Script Editor é iniciado com o cursor no eventos OnVersionUpgrade .

   JScript

   //=======
   // The following function handler is created by Microsoft Office InfoPath.
   // Do not modify the name of the function, or the name and number of arguments.
   //=======
   function XDocument::OnVersionUpgrade(eventObj)
   {
   // Write your code here
   }
   

   VBScript

   '=======
   ' The following function handler is created by Microsoft Office InfoPath.
   ' Do not modify the name of the function, or the name and number of arguments.
   '=======
   Sub XDocument_OnVersionUpgrade(eventObj)
   ' Write your code here
   End Sub
   

4. Substitua o comentário Write your code here com o seu código.

5. Para testar o código neste caso, publicar o modelo de formulário, criar vários formulários baseado neste modelo de formulário, modificar e publicar uma versão atualizada do modelo de formulário e, em seguida, abra um formulário existente com base na versão mais antiga deste modelo de formulário.

   Nota: Encontre ligações para mais informações sobre como publicar o seu modelo de formulário na secção Consulte também.

Início da página

Adicionar um script para outros eventos

Este procedimento pode ser utilizado para adicionar os seguintes processadores de eventos ao seu modelo de formulário:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• No menu Ferramentas, aponte para de programação e, em seguida, clique no evento para adicionar o processador de eventos. O Microsoft Script Editor é iniciado com o cursor no processador de eventos que selecionou.

• Substitua o comentário Write your code here com o seu código.

Início da página