Tilpasse en formularskabelon ved hjælp af et script

I denne artikel

• Oversigt

• Overvejelser om kompatibilitet

• Angive scriptsproget for en formularskabelon

• Få vist en meddelelse hver gang en hændelse indtræffer

• Tilføje et script, der køres, når en bruger gemmer formulardata

• Tilføje et script, der køres, når en bruger sender formulardata

• Tilføje et script, der køres, når en bruger klikker på en knap

• Tilføje et script, der køres, når eksisterende formularer flettes

• Tilføje et script for at opdatere de eksisterende formularer

• Tilføje et script til andre begivenheder

Oversigt

Du kan tilpasse InfoPath-formularskabelon ved hjælp af regler, formler, datavalidering og betinget formatering. Selvom disse funktioner er meget fleksible og kan håndtere en lang række opgaver, er nogle opgaver ud over funktionerne i disse funktioner. For eksempel kan du bruge regler til at sende en e-mail-meddelelse, når en bruger indtaster en værdi i et tekstfelt i en formular. Hvis du har brug at tilpasse din formularskabelon på en måde, der er ud over funktionerne i disse funktioner, og du er vant til at skrive scripts ved hjælp af JScript eller VBScript scriptsproget, kan du tilføje et script, der køres, når en bruger åbner en ny formular eller ændrer en ex isting formular, der er baseret på skabelonen.

Når du tilføjer et script til en formularskabelon, starter Microsoft Script Editor (MSE), hvor du kan tilføje, redigere og fejlfinding af script i en formularskabelon i InfoPath, og til at placere markøren i dine valgte begivenhed. InfoPath tilføjer automatisk en hændelseshandler til scriptet. En hændelseshandler er funktionen kode i en InfoPath-formularskabelon, der reagerer på en brugerhandling eller en ændring af XML-data i en formular. Hvis du vil dine brugere at gemme deres formularer til flere netværksplaceringer, kan du tilføje et script til hændelseshandler OnSaveRequest . Når du tilføjer et script skal køres, når brugeren gemmer en formular, der er baseret på skabelonen, InfoPath starter Microsoft Scripteditor og tilføjer en af følgende koder til scriptet.

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

Overvejelser om kompatibilitet

Du kan ikke tilføje script til en webbrowserkompatibel formularskabelon. Du kan tilføje script kun til en formularskabelon, der skal udfyldes Hvis formularer i InfoPath. Du kan tilpasse en webbrowserkompatibel formularskabelon kun ved hjælp af administreret kode.

Toppen af siden

Angive scriptsproget for en formularskabelon

Hvis du vil tilpasse en formularskabelon ved hjælp af script, kan du bruge enten Microsoft JScript eller Microsoft Visual Basic Scripting Edition (VBScript). InfoPath er som standard konfigureret til at tilføje script ved hjælp af JScript. Hvis formularskabelonen ikke indeholder scripts eller administreret kode, og du foretrækker at bruge VBScript som din scriptsproget, kan du ændre scriptsproget for formularskabelonen til VBScript. Du kan ikke bruge begge scripting sprog i den samme formularskabelon.

Hvis formularskabelonen allerede indeholder script på ét sprog, og du vil bruge andet sproget, du har brug at gemme det eksisterende script, så du kan konvertere scriptet til andet sproget, fjerne scriptet fra formularskabelonen gennem Formularindstillinger dialogboksen felt, og Tilføj derefter scriptet konverteret tilbage til formularskabelonen. InfoPath kan ikke konvertere scripts til en ny scriptsproget. Ændre et script-sprog i dialogboksen Formularindstillinger kun påvirker denne formularskabelon. Andre formularskabeloner får JScript som standard scriptsproget.

1. Klik på Formularindstillinger i menuen Funktioner.

2. Klik på det sted på listen kategori i dialogboksen Formularindstillingerprogrammering.

3. Klik på VBScript under programmeringssproget, på listen formular skabelon kodesprog.

   Bemærkninger!: 

   • Når du angive scriptsproget og opretter en eller flere hændelseshandlere for en formularskabelon, kan du ikke ændre scriptsproget for formularskabelonen.

   • Hvis du har installeret Microsoft Visual Studio 2005 Tools for Applications, er standardsproget Microsoft Visual Basic .NET. Du kan stadig bruge denne fremgangsmåde til at ændre scriptsproget til VBScript.

