Lomakemallin mukauttaminen komentosarjan avulla

Tämän artikkelin sisältö

• Yleistä

• Yhteensopivuuden huomioon otettavia seikkoja

• Lomakemallin komentosarjakielen määrittäminen

• Näyttöön tulee sanoma aina, kun tapahtuman tapahtuu

• Komentosarjan, joka suoritetaan, kun käyttäjä tallentaa lomakkeen tiedot

• Komentosarjan, joka suoritetaan, kun käyttäjä lähettää lomakkeen tiedot

• Komentosarjan, joka suoritetaan, kun käyttäjä napsauttaa painiketta

• Komentosarjan, joka suoritetaan, kun yhdistetään aiemmin luotuihin lomakkeisiin

• Jos haluat päivittää aiemmin luodut lomakkeet komentosarjan lisääminen

• Muita tapahtumia komentosarjan lisääminen

Yleiskatsaus

Voit mukauttaa InfoPath-lomakemalliksi sääntöjä, kaavat, tietojen kelpoisuuden tarkistaminen ja ehdollisen muotoilun avulla. Vaikka nämä ominaisuudet ovat joustavia, ja voit käsitellä erilaisia tehtäviä, jotkin tehtävät ovat lisäksi näistä toiminnoista ominaisuuksia. Sääntöjen avulla et voi lähettää sähköpostiviestin, kun käyttäjä lisää arvon tekstiruudun lomakkeessa. Jos haluat mukauttaa lomakemallin niin, että on lisäksi näistä toiminnoista ja ominaisuuksista on osaat kirjoittaa komentosarjoja käyttämällä JScript- tai VBScript komentosarjakielen, voit lisätä komentosarjan, joka suoritetaan, kun käyttäjä avaa uusi lomake tai Muokkaa ex isting-lomake, joka perustuu lomakemallin.

Kun komentosarjan lisääminen lomakemalliin, InfoPath käynnistyy Microsoft Script Editor (MSE), jonka avulla voit lisätä, muokata ja lomakemallin komentosarjan korjaaminen ja siirtää kohdistimen valittuun tapahtumaan. InfoPath lisää automaattisesti tapahtumakäsittelijän komentosarja. Tapahtumakäsittelijä on InfoPath-lomakemalliksi, joka vastaa käyttäjän toimet tai lomakkeen XML-tietojen muuttaminen. Esimerkiksi jos haluat tallentaa lomakkeet useita verkkosijainnit-käyttäjille, voit lisätä komentosarja tapahtumankäsittelijästä avulla. Kun lisäät komentosarjan, joka suoritetaan, kun käyttäjä tallentaa lomakemalliin perustuvan lomakkeen, InfoPath käynnistyy script editor ja Lisää jokin seuraavia koodeja komentosarja.

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

Yhteensopivuuden huomioon otettavia seikkoja

Et voi lisätä komentosarjan selainyhteensopiva lomakemalli. Voit lisätä komentosarjan vain lomakemalliin, jonka lomakkeet täytetään InfoPathissa. Voit mukauttaa selainyhteensopivan lomakemallin vain käyttämällä hallittua koodia.

Sivun alkuun

Lomakemallin komentosarjakielen määrittäminen

Jos haluat mukauttaa lomakemallin komentosarjan avulla, voit käyttää Microsoft JScript- tai Microsoft Visual Basic Scripting Edition (VBScript). Oletusarvon mukaan InfoPath on määritetty komentosarjan lisääminen käyttämällä JScript. Jos lomakemallin sisällä hallittua koodia tai komentosarjaa ja haluat käyttää VBScript komentosarjakielen, voit muuttaa lomakemallin komentosarjakielen VBScript. Et voi käyttää sekä komentosarjoja kieliä samaan lomakemalliin.

Lomakemallin sisältää jo komentosarjan eri kielellä ja haluat käyttää haluamaasi kieltä, jos haluat tallentaa aiemmin komentosarjaa niin, että voit muuntaa komentosarja kielen, komentosarjan poistaminen Lomakeasetukset läpi lomakemalli valintaikkuna-ruudusta ja lisää sitten takaisin lomakemallin muunnettu komentosarja. InfoPath ei voi muuntaa komentosarjojen uusi komentosarjakielen. Lomakemallin komentosarjakielen Lomakkeen asetukset -valintaikkunassa muuttaminen vaikuttaa vain. Muut lomakemallien on JScript komentosarjan kielen oletukseksi.

1. Valitse Työkalut -valikosta Lomakeasetukset.

2. Valitse luokka -luettelosta Lomakeasetukset -valintaikkunan Ohjelmointi.

