Prispôsobenie šablóny formulára použitím skriptu

Obsah tohto článku

• Prehľad

• Informácie týkajúce sa kompatibility

• Nastavenie skriptovacieho jazyka pre šablónu formulára

• Zobraziť správu zakaždým, keď sa vyskytne udalosť

• Pridať skript, ktorý sa spustí, keď používateľ uloží údajov formulára

• Pridajte skript, ktorý sa spustí po odoslaní údajov formulára

• Pridať skript, ktorý sa spustí, keď používateľ klikne na tlačidlo

• Pridať skript, ktorý sa spustí, keď sa zlúčia existujúce formuláre

• Pridanie skriptu aktualizovať existujúce formuláre

• Pridanie skriptu pre ostatné udalosti

Prehľad

Šablóny formulára programu InfoPath môžete prispôsobiť použitím pravidlá, vzorce, overovanie údajov a podmienené formátovanie. Aj napriek tomu, že tieto funkcie sú veľmi flexibilné a môžete pracovať s množstvom úloh, niektoré úlohy presahujú možnosti z týchto funkcií. Napríklad, nie je možné použiť pravidlá na odoslanie e-mailovej správy, keď používateľ zadá hodnotu v textovom poli vo formulári. Ak chcete prispôsobiť šablónu formulára tak, že je nad možnosti z týchto funkcií a ste oboznámení s písaním skriptov s použitím skriptovacieho jazyka JScript alebo VBScript, môžete pridať skript, ktorý sa spustí, keď používateľ otvorí formulár novej alebo upravujúce ex existujúcich formulár, ktorý je založený na šablóne formulára.

Po pridaní skriptu do šablóny formulára, program InfoPath spustí program Microsoft Script Editor (MSE), ktorá umožňuje pridať, upraviť a ladenie skriptu v šablóne formulára a umiestni kurzor zvolenej udalosti. Program InfoPath automaticky pridá obsluhy udalostí skriptu. Obsluha udalostí je kód funkcie v šablóne formulára programu InfoPath, ktorý odpovedá na akcie používateľa alebo zmeny v údajoch XML vo formulári. Napríklad, ak chcete používatelia ukladali formuláre do niektorých sieťových umiestnení, môžete pridať skript na udalosti OnSaveRequest . Pri pridávaní skript spustiť, keď používateľ uloží formulár založený na šablóne formulára, program InfoPath spustí editor skriptov a pridá jeden z nasledujúcich číselných skript.

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

Informácie týkajúce sa kompatibility

Skript je možné pridať do šablóna formulára kompatibilná s prehliadačom. Skript môžete pridať len do šablóny formulára, ktorej formuláre sa vypĺňať v programe InfoPath. Šablóny formulára kompatibilnej s prehľadávačom môžete prispôsobiť iba pomocou spravovaného kódu.

Na začiatok stránky

Nastavenie skriptovacieho jazyka pre šablónu formulára

Ak chcete prispôsobiť šablónu formulára použitím skriptu, môžete použiť buď Microsoft JScript alebo Microsoft Visual Basic Scripting Edition (VBScript). Na základe predvoleného nastavenia je program InfoPath nakonfigurovaný na Pridanie skriptu použitím jazyka JScript. Ak v šablóne formulára neobsahuje žiadne skript alebo spravovaný kód a chcete použiť VBScript ako skriptovacieho jazyka, môžete zmeniť skriptovacieho jazyka pre šablónu formulára na VBScript. Nemožno použiť obe skriptovacích jazykov v tej istej šablóny formulára.

Ak šablóna formulára už obsahuje skript v jednom jazyku a chcete použiť iný jazyk, je potrebné existujúci skript uložiť, aby skript môžete konvertovať na iný jazyk, odstráňte skript zo šablóny formulára Formulár-možnosti dialógové okno a potom pridajte skonvertovaný skript späť do šablóny formulára. Program InfoPath nedokáže konvertovať skripty do nového skriptovacieho jazyka. Zmena skriptovacieho jazyka v dialógovom okne Formulár-možnosti sa týka len tejto šablóne formulára. Ďalšie šablóny formulárov budú mať JScript ako predvolený jazyk skriptu.

1. V ponuke Nástroje kliknite na položku Možnosti formulára.

2. V zozname Kategória v dialógovom okne Formulár-možnosti kliknite na položku plánovanie.

