Tilpasse en skjemamal ved hjelp av et skript

I denne artikkelen

• Oversikt

• Vurderinger for kompatibilitet

• Angi skriptspråk for en skjemamal

• Vise en melding hver gang det oppstår en hendelse

• Legge til et skript som kjøres når en bruker lagrer skjemadata

• Legge til et skript som kjøres når en bruker sender skjemadata

• Legge til et skript som kjøres når brukeren klikker en knapp

• Legge til et skript som kjøres når eksisterende skjemaer slås sammen

• Legge til et skript for å oppdatere eksisterende skjemaer

• Legge til et skript for andre hendelser

Oversikt

Du kan tilpasse InfoPath-skjemamal ved hjelp av regler, formler, datavalidering og betinget formatering. Selv om disse funksjonene er svært fleksible og kan håndtere en rekke oppgaver, noen aktiviteter som er utenfor rekkevidde for disse funksjonene. Du kan for eksempel bruke regler til å sende en e-postmelding når en bruker angir en verdi i en tekstboks i et skjema. Hvis du trenger å tilpasse skjemamalen på en måte som er utenfor rekkevidde for disse funksjonene, og du er fortrolig med å skrive skript ved hjelp av skriptspråk JScript eller VBScript, kan du legge til et skript som kjøres når en bruker åpner et nytt skjema eller endrer en ex jemmeside skjema som er basert på skjemamalen.

Når du legger til et skript i en skjemamal, startes i Microsoft Script Editor (MSE), der du kan legge til, redigere og feilsøke skript i en skjemamal og plasserer markøren i den valgte hendelsen. InfoPath legger automatisk til en hendelsesbehandling skriptet. En hendelsesbehandling er funksjonskoden i en InfoPath-skjemamal som svarer på en brukerhandling eller en endring i XML-dataene i et skjema. Hvis du vil at brukerne skal lagre skjemaene på flere nettverksplasseringer, kan du for eksempel legge til et skript OnSaveRequest -hendelsesbehandling. Når du legger til et skript å kjøre når brukeren lagrer et skjema basert på skjemamalen, startes Skriptredigering og legger til ett av følgende koder i skriptet.

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

Vurderinger for kompatibilitet

Du kan ikke legge til skript i en nettleserkompatibel skjemamal. Du kan legge til skript bare en skjemamal med skjemaer skal fylles ut i InfoPath. Du kan tilpasse en webleserkompatibel skjemamal bare ved hjelp av forvaltet kode.

Til toppen av siden

Angi skriptspråk for en skjemamal

Hvis du vil tilpasse en skjemamal ved hjelp av skript, kan du bruke Microsoft JScript eller Microsoft Visual Basic Scripting Edition (VBScript). InfoPath er som standard konfigurert til å legge til skript ved hjelp av JScript. Hvis skjemamalen inneholder ikke skript eller forvaltet kode, og du foretrekker å bruke VBScript som skriptspråk, kan du endre skriptspråk for skjemamalen til VBScript. Du kan ikke bruke begge skriptspråk i samme skjemamal.

Hvis skjemamalen allerede inneholder skript på ett språk, og du vil bruke det andre språket, må du lagre det eksisterende skriptet slik at du kan konvertere skriptet til det andre språket, Fjern skriptet fra skjemamalen i Alternativer for skjema dialogboksen boksen, og legg deretter konverterte skriptet tilbake til skjemamalen. InfoPath kan ikke konvertere skript til et nytt skriptspråk. Endre skriptspråk i dialogboksen Alternativer for skjema, påvirker bare denne skjemamalen. Andre skjemamaler har JScript som standard skriptspråk.

1. Klikk Alternativer for skjema på Verktøy-menyen.

2. Klikk programmering i kategori-listen i dialogboksen Alternativer for skjema.

3. Klikk VBScript under programmeringsspråket, i listen kodespråk for skjemamal.

   Obs!: 

   • Når du angir skriptspråk og opprette én eller flere hendelsesbehandling for en skjemamal, kan du ikke endre skriptspråk for skjemamalen.

   • Hvis du har installert Microsoft Visual Studio 2005 Tools for Applications, er standardspråket Microsoft Visual Basic .NET. Du kan fortsatt bruke denne fremgangsmåten til å endre skriptspråk til VBScript.