3. Lomakemallin koodin kieli -luettelosta ohjelmointikielellä-kohdassa VBScript.

   Huomautukset: 

   • Kun olet komentosarjakielen määrittäminen ja luo lomakemallin vähintään tapahtuman käsittelytoimintoja, et voi muuttaa lomakemallin komentosarjakielen.

   • Jos olet asentanut Microsoft Visual Studio 2005 Tools for Applications-oletuskielen on Microsoft Visual Basic .NET. Voit muuttaa komentosarjakielen VBScript edelleen tämän toiminnon avulla.

Sivun alkuun

Näyttöön tulee sanoma aina, kun tapahtuman tapahtuu

Jos haluat tietää tapahtumien käsittely suorittaa toiminnon tai muun tapahtuman, voit lisätä väliaikaisen koodin, joka näyttää sanomaruudun aina, kun tapahtumakäsittely suoritetaan. Tätä koodia kannattaa käyttää vain, jos haluat määrittää tapahtumakäsittelijän suorittamisen. Kun olet lisännyt koodin, voit käyttää esikatselu voit tarkastella lomakkeen lomake-mallin pohjalta voit julkaista lomakemallin ja luot sitten uuden lomakemallin. Jotkin tapahtumien käsittely suorittaa vain, jos luot lomakkeen, kun lomakemalli on julkaistu. Voit suorittaa sitten toiminto, jonka uskot tapahtumakäsittelijä saattaa toimia. Tapahtumakäsittelijä suoritetaan, kun näyttöön tulee viesti-ruutuun.

Kun määrittänyt, mitkä toiminnot tai tapahtumat Suorita tapahtumakäsittelijä, Poista koodi ja jatkaa sitten lomakemallin. Jos et poista koodi ja valitse lomakemalli on julkaistu, käyttäjät näkevät viesti-valintaikkuna, kun tapahtumakäsittelijä suoritetaan.

1. Lisää tapahtumankäsittelijä.

2. Voit lisätä koodin JScript-kirjoittaa XDocument.UI.Alert (”tapahtuma-nimen tapahtuma suoritettiin juuri”); Vaihda käyttäjän tapahtumakäsittelijä nimi. Jos olet lisännyt koodin OnValidate tapahtumakäsittelijä, voit esimerkiksi kirjoittaa XDocument.UI.Alert (”OnValidate-tapahtumakäsittelijä suoritettiin juuri”);

3. Voit lisätä koodin VBScript kirjoittamalla XDocument.UI.Alert (”tapahtuman nimi tapahtuma suoritettiin juuri”) , jos lisäät koodi tapahtumankäsittelijästä , voit kirjoittaa XDocument.UI.Alert (”OnSaveRequest tapahtumakäsittelijä suoritettiin juuri”)

4. Jos haluat testata koodia, valitse Tiedosto -valikosta Esikatselu tai painamalla CTRL + VAIHTO + B ja suorita käyttäjältä-toiminto, joka voi aloittaa tapahtuman. Kun koodin viivalla tapahtuman ilmetessä sanomaruutu pitäisi näkyä viesti.

   Huomautus: Jotkin tapahtumat saattaa edellyttää lomakemallin julkaiseminen ja luo sitten lomakemalliin perusteella, ennen kuin voit suorittaa käyttäjän toimet voit aloittaa tapahtuman lomakkeeseen.

5. Ennen kuin lomakemallin julkaiseminen ja käyttäjät voivat täyttää lomakkeita lomakkeen mallin pohjalta, poista koodin, jota käytit viesti-ruutuun.

Sivun alkuun

Komentosarjan, joka suoritetaan, kun käyttäjä tallentaa lomakkeen tiedot

1. Valitse Työkalut -valikosta Lomakeasetukset.

2. Valitse luokka -luettelosta Lomakeasetukset -valintaikkunan avaaminen ja tallentaminen.

3. Valitse Tallenna toimintaValitse Tallenna käyttäen mukautettua koodia -valintaruutu ja valitse sitten Muokkaa. Microsoft Script Editor alkaa tapahtumankäsittelijästä kohdistin.

   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. Tee toinen tai molemmat seuraavista toimista:

   • Voit lisätä komentosarjan, joka suoritetaan, ennen kuin InfoPath tallentaa lomakkeen, korvaa kommentti Write the code to be run before saving here.koodisi.

   • Jos haluat lisätä komentosarjan, joka suoritetaan, kun InfoPath tallentaa lomakkeen, korvaa kommentti Write the code to be run after saving here. koodisi.

5. Testaa muutokset valitsemalla vakiotyökaluriviltä Esikatselu tai painamalla CTRL+VAIHTO+B-näppäinyhdistelmää.

   Huomautus: Tapahtumakäsittelijä käytetään vain, kun luot lomakkeen lomake-mallin, julkaista lomakemallin julkaiseminen valitsemalla Tiedosto -valikon ja noudata ohjatun julkaisutoiminnon. Kun lomakemalli on julkaistu-lomakkeen luominen ja suorita sitten suorittamalla tapahtumakäsittelijä toiminto.