3. V zozname Jazyk kódu šablóny formulára v časti programovací jazyk, kliknite na položku VBScript.

   Poznámky: 

   • Nastavenie skriptovacieho jazyka a vytvoriť jeden alebo viac obsluhy udalostí pre šablónu formulára, nie je možné zmeniť skriptovacieho jazyka pre šablónu formulára.

   • Ak máte nainštalovaný Microsoft Visual Studio 2005 Tools for Applications, je predvoleného jazyka Microsoft Visual Basic .NET. Stále môžete použiť tento postup na zmenu skriptovacieho jazyka VBScript.

Na začiatok stránky

Zobraziť správu zakaždým, keď sa vyskytne udalosť

Ak chcete vedieť, čo obsluhy udalostí spustiť v odpovedi na určitú akciu alebo inú udalosť, môžete pridať dočasný kód, ktorý sa zobrazí okno s hlásením, pri každom spustení. Tento kód treba použiť len na zistenie pri spustení obsluhy udalostí. Po pridaní tento kód, môžete použiť ukážky na zobrazenie formulár založený na šablóne formulára alebo na publikovanie šablóny formulára a potom vytvorte novú šablónu formulára. Niektoré obsluhy udalosti sa spustia iba v prípade, že môžete vytvoriť formulár, po publikovaní šablóny formulára. Potom môžete vykonať akciu, ktorá si myslíte, že môže spustiť obsluha udalostí. Po spustení sa zobrazí okno s hlásením.

Po stanovení akcií alebo udalostí spustiť obsluha udalostí, odstrániť kód a potom pokračujte v návrhu šablóny formulára. Ak neodstránite tento kód a potom šablónu formulára publikovať, používateľom zobrazí toto chybové hlásenie pri spustení popisovača udalostí.

1. Pridajte obsluhu udalosti.

2. Ak chcete pridať kód v jazyku JScript, reťazec XDocument.UI.Alert ("udalosť názov udalosti práve spustili"); Nahraďte názov vášho obsluha udalostí. Napríklad, ak pridáte tento kód do obsluhy udalostí overovanie , napíšte XDocument.UI.Alert ("overovanie obsluha udalostí práve spustili");

3. Pridať kód v jazyku VBScript, reťazec XDocument.UI.Alert ("udalosť názov udalosti práve spustili") napríklad, ak pridáte k udalosti OnSaveRequest tento kód, ktorý by reťazec XDocument.UI.Alert ("OnSaveRequest obsluha udalostí práve spustili")

4. Ak chcete otestovať kód, v ponuke súbor kliknite na položku Ukážka alebo stlačte kombináciu klávesov CTRL + SHIFT + B a potom vykonajte akciu používateľa, ktorá môže začať udalosti. Pri výskyte udalosti s riadok kódu, okno s hlásením by sa mala zobraziť správu.

   Poznámka: Niektoré udalosti, možno budete musieť publikovať šablónu formulára a potom vytvorte formulár založený na šablóne formulára budete môcť vykonať akcie používateľa na spustenie akcie.

5. Ak chcete publikovať šablónu formulára a povoliť používateľom vypĺňať formuláre založené na tejto šablóne formulára, odstráňte kód, ktorý sa používa na zobrazenie v okne s hlásením.

Na začiatok stránky

Pridať skript, ktorý sa spustí, keď používateľ uloží údajov formulára

1. V ponuke Nástroje kliknite na položku Možnosti formulára.

2. V zozname Kategória v dialógovom okne Formulár-možnosti kliknite na položku Otvoriť a uložiť.

3. V časti správanie pri ukladaní, začiarknite políčko Uložiť pomocou vlastného kódu a potom kliknite na položku Upraviť. Microsoft Script Editor sa spustí s kurzorom na udalosti 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. Použite jeden alebo oba z týchto postupov:

   • Ak chcete pridať skript, ktorý spustí pred formulár programu InfoPath uloží, nahraďte komentár Write the code to be run before saving here.kód.

   • Ak chcete pridať skript, ktorý sa spustí po formulár programu InfoPath uloží, nahraďte komentár Write the code to be run after saving here. kód.

5. Ak chcete otestovať vykonané zmeny, na štandardnom paneli s nástrojmi, kliknite na príkaz Ukážka alebo stlačte kombináciu klávesov CTRL + SHIFT + B.

   Poznámka: Ak obsluha udalostí až vtedy, keď vytvárate formulár založený na šablóne formulára získate nasledujúce publikovanie šablóny formulára v ponuke súbor kliknite na položku Publikovať a potom dokončite Sprievodcu publikovaním. Po publikovaní šablóny formulára vytvorte formulár a potom vykonajte akcie na spustenie obsluha udalostí.

Na začiatok stránky

