Personnalisation de la configuration du portail BAM

Article
07/21/2023

Il est possible de configurer de nombreuses options dans le portail BAM. Les procédures suivantes décrivent la manière de modifier le portail BAM pour obtenir les meilleures conditions d'utilisation possibles.

Notes

Lorsque vous configurez le portail en tant qu'utilisateur non-administrateur empruntant une identité, il est possible que vous deviez vous déconnecter, puis vous reconnecter pour avoir accès aux composants de portail BAM sans avoir à entrer des informations d'identification. Par exemple, examinez le scénario suivant :

Vous configurez le service Web ou le portail BAM avec un utilisateur non-administrateur empruntant une identité. Vous définissez ensuite des permissions de sorte que le groupe Tout le monde n'ait pas accès au portail. Vous créez un groupe local nommé PortalUsersGroup et affectez ce groupe en tant que groupe Utilisateurs du portail. Cela signifie que seuls les utilisateurs de ce groupe ont accès au portail. Une fois que vous avez configuré le portail BAM, ajoutez l'utilisateur en cours au groupe Utilisateurs du portail. Lorsque vous ouvrez le portail BAM, vous êtes invité à entrer vos informations d'identification. En revanche, si vous vous déconnectez et que vous vous reconnectez immédiatement, vous pouvez ouvrir le portail BAM sans être obligé d'entrer à nouveau vos informations d'identification.

BizTalk Server prend en charge les comptes d'utilisateur et de groupe locaux uniquement dans des configurations ne comprenant qu'un seul ordinateur. BizTalk Server prend en charge les comptes d'utilisateur et de groupe de domaine dans des configurations comprenant un ou plusieurs ordinateurs.

Exécution du portail BAM dans un environnement 64 bits

Si vous utilisez Internet Information Services (IIS) dans un environnement 64 bits, vous devez définir IIS en mode 32 bits pour exécuter le portail BAM.

Important

Il n'est pas utile de configurer IIS 7 en mode 32 bits.

Pour définir en mode 32 bits des services Internet initialement installés en mode 64 bits

Ouvrez une invite de commandes et exécutez la commande adsutil . Pour ce faire, cliquez sur Démarrer, sur Exécuter, puis tapez cmd.
Tapez ce qui suit à l’invite de commandes : cscript c:\inetpub\adminscripts\adsutil.vbs SET W3SVC/AppPools/Enable32bitAppOnWin64 1.
Fermez l'invite de commande.

Vous pouvez modifier la page du portail BAM de sorte qu'elle affiche des éléments textuels et graphiques similaires en les adaptant à votre entreprise :

le logo Windows Server System, situé dans l'angle supérieur droit de la page de portail BAM :

Dans la procédure suivante, il s'agit de modifier un fichier de feuille de style (.css) en cascade pour personnaliser l'apparence du portail BAM. Les modifications apportées aux classes spécifiées sont les seules à être prises en charge. Autant que possible, l'impact des modifications sur les classes a été isolé afin que les erreurs générées au cours du processus de modification n'empêchent pas le portail BAM de fonctionner.

Attention

La modification d'autres classes du fichier de styles CSS styles.css entraîne le masquage des données et des composants de portail, ce qui peut rendre le portail inutilisable.

Modifiez le fichier Web.config du portail BAM. Pour ce faire, cliquez sur Démarrer, sur Exécuter, tapez bloc-notes \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config, puis cliquez sur OK.
Le contenu du démarrage rapide de la page main peut être remplacé en modifiant la ligne suivante : <add key="MainPageContentUrl » value="~/MainPageContent.htm"/>. Modifiez MainPageContent.htm dans le champ valeur pour qu’il pointe vers votre propre fichier HTML. Ce fichier doit appartenir au même répertoire que le fichier Web.config.
Modifiez le texte d’identification de la page en ajoutant la ligne suivante au fichier web.config : <add key="PortalTitle » value="New Identification text"/>. Insérez le texte permettant d'identifier le portail dans le champ de valeur approprié.
Modifiez le fichier styles.css du portail BAM. Cliquez sur Démarrer, sur Exécuter, tapez bloc-notes \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\Styles.css, puis cliquez sur OK.
Modifiez le logo dans le coin supérieur droit en localisant la classe div .headerLogo et en modifiant la ligne suivante : background-image : url(« .. /images/WSS_Logo.gif ») ; pour pointer vers le fichier image que vous avez créé. Nous vous recommandons d'utiliser une image de format .gif.
Modifiez l’icône SharePoint en localisant la classe div .headerPageIcon et en modifiant la ligne suivante : image-arrière-plan : url(« .. /images/btsSuiteProduction.gif ») ; pour pointer vers le fichier image que vous avez créé.
Enregistrez le fichier .
Ouvrez le portail BAM pour visualiser vos modifications.

