Anpassa en formulärmall med hjälp av ett skript

I den här artikeln

• Översikt

• Att tänka på kompatibilitet

• Ange skriptspråk för en formulärmall

• Visa ett meddelande varje gång en händelse inträffar

• Lägga till ett skript som körs när en användare sparar formulärdata

• Lägga till ett skript som körs när en användare skickar formulärdata

• Lägga till ett skript som körs när användaren klickar på en knapp

• Lägga till ett skript som körs när befintliga formulär sammanfogas

• Lägga till ett skript för att uppdatera befintliga formulär

• Lägga till ett skript för andra händelser

Översikt

Du kan anpassa InfoPath-formulärmall med hjälp av regler, formler, dataverifiering och villkorsstyrd formatering. Även om de här funktionerna är mycket flexibelt och kan hantera en mängd olika aktiviteter, är vissa aktiviteter utöver funktionerna i de här funktionerna. Du kan inte till exempel använda regler för att skicka ett e-postmeddelande när en användare anger ett värde i en textruta i ett formulär. Om du vill anpassa formulärmallen på ett sätt som är lite mer funktionerna i de här funktionerna och du kan skriva skript med hjälp av skriptspråk JScript eller VBScript, du kan lägga till ett skript som körs när en användare öppnar ett nytt formulär eller ändrar fritt isting formulär som baseras på din formulärmall.

När du lägger till ett skript i en formulärmall startar på Microsoft Skriptredigeraren (MSE), där du kan lägga till, redigera och felsöka skript i en formulärmall och markören placeras i dina valda händelse. En händelsehanterare läggs automatiskt till skriptet. En händelsehanterare är funktionskod i ett InfoPath-formulärmall som svarar på en användare eller en ändring av XML-data i ett formulär. Om du vill spara sina formulär på flera platser i nätverket för användarna kan du lägga till ett skript till OnSaveRequest -händelsehanterare. När du har lagt till ett skript ska köras när användaren sparar ett formulär som baseras på din formulärmall startar Skriptredigeraren och lägger till något av följande koder till 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

Att tänka på kompatibilitet

Du kan inte lägga till skript i en webbläsarkompatibel formulärmall. Du kan lägga till skript i en formulärmall vars formulär ska fyllas i i InfoPath. Du kan anpassa en webbläsarkompatibel formulärmall endast med hjälp av förvaltad kod.

Överst på sidan

Ange skriptspråk för en formulärmall

Om du vill anpassa en formulärmall med hjälp av skript kan du använda Microsoft JScript eller Microsoft Visual Basic Scripting Edition (VBScript). Som standard konfigureras InfoPath om du vill lägga till skript med hjälp av JScript. Om formulärmallen innehåller inte skript eller hanterad kod, och du föredrar att använda VBScript som språk, kan du ändra skriptspråk för formulärmallen till VBScript. Du kan inte använda båda skriptspråk i samma formulärmall.

Om formulärmallen innehåller redan skript i ett språk och du vill använda andra språk, måste du spara det befintliga skriptet så att du kan konvertera skriptet till det andra språket ta bort skriptet från formulärmall mellan Formuläralternativ dialogrutan rutan och Lägg sedan till det konverterade skriptet i formulärmallen. InfoPath kan inte konvertera skript till ett nytt språk. Ändrar skriptspråk i dialogrutan Formuläralternativ påverkas bara den här formulärmallen. Andra formulärmallar har JScript som standard skriptspråk.

1. Klicka på Formuläralternativ på Verktyg-menyn.

2. Klicka på Programming i listan kategori i dialogrutan Formuläralternativ.

3. Klicka på VBScript under programmeringsspråket i formuläret mall kod språklistan.

   Meddelanden: 

   • När du ange skriptspråk och skapa en eller flera händelsehanterare för en formulärmall kan ändra du inte skriptspråk för formulärmallen.

   • Om du har installerat Microsoft Visual Studio 2005 Tools for Applications är standardspråket Microsoft Visual Basic .NET. Du kan fortfarande använda den här proceduren för att ändra skriptspråk till VBScript.

Överst på sidan

Visa ett meddelande varje gång en händelse inträffar

Om du vill veta vad händelsehanterare körs som svar på en åtgärd eller händelse du lägga till tillfälliga koden om du vill visa en meddelanderuta när händelsehanteraren körs. Du bör använda den här koden för att bestämma när en händelsehanterare körs. När du lägger till den här koden kan använda du förhandsversionen av att visa ett formulär som baseras på formulärmallen och publicera en formulärmall och sedan skapa en ny formulärmall. Vissa händelsehanterare köras endast om du skapar ett formulär när du har publicerat formulärmallen. Du kan sedan använda en funktion som du tror kan köra händelsehanterare. När händelsehanteraren körs visas en meddelanderuta.

När du ta reda på vilka åtgärder eller händelser kör händelsehanterare, ta bort koden och sedan fortsätta designa en formulärmall. Om du inte ta bort den här koden och sedan publicera formulärmallen kan kan användarna se den här meddelanderutan när händelsehanterare körs.

1. Lägga till en händelsehanterare.

2. Om du vill lägga till kod i JScript, Skriv XDocument.UI.Alert (”fältet händelse namn händelse körde”); Ersätt med namnet på din händelsehanterare. Om du lägger till den här koden händelsehanterare OnValidate kan skriver du till exempel XDocument.UI.Alert (”fältet OnValidate händelsehanterare körde”);

3. Om du vill lägga till kod i VBScript anger XDocument.UI.Alert (”fältet händelse namn händelse körde”) till exempel om du lägger till den här koden OnSaveRequest -händelsehanterare, skriver du XDocument.UI.Alert (”fältet OnSaveRequest händelsehanterare körde”)

