Come eseguire un collegamento a un file Readme

In questo argomento viene illustrato come utilizzare la console di amministrazione BizTalk Server o la riga di comando per aggiungere un file Readme.htm che verrà visualizzato quando un utente fa clic su un collegamento in Installazione applicazioni nel Pannello di controllo.

Quando si installa un'applicazione BizTalk, in Installazione applicazioni nel Pannello di controllo viene creato automaticamente un collegamento a un file denominato Readme.htm. Se nella cartella di installazione dell'applicazione esiste un file Readme.htm, l'utente può accedervi facendo clic sul collegamento "Fare clic qui per informazioni sul supporto" visualizzato sotto il nome dell'applicazione e quindi su "%BTAD_InstallDir%\Readme.htm" (%BTAD_InstallDir% è una variabile di ambiente che rappresenta la cartella di installazione dell'applicazione).

Affinché il collegamento al file Readme.htm da Installazione applicazioni nel Pannello di controllo funzioni, è necessario eseguire le operazioni seguenti:

  • Denominare il file Readme.htm.

  • Quando si aggiunge il file Readme.htm a un'applicazione, specificare la cartella di installazione dell'applicazione come percorso di destinazione del file (come descritto nel passaggio 6 più avanti). Per impostazione predefinita la cartella di installazione dell'applicazione è %Programmi%\Generated by BizTalk\NomeApplicazione. È possibile esprime questo percorso come %BTAD_InstallDir%.

    Se si desidera sovrascrivere un file Readme.htm già esistente nell'applicazione, specificare l'opzione per la sovrascrittura. Se non si seleziona questa opzione e nell'applicazione esiste già un file Readme.htm, l'operazione di aggiunta non riuscirà.

Nota

Se per l'applicazione si installano più file con estensione msi e si seleziona un percorso di installazione diverso per ognuno di essi, quando l'utente fa clic sul collegamento al file Readme in Installazione applicazioni, verrà aperto il file Readme.htm incluso nel file con estensione msi installato per ultimo.

Importante

Se non si crea un file Readme e lo si aggiunge all'applicazione come descritto in questo argomento, quando l'utente fa clic sul relativo collegamento non verrà visualizzato nulla.

Prerequisiti

Per eseguire la procedura descritta in questo argomento, è necessario effettuare l'accesso con un account membro del gruppo Amministratori BizTalk Server. Per informazioni più dettagliate sulle autorizzazioni, vedere Autorizzazioni necessarie per la distribuzione e la gestione di un'applicazione BizTalk.

Per aggiungere un file Readme a un'applicazione

Uso della console di amministrazione BizTalk Server

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

  2. Nell'albero della console espandere BizTalk Server Amministrazione e gruppo BizTalk contenente l'applicazione a cui si vuole aggiungere un file Readme.htm.

  3. Espandere Applicazioni e l'applicazione a cui si vuole aggiungere un file di Readme.htm.

  4. Fare clic con il pulsante destro del mouse sulla cartella Risorse , scegliere Aggiungi e quindi fare clic su Risorse.

  5. Fare clic su Aggiungi, selezionare il file Readme.htm e quindi fare clic su Apri.

  6. Nel percorso destinazione il percorso completo della cartella di installazione dell'applicazione viene specificato per impostazione predefinita, come indicato di seguito: %BTAD_InstallDir%\Readme.htm. Non è consigliabile modificare questo percorso. Se il percorso corretto della cartella di installazione dell'applicazione viene omesso, il file non verrà copiato in tale percorso durante l'installazione e il collegamento non funzionerà.

  7. Al termine, fare clic su OK.

Uso della riga di comando

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

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

    BTSTask AddResource [/ApplicationName:value] /Type:System.BizTalk:File [/Overwrite] /Source:value [/Destination:value] [/Server:value] [/Database:value] [/Database:value]

    Esempio:

    BTSTask AddResource /ApplicationName:MyApplication /Type:System.BizTalk:File /Overwrite /Source:"C:\Readme Files\MyApplication\Readme.htm" /Destination:%BTAD_InstallDir%\Readme.htm" /Server:MyServer /Database:BizTalkMgmtDB

    Parametro Valore
    /Applicationname Nome dell'applicazione BizTalk a cui aggiungere il file Readme. Se non si specifica il nome dell'applicazione, viene utilizzata l'applicazione BizTalk predefinita. Se il nome include spazi, sarà necessario racchiuderlo tra virgolette doppie (").
    /Digitare System.BizTalk:File (per questo valore non è rilevante la distinzione tra maiuscole e minuscole).
    /Sovrascrivere Opzione per sovrascrivere un file esistente. Se omesso, e se nell'applicazione esiste un file con lo stesso nome del file da aggiungere, l'operazione AddResource ha esito negativo.
    /Fonte Percorso completo del file di origine, incluso il nome del file. Se il percorso include spazi, è necessario racchiuderlo tra virgolette doppie (").
    /Destinazione %BTAD_InstallDir%\Readme.htm

    Rappresenta il percorso completo della cartella di installazione dell'applicazione e del File Readme.htm ed è il percorso in cui il file Readme.htm verrà copiato durante l'installazione. Se omesso, il file non verrà copiato nella cartella di installazione dell'applicazione e il collegamento al file Readme.htm in Installazione applicazioni non funzionerà.
    /Server Nome dell'istanza di SQL Server che ospita il database di gestione BizTalk. Necessario se si specifica il parametro Database. Se non viene fornito alcun nome, verrà utilizzato localhost. Se si omettono i parametri Server e Database, verrà utilizzato il database di gestione BizTalk predefinito per il gruppo.
    /Database Nome del database di gestione BizTalk. Necessario se si specifica il parametro Server. Se si omettono i parametri Server e Database, verrà utilizzato il database di gestione BizTalk predefinito per il gruppo.

Vedere anche

Creazione e modifica di applicazioni BizTalk
Comando AddResource: file