Pridajte skript, ktorý sa spustí po odoslaní údajov formulára

1. V ponuke Nástroje kliknite na položku Možnosti odoslania.

2. V dialógovom okne Možnosti odoslania začiarknite políčko Povoliť používateľom odoslanie tohto formulára.

3. Kliknite na položku vykonať vlastnú akciu pomocou kódu a potom kliknite na položku Upraviť kód. Microsoft Script Editor sa spustí s kurzorom na udalostí 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. Nahraďte komentár If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here kód.

5. Ak chcete otestovať vykonané zmeny, na štandardnom paneli s nástrojmi, kliknite na príkaz Ukážka alebo stlačte kombináciu klávesov CTRL + SHIFT + B.

Na začiatok stránky

Pridať skript, ktorý sa spustí, keď používateľ klikne na tlačidlo

1. Pridať nové tlačidlo do zobrazenia v šablóne formulára a potom dvakrát kliknite na tlačidlo.

   Poznámka: Ak pridávate skript na existujúce tlačidlo, namiesto toho kliknite dvakrát na tlačidlo existujúce.

2. Kliknite na kartu Všeobecné.

3. Kliknite na položku Upraviť kód formulára. Microsoft Script Editor sa spustí s kurzorom na udalosti OnClick toto tlačidlo .

   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. Nahraďte komentár Write your code here kód.

5. Ak chcete otestovať vykonané zmeny, na štandardnom paneli s nástrojmi, kliknite na príkaz Ukážka alebo stlačte kombináciu klávesov CTRL + SHIFT + B.

Na začiatok stránky

Pridať skript, ktorý sa spustí, keď sa zlúčia existujúce formuláre

1. V ponuke Nástroje kliknite na položku Možnosti formulára.

2. V zozname Kategória v dialógovom okne Formulár-možnosti kliknite na položku Rozšírené.

3. V časti zlúčenie formulárov, začiarknite políčko Zapnúť zlučovanie formulárov.

4. Začiarknite políčko Zlúčiť pomocou vlastného kódu a potom kliknite na položku Upraviť. Microsoft Script Editor sa spustí s kurzorom na udalosti 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. Nahraďte komentár Write the code that handles each form being merged here. kód.

6. V tomto prípade testovať kód, publikovať šablónu formulára, vytvorte niekoľko formulárov založených na šablóne formulára a zlúčte šablón formulárov.

   Poznámka: Prepojenia na ďalšie informácie o publikovaní šablóny formulára v časti Pozrite tiež.

Na začiatok stránky

Pridanie skriptu aktualizovať existujúce formuláre

Ak ste aktualizovali predtým publikovanú šablónu formulára a chcete aktualizovať existujúce formuláre založené na publikovanej šablóne formulára, môžete pridať skript do šablóny formulára aktualizácie, ktoré sa spustí pri otvorení jedného z existujúcich formulárov. Keď používateľ otvorí existujúci formulár, program InfoPath skontroluje číslo verzie priradenej šablóny formulára v mieste publikovania. Ak je číslo verzie šablóny formulára v mieste publikovania novšia ako číslo verzie do existujúceho formulára, ktorá označuje, či bol aktualizovaný, program InfoPath spustí kód v tomto prípade, ak chcete aktualizovať existujúci formulár.

1. V ponuke Nástroje kliknite na položku Možnosti formulára.

2. V zozname Kategória v dialógovom okne Formulár-možnosti kliknite na položku tvorby verzií.

3. V zozname na verziu inovácia kliknite na položku použiť vlastnú udalosť a potom kliknite na položku Upraviť. Microsoft Script Editor sa spustí s kurzorom na udalosti 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. Nahraďte komentár Write your code here kód.

5. Testovať kód v tomto prípade, publikovať šablónu formulára, vytvorte niekoľko formulárov založeného na šablóne formulára, úprava a publikovanie aktualizovanej verzie šablóny formulára a potom otvorte existujúci formulár založený na staršej verzii tejto šablóny formulára.

   Poznámka: Prepojenia na ďalšie informácie o publikovaní šablóny formulára v časti Pozrite tiež.

Na začiatok stránky

Pridanie skriptu pre ostatné udalosti

Tento postup je možné pridať tieto obsluhy udalostí do šablóny formulára:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• Overovanie

• V ponuke Nástroje ukážte na programovanie a potom kliknite na udalosť, ak chcete pridať do obsluhy udalostí. Microsoft Script Editor sa spustí s kurzorom na obsluha udalostí, ktoré ste vybrali.

• Nahraďte komentár Write your code here kód.

Na začiatok stránky