Particularizarea unui șablon formular utilizând un script

În acest articol

• Prezentare generală

• Considerații de compatibilitate

• Configurarea limbajului pentru un șablon formular

• Afișează un mesaj de fiecare dată când are loc un eveniment

• Adăugați un script care să ruleze atunci când un utilizator salvează datele de formular

• Adăugați un script care să ruleze atunci când un utilizator remite date formă

• Adăugați un script care să ruleze atunci când utilizatorul face clic pe un buton

• Adăugați un script care să ruleze atunci când sunt îmbinate formulare existente

• Adăugați un script pentru a actualiza formulare existente

• Adăugați un script pentru alte evenimente

Prezentare generală

Aveți posibilitatea să particularizați un șablon de formular InfoPath utilizând reguli, formule, validarea datelor și formatarea condiționată. Deși aceste caracteristici sunt foarte flexibile și puteți gestiona o largă varietate de activități, unele activități sunt dincolo de capacitățile aceste caracteristici. De exemplu, nu puteți utiliza reguli pentru a trimite un mesaj de e-mail atunci când un utilizator introduce o valoare dintr-o casetă text dintr-un formular. Dacă aveți nevoie pentru a personaliza șablonul de formular într-un mod care este dincolo de capacitățile aceste caracteristici și vă sunt familiare cu scriere scripturi utilizând limbajului JScript sau VBScript, puteți să adăugați un script care să ruleze atunci când un utilizator se deschide un formular nou sau care modifică un ex isting formular care se bazează pe șablonul de formular.

Atunci când adăugați un script într-un șablon formular, InfoPath pornește Microsoft Script Editor (MSE), care vă permite să adăugarea, editarea și depanarea Scripturilor într-un șablon formular și plasează cursorul în de eveniment aleasă. InfoPath adaugă automat un eveniment de tratare a evenimentelor scriptul. Un eveniment de tratare a evenimentelor este codul funcția într-un șablon de formular InfoPath care răspunde la o acțiune de utilizator sau o modificare la datele XML într-o formă. De exemplu, dacă doriți ca utilizatorii să salvați formele lor în mai multe locații de rețea, puteți adăuga un script pentru a evenimentului OnSaveRequest . Atunci când adăugați un script să ruleze atunci când utilizatorul salvează un formular bazat pe șablonul de formular, InfoPath pornește editorul de script și una dintre următoarele coduri adaugă scriptul.

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

Considerații de compatibilitate

Nu puteți adăuga script la o șablon formular compatibil cu browserul. Puteți să adăugați script doar la un șablon formular ale căror forme va fi completat în InfoPath. Posibilitatea să particularizați un șablon formular compatibil cu browserul doar utilizând cod gestionat.

Începutul paginii

Configurarea limbajului de script al unui formular

Pentru a particulariza un șablon formular utilizând script, puteți utiliza fie Microsoft JScript sau Microsoft Visual Basic Scripting Edition (VBScript). În mod implicit, InfoPath este configurat pentru a adăuga script utilizând JScript. Dacă șablonul formular nu conține orice script sau cod gestionat și preferați să utilizați VBScript ca limba scriptare, să modificați limbajului pentru șablonul de formular la VBScript. Nu se poate utiliza ambele limbi scriptare în același formular.

Dacă șablonul de formular conține deja script într-o limbă și doriți să utilizați altă limbă, trebuie să salvați script existent, astfel încât să puteți efectua conversia scriptul în altă limbă, eliminați scriptul din șablonul de formular prin Opțiuni formular caseta de dialog, apoi adăugați scriptul convertit la șablonul de formular. InfoPath nu poate efectua conversia scripturi un nou limbajului. Schimbarea limbii de script în caseta de dialog Opțiuni formular afectează numai acest șablon formular. Alte șabloane formular va avea JScript ca implicit scriptarea limbă.

1. În meniul Instrumente , faceți clic pe Opțiuni formular.

2. În lista Categorie , în caseta de dialog Opțiuni formular , faceți clic pe programare.

3. În lista limba de codul șablon formular , sub limbajul de programare, faceți clic pe VBScript.

   Note: 

   • După ce configurarea limbajului și creați una sau mai multe gestionari de eveniment pentru un șablon formular, nu puteți modifica limbajului pentru șablonul de formular.

   • Dacă ați instalat Microsoft Visual Studio 2005 Tools for Applications, limba implicită este Microsoft Visual Basic .NET. Încă puteți utiliza această procedură pentru a modifica limbajului la VBScript.