Toppen af siden

Få vist en meddelelse hver gang en hændelse indtræffer

Hvis du gerne vil vide, hvad hændelseshandlere køres som svar på en handling eller en anden begivenhed, kan du tilføje midlertidige-koden for at vise en meddelelse, når hændelseshandleren kører. Du skal bruge denne kode kun for at fastslå, hvornår en hændelseshandler kører. Når du tilføjer denne kode, kan du bruge preview til at få vist en formular, der er baseret på denne formularskabelon eller for at publicere formularskabelonen og derefter oprette en ny formularskabelon. Visse hændelseshandlere køre kun, hvis du opretter en formular, når du publicerer formularskabelonen. Du kan derefter udføre en handling, som du mener kan køre hændelseshandleren. Når hændelseshandleren kører, kan du se en meddelelsesboks.

Når du bestemmer, hvilke handlinger eller begivenheder afspille hændelseshandleren, skal du fjerne koden og derefter fortsætte med at designe formularskabelonen. Hvis du ikke fjerne denne kode, og derefter du publicere formularskabelonen, får brugerne vist denne meddelelsesboks, når hændelseshandleren køres.

1. Tilføj din hændelseshandler.

2. Hvis du vil tilføje kode i JScript, Skriv XDocument.UI.Alert ("feltet begivenhed navn begivenhed lige har kørt") Erstat med navnet på din hændelseshandler. F.eks, hvis du tilføjer denne kode til hændelseshandler OnValidate , skal du skrive XDocument.UI.Alert ("feltet OnValidate hændelseshandler lige har kørt");

3. Tilføje kode i VBScript, skal du skrive XDocument.UI.Alert ("feltet hændelse navn begivenhed lige har kørt") f.eks, hvis du føjer denne kode til hændelseshandler OnSaveRequest , skal du skrive XDocument.UI.Alert ("feltet OnSaveRequest hændelseshandler lige har kørt")

4. Klik på Vis i menuen filer for at teste koden, eller tryk på CTRL + SHIFT + B, og udfør derefter en brugerhandling, der kan starte begivenheden. Når der forekommer på begivenheden med linje af kode, skal en meddelelsesboks vise din meddelelse.

   Bemærk!: Nogle begivenheder kan kræve, at du publicere formularskabelonen og derefter oprette en formular, der er baseret på denne formularskabelon, før du kan udføre en brugerhandling for at starte begivenheden.

5. Før du udgiver på formularskabelon og aktiverer dine brugere at udfylde formularer, der er baseret på denne formularskabelon, kan du slette den kode, du brugte til at få vist meddelelsesfeltet.

Toppen af siden

Tilføje et script, der køres, når en bruger gemmer formulardata

1. Klik på Formularindstillinger i menuen Funktioner.

2. Klik på Åbn og Gem på listen kategori i dialogboksen Formularindstillinger.

3. Marker afkrydsningsfeltet Gem ved hjælp af brugerdefineret kode, og klik derefter på Rediger under funktionsmåde ved lagring. Microsoft Script Editor starter med markøren i hændelseshandler 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. Benyt en af følgende fremgangsmåder eller begge:

   • For at tilføje et script, der afspilles, før InfoPath gemmer formularen, skal du erstatte kommentar Write the code to be run before saving here.med din kode.

   • For at tilføje et script, der afspilles, når InfoPath gemmer formularen, skal du erstatte kommentar Write the code to be run after saving here. med din kode.

5. Klik på Eksempel på værktøjslinjen Standard, eller tryk på Ctrl+Shift+B for at teste ændringerne.

   Bemærk!: Hvis hændelseshandleren kører kun, når du har oprettet en formular, der er baseret på skabelonen, publicere formularskabelonen ved at klikke på Udgiv i menuen filer, og derefter fuldføre guiden Udgivelse. Når du udgiver formularskabelonen, oprette en formular og derefter udføre en handling for at køre hændelseshandleren.

