Veidlapas veidnes pielāgošana, izmantojot skriptu

Šajā rakstā

• Pārskats

• Saderības apsvērumi

• Veidlapas veidnes skriptu valodas iestatīšana

• Parāda ziņojumu ikreiz, kad notikums

• Pievienot skriptu, kas tiek palaists, lietotājam saglabājot veidlapas datus

• Pievienot skriptu, kas tiek palaists, lietotājam iesniedzot veidlapas datus

• Kā pievienot skriptu, kas tiek palaists, kad lietotājs noklikšķina uz pogas

• Kā pievienot skriptu, kas tiek palaists, sapludinot esošās veidlapas

• Skripta pievienošana, lai atjauninātu esošās veidlapas

• Skripta pievienošana citos gadījumos

Pārskats

InfoPath veidlapas veidni var pielāgot, izmantojot kārtulas, formulas, datu validāciju un nosacījumformatēšanu. Lai gan šie līdzekļi ir ļoti elastīgas un apstrādāt dažādus uzdevumus, daži uzdevumi ir ne tikai iespēju no šiem līdzekļiem. Piemēram, nevar izmantot kārtulas, lai nosūtītu e-pasta ziņojumu, lietotājam ievadot vērtību tekstlodziņā formā. Ja jums ir nepieciešams, lai pielāgotu veidlapas veidnē tādā veidā, kas ir ārpus šos līdzekļus un iespējas ir zināmas rakstot skriptus, izmantojot JScript vai VBScript skripta valodu, varat pievienot skriptu, kas tiek izpildīts, ja lietotājs tiek atvērta jauna veidlapa vai modificē ex isting veidlapas, kuras pamatā ir veidlapas veidne.

Pievienojot veidlapas veidnes skriptu, programma InfoPath tiek startēta Microsoft Script Editor (MSE), kas ļauj pievienot, rediģēt un veidlapas veidnē skripta atkļūdošana un novieto kursoru izvēlētajā notikumā. InfoPath automātiski pievieno notikumu apdarinātāja skriptu. Notikumu apdarinātājs ir funkcijas kods InfoPath veidlapas veidnē, kas atbild uz lietotāja darbību vai izmaiņām XML datus formā. Piemēram, ja vēlaties, lai lietotāji to veidlapas saglabāt vairākas tīkla vietām, varat pievienot skriptu notikumu apdarinātāja OnSaveRequest . Pievienojot skriptu, ko palaist, kad lietotājs saglabā veidlapu, kuras pamatā ir veidlapas veidne, programma InfoPath tiek startēta script editor un viens no šiem kodiem pievieno skriptu.

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

Saderības apsvērumi

Skriptu nevar pievienot ar pārlūkprogrammu saderīgu veidlapu veidne. Skriptu var pievienot tikai veidlapas veidnes, kuras veidlapas tiks aizpildītas InfoPath. Varat pielāgot pārlūkprogrammu saderīgas veidlapu veidnes, tikai izmantojot pārvaldītu kodu.

Uz lapas sākumu

Veidlapas veidnes skriptu valodas iestatīšana

Lai pielāgotu veidlapas veidnes, izmantojot skriptu, varat izmantot Microsoft JScript vai Microsoft Visual Basic Scripting Edition (VBScript). Pēc noklusējuma programma InfoPath ir konfigurēta, lai pievienotu skriptu, izmantojot JScript. Ja jūsu veidlapas veidne nesatur skriptu vai pārvaldītu kodu un vēlaties, lai izmantotu VBScript kā skripta valodu, uz VBScript varat mainīt veidlapas veidnes skriptu valodas. Abas skriptēšanas valodas nevar izmantot to pašu veidlapas veidni.

