Vormimalli kohandamiseks skripti abil

Selle artikli teemad

• Ülevaade

• Ühilduvus

• Vormimalli skriptimiskeele seadmine

• Kuva sõnum iga kord, kui leiab aset sündmus

• Skripti, mis käivitub, kui kasutaja salvestab vormi andmete lisamine

• Skripti, mis käivitub, kui kasutaja edastab vormi andmete lisamine

• Skripti, mis töötab, kui kasutaja klõpsab nuppu Lisa.

• Skripti, mida käitatakse ühendatakse olemasolevate vormide lisamine

• Skripti värskendada olemasolevat vormi lisamine

• Lisage skripti muude sündmuste jaoks.

Overview

InfoPathi vormimalle saate kohandada reeglite, valemite, andmete valideerimise ja tingimusvormingu abil. Kuigi need funktsioonid on väga paindlik ja saate teha mitmesuguseid tööülesandeid, on nende funktsioonide pakutavad mõningaid ülesandeid. Näiteks ei saa saata meilisõnumeid, kui kasutaja sisestab väärtuse tekstiväljal vormi reeglite abil. Kui teil on vaja kohandada vormimalli viisil, mis on väljaspool nende funktsioonide ja võimaluste tuttavaid kirjutamine skriptide JScript või VBScripti skriptimiskeele abil, saate lisada skripti, mis käivitub, kui kasutaja avab uue vormi või muudab seda ex viima vorm, mis on teie vormimallil põhinevaid.

Skripti lisamisel vormimalli InfoPathi käivitab Microsoft Script Editor (MSE), mis võimaldab teil lisamine, redigeerimine ja vormimalli skripti silumine ja viib kursori teie valitud sündmusele. InfoPath lisab automaatselt sündmuseohjuri skripti. Sündmuseohjur on InfoPathi vormimalliks, mis vastab toimingule või vormi XML-andmete muudatuse funktsioon koodi. Näiteks, kui soovite salvestada oma vormide mitu võrgukohtades kasutajate, saate lisada skripti OnSaveRequesti sündmuseohjur. Skripti käivitamiseks, kui kasutaja salvestab teie vormimallil põhinevaid lisamisel InfoPathi käivitab skriptiredaktor ja lisab skripti üks järgmisi koode.

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

Ühilduvus

Ei saa mõnda brauseriga ühilduv vormimallskripti lisada. Skripti saate lisada ainult mille vorme täita InfoPathi vormimalli. Brauseriga ühilduva vormimalli saate kohandada ainult hallatavat koodi abil.

Lehe algusesse

Vormimalli skriptimiskeele seadmine

Vormimalli kohandamiseks skripti abil saate kasutada Microsoft JScripti või Microsoft Visual Basic Scripting Editioni (VBScript). Vaikimisi on konfigureeritud InfoPathi JScripti abil skripti lisada. Vormimalli ei sisalda hallatavat koodi ega skripti, kui soovite oma skriptimiskeele VBScript kasutamiseks, saate muuta skriptimiskeele vormimalli VBScript. Te ei saa kasutada sama vormimalli mõlemas skriptimine keeles.

Kui vormimall juba sisaldab skripti ühes keeles ja te soovite kasutada muud keelt, peate olemasoleva skripti salvestada, et saate teisendada skripti muus keeles skripti eemaldamine vormimalli Vormi suvandid dialoogiboksi ja seejärel lisage teisendatud skripti uuesti vormimalli. InfoPath ei saa teisendada skriptide uue skriptimiskeele. Vormi suvandid dialoogiboksis Skriptimiskeele muutmine mõjutab ainult sellel vormimallil. Vormimallide on JScripti skriptimise keele vaikeväärtuseks.

1. Klõpsake menüü Tööriistad nuppu Vormi suvandid.

2. Klõpsake dialoogiboksi Vormi suvandid loendis kategooriaprogrammeerimisega.

3. Klõpsake loendis vormimalli koodi keel jaotises programmeerimiskeele, VBScript.

   Märkused: 

   • Kui olete skriptimiskeele seadmine ja luua ühe või mitme sündmuseohjur vormimalli, ei saa muuta vormimalli skriptimiskeele.

   • Kui olete installinud Microsoft Visual Studio 2005 Tools for Applications, vaikekeele on Microsoft Visual Basic .NET. Saate siiski kasutada seda toimingut VBScript skriptimiskeele muuta.