Sivun alkuun

Komentosarjan, joka suoritetaan, kun käyttäjä lähettää lomakkeen tiedot

1. Valitse Työkalut -valikosta Lähetysasetukset.

2. Lähetyksen asetukset -valintaikkunassa valitse Salli käyttäjien tämän lomakkeen lähettäminen -valintaruutu.

3. Valitse Mukautettu toiminto-koodin avullaja valitse sitten Muokkaa koodia. Microsoft Script Editor alkaa OnSubmitRequest tapahtumakäsittelijä kohdistin.

   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. Korvaa kommentti If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here koodisi.

5. Testaa muutokset valitsemalla vakiotyökaluriviltä Esikatselu tai painamalla CTRL+VAIHTO+B-näppäinyhdistelmää.

Sivun alkuun

Komentosarjan, joka suoritetaan, kun käyttäjä napsauttaa painiketta

1. Lisää uusi-painike lomakemallin näkymään ja kaksoisnapsauta sitten painiketta.

   Huomautus: Jos olet lisäämässä komentosarjan aiemmin luotuun painikkeeseen, kaksoisnapsauta aiemmin-painiketta.

2. Valitse Yleiset-välilehti.

3. Valitse Muokkaa lomakkeen koodia. Microsoft Script Editor alkaa painiketta Napsautettaessa tapahtumakäsittely kohdistin.

   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. Korvaa kommentti Write your code here koodisi.

5. Testaa muutokset valitsemalla vakiotyökaluriviltä Esikatselu tai painamalla CTRL+VAIHTO+B-näppäinyhdistelmää.

Sivun alkuun

Komentosarjan, joka suoritetaan, kun yhdistetään aiemmin luotuihin lomakkeisiin

1. Valitse Työkalut -valikosta Lomakeasetukset.

2. Valitse luokka -luettelosta Lomakeasetukset -valintaikkunan Lisäasetukset.

3. Valitse Yhdistä lomakkeet, Ota käyttöön lomakkeiden yhdistäminen -valintaruutu.

4. Valitse Yhdistä käyttäen mukautettua koodia -valintaruutu ja valitse sitten Muokkaa. Microsoft Script Editor alkaa OnMergeRequest tapahtumakäsittelijä kohdistin.

   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. Korvaa kommentti Write the code that handles each form being merged here. koodisi.

6. Voit esikatsella tapahtuman koodi-lomakemallin julkaiseminen, luominen mallin pohjalta lomakkeen useita lomakkeita ja yhdistää sitten lomakemallien.

   Huomautus: Lisätietoja lomakemallin julkaiseminen on Katso myös -osan linkeissä.

Sivun alkuun

Jos haluat päivittää aiemmin luodut lomakkeet komentosarjan lisääminen

Jos olet päivittänyt aiemmin julkaistuja lomakemallin ja haluat päivittää aiemmin lomakemalliin perustuvia lomakkeita, voit lisätä komentosarjan päivitetty lomakemalli, joka suoritetaan, kun käyttäjä avaa jokin aiemmin luotuihin lomakkeisiin. Kun käyttäjä avaa aiemmin luodun lomakkeen, InfoPath tarkistaa siihen liittyvä lomakemalli Julkaise sijainnissa versionumero. Jos lomakemallin julkaiseminen sijainnissa versionumero on uudempi kuin aiemmin luodun lomakkeen versionumero, joka ilmoittaa, että se on päivitetty, InfoPath suorittaa koodin tapahtuman päivittää olemassa olevaa lomaketta.

1. Valitse Työkalut -valikosta Lomakeasetukset.

2. Valitse luokka -luettelosta Lomakeasetukset -valintaikkunan Versiotietojen.

3. Versio päivitetään -luettelossa Käytä mukautettua tapahtumaaja valitse sitten Muokkaa. Microsoft Script Editor alkaa kohdistin tapahtuma .

   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. Korvaa kommentti Write your code here koodisi.

5. Lomakemallin perusteella testata koodia tässä tapauksessa lomakemallin julkaiseminen, useita lomakkeiden luominen, muokkaaminen ja lomakemallin päivitetyn version julkaiseminen ja avaa sitten aiemmin luodun lomakkeen lomakemallin vanhemman version perusteella.

   Huomautus: Lisätietoja lomakemallin julkaiseminen on Katso myös -osan linkeissä.

Sivun alkuun

Muita tapahtumia komentosarjan lisääminen

Tämä toiminto voidaan seuraavat tapahtumien käsittely lisääminen lomakemalliin:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Valitse Työkalut -valikosta Ohjelmointija valitse sitten tapahtuman lisääminen tapahtumakäsittelijä. Microsoft Script Editor alkaa, jonka valitsit tapahtumakäsittelijä kohdistin.

• Korvaa kommentti Write your code here koodisi.

Sivun alkuun