Toppen af siden

Tilføje et script, der køres, når en bruger sender formulardata

1. Klik på Indstillinger for afsendelse i menuen Funktioner.

2. Markér afkrydsningsfeltet Tillad brugere at sende formularen i dialogboksen Indstillinger for afsendelse.

3. Klik på Udfør brugerdefineret handling ved hjælp af kode, og klik derefter på Rediger kode. Microsoft Script Editor starter med markøren i hændelseshandleren af typen 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. Erstat kommentar If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here med din kode.

5. Klik på Eksempel på værktøjslinjen Standard, eller tryk på Ctrl+Shift+B for at teste ændringerne.

Toppen af siden

Tilføje et script, der køres, når en bruger klikker på en knap

1. Tilføj en ny knap til en visning i formularskabelonen, og dobbeltklik derefter på knappen.

   Bemærk!: Hvis du føjer script til en eksisterende knap, skal du dobbeltklikke på eksisterende knappen i stedet.

2. Klik på fanen Generelt.

3. Klik på Rediger formularkode. Microsoft Script Editor starter med markøren på VedKlik hændelseshandler for denne knap.

   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. Erstat kommentar Write your code here med din kode.

5. Klik på Eksempel på værktøjslinjen Standard, eller tryk på Ctrl+Shift+B for at teste ændringerne.

Toppen af siden

Tilføje et script, der køres, når eksisterende formularer flettes

1. Klik på Formularindstillinger i menuen Funktioner.

2. Klik på Avanceret i dialogboksen Formularindstillinger på listen kategori.

3. Under flette formularer, skal du markere afkrydsningsfeltet Aktiver fletning af formularer.

4. Markér afkrydsningsfeltet Flet ved hjælp af brugerdefineret kode, og klik derefter på Rediger. Microsoft Script Editor starter med markøren i hændelseshandler OnMergeRequest .

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

6. Hvis du vil teste koden i så fald, publicere formularskabelonen, oprette flere formularer, der er baseret på denne formularskabelon og derefter flette formularskabelonerne.

   Bemærk!: Du kan finde links til flere oplysninger om publicering af formularskabelonen i afsnittet Se også.

Toppen af siden

Tilføje et script for at opdatere de eksisterende formularer

Hvis du har opdateret en tidligere publiceret formularskabelon, og du vil opdatere de eksisterende formularer, der er baseret på formularskabelonen, kan du føje script til den opdaterede formularskabelon, der afspilles, når en bruger åbner en af de eksisterende formularer. Når en bruger åbner en eksisterende formular, kontrollerer InfoPath versionsnummeret for den tilknyttede formularskabelon på udgivelsesplaceringen. Hvis versionsnummeret af formularskabelonen på udgivelsesplaceringen er nyere end versionsnummeret i den eksisterende formular, kører der angiver, er det blevet opdateret, InfoPath koden i begivenheden at opdatere den eksisterende formular.

1. Klik på Formularindstillinger i menuen Funktioner.

2. Klik på versionsstyring på listen kategori i dialogboksen Formularindstillinger.

3. Klik på Benyt brugerdefineret hændelse på listen ved opgradering, og klik derefter på Rediger. Microsoft Script Editor starter med markøren i hændelseshandler 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. Erstat kommentar Write your code here med din kode.

5. Baseret på denne formularskabelon til at teste koden i så fald, publicere formularskabelonen, oprette flere formularer, redigere og udgive en opdateret version af formularskabelonen og derefter åbne en eksisterende formular, der er baseret på den gamle version af denne formularskabelon.

   Bemærk!: Du kan finde links til flere oplysninger om publicering af formularskabelonen i afsnittet Se også.

Toppen af siden

Tilføje et script til andre begivenheder

Denne fremgangsmåde kan bruges til at føje følgende hændelseshandlerne til formularskabelonen:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Peg på programmering i menuen Funktioner, og klik derefter på hændelsen til at føje til hændelseshandleren. Microsoft Script Editor starter med markøren i den hændelseshandler, du har valgt.

• Erstat kommentar Write your code here med din kode.

Toppen af siden