Începutul paginii

Afișează un mesaj de fiecare dată când are loc un eveniment

Dacă doriți să știți ce rulați gestionari de eveniment ca răspuns la o acțiune sau alt eveniment, puteți adăuga temporare cod pentru a afișa o casetă de mesaj, ori de câte ori rulează rutină de tratare eveniment. Trebuie să utilizați acest cod doar pentru a determina când se execută o rutină de tratare eveniment. După ce adăugați acest cod, utilizați examinare pentru a vizualiza un formular bazat pe acest șablon de formular sau de la publicarea șablonului de formular, apoi creați un șablon formular nou. Unele gestionari de eveniment rula doar dacă creați un formular după ce publicarea șablonului de formular. Apoi puteți efectua o acțiune care credeți că poate rula rutină de tratare eveniment. Când se execută de tratare a evenimentului, vedeți o casetă de mesaj.

După ce determinați ce acțiuni sau evenimente rularea de tratare a evenimentului, eliminați codul și apoi să reluați proiectarea șablonul de formular. Dacă nu eliminaţi acest cod și apoi publicați șablonul de formular, utilizatorii vor vedea această casetă de mesaj atunci când rulează de tratare a evenimentului.

1. Adăugarea de tratare a evenimentului.

2. Pentru a adăuga cod în JScript, tastați XDocument.UI.Alert ("Event nume eveniment doar rulat"); Înlocuiți cu numele de tratare a evenimentului. De exemplu, dacă adăugați acest cod la OnValidate de tratare a evenimentului, să tastați XDocument.UI.Alert ("OnValidate rutină de tratare eveniment doar rulat");

3. Pentru a adăuga cod în VBScript, tastați XDocument.UI.Alert ("Event nume eveniment doar rulat") , de exemplu, dacă adăugați acest cod pentru a evenimentului OnSaveRequest , să tastați XDocument.UI.Alert ("OnSaveRequest rutină de tratare eveniment doar rulat")

4. Pentru a testa cod, faceți clic pe examinare în meniul fișier , sau apăsați CTRL + SHIFT + B și apoi efectuați o acțiune de utilizator care poate începe evenimentul. Atunci când are loc evenimentul cu linii de cod, o casetă de mesaj ar trebui să afișeze mesajul.

   Notă: Unele evenimente poate solicita să publicați șablonul formular, apoi creați un formular bazat pe acest șablon formular înainte să efectuați o acțiune de utilizator pentru a începe evenimentul.

5. Înainte de a publica șablonul de formular și permite utilizatorilor să completarea formularelor bazat pe acest șablon de formular, ștergeți codul utilizat pentru a afișa caseta de mesaje.

Începutul paginii

Adăugați un script care să ruleze atunci când un utilizator salvează datele de formular

1. În meniul Instrumente , faceți clic pe Opțiuni formular.

2. În lista Categorie , în caseta de dialog Opțiuni formular , faceți clic pe Deschidere și salvare.

3. Sub Salvare comportament, bifați caseta de selectare Salvare utilizând cod particularizat și apoi faceți clic pe Editare. Microsoft Script Editor începe cu cursorul la evenimentului 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. Alegeți una dintre următoarele sau ambele:

   • Pentru a adăuga un script care rulează înainte de a InfoPath salvează formularul, înlocuiți comentariu Write the code to be run before saving here.cu codul.

   • Pentru a adăuga un script care rulează după InfoPath salvează formularul, înlocuiți comentariu Write the code to be run after saving here. cu codul.

5. Pentru a testa modificările, faceți clic pe Previzualizare pe bara de instrumente Standard sau apăsați CTRL+SHIFT+B.

   Notă: Dacă rutină de tratare eveniment rulează doar după ce creați un formular bazat pe șablonul de formular, publicarea șablonului de formular, făcând clic pe Publicare în meniul fișier și apoi Finalizați expertul de publicare. După ce vă publicarea șablonului de formular, crearea unui formular și apoi efectuați o acțiune pentru a rula rutină de tratare eveniment.

Începutul paginii

Adăugați un script care să ruleze atunci când un utilizator remite date formă

