Een formuliersjabloon aanpassen met behulp van een script

In dit artikel

• Overzicht

• Informatie over compatibiliteit

• De scripttaal instellen voor een formuliersjabloon

• Een bericht telkens wanneer die een gebeurtenis weergeven

• Een script toevoegen dat wordt uitgevoerd wanneer een gebruiker de formuliergegevens opslaat

• Een script toevoegen dat wordt uitgevoerd wanneer een gebruiker de formuliergegevens indient

• Een script die wordt uitgevoerd wanneer een gebruiker een knop toevoegen

• Een script toevoegen dat wordt uitgevoerd wanneer bestaande formulieren worden samengevoegd

• Een script als u wilt bijwerken van de bestaande formulieren toevoegen

• Een script toevoegen voor andere gebeurtenissen

Overzicht

U kunt de InfoPath-formuliersjabloon aanpassen met behulp van regels, formules, gegevensvalidatie en voorwaardelijke opmaak. Hoewel deze functies heel flexibel zijn en een groot aantal verschillende taken kunnen afhandelen, worden sommige taken voorbij de mogelijkheden van deze functies zijn. U kunt bijvoorbeeld regels niet gebruiken voor het verzenden van een e-mailbericht wanneer een gebruiker een waarde in een tekstvak op een formulier invoert. Als u nodig hebt om aan te passen de formuliersjabloon op een manier die buiten de mogelijkheden van deze functies en u bekend bent met het schrijven van scripts met behulp van de scripttaal JScript of VBScript, kunt u een script die wordt uitgevoerd wanneer een gebruiker een nieuw formulier opent of een ex wijzigt toevoegen formulier ntroductiepagina die is gebaseerd op de formuliersjabloon.

Wanneer u een script aan een formuliersjabloon toevoegt, wordt InfoPath Hiermee start u de Microsoft Script Editor (MSE), waarmee u kunt toevoegen, bewerken en fouten opsporen in script in een formuliersjabloon en de cursor op de gewenste gebeurtenis geplaatst. Een gebeurtenis-handler InfoPath automatisch toegevoegd aan het script. Een gebeurtenis-handler is de functiecode in een InfoPath-formuliersjabloon die op een gebruikersactie of een wijziging in het XML-gegevens in een formulier reageert. Als u uw gebruikers kunnen hun formulieren opslaan bij verschillende netwerklocaties indienen wilt, kunt u bijvoorbeeld een script toevoegen aan de gebeurtenis . Wanneer u een script om uit te voeren wanneer de gebruiker een formulier op basis van de formuliersjabloon opslaat toevoegt, wordt in InfoPath scripteditor starten en voegt een van de volgende codes aan het script.

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

Informatie over compatibiliteit

U kunt geen script toevoegen aan een voor browsers compatibele formuliersjabloon. U kunt script alleen toevoegen aan een formuliersjabloon waarvan de formulieren in InfoPath worden ingevuld. U kunt een browsercompatibele formuliersjabloon alleen met behulp van beheerde code.

Naar boven

De scripttaal instellen voor een formuliersjabloon

U kunt een formuliersjabloon aanpassen met behulp van script, kunt u Microsoft JScript of Microsoft Visual Basic Scripting Edition (VBScript). InfoPath is standaard geconfigureerd voor het script toevoegen met behulp van JScript. Als de formuliersjabloon geen script of beheerde code bevat en u liever VBScript als scripttaal gebruikt, kunt u de taal voor de formuliersjabloon wijzigen in VBScript. U kunt beide uitvoeren van scripts talen niet gebruiken in dezelfde formuliersjabloon.

Als de formuliersjabloon al script in één taal bevat en u het gebruik van de andere taal wilt wijzigen, moet u het bestaande script opslaan, zodat u het script naar de andere taal converteren kunt, het script verwijderen uit de formuliersjabloon door de Formulieropties dialoogvenster vak en klikt u vervolgens de geconverteerde script terug naar de formuliersjabloon toevoegen. InfoPath kan scripts converteren naar een nieuwe taal voor het uitvoeren van scripts. Als u de scripttaal in het dialoogvenster Formulieropties is alleen van invloed op dit formuliersjabloon. Andere formuliersjablonen heeft JScript als standaard scripttaal.

1. Klik op het menu Extra op Formulieropties.

2. Klik in de lijst categorie in het dialoogvenster Formulieropties op Programming.

3. Klik in de lijst Sjabloontaalprogrammeertaal, klik op VBScript.

   Notities: 

   • Nadat u de scripttaal instellen en een of meer gebeurtenishandlers voor een formuliersjabloon maakt, kunt u de scripttaal voor de formuliersjabloon niet wijzigen.

   • Als u Microsoft Visual Studio 2005 Tools for Applications hebt geïnstalleerd, is de standaardtaal in Microsoft Visual Basic .NET. U kunt deze procedure nog steeds gebruiken om te wijzigen van de scripttaal in VBScript.

