Prilagođavanje predložaka obrasca pomoću skripte

Sadržaj članka

• Pregled

• Razmatranje kompatibilnosti

• Postavljanje skriptnog jezika za predložak obrasca

• Prikaz poruke svaki put kada se pojavi događaj

• Dodavanje skripte koja se pokreće kada korisnik sprema podatke iz obrasca

• Dodavanje skripte koja se izvodi kad korisnik pošalje podataka obrasca

• Dodavanje skripte koja se izvodi kad korisnik klikne gumb

• Dodajte skriptu koja se pokreće kada se spajaju postojećih obrazaca

• Dodavanje skripte za ažuriranje postojećih obrazaca

• Dodavanje skripte za druge događaje

Pregled

Predložak obrasca programa InfoPath možete prilagoditi pomoću pravila, formule, provjera valjanosti podataka i uvjetno oblikovanje. Iako te značajke su prilagodljivih i mogu izvršavati cijeli niz zadataka, neki zadaci su izvan mogućnosti te značajke. Na primjer, nećete moći koristiti pravila da biste poslali poruku e-pošte kada korisnik unese vrijednost u tekstnom okviru na obrascu. Ako vam je potrebna da biste prilagodili predloška obrasca na način na koji se nalazi izvan mogućnosti te značajke, a upoznati s pisanjem skripte pomoću JScript ili VBScript skriptnog jezika, možete dodati skriptu koja se pokreće kada korisnik otvori novi obrazac ili mijenja se franko isting obrazac koji se temelji na predlošku obrasca.

Kada dodate skriptu u predložak obrasca, InfoPath pokreće Microsoft Script Editor (MSE), koji omogućuje dodavanje, uređivanje i ispravljanje pogrešaka u skripti u predlošku obrasca i postavlja pokazivač na odabrani događaj. InfoPath automatski dodaje rukovatelja događajima u skriptu. Rukovatelj događajima je kod funkcije u predložak obrasca programa InfoPath koji odgovara korisničku akciju ili promjenu XML podataka u obrascu. Na primjer, ako želite da korisnici obrasce spremaju na nekoliko mrežna mjesta, možete dodati skriptu događaja OnSaveRequest . Kada dodate skriptu da biste pokrenuli kad korisnik Spremi obrazac koji se temelji na predlošku obrasca, InfoPath pokreće uređivač skripta i dodaje sljedeće kodove u 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

Razmatranje kompatibilnosti

Ne možete dodati skripte predložak obrasca kompatibilan s preglednikom. Možete dodati skriptu samo na predložak obrasca koji će biti ispunjeni čiji obrasci u programu InfoPath. Predložak obrasca kompatibilan s preglednikom možete prilagoditi samo pomoću upravljani kod.

Vrh stranice

Postavljanje skriptnog jezika za predložak obrasca

Da biste prilagodili predloška obrasca pomoću skripte, možete koristiti Microsoft JScript ili Microsoft Visual Basic Scripting Edition (VBScript). Prema zadanim postavkama, InfoPath je konfiguriran za dodavanje skripte pomoću JScript. Ako predložak obrasca sadrži kod skripte ili upravljani kod, a želite koristiti VBScript kao skriptnog jezika, možete promijeniti skriptnog jezika za predložak obrasca za VBScript. Ne možete koristiti oba skriptnog jezika u istom predlošku obrasca.

Ako predložak obrasca već sadrži skripte na jednom jeziku, a želite koristiti na drugom jeziku, morate spremiti postojeće skripte tako da na drugom jeziku možete pretvoriti u skriptu uklanjanje skripte iz predloška obrasca kroz Mogućnosti obrasca dijaloški okvir i zatim dodajte pretvorene skripte natrag u predlošku obrasca. InfoPath ne može pretvoriti skripte novi skriptnog jezika. Promjena jezika za skripte u dijaloškom okviru Mogućnosti obrasca utječe samo na tom predlošku obrasca. Ostale predloške obrasca će imati JScript kao zadani jezik za skriptiranje.

1. Na izborniku Alati kliknite Mogućnosti obrasca.

2. Na popisu kategorija u dijaloškom okviru Mogućnosti obrasca kliknite Programiranje.