1. În meniul Instrumente , faceți clic pe Opțiuni remitere.

2. În caseta de dialog Opțiuni remitere , bifați caseta de selectare se permite utilizatorilor să remiteți acest formular .

3. Faceți clic pe efectua acțiuni particularizate utilizând codși apoi faceți clic pe Editare cod. Microsoft Script Editor începe cu cursorul la evenimentului 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. Înlocuiți comentariu If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here cu codul.

5. Pentru a testa modificările, faceți clic pe Previzualizare pe bara de instrumente Standard sau apăsați CTRL+SHIFT+B.

Începutul paginii

Adăugați un script care să ruleze atunci când utilizatorul face clic pe un buton

1. Adăugarea unui buton nou într-o vizualizare din șablonul de formular și apoi faceți dublu clic pe butonul.

   Notă: Dacă adăugați script la un buton existent, faceți dublu clic pe butonul existente în schimb.

2. Faceți clic pe fila General.

3. Faceți clic pe Editare formă de cod. Microsoft Script Editor începe cu cursorul la rutină de tratare eveniment OnClick pentru acel buton.

   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. Înlocuiți comentariu Write your code here cu codul.

5. Pentru a testa modificările, faceți clic pe Previzualizare pe bara de instrumente Standard sau apăsați CTRL+SHIFT+B.

Începutul paginii

Adăugați un script care să ruleze atunci când sunt îmbinate formulare existente

1. În meniul Instrumente , faceți clic pe Opțiuni formular.

2. În lista Categorie , în caseta de dialog Opțiuni formular , faceți clic pe Complex.

3. Sub Îmbinarea formularelor, bifați caseta de selectare Activare formular îmbinarea .

4. Bifați caseta de selectare Îmbinare utilizând cod particularizat și apoi faceți clic pe Editare. Microsoft Script Editor începe cu cursorul la OnMergeRequest de tratare a evenimentului.

   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. Înlocuiți comentariu Write the code that handles each form being merged here. cu codul.

6. Pentru a testa codul în acest caz, publicarea șablonului de formular, creați mai multe forme bazat pe acest șablon de formular și apoi îmbinare șabloane formular.

   Notă: Găsiți linkuri către mai multe informații despre publicarea șablonului de formular în secțiunea Consultați și .

Începutul paginii

Adăugați un script pentru a actualiza formulare existente

Dacă ați actualizat un șablon formular publicată anterior, și doriți să actualizați formulare existente bazat pe șablonul de formular respectiv, puteți adăuga script la șablonul de formular actualizat care să ruleze atunci când un utilizator se deschide una dintre formele existente. Atunci când un utilizator se deschide un formular existent, InfoPath verifică numărul de versiune sale asociate a șablonului de formular la locația de publicare. Dacă numărul de versiune al șablonului de formular la locația de publicare este mai nouă decât numărul de versiune în formular existent, care indică faptul că aceasta a fost actualizat, InfoPath rulează codul, în acest eveniment să se actualizeze pe formular.

1. În meniul Instrumente , faceți clic pe Opțiuni formular.

2. În lista Categorie , în caseta de dialog Opțiuni formular , faceți clic pe controlul de versiune.

3. În lista versiune faceți upgrade , faceți clic pe utilizare eveniment particularizateși apoi faceți clic pe Editare. Microsoft Script Editor începe cu cursorul la evenimentului 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. Înlocuiți comentariu Write your code here cu codul.

5. Pentru a testa codul în acest caz, publicarea șablonului de formular, creați mai multe forme bazat pe acest șablon de formular, modificarea și publicarea unei versiuni actualizate a șablonului de formular și deschideți un formular existent, bazat pe o versiune mai veche a acestui șablon formular.

   Notă: Găsiți linkuri către mai multe informații despre publicarea șablonului de formular în secțiunea Consultați și .

Începutul paginii

Adăugați un script pentru alte evenimente

Această procedură, poate fi utilizată pentru a adăuga următoarele gestionari de eveniment la un șablon formular:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• În meniul Instrumente , indicați spre programareși apoi faceți clic pe eveniment pentru a adăuga la rutină de tratare eveniment. Microsoft Script Editor începe cu cursorul la rutină de tratare evenimente care le-ați selectat.

• Înlocuiți comentariu Write your code here cu codul.

Începutul paginii