Procedura: Eseguire la visualizzazione in anteprima e il debug dei modelli di modulo con codice gestito di InfoPath

L'utilizzo di Microsoft Office InfoPath 2007 con Microsoft Visual Studio Tools for Applications (VSTA), di Visual Studio 2005 con Microsoft Visual Studio Tools per Microsoft Office System 2007 e di Visual Studio 2008 con Visual Studio Tools per Office consente di eseguire il debug tramite l'esecuzione del codice del modulo in modalità anteprima. Quando si avvia il debug del codice del modulo, il progetto viene compilato e il modulo viene visualizzato automaticamente nella finestra di anteprima di InfoPath. Se viene rilevata una riga di codice per cui è stato impostato un punto di interruzione, lo stato attivo passa all'editor di codice. Quando si supera un punto di interruzione, lo stato attivo torna alla finestra di anteprima. Il debug viene interrotto quando si chiude la finestra di anteprima.

È inoltre possibile modificare le opzioni del modulo per il modello di modulo da visualizzare in anteprima e sottoporre a debug utilizzando un ruolo utente specifico o un file di dati di esempio oppure specificando il dominio in cui verrà pubblicato il modulo.

Dopo aver impostato i punti di interruzione nel codice e aver compilato il modello di modulo, è possibile aprire quest'ultimo in modalità di modifica, connetterlo al processo di InfoPath in Visual Studio ed eseguirne il debug in fase di esecuzione.

Nota:
Non è possibile eseguire il debug dei modelli di modulo in fase di esecuzione da VSTA, sia nel caso di modelli di modulo compatibili solo con InfoPath che di quelli compatibili con InfoPath e con InfoPath Forms Services.

Per informazioni sul debug della regola business dei modelli di modulo distribuita in InfoPath Forms Services da Visual Studio, vedere Procedura: Eseguire il debug di moduli abilitati per i browser distribuiti in InfoPath Form Services.

Debug in modalità anteprima

Per eseguire il debug di un progetto di InfoPath in modalità anteprima

1. Creare o aprire un modello di modulo con codice gestito di InfoPath in VSTA o Visual Studio.

2. Impostare uno o più punti di interruzione nel codice del modulo all'interno dell'editor di codice facendo clic sulla barra grigia a sinistra della riga di codice in cui si desidera inserire un punto di interruzione.

   Verrà visualizzato un cerchio rosso e la riga del codice verrà evidenziata, a indicare che l'esecuzione verrà sospesa in corrispondenza di questo punto di interruzione.

3. Scegliere Avvia debug dal menu Debug o premere F5.

   Il progetto verrà compilato e il modulo verrà visualizzato nella finestra di anteprima.

4. Interagire con il modulo fino a quando non viene rilevata una riga di codice contenente un punto di interruzione.

   Lo stato attivo torna all'editor di codice.

5. Scegliere Continua dal menu Debug o premere F5.

6. Al termine del debug, chiudere la finestra di anteprima o scegliere Termina debug dal menu Debug.

Nota:
Per eseguire il debug di un modello di modulo con codice gestito di InfoPath quando si utilizza un membro del modello a oggetti che richiede l'attendibilità completa, è necessario configurare il modello di modulo come descritto in Procedura: Eseguire la visualizzazione in anteprima e il debug dei modelli di modulo con codice gestito che richiedono l'attendibilità completa.

Utilizzo di un file di dati di esempio

Per impostazione predefinita, durante il debug e la visualizzazione in anteprima viene utilizzato il file template.xml generato quando viene creato un modello di modulo. È possibile creare un file di dati personalizzato e specificare che deve essere utilizzato per la visualizzazione in anteprima o il debug eseguendo una delle procedure seguenti.

Per specificare un file di dati di esempio da utilizzare per il debug o la visualizzazione in anteprima in VSTA

1. Per visualizzare il file template.xml, aprire il modello di modulo in modalità progettazione di InfoPath.

2. Scegliere Salva come file di origine dal menu File, salvare i file del modello di modulo in una cartella e quindi aprire il file template.xml in un editor di testo.