3. Na popisu jezik kod predloška obrasca u odjeljku programskom jeziku, kliknite VBScript.

   Napomene: 

   • Nakon što Postavljanje skriptnog jezika i stvaranje rukovatelja događajima za predložak obrasca, ne možete promijeniti skriptnog jezika za predložak obrasca.

   • Ako ste instalirali Microsoft Visual Studio 2005 Tools for Applications, zadani jezik je Microsoft Visual Basic .NET. I dalje možete koristiti ovaj postupak da biste promijenili skriptnog jezika VBScript.

Vrh stranice

Prikaz poruke svaki put kada se pojavi događaj

Ako želite saznati što rukovatelja događajima pokreću kao odgovor na akciju ili neki drugi događaj, možete dodati privremeni kod za prikaz u okviru poruke prilikom izvođenja rukovatelja događajima. Koristite kod samo da biste odredili kada se pokrene rukovatelj događajima. Nakon što dodate kod, poslužite se pretpregled za prikaz obrasca koji se temelji na predlošku obrasca ili za objavljivanje predloška obrasca, a zatim stvorite novi predložak obrasca. Neke rukovatelja događajima će se pokrenuti samo ako stvorite obrazac nakon objavljivanja predloška obrasca. Zatim možete izvršiti akciju koja se može pokrenuti rukovatelja događajima. Kada se rukovatelj događajima pokrene, vidjet ćete okvir s porukom.

Nakon što odredite koje akcije ili događaji pokreću rukovatelja događajima, uklonite kod, a zatim nastavite s Dizajniranjem predloška obrasca. Ako ne uklonite taj kod, a zatim objavljivanje predloška obrasca, vaši korisnici će vidjeti taj okvir poruku kada se pokrene rukovatelj događajima.

1. Dodajte svoj rukovatelj događajima.

2. Da biste dodali kod u JScript, upišite XDocument.UI.Alert ("u događaj naziv događaja upravo pokrenut"); Zamijenite nazivom rukovatelj događajima. Na primjer, ako dodate kod rukovatelj događajima OnValidate upisali XDocument.UI.Alert ("u OnValidate rukovatelja događajima upravo pokrenut");

3. Da biste dodali kod u VBScript, upišite XDocument.UI.Alert ("u događaj naziv događaja upravo pokrenut") , na primjer, ako dodate kod događaja OnSaveRequest , upišite XDocument.UI.Alert ("u OnSaveRequest rukovatelja događajima upravo pokrenut")

4. Da biste testirali kod, na izborniku datoteka kliknite Pretpregled ili pritisnite CTRL + SHIFT + B, a zatim izvedite korisničku akciju koja se može pokrenuti događaj. Kada se pojavi događaj s retkom koda, okvir s porukom treba prikazati poruku.

   Napomena: Neke događaje biti potrebno objaviti predložak obrasca, a zatim stvorite obrazac koji se temelji na predlošku obrasca prije poduzimanja akcija korisnika da biste pokrenuli događaj.

5. Prije objavljivanja predloška obrasca i omogućite korisnicima ispunjavanje obrazaca koji se temelji na predlošku obrasca, izbrišite kod koji ste koristili da biste prikazali okvir poruke.

Vrh stranice

Dodavanje skripte koja se pokreće kada korisnik sprema podatke iz obrasca

1. Na izborniku Alati kliknite Mogućnosti obrasca.

2. Na popisu kategorija u dijaloškom okviru Mogućnosti obrasca kliknite Otvori i Spremi.

3. U odjeljku ponašanje prilikom spremanja, potvrdite okvir Spremi pomoću prilagođenog koda , a zatim kliknite Uredi. Microsoft Script Editor se pokreće s pokazivačem na događaja 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. Učinite nešto od sljedećeg:

   • Da biste dodali skriptu koja se pokreće prije InfoPath Spremi obrazac, zamijenite komentar Write the code to be run before saving here.kod.

   • Da biste dodali skriptu koja se pokreće nakon InfoPath Spremi obrazac, zamijenite komentar Write the code to be run after saving here. kod.

5. Da biste testirali promjene, kliknite Pretpregled na alatnoj traci Standardno ili pritisnite CTRL + SHIFT + B.

   Napomena: Ako rukovatelja događajima izvodi samo nakon što stvorite obrazac koji se temelji na predlošku obrasca, objavljivanje predloška obrasca tako da kliknete Objavi na izborniku datoteka , a zatim dovršite Čarobnjak za objavljivanje. Nakon objavljivanja predloška obrasca, stvorite obrazac i zatim izvedite akcije da biste pokrenuli rukovatelja događajima.

Vrh stranice

