Formos šablono tinkinimas naudojant scenarijų

Šiame straipsnyje:

• Apžvalga

• Suderinamumo pastabos

• Formos šablono scenarijaus kalbos nustatymas

• Rodyti pranešimą, kiekvieną kartą, kai įvyksta įvykis

• Pridėti scenarijų, kuris paleidžiamas, kai vartotojas įrašo formos duomenys

• Pridėti scenarijų, kuris paleidžiamas, kai vartotojas pateikia formos duomenis

• Pridėti scenarijų, kuris paleidžiamas, kai vartotojas spusteli mygtuką

• Pridėti scenarijų, kuris paleidžiamas, kai sujungiamos formas

• Pridėti scenarijų atnaujinti esamas formas

• Pridėti ir kitų įvykių scenarijų

Apžvalga

Programos InfoPath formos šabloną galite tinkinti naudodami taisykles, formules, duomenų tikrinimo ir sąlyginis formatavimas. Nors šios funkcijos yra labai lankstus ir gali dirbti įvairių užduočių, kai kurias užduotis, yra galimybes, šias funkcijas. Pvz., negalima naudoti taisykles siųsti laišką, kai vartotojas įveda reikšmė į teksto lauką į formos. Jei norite tinkinti savo formos šabloną taip, kad yra galimybes, šias funkcijas, ir jūs esate susipažinęs su rašyti scenarijus naudodami JScript arba VBScript scenarijaus kalbą, galite pridėti scenarijų, kuris paleidžiamas, kai vartotojas atidaro naują formą arba keičia ex svarbiomis formą, sukurtą pagal jūsų formos šabloną.

Jei norite pridėti scenarijų į formos šabloną, "InfoPath" paleidžia "Microsoft" scenarijų rengyklė (MSE), kuris leidžia įtraukti, redaguoti ir derinti scenarijus formos šablone ir perkelia žymeklį į jūsų pasirinktą įvykį. InfoPath automatiškai įtraukia scenarijų įvykio apdorojimo programą. Įvykio apdorojimo programą yra funkcijos kodą į programos InfoPath formos šabloną, kad ji labiau atitiktų vartotojo veiksmus arba pakeisti XML duomenų formoje. Pavyzdžiui, jei norite, kad vartotojai savo formas keliose tinklo vietose, prie OnSaveRequest įvykio apdorojimo programos galite įtraukti scenarijų. Jei norite pridėti scenarijų, kai vartotojas įrašo pagal jūsų formos šabloną, InfoPath scenarijų rengyklė ir prideda šiuos kodus scenarijų.

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

Suderinamumo pastabos

Jūs negalite pridėti scenarijų į su naršykle suderinamas formos šablonas. Scenarijaus galite įtraukti tik į formas, kurios bus pildomos programoje "InfoPath" formos šabloną. Tik naudojant Valdomasis kodas, galite tinkinti su naršykle suderinamas formos šabloną.

Puslapio viršus

Formos šablono scenarijaus kalbos nustatymas

Norėdami tinkinti formos šablono scenarijų, galite naudoti "Microsoft" JScript "arba" Microsoft Visual Basic Scripting Edition (VBScript). Pagal numatytuosius nustatymus InfoPath sukonfigūruotas naudojant JScript pridėti scenarijų. Jei formos šablone nėra scenarijaus ar Valdomasis kodas, ir norite naudoti "VBScript" kalbos scenarijaus kalbą, galite pakeisti scenarijų kūrimo kalbą formos šablono į "VBScript" kalbos. Negalima naudoti abiejų scenarijų kūrimo kalbų tą patį formos šabloną.

Jei formos šablone jau yra scenarijus viena kalba, o jūs norite naudoti kitą kalbą, reikia išsaugoti esamą scenarijų, kad scenarijų, galite konvertuoti į kitą kalbą, pašalinti scenarijų iš formos šablono per Formos parinktys dialogo lango, ir tada konvertuotą scenarijų įtraukti atgal į formos šabloną. InfoPath negalite konvertuoti scenarijų į naują scenarijų kūrimo kalbą. Dialogo lange Formos parinktys scenarijų kalbos keitimas paveikia tik šį formos šabloną. Kitų formų šablonų turės JScript kaip scenarijų kalbą numatytąjį.

1. Meniu Įrankiai spustelėkite Formos parinktys.

2. Dialogo lange Formos parinktys sąraše kategorija spustelėkite programavimas.

3. Sąraše formos šablono kodo kalbaprogramavimo kalba, spustelėkite VBScript.

   Pastabos: 

   • Nustačius scenarijų kūrimo kalbą ir sukurti vieną ar daugiau apdorojimo elementų formos šablono, negalite keisti formos šablono kalbą.

   • Jei įdiegėte "Microsoft Visual Studio 2005 Tools for Applications", numatytoji kalba yra Microsoft Visual Basic .NET. Vis dar galite naudoti šią procedūrą, Norėdami pakeisti scenarijų kūrimo kalbą į "VBScript" kalbos.