Modification du fichier web.config dans le portail BAM

Si votre portail BAM réside sur un serveur utilisant les certificats d'authentification unique de l'entreprise pour SSL (Secure Sockets Layer), vous devez configurer le portail de manière à ce qu'il accepte l'URL appropriée au certificat.

Pour paramétrer le portail BAM afin qu'il prenne en charge les sites SSL

Ouvrez le fichier web.config à l'aide du Bloc-notes. Cliquez sur Démarrer, sur Exécuter, tapez bloc-notes \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config, puis cliquez sur OK.

Modifiez les deux lignes suivantes dans le fichier pointant vers l'emplacement de votre portail SSL :

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

Enregistrez le fichier .

Le portail BAM affiche et accepte les données dans le format pris en charge par la culture dans laquelle il a été configuré. Cette configuration se fait dans le fichier Web.config. Le portail web ignore les informations de l'en-tête « Accept-Language » envoyées par Internet Explorer. Par exemple, supposez que vous lancez une session Internet Explorer paramétrée avec la culture japonaise, mais que vous avez configuré une culture anglaise (États-Unis) pour votre portail BAM. Les éléments de données tels que les dates et les nombres entiers seront affichés, acceptés et triés selon les règles propres à la culture anglaise (États-Unis) et non selon les règles du paramétrage en japonais. Toute information entrée en utilisant les règles de format propres à la culture japonaise sera considérée comme non valide par le portail BAM puisqu'il s'attend à recevoir des données en anglais (États-Unis).

Pour parvenir à une certaine cohérence entre la gestion de l'affichage et le formatage des données dépendant des paramètres culturels, optez pour une langue qui convienne à tous les clients du portail BAM. Configurez le portail BAM avec cette culture. Vous devez vérifier que les paramètres culturels sont les mêmes pour tous les clients en installant le pack d'interface utilisateur multilingue.

Pour les installations non américaines de BAM, il peut être nécessaire de définir le paramètre de culture dans le fichier web.config. Voici une liste des cas où ce paramétrage doit être effectué :

Pour localiser le format d'affichage de la date et de l'heure
Pour localiser le format d'affichage de la devise

Pour modifier le paramétrage de la culture dans le portail

Ouvrez le fichier web.config à l'aide du Bloc-notes. Cliquez sur Démarrer, sur Exécuter, tapez bloc-notes \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config, puis cliquez sur OK.
Modifiez les attributs de culture dans la ligne suivante du fichier pour refléter les paramètres de globalisation appropriés :
```
<globalization requestEncoding="utf-8" responseEncoding="utf-8" culture="de-DE" uiCulture="en" />
```
Enregistrez le fichier .

Lorsque vous êtes confronté à des délais d'attente pour des requêtes SQL volumineuses, il peut être nécessaire d'augmenter la valeur du délai d'expiration des services de requête.

Pour augmenter la valeur du délai d'expiration des services de requête

Ouvrez le fichier web.config à l'aide du Bloc-notes. Cliquez sur Démarrer, sur Exécuter, tapez bloc-notes \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\BAMManagementService\web.config, puis cliquez sur OK.
Par défaut, le délai du service de requête est de 45 secondes. Augmentez ou diminuez la valeur de l'intervalle de délai dans la ligne suivante :
```
<add key="QueryServiceTimeout" value="45" />
```
Enregistrez le fichier .

Dans un environnement multiserveur, il peut arriver qu'un serveur soit déconnecté. Lorsque cela se produit, les utilisateurs du portail peuvent être confrontés à des délais car le portail BAM ne répond plus. Pour améliorer les conditions d'utilisation du portail, vous pouvez modifier l'intervalle avant nouvelle tentative pour le serveur. Cette modification entraîne la création d'une durée minimale pendant laquelle le service Web de requête du portail BAM suppose que le serveur est déconnecté suite à un échec de connexion.