3. Creare e salvare un file con la stessa struttura di template.xml e i dati di esempio che si desidera utilizzare.

4. Scegliere Anteprima dal menu File e quindi Impostazioni anteprima.

5. In Dati di esempio specificare il file di dati di esempio personalizzato.

Per specificare un file di dati di esempio da utilizzare per il debug o la visualizzazione in anteprima in Visual Studio

1. Per visualizzare il file template.xml, aprire il progetto modello di modulo in Visual Studio.

2. Chiudere la scheda manifest.xsf [Progettazione].

3. Nella barra degli strumenti Esplora soluzioni fare clic su Mostra tutti i file, fare clic con il pulsante destro del mouse sul file template.xml e quindi scegliere Apri.

4. Selezionare e copiare il contenuto del file template.xml.

5. Scegliere Nuovo dal menu File, scegliere File e creare un file XML.

6. Incollare il contenuto del file template.xml nel nuovo file aggiungendo inoltre i dati di esempio.

7. Scegliere Salva XMLFile1.xml con nome+++ dal menu File e quindi salvare il file nella cartella Modello di modulo InfoPath relativa al progetto.

8. Aprire il file manifest.xsf, scegliere Opzioni modulo dal menu Strumenti, fare clic su Anteprima e quindi specificare il file di dati di esempio personalizzato.

Specifica di un ruolo utente da utilizzare per il debug o la visualizzazione in anteprima

Se sono stati definiti ruoli utente per il modulo utilizzato, è possibile specificarne uno da utilizzare per il debug o la visualizzazione in anteprima del modulo. Per informazioni sulla definizione dei ruoli utente, cercare "ruolo utente" nella Guida di InfoPath.

Per specificare un ruolo da utilizzare per il debug o la visualizzazione in anteprima

1. Se si utilizza InfoPath con VSTA, passare a InfoPath.

   Se si utilizza Visual Studio, fare clic sulla scheda manifest.xsf [Progettazione].

2. Scegliere Opzioni modulo dal menu Strumenti.

3. Fare clic su Anteprima e quindi specificare il ruolo utente da utilizzare nella casella di riepilogo a discesa Anteprima come.

Specifica di un dominio da utilizzare per il debug o la visualizzazione in anteprima

È possibile visualizzare un modulo in anteprima come se fosse pubblicato in un dominio specifico. Questa impostazione verrà applicata solo se il livello di protezione del modello di modulo è impostato in modo esplicito su Dominio.

Per specificare un dominio da utilizzare per il debug o la visualizzazione in anteprima

1. Se si utilizza InfoPath con VSTA, passare a InfoPath.

   Se si utilizza Visual Studio, fare clic sulla scheda manifest.xsf [Progettazione].

2. Scegliere Opzioni modulo dal menu Strumenti.

3. Fare clic su Anteprima e quindi specificare il dominio da utilizzare per la visualizzazione in anteprima e il debug nella casella Dominio.

4. Fare clic su Protezione e attendibilità, deselezionare la casella di controllo Determina automaticamente il livello di protezione (scelta consigliata) e quindi fare clic su Dominio.

Debug in fase di esecuzione

Se si sviluppa il modello di modulo di InfoPath in Microsoft Visual Studio Tools per Microsoft Office System 2007 o in Visual Studio 2008 con Visual Studio Tools per Office, è possibile eseguirne il debug in fase di esecuzione utilizzando la procedura seguente.

Per eseguire il debug di un progetto di InfoPath in fase di esecuzione

1. Aprire il progetto modello di modulo in Visual Studio, impostare uno o più punti di interruzione nel codice e quindi compilare e distribuire il modello di modulo come descritto in Procedura: Distribuire progetti di InfoPath.

2. In InfoPath aprire il modello di modulo in modalità di modifica.

3. In Visual Studio scegliere Connetti a processo dal menu Strumenti.

4. Nell'elenco Processi disponibili selezionare INFOPATH.EXE e quindi fare clic su Connetti.

5. Utilizzare il modulo in InfoPath fino a quando non viene rilevato un punto di interruzione e quindi utilizzare gli strumenti di debug disponibili Visual Studio.