Puslapio viršus

Rodyti pranešimą, kiekvieną kartą, kai įvyksta įvykis

Jei norite sužinoti, kas įvykio apdorojimo programos vykdyti veiksmą arba kito įvykio eigą, galite įtraukti laikinąjį kodą, kad būtų rodomas pranešimo langas, kiekvieną kartą, kai įvykio apdorojimo programą. Naudodami šį kodą tik norint nustatyti, kai veikia įvykio apdorojimo programą. Įtraukus šį kodą, galite peržiūrėti peržiūrėti pagal šį formos šabloną arba publikuoti formos šabloną ir sukurti naują formos šabloną. Kai kurios įvykio apdorojimo programos paleisti tik tada, jei kuriate formą, po to, galite publikuoti formos šabloną. Tada galite atlikti veiksmus, kurie, jūsų manymu, gali veikti įvykių apdorojimo programa. Įvykių apdorojimo programa bus vykdoma, matysite pranešimo lauke.

Po to, galite nustatyti, kokius veiksmus arba įvykių vykdyti įvykio apdorojimo programos, pašalinkite kodą ir tada vėl projektuojate formos šabloną. Jei nepašalinti šį kodą ir tada galite publikuoti formų šabloną, kai įvykio apdorojimo programą vartotojai matys šio pranešimo lange.

1. Įtraukite savo įvykio apdorojimo programos.

2. Jei norite pridėti kodo "JScript", įveskite XDocument.UI.Alert ("renginį įvykio pavadinimą tik paleidę"); Pakeiskite savo įvykio pavadinimą. Pavyzdžiui, jei norite pridėti šį kodą įvykio OnValidate apdorojimo programos, įveskite XDocument.UI.Alert ("OnValidate įvykio apdorojimo programa");

3. Kodo įtraukimas į "VBScript" kalbos, pvz., įveskite XDocument.UI.Alert ("renginį įvykio pavadinimą tik paleidę") , jei galite pridėti šį kodą OnSaveRequest įvykio apdorojimo programos, įveskite XDocument.UI.Alert ("The OnSaveRequest įvykio apdorojimo programa")

4. Norėdami patikrinti kodą, meniu failas spustelėkite Peržiūra arba paspauskite CTRL + SHIFT + B ir atlikite vartotojo veiksmą, kuris gali pradėti įvykį. Kai kodo linija įvykiui, pranešimo lauke turėtų būti rodomas savo pranešimą.

   Pastaba: Kai kurie įvykiai gali tekti publikuoti formos šabloną ir tada sukurti formą pagal šį formos šabloną galėtumėte atlikti vartotojo veiksmus Norėdami pradėti įvykį.

5. Prieš publikuodami formos šabloną ir leisti vartotojams pagal šį formos šabloną, panaikinkite kodą, kurį naudojote, kad būtų rodomas pranešimo langas.

Puslapio viršus

Pridėti scenarijų, kuris paleidžiamas, kai vartotojas įrašo formos duomenys

1. Meniu Įrankiai spustelėkite Formos parinktys.

2. Dialogo lange Formos parinktys sąraše kategorija spustelėkite atidaryti ir įrašyti.

3. Dalyje įrašyti veikimo būdą, pažymėkite žymės langelį įrašyti naudojant pasirinktinį kodą , ir spustelėkite Redaguoti. "Microsoft" scenarijų doroklis prasideda OnSaveRequest įvykio apdorojimo programos žymeklį.

   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" kalbos

   '=======
   ' 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. Atlikite vieną arba abu šiuos veiksmus:

   • Norėdami įtraukti scenarijų, kuris paleidžiamas prieš InfoPath įrašo formą, pakeiskite komentarą Write the code to be run before saving here.kodą.

   • Norėdami įtraukti scenarijų, kuris paleidžiamas po InfoPath įrašo formą, pakeiskite komentarą Write the code to be run after saving here. kodą.

5. Norėdami patikrinti savo pakeitimus, įrankių juostoje Standartinė spustelėkite Peržiūra arba paspauskite CTRL + SHIFT + B.

   Pastaba: Jei įvykio apdorojimo programa veikia tik tada, kai kuriate formą pagal jūsų formos šabloną, meniu failas spustelėkite publikuoti publikuoti formos šabloną ir užpildykite publikavimo vedlį. Publikavus formos šabloną, sukurkite formą ir atlikite veiksmą įvykio apdorojimo programos paleisti.

Puslapio viršus

Pridėti scenarijų, kuris paleidžiamas, kai vartotojas pateikia formos duomenis