Lehe algusesse

Kuva sõnum iga kord, kui leiab aset sündmus

Kui soovite teada, mis sündmuseohjur käivitatakse vastuseks toiming või muu sündmuse, saate lisada ajutine koodi iga kord, kui selle sündmuseohjuri teateboks kuvamiseks. Kasutage ainult määratlemiseks sündmuseohjuri käitamisel järgmine kood. Pärast selle koodi lisamist abil saate eelvaate kuvamiseks sellel vormimallil põhineva vormi või vormimalli ja seejärel looge uue vormimalli. Mõni sündmuseohjur käivitatakse ainult siis, kui loote vormi pärast vormimalli avaldamist. Saate teha toimingut, mis teie arvates võib sündmuseohjuri käivitama. Sündmuseohjuri käitamisel kuvatakse teateboks.

Pärast seda, kui olete kindlaks teinud, milliseid toiminguid või sündmused sündmuseohjuri käivitamise, eemaldage kood ja jätkake vormimalli kujundamine. Kui eemaldate järgmine kood ja vormimalli avaldamine, näevad teie kasutajad vastav teade sündmuseohjuri käitamisel.

1. Lisage sündmuseohjur.

2. JScripti koodi lisamiseks tippige XDocument.UI.Alert ("sündmuse nimi"); Asendage sündmuseohjur nime. Näiteks kui lisate OnValidate sündmuseohjuri järgmine kood, tippige XDocument.UI.Alert ("The OnValidate sündmuseohjur lihtsalt parandusfunktsiooni");

3. VBScript koodi lisada, tippige XDocument.UI.Alert ("sündmuse nimi") näiteks, kui lisate OnSaveRequesti sündmuseohjur järgmine kood, tippige XDocument.UI.Alert ("The OnSaveRequesti sündmuseohjur lihtsalt parandusfunktsiooni")

4. Koodi testimiseks klõpsake menüü fail nuppu Eelvaade või vajutage klahvikombinatsiooni CTRL + SHIFT + B ja sooritage Kasutajatoiming, mida saate alustada sündmus. Kui sündmus koodi rida, peaksid teateboks kuvamine sõnum.

   Märkus.: Teatud sündmuste võib olla vajalik vormimalli ja seejärel looge põhineva vormimalli kasutaja toimingu alustamiseks sündmuse sooritamiseks.

5. Enne vormimalli avaldamine ja teie kasutajad saavad täita sellel vormimallil põhinevaid vorme, kustutage koodi, mida kasutasite sõnumi väljale kuvatav.

Lehe algusesse

Skripti, mis käivitub, kui kasutaja salvestab vormi andmete lisamine

1. Klõpsake menüü Tööriistad nuppu Vormi suvandid.

2. Klõpsake dialoogiboksi Vormi suvandid loendis kategooriaavada ja salvestada.

3. Klõpsake jaotises Salvesta käitumine, märkige ruut Salvesta kohandatud koodi abil ja seejärel klõpsake nuppu Redigeeri. Kursor peab olema OnSaveRequesti sündmuseohjur käivitatakse Microsoft Script Editor.

   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. Tehke ühte või mõlemat järgmistest.

   • Skripti, mis käivitatakse enne salvestab InfoPathi vormi lisamiseks kommentaari Write the code to be run before saving here.asendada oma kood.

   • Skripti, mis käivitatakse pärast salvestab InfoPathi vormi lisamiseks kommentaari Write the code to be run after saving here. asendada oma kood.

5. Muudatuste kontrollimiseks klõpsake tööriistaribal Standard nuppu Eelvaade või vajutage klahvikombinatsiooni CTRL+SHIFT+B.

   Märkus.: Kui sündmuseohjuri töötab ainult siis, kui olete loonud teie vormimallil põhinevaid vormi, klõpsake menüü fail käsku Avalda vormimalli avaldamine ja järgige viisardi avaldamise. Pärast vormimalli avaldamist vormi loomine ja siis sündmuseohjuri käivitamiseks toimingu sooritamine.

Lehe algusesse

Skripti, mis käivitub, kui kasutaja edastab vormi andmete lisamine

1. Klõpsake menüü TööriistadEdastamise suvandid.

2. Dialoogiboksis Edastamise suvandid ruut Luba kasutajatel selle vormi edastada .

