Personalizzazione della configurazione del portale BAM

Articolo
07/21/2023

Nel portale BAM sono disponibili diverse opzioni configurabili. Nelle procedure seguenti viene illustrato come modificare il portale BAM per ottimizzare l'esperienza utente.

Nota

Quando si configura il portale come utente rappresentato senza privilegi di amministratore, potrebbe essere necessario disconnettersi e quindi connettersi nuovamente per avere accesso alle funzionalità del portale BAM senza che venga richiesta l'immissione delle credenziali. Prendere ad esempio in considerazione i seguenti scenari:

Si configura il servizio Web o il portale BAM con un utente rappresentato senza privilegi di amministratore. Si impostano le autorizzazioni per il portale in modo che al gruppo Everyone non venga concesso l'accesso al portale. Si crea quindi un gruppo locale denominato PortalUsersGroup e lo si assegna come gruppo Utenti portale. In questo modo solo gli utenti appartenenti a quel gruppo hanno accesso al portale. Dopo aver configurato il portale BAM, aggiungere l'utente corrente al gruppo Utenti portale. Quando si apre il portale BAM, verrà richiesta l'immissione delle credenziali. Tuttavia, se si esegue la disconnessione e quindi ci si connette nuovamente, sarà possibile aprire il portale BAM senza che venga richiesta l'immissione delle credenziali.

BizTalk Server supporta account di gruppo e account utente locali solo in configurazioni basate su un singolo computer. BizTalk Server supporta gli account utente e di gruppo di dominio in configurazioni a uno o più computer.

Esecuzione del portale BAM in un ambiente a 64 bit

Se si usa Internet Information Services (IIS) in un ambiente a 64 bit, è necessario impostare IIS sulla modalità a 32 bit per eseguire il portale BAM.

Importante

Non è necessario impostare IIS 7 in modalità a 32 bit.

Per modificare l'impostazione di un'installazione di IIS dalla modalità a 64 bit alla modalità a 32 bit

Aprire un prompt dei comandi ed eseguire il comando adsutil . A tale scopo, fare clic su Start, fare clic su Esegui, quindi digitare cmd.
Digitare quanto segue al prompt dei comandi: cscript c:\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1.
Chiudere il prompt dei comandi.

Per visualizzare grafica e testo relativi all'azienda in modo uniforme, è possibile modificare gli elementi nella pagina del portale BAM riportati di seguito:

Il logo di Windows Server System posizionato nell'angolo superiore destro della pagina del portale BAM.

Nella seguente procedura viene modificato il file di un foglio di stile CSS (file css) per personalizzare l'aspetto del portale BAM. Le modifiche apportate alle classi specificate sono le sole modifiche supportate. Per quanto possibile, l'impatto delle modifiche sulle classi è stato isolato in modo che, in caso di errori durante la procedura di modifica, venisse mantenuto lo stato attivo del portale BAM.

Attenzione

Se si modificano le altre classi nel file styles.css, verranno disattivate le funzionalità del portale e dei dati e il portale potrebbe non essere più usabile.

