Настроювання шаблону форми за допомогою сценарію

У цій статті

• Огляд

• Зауваження щодо сумісності

• Встановлення мови сценаріїв для шаблону форми

• Відображення повідомлення під час кожного подія відбувається

• Додавання сценарій, який запускається, коли користувач зберігає дані форми

• Сценарій, який запускається під час надсилання даних форми

• Сценарій, який запускається під час натискання кнопки

• Сценарій, який запускається під час злиття наявних форм

• Сценарій для оновлення наявних форм

• Сценарій для інших подій

Огляд

За допомогою правила, формули, перевірка даних і умовне форматування, можна настроїти шаблон форми InfoPath. Хоча ці функції дуже гнучкі і може обробляти різноманітні завдання, деякі завдання виходять за рамки можливості, які з цих функцій. Наприклад, не можна використовувати правила для надсилання повідомлення електронної пошти, коли користувач вводить значення в текстовому полі у формі. Якщо потрібно настроїти шаблон форми таким чином, що виходить за рамки можливостей цих функцій, і ви знайомі з написання сценаріїв за допомогою мови сценаріїв JScript або VBScript, можна додати сценарій, який запускається під час відкриття нової форми або змінює ex isting на основі вашого шаблону форми.

Під час додавання сценарію до шаблону форми, InfoPath починається з Microsoft сценарій редактор (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, мови за промовчанням – .NET Microsoft Visual Basic. Можна й надалі використовувати цю процедуру, змінення мови сценаріїв для VBScript.

На початок сторінки

Відображення повідомлення під час кожного подія відбувається

Якщо потрібно знати, що обробники запуск у відповідь на дії або іншої події, можна додати тимчасового коду для відображення у вікні повідомлення, щоразу, коли запускається обробника подій. Ви повинні використовувати цей код лише, щоб визначити, коли запускається обробника подій. Коли ви додасте код, можна попереднього перегляду до подання форми на основі цього шаблону форми або публікування шаблону форми а потім створити новий шаблон форми. Деякі обробники запускати лише якщо форма створюється після публікування шаблону форми. Потім можна виконувати дії, які ви вважаєте, що можуть працювати обробника подій. Обробник подій запускається, з'явиться вікно повідомлення.

Після того, як визначити, які дії або подій запуску обробника подій, видалити код і потім відновити шаблону форми. Якщо не зняти цей код, і натисніть публікувати шаблон форми, ваші користувачі бачитимуть це вікно повідомлення, під час запуску обробника подій.

1. Додавання обробника подій.

2. Щоб додати код у JScript, введіть XDocument.UI.Alert ("подія назву події просто запускали"); Замініть ім'я обробника подій. Наприклад, якщо додати код обробника подій OnValidate , потрібно ввести XDocument.UI.Alert ("The OnValidate обробника подій просто запускали");

3. Щоб додати код у VBScript, введіть XDocument.UI.Alert ("подія назву події просто запускали") , наприклад, якщо додати код подій OnSaveRequest , потрібно ввести XDocument.UI.Alert ("The OnSaveRequest обробника подій просто запускали")

4. Щоб перевірити код, натисніть кнопку попередній перегляд у меню файл , або натисніть сполучення клавіш CTRL + SHIFT + B і виконайте дію, яка може запустити подію. Під час події з рядок коду, у вікні повідомлення має відобразити повідомлення.

   Примітка.: Деякі події може знадобитися публікування шаблону форми а потім створити форму на основі цього шаблону форми перед виконанням дії користувача до початку події.

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

На початок сторінки

Додавання сценарій, який запускається, коли користувач зберігає дані форми

1. У меню Знаряддя виберіть пункт Параметри форми.

2. У списку числові формати , у діалоговому вікні Параметри форми натисніть кнопку Відкрити та зберегти.

3. У розділі збереження поведінкуустановіть прапорець зберегти за допомогою настроюваного коду і натисніть кнопку редагувати. Редактор сценаріїв Microsoft починається з курсор перебуває на подій 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. Виконайте одну або обидві такі дії:

   • Щоб додати сценарій, який запускається перед 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. У списку версії оновлення натисніть кнопку використовувати настроюваний подіюі натисніть кнопку редагувати. Редактор сценаріїв Microsoft починається з курсор перебуває на 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. Замініть примітки Write your code here код.

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

   Примітка.: Знайти посилання на додаткові відомості про публікування шаблону форми у розділі Додаткові відомості .

На початок сторінки

Сценарій для інших подій

Цю процедуру можна додати такі обробники до шаблону форми:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• У меню Знаряддя наведіть вказівник миші на програмуванняі клацніть подію, щоб додати до обробника подій. Редактор сценаріїв Microsoft починається з курсор перебуває на обробник подій, який ви вибрали.

• Замініть примітки Write your code here код.

На початок сторінки