Ja veidlapas veidnē jau ir skriptu vienā valodā un jūs vēlaties izmantot citu valodu, jums saglabāt esošo skriptu, lai skriptu var konvertēt uz citu valodu skriptu noņemšana no veidlapas veidnes, izmantojot Formas opcijas dialoglodziņu un pēc tam pievienojiet konvertēto skriptu atpakaļ uz veidlapas veidnes. InfoPath skriptus nevar konvertēt uz jaunām skriptēšanas valodām. Veidlapas opciju dialoglodziņā skriptu valodas mainīšana ietekmē tikai šī veidlapas veidne. Citas veidlapas veidnes skriptu valodas noklusējuma būs JScript.

1. Izvēlnē Rīki noklikšķiniet uz Formas opcijas.

2. Sarakstā Kategorija dialoglodziņā Veidlapas opcijas noklikšķiniet uz programmas.

3. Sarakstā veidlapas veidnes koda valoda zem programmēšanas valoda, noklikšķiniet uz VBScript.

   Piezīmes.: 

   • Pēc tam, kad skriptu valodas iestatīšana un izveidojis vienu vai vairākus notikumu apdarinātājus veidlapas veidnes, nevar mainīt veidlapas veidnes skriptu valodas.

   • Ja ir instalēta Microsoft Visual Studio 2005 Tools for Applications, noklusējuma valoda ir Microsoft Visual Basic .NET. Joprojām varat izmantot šo procedūru, lai mainītu skriptu valodas VBScript.

Uz lapas sākumu

Parāda ziņojumu ikreiz, kad notikums

Ja vēlaties uzzināt, kas notikumu apdarinātāja darbojas, atbildot uz darbību vai citu notikumu, varat pievienot pagaidu kodu, lai parādītu ziņojuma lodziņā ikreiz, kad tiek palaists notikumu apdarinātājs. Šis kods ir jālieto tikai, lai noteiktu, kad tiek palaists notikumu apdarinātājs. Pēc tam, kad esat pievienojis šādu kodu, varat izmantot priekšskatījuma skatītu veidlapu, kuras pamatā ir šī veidlapas veidne vai arī veidlapas veidnes publicēšana un pēc tam izveidotu jaunu veidlapas veidni. Daži notikumu apdarinātāja palaist tikai tad, ja formas izveide pēc veidlapas veidnes publicēšanas. Pēc tam varat veikt darbību, kas, Jūsuprāt, iespējams, darbosies notikumu apdarinātāja. Kad tiek palaists notikumu apdarinātājs, ir redzams ziņojuma lodziņš.

Pēc tam, kad jums noteikt, kādas darbības vai notikumi palaiž notikumu apdarinātāja, noņemiet kodu un pēc tam atsāciet veidlapas veidnes noformēšanas. Ja nevar noņemt šo kodu un pēc tam publicēt veidlapas veidni, jūsu lietotājiem tiks rādītas šī ziņojuma lodziņš, kad tiek palaists notikumu apdarinātājs.

1. Notikumu apdarinātāja pievienošana.

2. Lai pievienotu kodu JScript, ierakstiet XDocument.UI.Alert ("notikuma nosaukums notikums tikko veicāt"); Aizstājiet ar notikumu apdarinātāja nosaukumu. Piemēram, ja šo kodu pievienojat notikumu apdarinātājs OnValidate , ierakstiet XDocument.UI.Alert ("OnValidate notikumu apdarinātāja tikko veicāt");

3. Lai pievienot kodu VBScript, ierakstiet XDocument.UI.Alert ("notikuma nosaukums notikums tikko veicāt") , piemēram, ja pievienojat notikumu apdarinātāja OnSaveRequest šādu kodu, ierakstiet XDocument.UI.Alert ("OnSaveRequest notikumu apdarinātājs tikko veicāt")

4. Lai kodu pārbaudītu, izvēlnē Fails noklikšķiniet uz Priekšskatījums vai nospiediet taustiņu kombināciju CTRL + SHIFT + B un pēc tam veiciet lietotāja darbību, kas var sākt notikumu. Kad notiek notikums ar koda rindiņu, ziņojuma lodziņam ir jāparāda savu ziņojumu.

   Piezīme.: Daži notikumi var pieprasīt publicēt veidlapu veidni un pēc tam izveidot veidlapu, kuras pamatā ir šī veidlapas veidne, lai jūs varētu pildīt lietotāja darbību, lai sāktu notikumu.

