Anpassen einer Formularvorlage mithilfe eines Skripts

Inhalt dieses Artikels

• (Übersicht)

• Kompatibilität Aspekte

• Festlegen der Skriptingtools Sprache für eine Formularvorlage

• Anzeigen einer Meldung bei jedem eines Ereignisses eintreten

• Hinzufügen eines Skripts, das ausgeführt wird, wenn ein Benutzer die Formulardaten speichert

• Hinzufügen eines Skripts, das ausgeführt wird, wenn ein Benutzer die Formulardaten übermittelt.

• Hinzufügen eines Skripts, das ausgeführt wird, wenn ein Benutzer auf eine Schaltfläche klickt

• Hinzufügen eines Skripts, das ausgeführt wird, wenn Sie vorhandene Formulare zusammengeführt werden

• Hinzufügen eines Skripts zum Aktualisieren der vorhandenen Formulare

• Hinzufügen eines Skripts für andere Ereignisse

Übersicht

Sie können Ihre InfoPath-Formularvorlage mithilfe von Regeln, Formeln, datenüberprüfung und bedingte Formatierung anpassen. Obwohl diese Features sehr flexibel sind und eine Vielzahl von Aufgaben behandeln können, können Sie einige Aufgaben Funktionen, die dieser Features werden. Regeln können Sie beispielsweise eine e-Mail-Nachricht senden, wenn ein Benutzer einen Wert in einem Textfeld auf einem Formular eingibt. Wenn Sie müssen Anpassen Ihrer Formularvorlage auf eine Weise, die Funktionen, die über die folgenden Features und Sie wird mit dem Schreiben von Skripts mithilfe der scripting JScript oder VBScript-Sprache vertraut sind, können Sie ein Skript, das ausgeführt wird, wenn ein Benutzer ein neues Formular öffnet oder ein Ex ändert, hinzufügen artseite für einen vorhandenen Formular, das auf Ihrer Formularvorlage basiert.

Wenn Sie einer Formularvorlage ein Skript hinzufügen, InfoPath startet den Microsoft Skript-Editor (MSE), wodurch Sie hinzufügen, bearbeiten und Debuggen von Skripts in einer Formularvorlage, und stellen den Cursor in das ausgewählte Ereignis. InfoPath fügt automatisch einen Ereignishandler an das Skript hinzu. Ein Ereignishandler ist der Funktionscode in einem InfoPath-Formular, das auf eine Benutzeraktion oder eine Änderung der XML-Daten in einem Formular reagiert. Wenn Sie Ihre Benutzer ihre Formulare mit mehreren Netzwerkspeicherorten speichern möchten, können Sie ein Skript zum OnSaveRequest -Ereignishandler hinzufügen. Beim Hinzufügen eines Skripts ausgeführt, wenn der Benutzer ein Formular basierend auf Ihrer Formularvorlage speichert InfoPath startet den Skripteditor, und fügt die folgenden Codes im Skript hinzu.

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

Überlegungen zur Kompatibilität

Sie können keine Browserkompatible Formularvorlage Skript hinzufügen. Sie können nur für eine Formularvorlage Skript hinzufügen, deren Formulare in InfoPath ausgefüllt werden. Sie können eine browserkompatible Formularvorlage nur mithilfe von verwaltetem Code anpassen.

Seitenanfang

Festlegen der Skriptsprache für eine Formularvorlage

Zum Anpassen einer Formularvorlage mithilfe von Skripts können Sie entweder Microsoft JScript oder Microsoft Visual Basic Scripting Edition (VBScript) verwenden. Standardmäßig ist InfoPath für Skript hinzufügen, indem Sie mit JScript konfiguriert. Wenn die Formularvorlage verwalteten Code oder Skripts keine enthalten, und Sie lieber VBScript als scripting-Sprache verwenden, können Sie die scripting-Sprache für die Formularvorlage zu VBScript ändern. Sie können nicht in derselben Formularvorlage beide Skriptingtools Sprachen verwenden.

