Come aggiungere uno script di pre-elaborazione o post-elaborazione a un'applicazione

In questo argomento viene descritto come usare la console di amministrazione di BizTalk Server o la riga di comando per aggiungere uno script di pre-elaborazione o post-elaborazione a un'applicazione. Quando si aggiunge uno script a un'applicazione, lo script viene incluso nell'applicazione .msi file e viene eseguito quando l'applicazione viene importata, installata o disinstallata.

Quando si aggiunge uno script, è necessario specificare se si tratta di uno script di pre-elaborazione, che verrà eseguito prima dell'avvio dell'importazione o dell'installazione dell'applicazione o di uno script di post-elaborazione, che verrà eseguito al termine dell'importazione o dell'installazione dell'applicazione. Gli script di pre-elaborazione e post-elaborazione vengono eseguiti anche in fase di disinstallazione, nell'ordine opposto a quello in cui sono stati eseguiti durante l'installazione: gli script di pre-elaborazione vengono eseguiti dopo la disinstallazione e gli script di post-elaborazione vengono eseguiti prima della disinstallazione.

È anche possibile rimuovere uno script da un'applicazione. Per istruzioni, vedere Come rimuovere uno script di pre-elaborazione o post-elaborazione da un'applicazione.

Prerequisiti

Per eseguire le procedure descritte in questo argomento, è necessario essere connessi con un account membro del gruppo BizTalk Server Administrators. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk.

Per aggiungere uno script a un'applicazione

Uso della console di amministrazione di BizTalk Server

1. Fare clic su Start, fare clic su Tutti i programmi, fare clic su Microsoft BizTalk Server 20xx e quindi su Amministrazione bizTalk Server.

2. Espandere il gruppo BizTalk, espandere Applicazioni e quindi fare clic con il pulsante destro del mouse sulla cartella dell'applicazione a cui si vuole aggiungere uno script.

3. Scegliere Aggiungi ed eseguire una delle operazioni seguenti:

   • Fare clic su Script di pre-elaborazione se si vuole che lo script venga eseguito prima che l'importazione o l'installazione dell'applicazione inizi o dopo la disinstallazione.

   • Fare clic su Script di post-elaborazione se si vuole che lo script venga eseguito dopo l'importazione o l'installazione dell'applicazione o prima della disinstallazione.

4. Fare clic su Aggiungi e passare al file di script da aggiungere.

5. Selezionare il file di script e fare clic su Apri.

6. Se si desidera sovrascrivere un file di script già esistente nell'applicazione, selezionare la casella di controllo Sovrascrivi tutto . Il file di script deve avere lo stesso nome file di quello aggiunto per essere sovrascritto. In caso contrario, verrà aggiunto il nuovo script e lo script esistente rimarrà invariato nell'applicazione.

7. Fare clic sull'elenco a discesa Tipo di file e fare clic sul tipo di file System.BizTalk:PreprocessingScript o System.BizTalk:PostprocessingScript.

8. Se necessario, in Percorso di destinazione digitare il percorso in cui si desidera copiare il file di script quando l'applicazione è installata e quindi fare clic su OK. Il percorso predefinito installerà lo script nella cartella di installazione dell'applicazione (%BTAD_InstallDir%).

Annotazioni

Se non si specifica questo percorso, lo script non verrà copiato nel file system locale durante l'installazione. Se lo script deve essere eseguito quando l'applicazione viene disinstallata, assicurarsi di specificare questo percorso; in caso contrario, lo script non sarà presente nel file system locale e non verrà eseguito durante la disinstallazione.

Lo script viene aggiunto all'applicazione e viene visualizzato nella cartella Risorse dell'applicazione.

Uso della riga di comando

1. Aprire un prompt dei comandi come indicato di seguito: fare clic su Start, fare clic su Esegui, digitare cmde quindi fare clic su OK.

2. Digitare il comando seguente, sostituendo i valori appropriati, come descritto nella tabella seguente:

   BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:PreProcessingScript|System.BizTalk:PostProcessingScript [/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value][/Property:Args="argument list"]

   Esempio:

   BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:PreProcessingScript /Overwrite /Source:"C:\Source Scripts\MyScript.vbs" /Destination:"C:\New Scripts\MyScript.vbs" /Server:MyDatabaseServer /Database:BizTalkMgmtDb /Property:Args="argument1 argument2"

   Parametro	Valore
   /ApplicationName	Nome dell'applicazione BizTalk a cui aggiungere lo script. Se il nome dell'applicazione non viene specificato, viene usata l'applicazione BizTalk predefinita. Se il nome include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Tipo	System.BizTalk:PreProcessingScript o System.BizTalk:PostProcessingScript, a seconda del tipo di script da aggiungere. Usare System.BizTalk:PreProcessingScript se si vuole che lo script venga eseguito prima dell'importazione o dell'installazione dell'applicazione o dopo la disinstallazione. Usare System.BizTalk:PostProcessingScript se si vuole che lo script venga eseguito dopo l'importazione o l'installazione dell'applicazione o prima della disinstallazione.
   /Sovrascrivere	Aggiornare uno script esistente. Se non specificato e nell'applicazione esiste già un file di script con lo stesso nome del file di script da aggiungere, l'operazione di aggiunta avrà esito negativo.
   /Fonte	Percorso completo del file di script, incluso il nome del file. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Destinazione	Percorso completo del percorso in cui deve essere copiato il file di script quando l'applicazione viene installata dal file MSI. Se non specificato, il file non viene copiato nel file system locale durante l'installazione. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
   /Server	Nome dell'istanza di SQL Server che ospita il database di gestione BizTalk nel formato NomeServer\NomeIstanza,Porta. Il nome dell'istanza è obbligatorio solo quando il nome dell'istanza è diverso dal nome del server. La porta è necessaria solo quando SQL Server usa un numero di porta diverso da quello predefinito (1433). Esempi: Server=MyServer Server=MyServer\MySQLServer,1533 Se non specificato, viene usato il nome dell'istanza di SQL Server in esecuzione nel computer locale.
   /Banca dati	Nome del database di gestione BizTalk. Se non specificato, viene usato il database di gestione BizTalk in esecuzione nell'istanza locale di SQL Server.
   /Property:Args=	Zero o più argomenti. Gli argomenti forniti qui verranno passati allo script quando sarà richiamato.

Vedere anche

Gestione di script di pre-elaborazione e post-elaborazione
Comando AddResource: Script di pre-elaborazione
Comando AddResource: script di post-elaborazione