Til toppen av siden

Vise en melding hver gang det oppstår en hendelse

Hvis du vil vite hva hendelsesbehandling kjøres som svar på en handling eller en annen hendelse, kan du legge til midlertidig kode for å vise en melding når hendelsesbehandling kjøres. Du bør bruke denne koden bare til å bestemme når en hendelsesbehandling kjøres. Når du legger til denne koden, kan du bruke forhåndsvisning til å vise et skjema basert på denne skjemamalen eller til å publisere skjemamalen og deretter opprette en ny skjemamal. Del hendelsesbehandling kjøres bare hvis du oppretter et skjema når du har publisert skjemamalen. Du kan deretter utføre en handling som du tror kan kjøre hendelsesbehandling. Når en hendelsesbehandling kjører, kan du se en melding til alle.

Når du har funnet ut hvilke handlinger eller hendelser kjøres hendelsesbehandling, fjerner du koden og fortsetter utformingen av skjemamalen. Hvis du ikke fjerne denne koden, og deretter publiserer skjemamalen, ser brukerne denne meldingsboksen når hendelsesbehandling kjøres.

1. Legge til din hendelsesbehandling.

2. Hvis du vil legge til kode i JScript, skriver du inn XDocument.UI.Alert ("The hendelse navnet hendelse oppstod bare"); Erstatt med navnet på din hendelsesbehandling. Hvis du for eksempel hvis du legger til denne koden OnValidate hendelsesbehandling, skriver du XDocument.UI.Alert ("OnValidate ble nettopp kjørt");

3. Legge til kode i VBScript, skriver du inn XDocument.UI.Alert ("The hendelse navnet hendelse oppstod bare") For Hvis du legger til denne koden OnSaveRequest hendelsesbehandling, skriver du inn XDocument.UI.Alert ("The OnSaveRequest hendelsesbehandling nettopp kjørt")

4. Du kan teste koden, klikker du Forhåndsvisning på fil-menyen eller trykker CTRL + SKIFT + B og utføre en brukerhandling som kan starte hendelsen. Når det oppstår hendelsen med du kodelinje, vises en melding til alle meldingen din.

   Obs!: Enkelte hendelser kan kreve at du publiserer skjemamalen og opprette et skjema basert på denne skjemamalen før du kan utføre en brukerhandling for å starte hendelsen.

5. Før du publiserer skjemamalen og gi brukerne mulighet til å fylle ut skjemaer som er basert på denne skjemamalen, sletter du koden du brukte til å vise melding-boksen.

Til toppen av siden

Legge til et skript som kjøres når en bruker lagrer skjemadata

1. Klikk Alternativer for skjema på Verktøy-menyen.

2. Klikk Åpne og lagre i kategori-listen i dialogboksen Alternativer for skjema.

3. Merk av for Lagre ved hjelp av egendefinert kode under Virkemåte ved lagring, og klikk deretter Rediger. Microsoft Script Editor starter med markøren i OnSaveRequest -hendelsesbehandling.

   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. Gjør ett eller begge av følgende:

   • Hvis du vil legge til et skript som kjøres før skjemaet lagres i InfoPath, erstatte kommentar Write the code to be run before saving here.med koden din.

   • Hvis du vil legge til et skript som kjøres når skjemaet lagres i InfoPath, erstatte kommentar Write the code to be run after saving here. med koden din.

5. Hvis du vil teste endringene, klikker du Forhåndsvisning på standardverktøylinjen eller trykker CTRL+SKIFT+B.

   Obs!: Hvis hendelsesbehandling kjøres bare når du har opprettet et skjema basert på skjemamalen, publiserer skjemamalen ved å klikke Publiser på fil-menyen, og fullfør deretter veiviseren for publisering. Når du publiserer skjemamalen, opprette et skjema, og deretter utføre en handling for å kjøre hendelsesbehandling.

Til toppen av siden

Legge til et skript som kjøres når en bruker sender skjemadata