Naar boven

Een bericht telkens wanneer die een gebeurtenis weergeven

Als u weten wat gebeurtenishandlers reactie op een actie of andere gebeurtenis worden uitgevoerd wilt, kunt u tijdelijke code als u wilt een berichtvak weergeven wanneer de gebeurtenis-handler wordt uitgevoerd kunt toevoegen. Moet u deze code alleen om te bepalen wanneer een gebeurtenis-handler wordt uitgevoerd. Nadat u deze code hebt toegevoegd, kunt u voorbeeld weergeven van een formulier op basis van deze formuliersjabloon voor een of de formuliersjabloon publiceren en vervolgens een nieuwe formuliersjabloon te maken. Sommige gebeurtenisafhandelingen uitvoeren alleen als u een formulier maken nadat u de formuliersjabloon publiceren. U kunt vervolgens een actie die u denkt dat daardoor de gebeurtenis-handler uitvoeren. Wanneer de gebeurtenis-handler wordt uitgevoerd, ziet u het bericht.

Nadat u welke acties bepalen of gebeurtenissen de gebeurtenis-handler uitgevoerd, verwijdert u de code en vervolgens verder met het ontwerpen van de formuliersjabloon. Als u deze code niet verwijdert en u de formuliersjabloon publiceren, zien uw gebruikers dit berichtvenster wanneer de gebeurtenis-handler wordt uitgevoerd.

1. De gebeurtenis-handler toevoegen.

2. Als u wilt code in JScript hebt toegevoegd, typt u XDocument.UI.Alert ("de gebeurtenis naam gebeurtenis de zojuist hebt uitgevoerd"); Vervangen door de naam van de gebeurtenis-handler. Bijvoorbeeld als u deze code aan de gebeurtenis-handler OnValidate toevoegt , typt u XDocument.UI.Alert ("de OnValidate gebeurtenis-handler zojuist uitgevoerd");

3. Als u wilt toevoegen in VBScript, typt u XDocument.UI.Alert ("de gebeurtenis naam gebeurtenis de zojuist hebt uitgevoerd") , bijvoorbeeld als u deze code toevoegt aan de gebeurtenis , typt u XDocument.UI.Alert ("de OnSaveRequest gebeurtenis-handler zojuist uitgevoerd")

4. De code testen, klikt u op voorbeeld in het menu bestand , of druk op CTRL + SHIFT + B en voert u een gebruikersactie waarop de gebeurtenis kan worden begonnen. Als de gebeurtenis met de regel met code, kan het bericht moet worden weergegeven door een berichtvak.

   Opmerking: Sommige gebeurtenissen mogelijk moet u de formuliersjabloon publiceren en vervolgens een formulier maken op basis van deze formuliersjabloon voordat u een gebruikersactie om te starten van de gebeurtenis kunt uitvoeren.

5. Voordat u de formuliersjabloon publiceren en uw gebruikers dat kunnen formulieren op basis van deze formuliersjabloon voor een invullen, verwijdert u de code die u gebruikt het berichtvak weer te geven.

Naar boven

Een script toevoegen dat wordt uitgevoerd wanneer een gebruiker de formuliergegevens opslaat

1. Klik op het menu Extra op Formulieropties.

2. Klik op openen en opslaanin de lijst categorie in het dialoogvenster Formulieropties .

3. Klik onder gedrag opslaan, schakel het selectievakje opslaan met aangepaste code in en klik vervolgens op bewerken. Microsoft Script Editor wordt gestart met de cursor aan de gebeurtenis .

   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. Voer een of beide handelingen hieronder uit:

   • Als u wilt een script die wordt uitgevoerd voordat InfoPath het formulier slaat toevoegt, kunt u de opmerking Write the code to be run before saving here.vervangen door uw code.

   • Als u wilt een script die wordt uitgevoerd nadat InfoPath het formulier slaat toevoegt, kunt u de opmerking Write the code to be run after saving here. vervangen door uw code.

5. Als u de wijzigingen wilt testen, klikt u op Voorbeeld op de werkbalk Standaard of drukt u op Ctrl+Shift+B.

   Opmerking: Als de gebeurtenis-handler wordt uitgevoerd alleen nadat u een formulier op basis van de formuliersjabloon hebt gemaakt, de formuliersjabloon publiceren door te klikken op publiceren in het menu bestand en voltooi de Wizard publiceren. Nadat u de formuliersjabloon publiceert, een formulier maken en voert u een actie om uit te voeren van de gebeurtenis-handler.