Modificare il file web.config del portale BAM. A tale scopo, fare clic su Start, scegliere Esegui, digitare Blocco note \Programmi (x86)\Microsoft BizTalk Server VERSION>BAMPortal\web.config<, quindi fare clic su OK.
Il contenuto della guida introduttiva della pagina principale può essere sostituito modificando la riga seguente: <add key="MainPageContentUrl" value="~/MainPageContent.htm"/>. Modificare MainPageContent.htm nel campo valore in modo che punti al proprio file HTML. Il file HTML deve trovarsi nella stessa directory del file web.config.
Modificare il testo di identificazione della pagina aggiungendo la riga seguente al file di web.config: <add key="PortalTitle" value="New Identification text"/>. Modificare il campo del valore in modo che contenga il testo per l'identificazione del portale.
Modificare il file styles.css del portale BAM. Fare clic su Start, scegliere Esegui, digitare Blocco note \Programmi (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\Styles.css, quindi fare clic su OK.
Modificare il logo nell'angolo superiore destro individuando la classe div .headerLogo e modificando la riga seguente: background-image: url(".. /images/WSS_Logo.gif"); per puntare al file di immagine creato. È consigliabile usare un'immagine gif.
Modificare l'icona di SharePoint individuando la classe div .headerPageIcon e modificando la riga seguente: background-image: url(".. /images/btsSuiteProduction.gif"); per puntare al file di immagine creato.
Salvare il file.
Aprire il portale BAM per visualizzare le modifiche.

Modifica del file web.config del portale BAM

Se il portale BAM risiede in un server in cui vengono usati i certificati SSO (Enterprise Single Sign-On) per SSL (Secure Sockets Layer), sarà necessario configurare il portale in modo che venga accettato l'URL appropriato per il certificato.

Per modificare il portale BAM per il supporto dei siti SSL

Aprire il file web.config usando il Blocco note. Fare clic su Start, scegliere Esegui, digitare Blocco note \Programmi (x86)\Microsoft BizTalk Server VERSIONE>BAMPortal\web.config<, quindi fare clic su OK.

Modificare le due righe seguenti nel file in modo da specificare il percorso del portale abilitato per SSL:

<add key="BamQueryWSUrl" value="http://localhost/BAM/BamQueryService/BamQueryService.asmx"/>
<add key="BamManagementWSUrl" value="http://localhost/BAM/BamManagementService/BamManagementService.asmx"/>

Salvare il file.

Nel portale BAM vengono visualizzati e accettati i dati formattati in base alle impostazioni cultura per cui sono stati configurati. La configurazione viene specificata nel file web.config. Il portale Web ignora le informazioni del parametro "Accept Language" inviate da Internet Explorer. Se ad esempio si esegue una versione di Internet Explorer in cui sono definite impostazioni cultura per la lingua giapponese e si è configurato il portale BAM per l'uso delle impostazioni cultura per la lingua inglese (Stati Uniti), alcuni elementi dati quali date e numeri interi verranno visualizzati, accettati e ordinati in base alle regole appropriate per le impostazioni cultura della lingua inglese (Stati Uniti) e non della lingua giapponese. Tutte le informazioni specifiche delle impostazioni cultura immesse in formato giapponese verranno considerate non valide in quanto nel portale BAM sono previsti dati formattati per la lingua inglese (Stati Uniti).

Per ottenere una gestione coerente della visualizzazione e della formattazione dei dati che possa variare in base alle impostazioni cultura, scegliere una lingua che risulti appropriata per tutti i client del portale BAM e configurare il portale BAM per queste impostazioni cultura. Per assicurarsi che tutti i client siano impostati sulle impostazioni cultura scelte, è necessario installare Multilingual User Interface Pack.

Per le installazioni non in inglese (Stati uniti) di BAM, potrebbe essere necessario impostare il parametro della lingua nel file web.config. Di seguito sono riportati alcuni casi in cui potrebbe essere necessario adottare questa soluzione:

Per localizzare il formato della data e dell'ora visualizzate.
Per localizzare il formato della valuta visualizzata.

Per modificare l'impostazione della lingua del portale.

Aprire il file web.config usando il Blocco note. Fare clic su Start, scegliere Esegui, digitare Blocco note \Programmi (x86)\Microsoft BizTalk Server VERSIONE>BAMPortal\web.config<, quindi fare clic su OK.
Modificare gli attributi delle impostazioni cultura nella seguente riga del file in base alle impostazioni di globalizzazione appropriate:
```
<globalization requestEncoding="utf-8" responseEncoding="utf-8" culture="de-DE" uiCulture="en" />
```
Salvare il file.

Nei casi in cui si verificano timeout per l'attesa di query SQL di grandi dimensioni, potrebbe essere necessario aumentare il valore di timeout del servizio di query.

Per aumentare il valore di timeout del servizio di query

Aprire il file web.config usando il Blocco note. Fare clic su Start, scegliere Esegui, digitare Blocco note \Programmi (x86)\Microsoft BizTalk Server VERSIONE>BAMPortal\BAMManagementService\web.config<, quindi fare clic su OK.
Il valore predefinito di QueryServiceTimeout è 45 secondi. Modificare il valore nella seguente riga per aumentare o ridurre l'intervallo di timeout:
```
<add key="QueryServiceTimeout" value="45" />
```
Salvare il file.

In un ambiente multiserver è a volte possibile che un server non sia in linea. Se ciò accade, potrebbero verificarsi dei ritardi durante i quali il portale BAM non risponde. Per ottimizzare l'uso dell'utente, è possibile modificare l'intervallo tra i tentativi del server. In questo modo viene creato un intervallo di tempo minimo che consente al servizio Web di query BAM di stabilire che il server non è in linea in seguito a un tentativo di connessione non riuscito.

Il valore indica che se si verifica un timeout del database locale durante il tentativo di contattare un database remoto, i dati vengono contrassegnati come incompleti e nel computer locale non verranno eseguiti tentativi di connessione al database remoto finché non è trascorso l'intervallo di tempo specificato.

Per aumentare l'intervallo tra i tentativi per le attività distribuite in un ambiente multiserver

Aprire il file web.config usando il Blocco note. Fare clic su Start, scegliere Esegui, digitare Blocco note \Programmi (x86)\Microsoft BizTalk Server VERSIONE>BAMPortal\BAMManagementService\web.config<, quindi fare clic su OK.
Il valore predefinito di ServerRetryInterval è 5 minuti. Modificare il valore nella seguente riga per aumentare o ridurre l'intervallo tra i tentativi del server:
```
<add key="ServerRetryInterval" value="5"/>
```
Salvare il file.

Per configurare la modalità di presentazione delle opzioni di notifica degli avvisi nel portale BAM

Aprire il file web.config usando il Blocco note. Fare clic su Start, scegliere Esegui, digitare Blocco note \Programmi (x86)\Microsoft BizTalk Server VERSIONE>BAMPortal\web.config<, quindi fare clic su OK.

Modificare il campo valore nell'elemento <add key="AlertNotificationOptions" value="" /> riga del file web.config con un elenco delimitato da virgole che specifica le opzioni di notifica valide con uno dei valori seguenti. Con un valore vuoto vengono visualizzate tutte le opzioni di notifica disponibili sul server nell'ordine restituito dal server. Qualsiasi valore non riconosciuto equivale a un valore vuoto.

Valore	Descrizione
File, Posta elettronica	Vengono visualizzate le opzioni File e Indirizzo posta elettronica. Nell'elenco a discesa viene visualizzata prima l'opzione File e quindi l'opzione Indirizzo posta elettronica.
Indirizzo posta elettronica, File	Vengono visualizzate le opzioni File e Indirizzo posta elettronica. Nell'elenco a discesa viene visualizzata prima l'opzione Indirizzo posta elettronica e quindi l'opzione File.
File	Nel portale viene visualizzata solo la notifica tramite file.
E-mail	Nel portale viene visualizzata solo la notifica tramite posta elettronica.

Salvare il file.

Ambienti server distribuiti

Se l'installazione del portale BAM inserisce gli avvisi e il portale BAM in server diversi, nel registro eventi verrà visualizzato l'errore seguente: "System.Reflection.TargetInvocationException: Eccezione generata dalla destinazione di una chiamata. >--- Impossibile trovare le voci del Registro di sistema per l'istanza specificata di Notification Services."

Per configurare il portale e gli avvisi su server diversi.

Aprire un prompt dei comandi.
Eseguire C:\Programmi\Microsoft SQL Server\90\Notification Services\9.0.242\Bin\nscontrol register -name bamalerts -<server server name Replace server name>>with the name of the server.<
Premere F5 per aggiornare il browser.

Configurazione di IIS per consentire l'uso del protocollo di rete Kerberos nel portale BAM

Se si desidera usare il protocollo di rete Kerberos con il portale BAM, è necessario modificare le impostazioni di sicurezza ACL per il portale Web. Se IIS non è configurato in modo corretto, gli utenti riceveranno l'errore seguente:

Errore HTTP 401.1 - Non autorizzato: l'accesso viene negato a causa di credenziali non valide.

Per altre informazioni sulla modifica delle impostazioni di sicurezza di IIS, vedere l'articolo della Knowledge Base all'indirizzo https://go.microsoft.com/fwlink/?LinkId=57922.

Visualizzazione dei dati BAM aggregati nel portale BAM nelle distribuzioni di SQL Server 2008

Per visualizzare i dati aggregati nel portale BAM da un computer client che si connette al portale BAM quando l'ambiente di distribuzione usa SQL Server 2008, è necessario installare Microsoft SQL Server 2008 Analysis Services 10.0 Provider OLE DB nel computer client. Se il componente Analysis Services non è installato, verrà visualizzato il messaggio di errore seguente:

Il nome> server del server< non può essere contattato o è troppo occupato.

Vedere anche

Pianificazione per il portale BAM

Condividi tramite