5. Pirms veidlapas veidnes publicēšana un jūsu lietotājiem ļauj aizpildīt veidlapas, kuru pamatā ir šī veidlapas veidne, izdzēsiet kodu, kuru izmantojāt, lai parādītu ziņojuma lodziņu.

Uz lapas sākumu

Pievienot skriptu, kas tiek palaists, lietotājam saglabājot veidlapas datus

1. Izvēlnē Rīki noklikšķiniet uz Formas opcijas.

2. Sarakstā Kategorija dialoglodziņā Veidlapas opcijas noklikšķiniet uz Atvērt un saglabāt.

3. Sadaļā saglabāt darbību, atzīmējiet izvēles rūtiņu saglabāt, izmantojot pielāgotu kodu un pēc tam noklikšķiniet uz Rediģēt. Microsoft Script Editor sāk kursors atrodas notikumu apdarinātāja OnSaveRequest .

   ofjscript

   //=======
   // 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. Veiciet vienu vai abas no šīm darbībām:

   • Lai pievienotu skriptu, kas tiek palaista pirms InfoPath veidlapu saglabā, aizstājiet komentāru Write the code to be run before saving here.ar kodu.

   • Lai pievienotu skriptu, kas tiek palaists pēc InfoPath veidlapu saglabā, aizstājiet komentāru Write the code to be run after saving here. ar kodu.

5. Lai pārbaudītu izmaiņas, standarta rīkjoslā noklikšķiniet uz Priekšskatīt vai nospiediet taustiņu kombināciju CTRL+SHIFT+B.

   Piezīme.: Ja notikumu apdarinātājs darbojas tikai tad, kad esat izveidojis veidlapu, kuras pamatā ir veidlapas veidne, publicējiet veidlapas veidni, izvēlnē Fails noklikšķinot uz publicēt un pēc tam izpildiet Publishing Wizard. Pēc veidlapas veidnes publicēšanas formas izveide un pēc tam veikt darbību, lai palaistu notikumu apdarinātāja.

Uz lapas sākumu

Pievienot skriptu, kas tiek palaists, lietotājam iesniedzot veidlapas datus

1. Izvēlnē Rīki noklikšķiniet uz Iesniegšanas opcijas.

2. Dialoglodziņā Iesniegšanas opcijas atzīmējiet izvēles rūtiņu ļaut lietotājiem iesniegt šo veidlapu .

3. Noklikšķiniet uz veikt pielāgotu darbību, izmantojot koduun pēc tam noklikšķiniet uz Rediģēt kodu. Microsoft Script Editor sāk kursors atrodas notikumu apdarinātājs OnSubmitRequest .

   ofjscript

   //=======
   // 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. Komentāru If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here aizstājiet ar savu kodu.

5. Lai pārbaudītu izmaiņas, standarta rīkjoslā noklikšķiniet uz Priekšskatīt vai nospiediet taustiņu kombināciju CTRL+SHIFT+B.

Uz lapas sākumu

Kā pievienot skriptu, kas tiek palaists, kad lietotājs noklikšķina uz pogas

1. Poga Pievienot jaunu skatu veidlapas veidnē un pēc tam veiciet dubultklikšķi uz pogas.

   Piezīme.: Ja pievienojat skriptu esošas pogas, veiciet dubultklikšķi uz esošās pogas.

2. Noklikšķiniet uz cilnes Vispārīgi .

3. Noklikšķiniet uz Rediģēt formas kodu. Microsoft Script Editor sāk kursors atrodas OnClick notikumu apdarinātāja uz šīs pogas.

   ofjscript

   //=======
   // 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. Komentāru Write your code here aizstājiet ar savu kodu.

