Personalizzare un modello di modulo mediante uno script

In questo articolo

• Panoramica

• Considerazioni sulla compatibilità

• Impostare il linguaggio di script per un modello di modulo

• Visualizzare un messaggio ogni volta che si verifica un evento

• Aggiunta di uno script che viene eseguita quando si salva i dati del modulo

• Aggiunta di uno script che viene eseguita quando si inviano i dati del modulo

• Aggiunta di uno script che viene eseguita quando un utente fa clic su un pulsante

• Aggiunta di uno script che viene eseguita quando vengono uniti moduli esistenti

• Aggiunta di uno script per aggiornare i moduli esistenti

• Aggiunta di uno script per altri eventi

Panoramica

È possibile personalizzare il modello di modulo di InfoPath utilizzando regole, formule, la convalida dei dati e formattazione condizionale. Sebbene queste funzionalità sono molto flessibili e possono gestire un'ampia varietà di attività, alcune attività sono oltre le capacità di queste funzionalità. È ad esempio, non è possibile usare le regole per inviare un messaggio di posta elettronica quando si immette un valore in una casella di testo in una maschera. Se è necessario personalizzare il modello di modulo in modo che supera le funzionalità di queste funzionalità e si ha familiarità con la scrittura di script mediante il linguaggio di script JScript o VBScript, è possibile aggiungere uno script che viene eseguita quando si apre un nuovo modulo o modifica di una ex modulo ome basato sul modello di modulo.

Quando si aggiunge un script a un modello di modulo, InfoPath verrà avviata la Microsoft Script Editor (MSE), che consente di aggiungere, modificare ed eseguire il debug dello script in un modello di modulo e il cursore viene posizionato nell'evento scelto. InfoPath aggiunge automaticamente un gestore eventi per lo script. Gestore eventi è il codice della funzione in un modello di modulo di InfoPath che risponde a un'azione dell'utente o modificarne i dati XML in un modulo. Ad esempio, se si vuole agli utenti di salvare i moduli in più percorsi di rete, è possibile aggiungere uno script al gestore eventi OnSaveRequest . Quando si aggiunge uno script da eseguire quando si salva un modulo basato sul modello di modulo, InfoPath verrà avviato l'editor di script e aggiunge uno dei seguenti codici per lo 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

Considerazioni sulla compatibilità

È possibile aggiungere script a un modello di modulo compatibile con browser. È possibile aggiungere script solo a un modello di modulo verranno compilati cui moduli in InfoPath. È possibile personalizzare un modello di modulo compatibile con browser solo tramite codice gestito.

Torna all'inizio

Impostare il linguaggio di script per un modello di modulo

Per personalizzare un modello di modulo mediante gli script, è possibile utilizzare Microsoft JScript o Microsoft Visual Basic, Scripting Edition (VBScript). Per impostazione predefinita, InfoPath è configurato per aggiungere script utilizzando JScript. Il modello di modulo non contiene script o codice gestito, se si preferisce utilizzare il linguaggio di script VBScript, è possibile modificare il linguaggio di script per il modello di modulo in VBScript. Non è possibile utilizzare entrambe le lingue scripting nello stesso modello di modulo.

Se il modello di modulo contiene già script in una lingua e si desidera utilizzare l'altra lingua, è necessario salvare lo script esistente, in modo che è possibile convertire lo script in tali lingue, rimuovere lo script dal modello di modulo mediante le Opzioni modulo finestra di dialogo casella e quindi aggiungere lo script convertito al modello di modulo. InfoPath non è possibile convertire gli script in un nuovo linguaggio di script. Modifica della lingua di script nella finestra di dialogo Opzioni modulo influisce solo su questo modello di modulo. Altri modelli di modulo avrà JScript come il linguaggio di script predefinito.

1. Dal menu Strumenti fare clic su Opzioni modulo.

2. Nell'elenco categoria, nella finestra di dialogo Opzioni modulo, fare clic su programmazione.

3. Nell'elenco linguaggio codice modello di modulo in linguaggio di programmazione, fare clic su VBScript.

   Note: 

   • Dopo aver impostato il linguaggio di script e creare uno o più gestori di eventi per un modello di modulo, non è possibile modificare il linguaggio di script per il modello di modulo.

   • Se è stato installato Microsoft Visual Studio 2005 Tools per le applicazioni, la lingua predefinita è Microsoft Visual Basic .NET. È comunque possibile utilizzare questa procedura per impostare il linguaggio di script VBScript.