Naar boven

Een script toevoegen dat wordt uitgevoerd wanneer een gebruiker de formuliergegevens indient

1. Klik op het menu Extra op Opties voor indienen.

2. Selecteer het selectievakje gebruikers toestaan om in te dienen dit formulier in het dialoogvenster Opties voor indienen .

3. Klik op aangepaste actie met Code uitvoerenen klik vervolgens op Programmacode bewerken. Microsoft Script Editor wordt gestart met de cursor aan de gebeurtenis-handler 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. Vervang de opmerking If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here door uw code.

5. Als u de wijzigingen wilt testen, klikt u op Voorbeeld op de werkbalk Standaard of drukt u op Ctrl+Shift+B.

Naar boven

Een script die wordt uitgevoerd wanneer een gebruiker een knop toevoegen

1. Knop een nieuwe toevoegen aan een weergave in de formuliersjabloon en dubbelklik vervolgens op de knop.

   Opmerking: Als u script aan een bestaande knop toevoegt, dubbelklikt u in plaats hiervan op de bestaande knop.

2. Klik op het tabblad Algemeen.

3. Klik op Formuliercode bewerken. Microsoft Script Editor wordt gestart met de cursor aan de gebeurtenis-handler OnClick voor deze knop.

   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. Vervang de opmerking Write your code here door uw code.

5. Als u de wijzigingen wilt testen, klikt u op Voorbeeld op de werkbalk Standaard of drukt u op Ctrl+Shift+B.

Naar boven

Een script toevoegen dat wordt uitgevoerd wanneer bestaande formulieren worden samengevoegd

1. Klik op het menu Extra op Formulieropties.

2. Klik in de lijst categorie in het dialoogvenster Formulieropties op Geavanceerd.

3. Selecteer onder formulieren samenvoegen, het selectievakje voor het samenvoegen van formulieren inschakelen .

4. Schakel het selectievakje samenvoegen met aangepaste code in en klik vervolgens op bewerken. Microsoft Script Editor wordt gestart met de cursor aan de gebeurtenis-handler 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. Vervang de opmerking Write the code that handles each form being merged here. door uw code.

6. Test de code in deze gebeurtenis door de formuliersjabloon publiceren, meerdere formulieren op basis van deze formuliersjabloon voor een maken en vervolgens de formuliersjablonen samen te voegen.

   Opmerking: Vindt u koppelingen naar meer informatie over de formuliersjabloon publiceren in de sectie Zie ook .

Naar boven

Een script als u wilt bijwerken van de bestaande formulieren toevoegen

Als u een eerder gepubliceerde formuliersjabloon bijgewerkt en u wilt bijwerken van de bestaande formulieren die zijn gebaseerd op de sjabloon, kunt u script toevoegen aan de bijgewerkte formuliersjabloon die wordt uitgevoerd wanneer een gebruiker een van de bestaande formulieren opent. Wanneer een gebruiker een bestaand formulier opent, controleert InfoPath het versienummer van de bijbehorende formuliersjabloon op de locatie publiceren. Als het versienummer van de formuliersjabloon op de locatie publiceren nieuwer dan het versienummer weergegeven in het bestaande formulier is, die aangeeft dat deze is bijgewerkt, InfoPath wordt uitgevoerd de code in dat geval het bestaande formulier bijwerken.

1. Klik op het menu Extra op Formulieropties.

2. Klik in de lijst categorie in het dialoogvenster Formulieropties op versiebeheer.

3. Klik in de lijst bij versie-upgrade op aangepaste gebeurtenis gebruikenen klik vervolgens op bewerken. Microsoft Script Editor wordt gestart met de cursor aan de gebeurtenis-handler 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. Vervang de opmerking Write your code here door uw code.

5. Voor het testen van de code in dat geval, de formuliersjabloon publiceren, meerdere formulieren maken op basis van deze formuliersjabloon, wijzigen en een bijgewerkte versie van de formuliersjabloon publiceren en open een bestaand formulier op basis van de oudere versie van deze formuliersjabloon.

   Opmerking: Vindt u koppelingen naar meer informatie over de formuliersjabloon publiceren in de sectie Zie ook .

Naar boven

Een script toevoegen voor andere gebeurtenissen

Deze procedure kan worden gebruikt de volgende gebeurtenishandlers toevoegen aan de formuliersjabloon:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Wijs programmerenin het menu Extra en klik vervolgens op de gebeurtenis toevoegen aan de gebeurtenis-handler. Microsoft Script Editor wordt gestart met de cursor aan de gebeurtenis-handler die u hebt geselecteerd.

• Vervang de opmerking Write your code here door uw code.

Naar boven