La valeur indique que si le délai défini pour une base de données locale a expiré lors d'une tentative de communication avec une base de données distante, les données sont marquées comme étant inachevées et l'ordinateur local ne tente pas de se reconnecter à la base de données distante avant que le délai indiqué ne se soit écoulé.

Pour augmenter l'intervalle avant nouvelle tentative dans le cas d'activités distribuées dans un environnement multiserveur

Ouvrez le fichier web.config à l'aide du Bloc-notes. Cliquez sur Démarrer, sur Exécuter, tapez bloc-notes \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\BAMManagementService\web.config, puis cliquez sur OK.
La valeur par défaut de la propriété ServerRetryInterval est de 5 minutes. Augmentez ou diminuez la valeur de l'intervalle avant nouvelle tentative pour le serveur dans la ligne suivante :
```
<add key="ServerRetryInterval" value="5"/>
```
Enregistrez le fichier .

Pour configurer la présentation des options de notification d'alerte dans le portail BAM

Ouvrez le fichier web.config à l'aide du Bloc-notes. Cliquez sur Démarrer, sur Exécuter, tapez bloc-notes \Program Files (x86)\Microsoft BizTalk Server <VERSION>BAMPortal\web.config, puis cliquez sur OK.

Modifiez le champ valeur dans add <key="AlertNotificationOptions » value=" » /> ligne du fichier web.config avec une liste délimitée par des virgules spécifiant des options de notification valides avec l’une des valeurs suivantes. Une valeur vide entraîne l'affichage de toutes les options de notification disponibles sur le serveur, dans l'ordre renvoyé par le serveur. Toute valeur non reconnue est équivalente à une valeur vide.

Valeur	Description
Fichier, Adresse de messagerie	Les options Fichier et Adresse de messagerie s'affichent. Dans la liste déroulante, l'option Fichier est affichée en premier et l'option Adresse de messagerie vient ensuite.
Adresse de messagerie, Fichier	Les options Fichier et Adresse de messagerie s'affichent. Dans la liste déroulante, l'option Adresse de messagerie est affichée en premier et l'option Fichier vient ensuite.
Fichier	Seule la notification de type Fichier est affichée dans le portail.
E-mail	Seule la notification de type Adresse de messagerie est affichée dans le portail.

Enregistrez le fichier .

Environnements de serveur distribués

Si votre installation du portail BAM place les alertes et le portail BAM sur différents serveurs, vous verrez l’erreur suivante dans le journal des événements : « System.Reflection.TargetInvocationException : Une exception a été levée par la cible d’un appel. >--- Les entrées de Registre pour le instance spécifié de Notification Services sont introuvables. »

Pour configurer le portail et les alertes sur des serveurs différents

Ouvrez une invite de commandes.
Exécutez C :\Program Files\Microsoft SQL Server\90\Notification Services\9.0.242\Bin\nscontrol register -name bamalerts -nom<du> serveur Remplacez <le nom> du serveur par le nom du serveur.
Appuyez sur F5 pour actualiser le navigateur.

Configuration des services Internet (IIS) pour permettre au portail BAM d'utiliser le protocole réseau Kerberos

Si vous souhaitez utiliser le protocole réseau Kerberos avec le portail BAM, vous devez modifier la sécurité définie pour les listes de contrôle d'accès (ACL) dans le portail Web. Si les services IIS ne sont pas configurés correctement, les utilisateurs reçoivent le message d'erreur suivant :

Erreur HTTP 401.1 - Non autorisé : l’accès est refusé en raison d’informations d’identification non valides.

Pour plus d’informations sur la modification des paramètres de sécurité IIS, consultez l’article de la Base de connaissances à l’adresse https://go.microsoft.com/fwlink/?LinkId=57922.

Affichage des données BAM agrégées dans le portail BAM dans SQL Server déploiements 2008

Pour afficher les données agrégées dans le portail BAM à partir d’un ordinateur client qui se connecte au portail BAM lorsque l’environnement de déploiement utilise SQL Server 2008, vous devez installer le fournisseur OLE DB Microsoft SQL Server 2008 Analysis Services 10.0 sur l’ordinateur client. Si les services d’analyse ne sont pas installés, les utilisateurs recevront le message d’erreur suivant :

Le nom<> du serveur ne peut pas être contacté ou est trop occupé.

Voir aussi

Planification du portail BAM

Partager via