4. Om du vill testa koden klickar du på Förhandsgranska på Arkiv-menyn eller tryck på CTRL + SKIFT + B och utföra en användaråtgärd som som kan starta händelsen. När inträffar med koden för ska en meddelanderuta visa meddelandet.

   Obs!: Vissa händelser kan kräva att publicera en formulärmall och sedan skapa ett formulär som baseras på formulärmallen innan du kan utföra en användaråtgärd att starta händelsen.

5. Ta bort den kod som du använde för att visa meddelanderutan innan du publicerar en formulärmall och användarna kan fylla i formulär som baseras på formulärmallen.

Överst på sidan

Lägga till ett skript som körs när en användare sparar formulärdata

1. Klicka på Formuläralternativ på Verktyg-menyn.

2. Klicka på Öppna och spara i listan kategori i dialogrutan Formuläralternativ.

3. Markera kryssrutan Spara med anpassad kod under funktioner för Spara, och klicka sedan på Redigera. Microsoft Skriptredigeraren startar med markören i OnSaveRequest -händelsehanterare.

   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. Gör något eller båda av följande:

   • Om du vill lägga till ett skript som körs innan InfoPath sparar formuläret Ersätt kommentar Write the code to be run before saving here.med kod.

   • Om du vill lägga till ett skript som körs när InfoPath sparar formuläret Ersätt kommentar Write the code to be run after saving here. med kod.

5. Om du vill testa dina ändringar klickar du på Förhandsgranska i verktygsfältet Standard eller trycker på CTRL+SKIFT+B.

   Obs!: Om händelsehanteraren körs när du har skapat ett formulär som baseras på din formulärmall, publicera formulärmallen genom att klicka på Publicera på Arkiv-menyn och slutföra Publiceringsguiden. När du har publicerat formulärmallen skapa ett formulär och utföra en åtgärd som kör händelsehanterare.

Överst på sidan

Lägga till ett skript som körs när en användare skickar formulärdata

1. Klicka på Skicka alternativ på Verktyg-menyn.

2. I dialogrutan Leveransalternativ markerar du kryssrutan Tillåt användare att skicka det här formuläret.

3. Klicka på Utför anpassad åtgärd med hjälp av koden och klickar sedan på Redigera kod. Microsoft Skriptredigeraren startar med markören i OnSubmitRequest -händelsehanterare.

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

5. Om du vill testa dina ändringar klickar du på Förhandsgranska i verktygsfältet Standard eller trycker på CTRL+SKIFT+B.

Överst på sidan

Lägga till ett skript som körs när användaren klickar på en knapp

1. Lägga till en ny knapp i en vy i en formulärmall och dubbelklicka sedan på knappen.

   Obs!: Om du lägger till skript till en befintlig knapp dubbelklickar du på knappen befintliga i stället.

2. Klicka på fliken Allmänt.

3. Klicka på Redigera formulärets kod. Microsoft Skriptredigeraren startar med markören i händelsehanterare OnClick för 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. Ersätt kommentar Write your code here med kod.

5. Om du vill testa dina ändringar klickar du på Förhandsgranska i verktygsfältet Standard eller trycker på CTRL+SKIFT+B.

Överst på sidan

Lägga till ett skript som körs när befintliga formulär sammanfogas

1. Klicka på Formuläralternativ på Verktyg-menyn.

2. Klicka på Avancerat i listan kategori i dialogrutan Formuläralternativ.

3. Under Koppla formulär, markerar du kryssrutan Aktivera koppling av formulär.

4. Markera kryssrutan Koppla med anpassad kod och klicka sedan på Redigera. Microsoft Skriptredigeraren startar med markören i händelsehanterare 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. Ersätt kommentar Write the code that handles each form being merged here. med kod.

6. Om du vill testa koden i den här händelsen publicera formulärmallen, skapa flera formulär som baseras på formulärmallen och koppla formulärmallarna.

   Obs!: Länkar till mer information om att publicera en formulärmall i avsnittet Se även.

Överst på sidan

Lägga till ett skript för att uppdatera befintliga formulär

Om du har uppdaterat en tidigare publicerad formulärmall och du vill uppdatera de befintliga formulär som baseras på mallen kan du lägga till skript till den uppdaterade formulärmallen som körs när en användare öppnar en av de befintliga formulär. När en användare öppnar ett befintligt formulär, kontrollerar InfoPath versionsnumret för den associerade formulärmallen på publiceringsplatsen. Om versionsnummer för formulärmallen på publiceringsplatsen är senare än versionsnumret i det befintliga formuläret körs som anger att den har uppdaterats, InfoPath koden i händelsen ska uppdatera det befintliga formuläret.

1. Klicka på Formuläralternativ på Verktyg-menyn.

2. Klicka på versionshantering i listan kategori i dialogrutan Formuläralternativ.

3. Klicka på Använd anpassad händelse i listan på version uppgradera och klicka sedan på Redigera. Microsoft Skriptredigeraren startar med markören i OnVersionUpgrade händelsehanterare.

   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. Ersätt kommentar Write your code here med kod.

5. Att testa koden i den här händelsen, publicera formulärmallen, skapa flera formulär som baseras på formulärmallen, ändra och publicera en uppdaterad version av formulärmallen och sedan öppna ett befintligt formulär som baseras på den tidigare versionen av formulärmallen.

   Obs!: Länkar till mer information om att publicera en formulärmall i avsnittet Se även.

Överst på sidan

Lägga till ett skript för andra händelser

Den här proceduren kan användas för att lägga till följande händelsehanterare i formulärmallen:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Peka på Programming på Verktyg-menyn och klicka sedan på händelsen som ska läggas till händelsehanterare. Microsoft Skriptredigeraren startar med markören i händelsehanterare som du har valt.

• Ersätt kommentar Write your code here med kod.

Överst på sidan