5. Lai pārbaudītu izmaiņas, standarta rīkjoslā noklikšķiniet uz Priekšskatīt vai nospiediet taustiņu kombināciju CTRL+SHIFT+B.

Uz lapas sākumu

Kā pievienot skriptu, kas tiek palaists, sapludinot esošās veidlapas

1. Izvēlnē Rīki noklikšķiniet uz Formas opcijas.

2. Sarakstā Kategorija dialoglodziņā Veidlapas opcijas noklikšķiniet uz papildu.

3. Sadaļā veidlapu sapludināšana, atzīmējiet izvēles rūtiņu Iespējot veidlapu sapludināšanu .

4. Atzīmējiet izvēles rūtiņu Sapludināt, izmantojot pielāgotu kodu un pēc tam noklikšķiniet uz Rediģēt. Microsoft Script Editor sāk kursors atrodas OnMergeRequest notikumu apdarinātāja.

   ofjscript

   //=======
   // 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. Komentāru Write the code that handles each form being merged here. aizstājiet ar savu kodu.

6. Lai kodu pārbaudītu šajā notikumā, publicējiet veidlapas veidni, izveidojiet vairākas veidlapas, kuras pamatā ir šī veidlapas veidne un pēc tam veidlapas veidnes sapludiniet.

   Piezīme.: Saites uz papildinformāciju par veidlapas veidnes publicēšana, skatiet sadaļā Skatiet arī .

Uz lapas sākumu

Skripta pievienošana, lai atjauninātu esošās veidlapas

Ja esat atjauninājis agrāk publicētu veidlapas veidni un vēlaties atjaunināt esošās veidlapas, kuru pamatā ir veidlapas veidne, varat pievienot skriptu atjauninātu veidlapas veidni, kas tiek palaists, lietotājam atverot vienu no esošajām veidlapām. Kad lietotājs atver esošu veidlapu, InfoPath pārbauda tās piesaistītā veidlapas veidne publicēšanas vietā versijas numurs. Ja vietā, kur publicēt veidlapas veidnes versijas numurs ir jaunāki par esošās veidlapas versijas numuru, norādot, ka tas ir atjaunināts, programma InfoPath šajā notikumā palaiž kodu, lai atjauninātu esošo veidlapu.

1. Izvēlnē Rīki noklikšķiniet uz Formas opcijas.

2. Sarakstā Kategorija dialoglodziņā Veidlapas opcijas noklikšķiniet uz versiju izveidi.

3. Sarakstā uz versiju jaunināšana noklikšķiniet uz izmantot pielāgotu notikumuun pēc tam noklikšķiniet uz Rediģēt. Microsoft Script Editor sāk kursors atrodas OnVersionUpgrade notikumu apdarinātāja.

   ofjscript

   //=======
   // 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. Komentāru Write your code here aizstājiet ar savu kodu.

5. Kodu pārbaudītu šajā notikumā, publicējiet veidlapas veidni, izveidojiet vairākas veidlapas, kuras pamatā ir šī veidlapas veidne, modificēt un atjauninātas veidlapas veidnes versijas publicēšana un pēc tam atveriet esošo veidlapu, kuras pamatā ir šī veidlapas veidnes vecāka versija.

   Piezīme.: Saites uz papildinformāciju par veidlapas veidnes publicēšana, skatiet sadaļā Skatiet arī .

Uz lapas sākumu

Skripta pievienošana citos gadījumos

Šo procedūru var izmantot, lai pievienotu šādu notikumu apdarinātāja veidlapas veidnes:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Izvēlnē Rīki norādiet uz programmēšanaun pēc tam noklikšķiniet uz Pievienot notikumu apdarinātāja notikumu. Microsoft Script Editor sāk kursors atrodas notikumu apdarinātāja, kuru atlasījāt.

• Komentāru Write your code here aizstājiet ar savu kodu.

Uz lapas sākumu