Wenn die Formularvorlage bereits Skripts in eine Sprache enthält aus, und die anderen Sprache verwenden möchten, müssen Sie das vorhandene Skript zu speichern, sodass Sie das Skript in der anderen Sprache konvertieren können entfernen Sie das Skript aus der Formularvorlage durch die Formularoptionen Dialogfeld ein, und klicken Sie dann das konvertierte Skript zurück zur Formularvorlage hinzufügen. InfoPath kann nicht Skripts in eine neue Skriptingtools Sprache konvertieren. Ändern im Dialogfeld ' Formularoptionen ' Skript-Sprache wirkt sich nur auf dieser Formularvorlage aus. Andere Formularvorlagen haben JScript als Standard scripting Sprache.

1. Klicken Sie im Menü Extras auf Formularoptionen.

2. Klicken Sie in der Liste Kategorie im Dialogfeld ' Formularoptionen ' auf Programmierung.

3. Klicken Sie in der Liste Formular Vorlage Codesprache unter Programmiersprache, die auf VBScript.

   Hinweise: 

   • Nachdem Sie die scripting-Sprache festlegen und einen oder mehrere Ereignishandler für eine Formularvorlage erstellen, können nicht Sie die scripting-Sprache für die Formularvorlage ändern.

   • Wenn Sie Microsoft Visual Studio 2005-Tools für Applikationen installiert haben, wird die Standardsprache Microsoft Visual Basic .NET. Dieses Verfahren können weiterhin um die scripting-Sprache in VBScript zu ändern.

Seitenanfang

Anzeigen einer Meldung bei jedem eines Ereignisses eintreten

Wenn Sie wissen, was Ereignishandler als Antwort auf eine Aktion oder eines anderen Ereignisses ausführen möchten, können Sie temporäre Code ein, um ein Meldungsfeld anzuzeigen, bei jedem Start von der Ereignishandler hinzufügen. Verwenden Sie dieses Codes, um nur zu ermitteln, wann ein Ereignishandler ausgeführt wird. Nachdem Sie diesen Code hinzugefügt haben, können Sie Preview ein Formular basierend auf dieser Formularvorlage anzeigen oder Veröffentlichen der Formularvorlage, und klicken Sie dann Erstellen einer neuen Formularvorlage. Einige Ereignishandler nur ausgeführt, wenn Sie ein Formular erstellen, nachdem Sie die Formularvorlage veröffentlicht. Sie können dann eine Aktion ausführen, die Sie der Meinung sind möglicherweise den Ereignishandler ausgeführt wird. Wenn der Ereignishandler ausgeführt wird, wird eine Meldung angezeigt.

Nachdem Sie, welche Aktionen entscheiden oder Ereignissen den Ereignishandler ausführen, entfernen Sie den Code, und klicken Sie dann fortsetzen Sie die Formularvorlage entwerfen. Wenn dieser Code nicht entfernt, und klicken Sie dann die Formularvorlage veröffentlichen, werden Ihre Benutzer dieses Meldungsfeld angezeigt, wenn der Ereignishandler ausgeführt wird.

1. Fügen Sie Ihren Ereignishandler hinzu.

2. Geben Sie zum Hinzufügen von Code in JScript XDocument.UI.Alert ("das Ereignis Namen-Ereignis wurde soeben ausgeführt"); Ersetzen Sie durch den Namen Ihrer Ereignishandler. Wenn Sie diesen Code der OnValidate -Ereignishandler hinzufügen, möchten Sie XDocument.UI.Alert ("das OnValidate Ereignishandler wurde soeben ausgeführt"); Geben Sie beispielsweise

3. Zum Hinzufügen von Code in VBScript geben XDocument.UI.Alert ("das Ereignis ein Ereignis gerade ausgeführt haben") beispielsweise an, wenn Sie diesen Code OnSaveRequest -Ereignishandler hinzufügen, geben Sie XDocument.UI.Alert ("der OnSaveRequest-Ereignishandler gerade ausgeführt haben")

