Настройка шаблона формы с использованием сценария

В этой статье

• Общие сведения

• Проблемы совместимости

• Выбор языка сценариев для шаблона формы

• Отобразить сообщение каждый раз при возникновении события

• Добавьте сценарий, который запускается при сохранении данных формы

• Добавьте сценарий, который запускается при отправке данных формы

• Добавьте сценарий, который запускается при нажатии кнопки

• Добавьте сценарий, который запускается при слиянии существующих форм

• Добавление сценария для обновления существующих форм

• Добавление сценария для других событий

Обзор

Вы можете настроить шаблон формы InfoPath с помощью правила, формулы, проверку данных и условное форматирование. Несмотря на то, что эти возможности гибкой и может обрабатывать широкий набор задач, некоторые задачи выходят за возможности этих функций. Например нельзя использовать правила для отправки сообщения электронной почты при вводе значения в текстовое поле в форме. Если вам нужно настроить шаблона формы таким образом, находится за пределами возможности этих функций и вы знакомы с сценариями с помощью языка сценариев VBScript или JScript, вы можете добавить сценарий, который выполняется, когда пользователь открывает новую форму или изменяет ex Форма isting, основанного на шаблоне формы.

При добавлении сценария на шаблон формы InfoPath запуск Microsoft Script Editor (MSE), которое позволяет добавлять, редактировать и отладка сценариев в шаблоне формы и поместит курсора в выбранном праздника. Приложение InfoPath автоматически добавляет обработчика событий сценария. Обработчик событий — это функция код в шаблон формы InfoPath, отвечает на действия пользователя или изменение данных XML в форме. Например если вы хотите пользователям сохранять свои формы в несколько расположений в сети, можно добавить сценарий обработчик событий OnSaveRequest . При добавлении скрипта для запуска при сохранении пользователем формы на основе шаблона формы InfoPath запуск редактора скриптов и добавляет одно из следующих кодов сценария.

//=======
// 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

Совместимость

Не удается добавить сценарий шаблон формы с поддержкой веб-браузера. Сценарий можно добавить только к шаблону формы будут заполнены которого форм в InfoPath. Вы можете настроить шаблон формы с поддержкой браузера только с помощью управляемого кода.

К началу страницы

Выбор языка сценариев для шаблона формы

Чтобы настроить шаблон формы с использованием сценария, можно использовать Microsoft JScript или Microsoft Visual Basic Scripting Edition (VBScript). По умолчанию InfoPath настроен для добавления сценариев с помощью JScript. Если вы предпочитаете использовать как язык сценариев VBScript шаблона формы не содержит любой управляемый код или сценарий, можно изменить язык сценариев для шаблона формы для VBScript. Оба языка сценариев нельзя использовать в шаблоне формы.

Если шаблон формы уже содержит сценария на одном языке и вы хотите использовать другой язык, необходимо сохранить существующий сценарий, чтобы сценарий можно преобразовать в другой язык удалить сценарий из шаблона формы по Параметры формы диалоговое окно поле, а затем добавьте сценарий преобразованные обратно в шаблон формы. InfoPath не удается преобразовать сценариев нового языка сценариев. Смена языка сценариев в диалоговом окне Параметры формы влияет только на этом шаблоне формы. Другие шаблоны форм будет иметь JScript для использования по умолчанию язык сценариев.

1. В меню Сервис выберите пункт Параметры формы.

2. В списке категорий в диалоговом окне Параметры формы щелкните программирования.

3. В списке язык кода шаблона формы в разделе язык программирования, нажмите кнопку VBScript.

   Примечания: 

   • После Выбор языка сценариев и создать один или несколько обработчики для шаблона формы, не удается изменить язык сценариев для шаблона формы.

   • Если вы установили Microsoft Visual Studio 2005 Tools for Applications, языком по умолчанию является Microsoft Visual Basic .NET. Чтобы изменить язык сценариев VBScript по-прежнему можно использовать эту процедуру.

К началу страницы

Отобразить сообщение каждый раз при возникновении события

Если вы хотите знать обработчики выполняются в ответ на действия или другого события, можно добавить временный код, чтобы отобразить окно сообщения при каждом выполнении обработчика событий. Этот код следует использовать только для определения при выполнении обработчика событий. Добавив этот код, можно использовать предварительный просмотр для просмотра формы на основе этого шаблона формы или для публикации шаблона формы, а затем создать новый шаблон формы. Некоторые обработчики выполняются только при условии, что вы создаете форму после публикации шаблона формы. Затем можно выполнять это действие, которое вы считаете, могут возникнуть обработчика событий. При повторном выполнении обработчика событий, появится окно сообщения.

После можно определить, какие действия или события выполнения обработчика событий, удалите код и нажмите Продолжить разработка шаблона формы. Если вы не удалить этот код, а затем опубликовать шаблон формы, ваш пользователи будут видеть это окно сообщения при выполнении обработчика событий.

1. Добавление обработчика событий.

2. Чтобы добавить код JScript, введите в XDocument.UI.Alert ("события имя события, просто запустили программу"); Замените имя обработчика событий. Например если добавить этот код обработчика событий OnValidate , вы введите XDocument.UI.Alert ("OnValidate обработчика событий просто запустили программу");

3. Чтобы добавить код в VBScript, введите XDocument.UI.Alert ("события имя события, просто запустили программу") , например, если добавить этот код в обработчик событий OnSaveRequest , необходимо ввести XDocument.UI.Alert ("OnSaveRequest обработчика событий просто запустили программу")