3. Klõpsake kohandatud toimingu abil koodja seejärel klõpsake nuppu Redigeeri koodi. Microsoft Script Editor algab sündmuseohjur OnSubmitRequest kursor.

   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. Asendage kood oma kommentaari If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here .

5. Muudatuste kontrollimiseks klõpsake tööriistaribal Standard nuppu Eelvaade või vajutage klahvikombinatsiooni CTRL+SHIFT+B.

Lehe algusesse

Skripti, mis töötab, kui kasutaja klõpsab nuppu Lisa.

1. Vormimalli vaate lisamine nuppu Uus ja seejärel topeltklõpsake nuppu.

   Märkus.: Kui lisate skripti olemasolevat nuppu, topeltklõpsake olemasolevat nuppu.

2. Klõpsake vahekaarti üldist .

3. Klõpsake nuppu Redigeeri vormi koodi. Kursor peab olema selle nupu OnClick sündmuseohjur käivitatakse Microsoft Script Editor.

   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. Asendage kood oma kommentaari Write your code here .

5. Muudatuste kontrollimiseks klõpsake tööriistaribal Standard nuppu Eelvaade või vajutage klahvikombinatsiooni CTRL+SHIFT+B.

Lehe algusesse

Skripti, mida käitatakse ühendatakse olemasolevate vormide lisamine

1. Klõpsake menüü Tööriistad nuppu Vormi suvandid.

2. Klõpsake dialoogiboksi Vormi suvandid loendis kategooriaTäpsemalt.

3. Klõpsake jaotises vormide ühendamine, märkige ruut Luba vormide liitmine .

4. Märkige ruut Ühenda kohandatud koodi abil ja seejärel klõpsake nuppu Redigeeri. Kursor peab olema OnMergeRequest sündmuseohjur käivitatakse Microsoft Script Editor.

   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. Asendage kood oma kommentaari Write the code that handles each form being merged here. .

6. Selle sündmuse koodi testimiseks, vormimalli avaldamine, mitu sellel vormimallil põhinevaid vorme luua, ja seejärel ühendada vormimallis korduvkasutatava.

   Märkus.: Kohta leiate lisateavet jaotise Vt ka vormimalli avaldamist.

Lehe algusesse

Skripti värskendada olemasolevat vormi lisamine

Kui te varem avaldatud vormimalli värskendatud ja mida soovite värskendada olemasolevaid selle vormimallil põhinevaid vorme, saate skripti lisada värskendatud vormimalli, mida käitatakse siis, kui kasutaja avab mõnda olemasolevat vormi. Kui kasutaja avab olemasoleva vormi, kontrollib InfoPath sellega seostatud vormimalli avaldamine asukohas versiooninumber. Kui vormimalli avaldamine asukohas versiooninumber on uuem kui olemasolevat vormi versiooninumber, mis näitab, et see on värskendatud, käivitab InfoPath koodi sellisel juhul värskendada olemasolevat vormi.

1. Klõpsake menüü Tööriistad nuppu Vormi suvandid.

2. Klõpsake dialoogiboksi Vormi suvandid loendis kategooriaVersioonimine.

3. Versiooni täiendamine loendis käsku Kasuta kohandatud sündmustja seejärel klõpsake nuppu Redigeeri. Kursor peab olema OnVersionUpgrade'i sündmuseohjur käivitatakse Microsoft Script Editor.

   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. Asendage kood oma kommentaari Write your code here .

5. See vormimallil põhinevaid selle sündmuse koodi testimiseks, vormimalli avaldamine, mitu vormide loomine, muutmine ja vormimalli värskendatud versiooni avaldamine ja avage olemasolevale vormile vanemat versiooni selle malli põhjal.

   Märkus.: Kohta leiate lisateavet jaotise Vt ka vormimalli avaldamist.

Lehe algusesse

Lisage skripti muude sündmuste jaoks.

Selle toimingu saab lisada järgmised sündmuseohjur vormimalli:

• OnAfterChange'i

• OnBeforeChange käivitumist

• OnContextChange

• Allalaadimine

• OnSwitchView

• OnSign

• OnValidate

• Klõpsake menüü Tööriistad käsk programmeerimineja klõpsake siis sündmuseohjuri lisamiseks. Kursor peab olema valitud sündmuseohjur käivitatakse Microsoft Script Editor.

• Asendage kood oma kommentaari Write your code here .

Lehe algusesse