4. Klicken Sie im Menü Datei auf Vorschau zum Testen des Codes, oder drücken Sie STRG + UMSCHALT + B, und führen Sie dann eine Benutzeraktion, an dem das Ereignis begonnen werden kann. Wenn das Ereignis mit der Zeile des Codes auftritt, sollte ein Meldungsfeld Ihre Nachricht angezeigt werden.

   Hinweis: Einige Ereignisse möglicherweise müssen Sie die Formularvorlage veröffentlichen und dann Erstellen eines Formulars, das auf dieser Formularvorlage basieren, bevor Sie zum Starten des Ereignisses eine Benutzeraktion ausführen können.

5. Bevor Sie die Formularvorlage veröffentlichen, und aktivieren die Benutzer zum Ausfüllen von Formularen, die auf dieser Formularvorlage basieren, löschen Sie den Code, mit dem Sie im Meldungsfeld angezeigt.

Seitenanfang

Hinzufügen eines Skripts, das ausgeführt wird, wenn ein Benutzer die Formulardaten speichert

1. Klicken Sie im Menü Extras auf Formularoptionen.

2. Klicken Sie in der Liste Kategorie im Dialogfeld ' Formularoptionen ' auf Öffnen und speichern.

3. Klicken Sie unter Verhalten beim Speichern möchten aktivieren Sie das Kontrollkästchen Speichern mithilfe von benutzerdefiniertem Code, und klicken Sie dann auf Bearbeiten. Microsoft Script Editor startet mit dem Cursor am Ereignishandler 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. Führen Sie eine der folgenden Aktionen oder beide aus:

   • Um einen Skript hinzuzufügen, bevor InfoPath das Formular speichert, ersetzen Sie den Kommentar Write the code to be run before saving here.mit Ihrem Code ein.

   • Um einen Skript hinzuzufügen, nachdem InfoPath das Formular speichert, ersetzen Sie den Kommentar Write the code to be run after saving here. mit Ihrem Code ein.

5. Klicken Sie zum Testen Ihrer Änderungen auf der Symbolleiste Standard auf Vorschau, oder drücken Sie STRG+UMSCHALT+B.

   Hinweis: Wenn der Ereignishandler ausgeführt wird, nachdem Sie ein Formular basierend auf Ihrer Formularvorlage erstellt, Veröffentlichen der Formularvorlage, indem Sie im Menü Datei auf Veröffentlichen, und führen Sie dann den Veröffentlichen-Assistenten. Nachdem Sie die Formularvorlage veröffentlicht haben, erstellen Sie ein Formular, und führen Sie dann eine Aktion, um die Ereignishandler ausgeführt werden.

Seitenanfang

Hinzufügen eines Skripts, das ausgeführt wird, wenn ein Benutzer die Formulardaten übermittelt.

1. Klicken Sie im Menü Extras auf Optionen zum Absenden.

2. Wählen Sie im Dialogfeld Optionen zum Absenden das Kontrollkästchen Benutzern erlauben, dieses Formular zu senden.

3. Klicken Sie auf benutzerdefinierte Aktion mithilfe von Code ausführen, und klicken Sie dann auf Code bearbeiten. Microsoft Script Editor startet mit dem Cursor am Ereignishandler 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. Ersetzen Sie den Kommentar If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here mit Ihrem Code ein.

5. Klicken Sie zum Testen Ihrer Änderungen auf der Symbolleiste Standard auf Vorschau, oder drücken Sie STRG+UMSCHALT+B.

Seitenanfang

Hinzufügen eines Skripts, das ausgeführt wird, wenn ein Benutzer auf eine Schaltfläche klickt

1. Fügen Sie eine neue Schaltfläche zu einer Ansicht in der Formularvorlage, und doppelklicken Sie dann auf die Schaltfläche.

   Hinweis: Wenn Sie eine vorhandene Schaltfläche Skript hinzufügen möchten, doppelklicken Sie auf die vorhandene Schaltfläche.

2. Klicken Sie auf die Registerkarte Allgemein.

3. Klicken Sie auf Formularcode bearbeiten. Microsoft Script Editor startet mit dem Cursor am Ereignishandler für diese Schaltfläche OnClick .

   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. Ersetzen Sie den Kommentar Write your code here mit Ihrem Code ein.