4. Чтобы протестировать код, нажмите кнопку Предварительный просмотр в меню файл или нажмите клавиши CTRL + SHIFT + B и выполните действия пользователя, который можно запустить событие. При возникновении события с строки кода, отображается сообщение должно отображаться сообщение.

   Примечание: Некоторые события может потребоваться опубликовать шаблон формы, а затем создать на основе этого шаблона формы перед выполнением на действия пользователя, чтобы начать события формы.

5. Прежде чем опубликовать шаблон форм и пользователи могли заполнять формы на основе этого шаблона формы, удалите код, который используется для отображения в окне сообщения.

К началу страницы

Добавьте сценарий, который запускается при сохранении данных формы

1. В меню Сервис выберите пункт Параметры формы.

2. В списке категорий в диалоговом окне Параметры формы нажмите кнопку Открыть и сохранить.

3. В разделе Сохранение поведение установите флажок Сохранить с использованием пользовательского кода и нажмите кнопку Изменить. Курсор находится в обработчик событий OnSaveRequest запустится редактор скриптов Microsoft.

   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. Выполните одно или оба указанные ниже действия.

   • Добавление сценарий, который запускается перед сохраняет форму InfoPath, замените комментарий Write the code to be run before saving here.кода.

   • Добавление сценарий, который запускается после сохраняет форму InfoPath, замените комментарий Write the code to be run after saving here. кода.

5. Чтобы проверить изменения, нажмите кнопку Просмотр на стандартной панели инструментов или нажмите клавиши CTRL+SHIFT+B.

   Примечание: Обработчик событий выполняется только после создания формы на основе шаблона формы, публикация шаблона формы нажмите кнопку Опубликовать в меню файл, а затем завершите мастер публикации. После публикации шаблона формы, создание формы, а затем выполните действия для запуска обработчика событий.

К началу страницы

Добавьте сценарий, который запускается при отправке данных формы

1. В меню Сервис выберите пункт Параметры отправки.

2. В диалоговом окне Параметры отправки установите флажок Разрешить пользователям отправлять эту форму.

3. Нажмите кнопку выполнить настраиваемое действие, с помощью кода и нажмите кнопку Изменить код. Запустится редактор скриптов Microsoft курсор находится в OnSubmitRequest обработчика событий.

   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. Замените комментарий If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here кода.

5. Чтобы проверить изменения, нажмите кнопку Просмотр на стандартной панели инструментов или нажмите клавиши CTRL+SHIFT+B.

К началу страницы

Добавьте сценарий, который запускается при нажатии кнопки

1. Кнопка добавления нового к представлению в шаблоне формы и затем дважды нажмите кнопку.

   Примечание: При добавлении сценария существующую кнопку вместо дважды нажмите кнопку существующие.

2. Откройте вкладку Общие.

3. Нажмите кнопку изменить код формы. Запустится редактор скриптов Microsoft курсор находится в обработчика событий OnClick для этой кнопки.

   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. Замените комментарий Write your code here кода.

5. Чтобы проверить изменения, нажмите кнопку Просмотр на стандартной панели инструментов или нажмите клавиши CTRL+SHIFT+B.

К началу страницы

Добавьте сценарий, который запускается при слиянии существующих форм

1. В меню Сервис выберите пункт Параметры формы.

2. В списке категорий в диалоговом окне Параметры формы нажмите кнопку Дополнительно.

3. В группе Объединение форм установите флажок Разрешить объединение форм.

4. Установите флажок " Объединить с использованием пользовательского кода " и нажмите кнопку Изменить. Запустится редактор скриптов Microsoft курсор находится в 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. Замените комментарий Write the code that handles each form being merged here. кода.

6. Чтобы проверить код в это событие, опубликовать шаблон формы, создать несколько форм на основе этого шаблона формы и затем объединить шаблонов форм.

   Примечание: Вы найдете ссылки на дополнительные сведения о публикации шаблона формы в разделе См.

К началу страницы

Добавление сценария для обновления существующих форм

Если обновляются шаблона формы, опубликованную ранее, и вы хотите обновить существующих форм на основе этого шаблона формы, можно добавить сценарий для обновленный шаблон формы, который запускается при открытии одну из существующих форм. Когда пользователь открывает существующую форму, InfoPath проверяет номер версии шаблоном формы в месте публикации. Если номер версии шаблона формы в месте публикации новее номер версии в существующую форму, о том, что он был обновлен, InfoPath запускается код в это событие, чтобы обновить существующую форму.

1. В меню Сервис выберите пункт Параметры формы.

2. В списке категорий в диалоговом окне Параметры формы нажмите кнопку Управление версиями.

3. В списке при обновлении версии выберите Использование настраиваемых событие и нажмите кнопку Изменить. Курсор находится в обработчика событий OnVersionUpgrade запустится редактор скриптов Microsoft.

   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. Замените комментарий Write your code here кода.

5. Протестируйте код в это событие, опубликовать шаблон формы, создание нескольких форм на основе этого шаблона формы, изменять и публикация обновленной версии шаблона формы и откройте существующую форму с учетом более раннюю версию этого шаблона формы.

   Примечание: Вы найдете ссылки на дополнительные сведения о публикации шаблона формы в разделе См.

К началу страницы

Добавление сценария для других событий

Эта процедура может использоваться для добавления следующих обработчики для шаблона формы:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• В меню Сервис выберите программирование и выберите событие для добавления обработчика событий. Запустится редактор скриптов Microsoft курсор находится в обработчика событий, который был выбран.

• Замените комментарий Write your code here кода.

К началу страницы