1. Meniu Įrankiai spustelėkite Pateikimo parinktys.

2. Pateikia dialogo langą Parinktys , pažymėkite žymės langelį leisti vartotojams pateikti šią formą .

3. Spustelėkite atlikti pasirinktinį veiksmą naudojant kodąir tada spustelėkite Redaguoti kodą. "Microsoft" scenarijų doroklis prasideda žymeklį įvykio OnSubmitRequest apdorojimo programa.

   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" kalbos

   '=======
   ' 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. Įrašykite komentarą If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here kodą.

5. Norėdami patikrinti savo pakeitimus, įrankių juostoje Standartinė spustelėkite Peržiūra arba paspauskite CTRL + SHIFT + B.

Puslapio viršus

Pridėti scenarijų, kuris paleidžiamas, kai vartotojas spusteli mygtuką

1. Mygtuko įtraukimas į naują rodinį į formos šabloną ir tada dukart spustelėkite mygtuką.

   Pastaba: Jei įtraukiate scenarijų į esamą mygtuką, dukart spustelėkite esamą mygtuką vietoj to.

2. Spustelėkite skirtuką Bendra .

3. Spustelėkite Redaguoti formą. "Microsoft" scenarijų doroklis prasideda OnClick įvykio apdorojimo programos mygtuko žymeklį.

   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" kalbos

   '=======
   ' 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. Įrašykite komentarą Write your code here kodą.

5. Norėdami patikrinti savo pakeitimus, įrankių juostoje Standartinė spustelėkite Peržiūra arba paspauskite CTRL + SHIFT + B.

Puslapio viršus

Pridėti scenarijų, kuris paleidžiamas, kai sujungiamos formas

1. Meniu Įrankiai spustelėkite Formos parinktys.

2. Sąraše kategorija dialogo lange Formos parinktys spustelėkite Išsamiau.

3. Dalyje sulieti formas, pažymėkite žymės langelį įgalinti formų suliejimą .

4. Pažymėkite žymės langelį sulieti naudojant pasirinktinį kodą , ir spustelėkite Redaguoti. "Microsoft" scenarijų doroklis prasideda OnMergeRequest įvykio žymeklį.

   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" kalbos

   '=======
   ' 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. Įrašykite komentarą Write the code that handles each form being merged here. kodą.

6. Norėdami patikrinti šio įvykio kodą, publikuokite formos šabloną, kurti kelias formas pagal šį formos šabloną ir suliekite formų šablonus.

   Pastaba: Saitai į išsamesnę informaciją apie publikuojant formos šabloną, rasite skyriuje Taip pat žr .

Puslapio viršus

Pridėti scenarijų atnaujinti esamas formas

Jei atnaujinote anksčiau publikuotą formos šabloną ir norite atnaujinti esamas formas, pagrįstas tuo formos šablonu, galite įtraukti scenarijų atnaujintą formos šabloną, kuris paleidžiamas, kai vartotojas atidarys vieną iš esamų formų. Kai vartotojas atidaro esamą formą, InfoPath patikrina savo susietąjį formos šabloną publikavimo vietoje versijos numeris. Jei formos šabloną publikavimo vietoje versijos numeris yra naujesnė negu versijos numerį į esamą formą, nurodanti, kad jis, InfoPath paleidžia kodą tokiu atveju atnaujinti esamą formą.

1. Meniu Įrankiai spustelėkite Formos parinktys.

2. Dialogo lange Formos parinktys sąraše kategorija spustelėkite versijos.

3. Versijos naujinimo sąraše, spustelėkite naudoti pasirinktinį įvykį, ir spustelėkite Redaguoti. "Microsoft" scenarijų doroklis prasideda žymeklį įvykio OnVersionUpgrade apdorojimo programa.

   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" kalbos

   '=======
   ' 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. Įrašykite komentarą Write your code here kodą.

5. Norėdami patikrinti šio įvykio kodą, publikuokite formos šabloną, sukurkite kelias formas pagal šį formos šabloną, modifikuoti ir publikuoti formos šablono versiją ir atidarykite esamą formą pagal šį formos šabloną senesnę.

   Pastaba: Saitai į išsamesnę informaciją apie publikuojant formos šabloną, rasite skyriuje Taip pat žr .

Puslapio viršus

Pridėti ir kitų įvykių scenarijų

Formos šablono pridėti šias įvykio apdorojimo programas galima naudoti šią procedūrą:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• Įkėlimo

• OnSwitchView

• OnSign

• OnValidate

• Meniu Įrankiai nukreipkite žymiklį į programavimasir spustelėkite įvykį, pridėti prie įvykio apdorojimo programos. "Microsoft" scenarijų doroklis prasideda įvykio apdorojimo programos, kurį pasirinkote žymeklį.

• Įrašykite komentarą Write your code here kodą.

Puslapio viršus