1. Klikk Sendealternativer på Verktøy-menyen.

2. Merk av for Tillat brukere å sende dette skjemaet i dialogboksen Sendealternativer.

3. Klikk Utfør egendefinert handling ved hjelp av kode, og klikk deretter Rediger kode. Microsoft Script Editor starter med markøren i OnSubmitRequest hendelsesbehandling.

   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. Erstatt kommentar If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here med koden.

5. Hvis du vil teste endringene, klikker du Forhåndsvisning på standardverktøylinjen eller trykker CTRL+SKIFT+B.

Til toppen av siden

Legge til et skript som kjøres når brukeren klikker en knapp

1. Legge til en ny-knapp i en visning i skjemamalen, og dobbeltklikk deretter knappen.

   Obs!: Hvis du legger til skript på en eksisterende knapp, dobbeltklikker du den eksisterende knappen i stedet.

2. Klikk på Generelt-fanen.

3. Klikk Rediger skjemakode. Microsoft Script Editor starter med markøren i OnClick hendelsesbehandling for knappen.

   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. Erstatt kommentar Write your code here med koden.

5. Hvis du vil teste endringene, klikker du Forhåndsvisning på standardverktøylinjen eller trykker CTRL+SKIFT+B.

Til toppen av siden

Legge til et skript som kjøres når eksisterende skjemaer slås sammen

1. Klikk Alternativer for skjema på Verktøy-menyen.

2. Klikk Avansert i kategori-listen i dialogboksen Alternativer for skjema.

3. Merk av for Aktiver skjemasammenslåing under Slå sammen skjemaer.

4. Merk av for Flett ved hjelp av egendefinert kode, og klikk deretter Rediger. Microsoft Script Editor starter med markøren i OnMergeRequest hendelsesbehandling.

   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. Erstatt kommentar Write the code that handles each form being merged here. med koden.

6. Hvis du vil teste koden i denne hendelsen, publisere skjemamalen, opprette flere skjemaer som er basert på denne skjemamalen og deretter slå sammen skjemamalene.

   Obs!: Du Finn koblinger til mer informasjon om publisering av skjemamalen i Se også-delen.

Til toppen av siden

Legge til et skript for å oppdatere eksisterende skjemaer

Hvis du har oppdatert en tidligere publisert skjemamal, og du vil oppdatere eksisterende skjemaer som er basert på malen, kan du legge til skript den oppdaterte skjemamalen som kjøres når en bruker åpner en eksisterende skjemaer. Når en bruker åpner et eksisterende skjema, kontrollerer InfoPath versjonsnummeret til den tilknyttede skjemamalen på publiseringsstedet du. Hvis versjonsnummeret av skjemamalen på publiseringsstedet du er nyere enn versjonsnummeret i det eksisterende skjemaet, som viser at har blitt oppdatert, kjøres InfoPath koden i denne hendelsen skal oppdatere det eksisterende skjemaet.

1. Klikk Alternativer for skjema på Verktøy-menyen.

2. Klikk versjonskontroll i kategori-listen i dialogboksen Alternativer for skjema.

3. Klikk Bruk egendefinert hendelse i listen på versjon oppgradere, og klikk deretter Rediger. Microsoft Script Editor starter med markøren i OnVersionUpgrade hendelsesbehandling.

   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. Erstatt kommentar Write your code here med koden.

5. Basert på denne skjemamalen til å teste koden i denne hendelsen, publisere skjemamalen, opprette flere skjemaer, endre og publisere en oppdatert versjon av skjemamalen og åpne et eksisterende skjema som er basert på den gamle versjonen av denne skjemamalen.

   Obs!: Du Finn koblinger til mer informasjon om publisering av skjemamalen i Se også-delen.

Til toppen av siden

Legge til et skript for andre hendelser

Denne fremgangsmåten kan brukes til å legge til følgende hendelsesbehandling i skjemamalen:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Velg programmering på Verktøy-menyen, og klikk deretter hendelsen som skal legges til hendelsesbehandling. Microsoft Script Editor starter med markøren i hendelsesbehandling du valgte.

• Erstatt kommentar Write your code here med koden.

Til toppen av siden