Dodavanje skripte koja se izvodi kad korisnik pošalje podataka obrasca

1. Na izborniku Alati kliknite Mogućnosti slanja.

2. U dijaloškom okviru Mogućnosti slanja odaberite potvrdni okvir Dopusti korisnicima slanje obrasca .

3. Kliknite Izvedi prilagođenu akciju koristeći kod, a zatim kliknite Uredi kod. Microsoft Script Editor se pokreće s pokazivačem na događajem 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. Zamijenite komentar If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here kod.

5. Da biste testirali promjene, kliknite Pretpregled na alatnoj traci Standardno ili pritisnite CTRL + SHIFT + B.

Vrh stranice

Dodavanje skripte koja se izvodi kad korisnik klikne gumb

1. Dodajte novi gumb za prikaz u predložak obrasca, a zatim dvokliknite gumb.

   Napomena: Ako skriptu dodajete postojećem gumbu, dvokliknite gumb postojeće.

2. Kliknite karticu Općenito .

3. Kliknite Uređivanje koda obrasca. Microsoft Script Editor se pokreće s pokazivačem na OnClick rukovatelja događajima za taj gumb.

   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. Zamijenite komentar Write your code here kod.

5. Da biste testirali promjene, kliknite Pretpregled na alatnoj traci Standardno ili pritisnite CTRL + SHIFT + B.

Vrh stranice

Dodajte skriptu koja se pokreće kada se spajaju postojećih obrazaca

1. Na izborniku Alati kliknite Mogućnosti obrasca.

2. Na popisu kategorija u dijaloškom okviru Mogućnosti obrasca kliknite Dodatno.

3. U odjeljku spajanje obrazaca, potvrdite okvir Omogući spajanje obrazaca .

4. Odaberite potvrdni okvir Spoji pomoću prilagođenog koda , a zatim kliknite Uredi. Microsoft Script Editor se pokreće s pokazivačem na OnMergeRequest događajima.

   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. Zamijenite komentar Write the code that handles each form being merged here. kod.

6. Da biste testirali kod u ovaj događaj, objavljivanje predloška obrasca, stvorite nekoliko obrazaca koji se temelji na predlošku obrasca i spajanje predložaka obrazaca.

   Napomena: Veze na dodatne informacije o objavljivanju predloška obrasca u odjeljku Vidi također .

Vrh stranice

Dodavanje skripte za ažuriranje postojećih obrazaca

Ako ste ažurirali prethodno objavljeni predložak obrasca, a želite ažurirati postojeće obrasce koji se temelje na tom predlošku obrasca, možete dodati skriptu ažurirani predložak obrasca koji se pokreće kada korisnik otvori neki od postojećih obrazaca. Kada korisnik otvori postojeći obrazac, InfoPath provjerava broj verzije njemu pridruženog predloška obrasca na mjestu objave. Ako je broj verzije predloška obrasca na mjestu objave novija od broj verzije u postojeći obrazac, koja označava da je ažuriran, InfoPath pokreće kod u ovaj događaj da biste ažurirali postojeći obrazac.

1. Na izborniku Alati kliknite Mogućnosti obrasca.

2. Na popisu kategorija u dijaloškom okviru Mogućnosti obrasca kliknite određivanja verzija.

3. Na popisu Nadogradnja na verziju kliknite koristi prilagođeni događaj, a zatim kliknite Uredi. Microsoft Script Editor se pokreće s pokazivačem na događajem 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. Zamijenite komentar Write your code here kod.

5. Testiranje koda u ovom događaju, objavljivanje predloška obrasca, stvorite nekoliko obrazaca koji se temelji na predlošku obrasca, izmjena i objava ažurirane verzije predloška obrasca, a zatim otvorite postojeći obrazac koji se temelji na stariju verziju ovog predloška obrasca.

   Napomena: Veze na dodatne informacije o objavljivanju predloška obrasca u odjeljku Vidi također .

Vrh stranice

Dodavanje skripte za druge događaje

Taj postupak može se koristiti za dodavanje sljedećih rukovatelja događajima u predlošku obrasca:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• Pri učitavanju

• OnSwitchView

• OnSign

• OnValidate

• Na izborniku Alati pokažite Programiranje, a zatim kliknite događaj da biste dodali rukovatelja događajima. Microsoft Script Editor se pokreće s pokazivačem na događajima koji ste odabrali.

• Zamijenite komentar Write your code here kod.

Vrh stranice