Torna all'inizio

Visualizzare un messaggio ogni volta che si verifica un evento

Se si vuole conoscere gestori eventi da eseguire in risposta a un'azione o un altro evento, è possibile aggiungere codice temporaneo per visualizzare una finestra di messaggio ogni volta che viene eseguito il gestore eventi. Utilizzare questo codice solo per stabilire quando viene eseguito un gestore eventi. Dopo aver aggiunto il codice, è possibile usare anteprima per visualizzare un modulo basato sul modello di modulo o pubblicare il modello di modulo e quindi si crea un nuovo modello di modulo. Alcuni gestori eseguite solo se si crea un modulo dopo la pubblicazione del modello di modulo. È quindi possibile eseguire un'azione che potrebbe eseguire il gestore eventi. Quando viene eseguito il gestore eventi, viene visualizzata una finestra di messaggio.

Dopo che è determinare quali azioni o eventi eseguono il gestore eventi, rimuovere il codice e quindi riprendere la progettazione del modello di modulo. Se non viene rimosso questo codice e quindi si pubblica il modello di modulo, gli utenti vedranno questa finestra di messaggio quando viene eseguito il gestore eventi.

1. Aggiungere il gestore eventi.

2. Per aggiungere codice in JScript, digitare XDocument.UI.Alert ("The evento evento name appena eseguita"); Sostituire con il nome del gestore eventi. Ad esempio, se si aggiunge il codice per il gestore eventi OnValidate , sarà necessario immettere XDocument.UI.Alert ("The OnValidate gestore eventi appena eseguita");

3. Per aggiungere codice in VBScript, digitare XDocument.UI.Alert ("The evento evento name appena eseguita") , ad esempio, se si aggiunge il codice al gestore eventi OnSaveRequest , sarà necessario immettere XDocument.UI.Alert ("The OnSaveRequest gestore eventi appena eseguita")

4. Per testare il codice, fare clic su Anteprima dal menu File o premere CTRL + MAIUSC + B e quindi eseguire un'azione dell'utente che è possibile avviare l'evento. Quando si verifica l'evento con la riga di codice, una finestra di messaggio deve essere visualizzato il messaggio.

   Nota: Alcuni eventi potrebbero essere necessario pubblicare il modello di modulo e quindi creare una maschera basata sul modello di modulo prima di poter eseguire un'azione dell'utente per avviare l'evento.

5. Prima di pubblicare il modello di modulo e consentire agli utenti di compilare i moduli basati sul modello di modulo, eliminare il codice che consente di visualizzare la finestra di messaggio.

Torna all'inizio

Aggiunta di uno script che viene eseguita quando si salva i dati del modulo

1. Dal menu Strumenti fare clic su Opzioni modulo.

2. Nell'elenco categoria, nella finestra di dialogo Opzioni modulo, fare clic su Apri e Salva.

3. In salvataggio, selezionare la casella di controllo Salva con codice personalizzato e quindi fare clic su Modifica. Microsoft Script Editor verrà avviato con il cursore sul gestore eventi 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. Eseguire una o entrambe le operazioni seguenti:

   • Per aggiungere uno script che viene eseguita prima salvataggio del modulo, sostituire il commento Write the code to be run before saving here.con il codice.

   • Per aggiungere uno script da eseguire dopo il salvataggio del modulo, sostituire il commento Write the code to be run after saving here. con il codice.

5. Per verificare le modifiche, fare clic su Anteprima nella barra degli strumenti Standard oppure premere CTRL+MAIUSC+B.

   Nota: Se il gestore eventi viene eseguita solo dopo aver creato un modulo basato sul modello di modulo, pubblicare il modello di modulo, fare clic su pubblica nel menu File e quindi completare la pubblicazione guidata. Dopo la pubblicazione del modello di modulo, creare una maschera e quindi eseguire un'azione per avviare il gestore eventi.

Torna all'inizio

Aggiunta di uno script che viene eseguita quando si inviano i dati del modulo

1. Dal menu Strumenti fare clic su Opzioni invio.