5. Klicken Sie zum Testen Ihrer Änderungen auf der Symbolleiste Standard auf Vorschau, oder drücken Sie STRG+UMSCHALT+B.

Seitenanfang

Hinzufügen eines Skripts, das ausgeführt wird, wenn Sie vorhandene Formulare zusammengeführt werden

1. Klicken Sie im Menü Extras auf Formularoptionen.

2. Klicken Sie in der Liste Kategorie im Dialogfeld ' Formularoptionen ' auf Erweitert.

3. Aktivieren Sie das Kontrollkästchen Zusammenführen von Formularen aktivieren, klicken Sie unter Zusammenführen von Formularen.

4. Aktivieren Sie das Kontrollkästchen Zusammenführen mithilfe von benutzerdefiniertem Code, und klicken Sie dann auf Bearbeiten. Microsoft Script Editor startet mit dem Cursor am Ereignishandler 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. Ersetzen Sie den Kommentar Write the code that handles each form being merged here. mit Ihrem Code ein.

6. Testen Sie den Code in das Ereignis, Veröffentlichen der Formularvorlage, erstellen mehrere Formulare, die auf dieser Formularvorlage basieren, und klicken Sie dann die Formularvorlagen zusammenführen.

   Hinweis: Suchen nach Links zu weiteren Informationen über das Veröffentlichen der Formularvorlage im Abschnitt Siehe auch.

Seitenanfang

Hinzufügen eines Skripts zum Aktualisieren der vorhandenen Formulare

Wenn Sie eine zuvor veröffentlichte Formularvorlage aktualisiert und auf dieser Formularvorlage basierenden vorhandenen Formularen aktualisiert werden sollen, können Sie Skripts auf der aktualisierten Formularvorlage hinzufügen, die ausgeführt wird, wenn ein Benutzer eine vorhandene Formulare öffnet. Wenn ein Benutzer ein vorhandenes Formular öffnet, überprüft InfoPath die Versionsnummer der die zugehörige Formularvorlage am Veröffentlichungsspeicherort. Ist die Versionsnummer der Formularvorlage am Veröffentlichungsspeicherort neuer als die Versionsnummer im vorhandenen Formular ausgeführt wird, die angibt, dass es aktualisiert wurde, InfoPath den Code in diesem Fall das vorhandene Formular aktualisieren.

1. Klicken Sie im Menü Extras auf Formularoptionen.

2. Klicken Sie auf " Versionsverwaltung " in der Liste Kategorie im Dialogfeld ' Formularoptionen '.

3. Klicken Sie in der Liste Version zu aktualisieren auf benutzerdefiniertes Ereignis, und klicken Sie dann auf Bearbeiten. Microsoft Script Editor startet mit dem Cursor am Ereignishandler 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. Ersetzen Sie den Kommentar Write your code here mit Ihrem Code ein.

5. Testen Sie den Code in das Ereignis, veröffentlichen die Formularvorlage, erstellen Sie mehrere Formulare, die auf dieser Formularvorlage basieren Sie, ändern Sie und veröffentlichen Sie eine aktualisierte Version der Formularvorlage, und öffnen Sie ein vorhandenes Formular basierend auf dieser Formularvorlage die ältere Version.

   Hinweis: Suchen nach Links zu weiteren Informationen über das Veröffentlichen der Formularvorlage im Abschnitt Siehe auch.

Seitenanfang

Hinzufügen eines Skripts für andere Ereignisse

Dieses Verfahren kann verwendet werden, die folgenden Ereignishandler zur Formularvorlage hinzufügen:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Klicken Sie im Menü ExtrasProgramming zeigen Sie, und klicken Sie dann auf das Ereignis mit dem Ereignishandler hinzufügen. Microsoft Script Editor startet mit dem Cursor am Ereignishandler, den Sie ausgewählt haben.

• Ersetzen Sie den Kommentar Write your code here mit Ihrem Code ein.

Seitenanfang