2. Nella finestra di dialogo Opzioni invio, selezionare la casella di controllo Consenti agli utenti di inviare il modulo.

3. Fare clic su Esegui azione personalizzata tramite codice e quindi fare clic su Modifica codice. Microsoft Script Editor verrà avviato con il cursore sul gestore eventi 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. Sostituire il commento If the submit operation is successful, set eventObj.ReturnStatus = true Write your code here con il codice.

5. Per verificare le modifiche, fare clic su Anteprima nella barra degli strumenti Standard oppure premere CTRL+MAIUSC+B.

Torna all'inizio

Aggiunta di uno script che viene eseguita quando un utente fa clic su un pulsante

1. Aggiungere un nuovo pulsante a una visualizzazione nel modello di modulo e quindi fare doppio clic sul pulsante.

   Nota: Se si sta aggiungendo script a un pulsante esistente, fare doppio clic sul pulsante esistente invece.

2. Fare clic sulla scheda Generale.

3. Fare clic su Modifica codice modulo. Microsoft Script Editor inizia con il cursore sul gestore eventi OnClick per tale pulsante.

   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. Sostituire il commento Write your code here con il codice.

5. Per verificare le modifiche, fare clic su Anteprima nella barra degli strumenti Standard oppure premere CTRL+MAIUSC+B.

Torna all'inizio

Aggiunta di uno script che viene eseguita quando vengono uniti moduli esistenti

1. Dal menu Strumenti fare clic su Opzioni modulo.

2. Nell'elenco categoria, nella finestra di dialogo Opzioni modulo, fare clic su Avanzate.

3. In unire moduli, selezionare la casella di controllo Consenti unione moduli.

4. Selezionare la casella di controllo Unisci con codice personalizzato e quindi fare clic su Modifica. Microsoft Script Editor inizia con il cursore sul gestore eventi 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. Sostituire il commento Write the code that handles each form being merged here. con il codice.

6. Per testare il codice in questo caso, pubblicare il modello di modulo, creare diversi moduli basati sul modello di modulo e quindi unire i modelli di modulo.

   Nota: Sono disponibili collegamenti a ulteriori informazioni sulla pubblicazione del modello di modulo nella sezione Vedere anche.

Torna all'inizio

Aggiunta di uno script per aggiornare i moduli esistenti

Se è stato aggiornato un modello di modulo pubblicato in precedenza e si desidera aggiornare i moduli esistenti basati sul modello di modulo, è possibile aggiungere script al modello di modulo aggiornato che viene eseguita all'apertura di uno dei moduli esistenti. Quando si apre una maschera esistente, InfoPath controlla il numero di versione del modello associato nella posizione di pubblicazione. Se il numero di versione del modello di modulo nella posizione di pubblicazione più recente del numero di versione nel modulo esistente, che indica che è stato aggiornato, viene eseguito il codice in questo evento per aggiornare il modulo esistente.

1. Dal menu Strumenti fare clic su Opzioni modulo.

2. Nell'elenco categoria, nella finestra di dialogo Opzioni modulo, fare clic su controllo delle versioni.

3. Nell'elenco nella versione aggiornata, fare clic su Utilizza evento personalizzato e quindi fare clic su Modifica. Microsoft Script Editor inizia con il cursore sul gestore eventi 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. Sostituire il commento Write your code here con il codice.

5. Per verificare il codice in questo caso, pubblicare il modello di modulo, creare diversi moduli basati su questo modello di modulo, modificare e pubblicare una versione aggiornata del modello di modulo e quindi aprire una maschera esistente in base alla versione precedente di questo modello di modulo.

   Nota: Sono disponibili collegamenti a ulteriori informazioni sulla pubblicazione del modello di modulo nella sezione Vedere anche.

Torna all'inizio

Aggiunta di uno script per altri eventi

Questa procedura può essere utilizzata per aggiungere i seguenti gestori al modello di modulo:

• OnAfterChange

• OnBeforeChange

• OnContextChange

• OnLoad

• OnSwitchView

• OnSign

• OnValidate

• Dal menu Strumenti scegliere programmazione e quindi fare clic sull'evento da aggiungere al gestore eventi. Microsoft Script Editor verrà avviato con il cursore sul gestore eventi che è stata selezionata.

• Sostituire il commento Write your code here con il codice.

Torna all'inizio