SAP Plateforme de BI Manuel utilisateur

Suite SAP BusinessObjects BI
Document Version: 4.0 Support Package 7 - 2013-10-07
Guide de personnalisation de SAP
BusinessObjects OEM
Table des matières
1
Historique du document. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
2
Démarrage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.1
A propos de ce guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2.2
Avant de commencer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
2.2.1
Personnalisation de la plateforme SAP BusinessObjects Business Intelligence . . . . . . . . . . . . . 7
2.2.2
Mise en services des clients dans la plateforme SAP BusinessObjects Business Intelligence
............................................................................9
2.2.3
Personnalisation de SAP Crystal Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
3
Personnalisation du programme d'installation de la plateforme de Business Intelligence. . . . . . . 11
3.1
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.2
Démarrage rapide pour la plateforme de Business Intelligence (Windows). . . . . . . . . . . . . . . . . . . . . . . 11
3.3
Démarrage rapide pour la plateforme de Business Intelligence (Unix ou Linux). . . . . . . . . . . . . . . . . . . 12
3.4
Pour télécharger le programme d'installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
3.5
Planification du processus de personnalisation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.5.1
3.6
3.7
Création du fichier de configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.6.1
Présentation du fichier de configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.6.2
Renommage du produit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
3.6.3
Personnalisation de la saisie utilisateur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.6.4
Suppression d'écrans d'installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.6.5
Incorporation d'un code clé. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
3.6.6
Suppression de fonctionnalités. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.6.7
Empêchement des vérifications des prérequis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
3.6.8
Suppression de packs linguistiques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.6.9
Empêchement de l'exécution de l'outil WDeploy. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.6.10
Suppression de la base de données par défaut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
3.6.11
Modification des ressources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3.6.12
Suppression d'éléments du dossier Collaterals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Exécution de l'outil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
3.7.1
3.8
3.9
2
Meilleures pratiques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Paramètres de ligne de commande. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Personnalisation des programmes d'installation de mise à jour. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
3.8.1
FAQ au sujet des programmes d'installation de mise à jour. . . . . . . . . . . . . . . . . . . . . . . . . . 36
3.8.2
Démarrage rapide pour les programmes d'installation de mise à jour. . . . . . . . . . . . . . . . . . . 37
3.8.3
Personnalisation de programmes d'installation de mise à jour. . . . . . . . . . . . . . . . . . . . . . . . 38
ID et codes pour la personnalisation de la plateforme de BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3.9.1
ID des fonctionnalités. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
3.9.2
ID des unités de déploiement de raccourci (Windows uniquement). . . . . . . . . . . . . . . . . . . . 43
3.9.3
ID de chaîne. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Table des matières
3.9.4
Codes langue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
3.9.5
ID d'écran d'installation et de propriété. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
4
Personnalisation d'applications Web. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.1
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.1.1
Notions clés. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
4.1.2
Test de vos personnalisations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.2
Démarrage rapide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
4.3
Personnalisation de la zone de lancement BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.3.1
Pour personnaliser l'image de favicon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.3.2
Pour personnaliser les logos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
4.3.3
Personnalisation d'autres éléments de l'interface utilisateur. . . . . . . . . . . . . . . . . . . . . . . . . 59
4.3.4
Utilisation des espaces de travail BI et modules composés. . . . . . . . . . . . . . . . . . . . . . . . . . 66
4.3.5
Pour modifier le nom de la zone de lancement BI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
4.4
Personnalisation d'OpenDocument. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
4.5
Personnalisation du visualiseur de Crystal Reports JavaScript. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
4.5.1
Personnalisation du visualiseur. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
5
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence. . . . . . . . 73
5.1
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
5.2
Démarrage rapide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
5.3
5.2.1
Conditions d'installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
5.2.2
Créer votre modèle de client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
5.2.3
Configurer votre fichier de définition des clients. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
5.2.4
Exécuter l'outil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
Configuration d'un modèle de client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.3.1
Dossiers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
5.3.2
Groupes d'utilisateurs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
5.3.3
Dossiers d'événements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
5.3.4
Catégories. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
5.3.5
Profils. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
5.3.6
Paramètres de sécurité. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
5.3.7
SAP Crystal Reports 2011. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
5.3.8
SAP Crystal Reports pour Enterprise. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
5.3.9
Univers et connexions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
5.4
Configuration du fichier de configuration client. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
5.5
Exécution de l'outil de gestion de l'architecture mutualisée. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
5.6
Dépannage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
5.6.1
Erreurs relatives à l'outil de gestion de l'architecture mutualisée . . . . . . . . . . . . . . . . . . . . . 104
5.6.2
Pour configurer le suivi pour l'outil de gestion de l'architecture mutualisée . . . . . . . . . . . . . . 109
6
Personnalisation de SAP Crystal Reports 2011. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
6.1
Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Guide de personnalisation de SAP BusinessObjects OEM
Table des matières
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
3
6.2
Démarrage rapide pour Crystal Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
6.3
Pour télécharger le programme d'installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
6.4
Planification du processus de personnalisation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
6.4.1
6.5
6.6
6.7
Création du fichier de configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
6.5.1
Présentation du fichier de configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
6.5.2
Renommage du produit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
6.5.3
Personnalisation de la saisie utilisateur par défaut. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
6.5.4
Suppression d'écrans d'installation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
6.5.5
Incorporation d'un code clé. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
6.5.6
Suppression de fonctionnalités. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
6.5.7
Empêchement des vérifications des prérequis. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
6.5.8
Suppression de packs linguistiques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
6.5.9
Modification des ressources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
6.5.10
Suppression d'éléments du dossier Collaterals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Personnalisation du concepteur de rapports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
6.6.1
Personnalisation de l'écran de présentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
6.6.2
Personnalisation de la page de démarrage. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
6.6.3
Personnalisation des chaînes de menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
6.6.4
Déploiement du fichier de personnalisation OEM. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
Exécution de l'outil. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
6.7.1
6.8
6.9
4
Meilleures pratiques. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Paramètres de ligne de commande. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Personnalisation des programmes d'installation de mise à jour. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
6.8.1
FAQ au sujet des programmes d'installation de mise à jour . . . . . . . . . . . . . . . . . . . . . . . . . 138
6.8.2
Démarrage rapide pour les programmes d'installation de mise à jour . . . . . . . . . . . . . . . . . . 140
6.8.3
Personnalisation de programmes d'installation de mise à jour. . . . . . . . . . . . . . . . . . . . . . . 140
ID et codes pour la personnalisation de Crystal Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
6.9.1
ID des fonctionnalités. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
6.9.2
ID des unités de déploiement de raccourci. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
6.9.3
ID de chaîne. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
6.9.4
Codes langue. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
6.9.5
ID d'écran d'installation et de propriété. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Table des matières
1
Historique du document
Le tableau suivant fournit une présentation des principaux enrichissements apportés à ce document :
Version
Date
Suite SAP
BusinessObjects
Business
Intelligence 4.0
Feature Pack 3
Mars 2012
Première version de ce document.
Suite SAP
BusinessObjects
Business
Intelligence 4.0
Support Package 5
Novembre 2
012
Personnalisation du programme d'installation de la plateforme de
Business Intelligence :
●
Le nouveau paramètre baselinePath remplace le paramètre
baselinePackages pour la personnalisation des programmes
d'installation de correctifs Patch ou de Support Package.
Pour en savoir plus sur le nouveau comportement et pour des
exemples, voir Personnalisation de programmes d'installation de
mise à jour [page 38] et Paramètres de ligne de commande [page
34].
Personnalisation de SAP Crystal Reports 2011 :
●
Le nouveau paramètre baselinePath remplace le paramètre
baselinePackages pour la personnalisation des programmes
d'installation de correctifs Patch ou de Support Package.
Pour en savoir plus sur le nouveau comportement et pour des
exemples, voir Personnalisation de programmes d'installation de
mise à jour [page 140] et Paramètres de ligne de commande [page
136].
Guide de personnalisation de SAP BusinessObjects OEM
Historique du document
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
5
2
Démarrage
2.1
A propos de ce guide
La suite SAP BusinessObjects Business Intelligence propose un ensemble d'outils et de modèles permettant aux
partenaires Original Equipment Manufacturer (OEM) de personnaliser la plateforme SAP BusinessObjects
Business Intelligence et SAP Crystal Reports Designer. Ce guide explique comment utiliser ces outils et modèles
pour créer les personnalisations que vous souhaitez.
Selon les besoins de vos clients, vous pouvez supprimer des fonctionnalités et des packs linguistiques pour
réduire la taille du programme d'installation et le produit installé. Et si vous souhaitez distinguer votre système
OEM et appliquer le seul branding de votre entreprise, vous pouvez personnaliser l'aspect de vos produits,
notamment le nom, les logos, les couleurs et autres éléments de l'interface utilisateur. Votre personnalisation
peut être aussi simple qu'une modification de logo au aussi détaillée qu'une modification complète de l'aspect.
La meilleure chose est que vos personnalisations sont prises en charge tout au long du cycle de vie des produits. Il
est facile de conserver vos modifications au cours des montées de version et des mises à jour ultérieures.
Ce guide est destiné aux partenaires OEM qui personnalisent des produits de Suite SAP BusinessObjects
Business Intelligence et il suppose certaines connaissances en matière de processus OEM. Vous n'aurez pas
besoin de lire l'intégralité du document ; la section Avant de commencer [page 6] décrit les workflows
pertinents pour chaque domaine majeur de personnalisation de produit et vous indique où rechercher les
informations dont vous avez besoin.
Conventions du guide
Les variables suivantes sont utilisées dans ce guide.
Variable
Description
<REPINSTALL>
Chemin d'accès où est installée la plateforme de Business
Intelligence. Sur un ordinateur fonctionnant sous Windows, le
répertoire par défaut est C:\Program Files
(x86)\SAP BusinessObjects\.
2.2
Avant de commencer
Ce guide traite des différents types de personnalisation OEM pour les différents produits de la suite SAP
BusinessObjects Business Intelligence. Vous devez lire les sections consacrées aux produits que vous avez
l'intention de personnaliser.
6
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Démarrage
2.2.1
Personnalisation de la plateforme SAP
BusinessObjects Business Intelligence
Vous pouvez personnaliser de nombreux aspects du déploiement de la plateforme de Business Intelligence :
●
Personnaliser le programme d'installation.
Vous pouvez supprimer des fonctionnalités, des packs linguistiques et des ressources afin de réduire la taille
du produit installé, renommer le produit, changer les images, masquer les écrans d'installation non désirés,
incorporer un code clé et préremplir la saisie utilisateur.
Voir Introduction [page 11] pour “Personnalisation du programme d'installation de la plateforme de
Business Intelligence” dans ce document.
●
Personnaliser les applications Web de la zone de lancement BI et OpenDocument.
Vous pouvez changer les titres et les URL utilisés pour accéder aux applications Web. Vous pouvez changer
l'apparence et le branding de ces applications à l'aide d'images et de feuilles de style en cascade (CSS)
personnalisées.
Voir Personnalisation de la zone de lancement BI [page 59] pour “Personnalisation d'applications Web” dans
ce document.
●
Personnaliser le visualiseur de rapports de l'API JavaScript de Crystal Reports.
Vous pouvez changer le logo et personnaliser le style visuel du visualiseur à l'aide d'images personnalisées et
de feuilles de style en cascade (CSS). Vous pouvez ajouter vos propres écouteurs d'événements et d'actions
à l'API JavaScript existante, ou ajouter vos propres fichiers JavaScript externes.
Voir Personnalisation du visualiseur de Crystal Reports JavaScript [page 70] dans ce document.
Vous pouvez personnaliser les applications Web, le programme d'installation ou les deux. Le diagramme qui suit
illustre le workflow où sont réalisés tous les types de personnalisation :
Guide de personnalisation de SAP BusinessObjects OEM
Démarrage
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
7
8
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Démarrage
2.2.2 Mise en services des clients dans la plateforme SAP
BusinessObjects Business Intelligence
De nombreux partenaires OEM utilisent la plateforme SAP BusinessObjects Business Intelligence dans leur
environnement logiciel Saas (Software as a Service). Ces environnements hébergent plusieurs clients dans le
même système. Les environnements client sont en général très semblables avec quelques personnalisations clés.
L'outil de gestion de l'architecture mutualisée permet aux fournisseurs logiciels Saas de créer rapidement un
environnement client unique sur base d'un modèle courant.
Voir Introduction [page 73] pour l'outil de gestion de l'architecture mutualisée de la plateforme de BI dans ce
document.
2.2.3
Personnalisation de SAP Crystal Reports
Vous pouvez procéder à de nombreuses personnalisations afin d'améliorer et de personnaliser l'apparence et
l'expérience client pour vos utilisateurs de SAP Crystal Reports :
●
Installez et exécutez l'outil de personnalisation SAP BusinessObjects Pour en savoir plus, voir Démarrage
rapide pour Crystal Reports [page 112].
●
Si vous souhaitez personnaliser le programme d'installation de SAP Crystal Reports, vous pouvez en modifier
l'apparence, masquer les écrans d'assistant non souhaités par les utilisateurs et supprimer les fonctionnalités
non utilisées afin de réduire la taille du produit installé sur les ordinateurs client.
Voir Introduction [page 112] pour “Personnalisation de SAP Crystal Reports 2011” dans ce document.
●
Si vous souhaitez personnaliser le concepteur de rapports, vous pouvez modifier l'écran de présentation ou la
page de démarrage. Vous pouvez également personnaliser le nom du produit, les menus et d'autres atouts du
concepteur de rapports.
Voir Personnalisation du concepteur de rapports [page 132] dans ce document.
Le diagramme qui suit illustre le workflow où sont réalisés tous les types de personnalisation :
Guide de personnalisation de SAP BusinessObjects OEM
Démarrage
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
9
10
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Démarrage
3
Personnalisation du programme
d'installation de la plateforme de Business
Intelligence
3.1
Introduction
La plateforme SAP BusinessObjects Business Intelligence peut être réassemblée et vendue pas les partenaires.
Vous pouvez personnaliser le produit installé et le programme d'installation afin de cibler une base de clientèle
spécifique ou pour les revendre comme éléments de votre propre produit. L'outil de personnalisation SAP
BusinessObjects permet de personnaliser la plateforme de BI et son programme d'installation par le biais de
modifications telles que :
●
Réduction de la taille du produit
●
Renommage du produit
●
Modification des propriétés par défaut du programme d'installation
●
Masquage d'écrans du programme d'installation
Pour réaliser des personnalisations, écrivez un fichier de configuration pour spécifier les modifications, puis
exécutez l'outil de personnalisation SAP BusinessObjects pour créer un programme d'installation personnalisé.
Les clients peuvent utiliser ce programme d'installation pour installer une version personnalisée du produit.
L'outil de personnalisation est disponible pour Windows et Unix. Il peut servir à personnaliser un programme
d'installation dans son intégralité, un programme d'installation de Support Package et un programme
d'installation de correctif.
Remarque
Cet outil ne permet pas de réaliser de personnalisations sur les outils client de la plateforme SAP
BusinessObjects Business Intelligence.
3.2 Démarrage rapide pour la plateforme de Business
Intelligence (Windows)
Cette section explique comment exécuter l'outil de personnalisation afin de créer un programme d'installation
personnalisé pour la plateforme SAP BusinessObjects Business Intelligence (Plateforme de BI). Elle utilise
l'exemple de fichier de configuration fourni avec cet outil. A l'issue de ce didacticiel, vous pouvez exécuter votre
package d'installation personnalisé et installer une version personnalisée de la plateforme de BI.
Les personnalisations comprennent le changement de type d'installation par défaut, la suppression de
fonctionnalités, le codage en dur du code clé du produit, le changement de dossier d'installation par défaut, le
renommage du produit et le changement du raccourci du menu Démarrer de Windows pour le Central
Configuration Manager. Elles sont décrites de façon plus détaillée dans le fichier de configuration.
1.
Configurez l'outil de personnalisation.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
11
a) Créez un dossier de travail sur votre ordinateur de développement, par exemple : C:\SAPCustomTool
\packages.
b) Copiez le contenu du package d'installation de la plateforme de BI sous C:\SAPCustomTool\packages.
Le package d'installation contient les dossiers Collaterals, dunit, langs et setup.engine ainsi que
d'autres fichiers binaires. Pour en savoir plus, voir Pour télécharger le programme d'installation [page
13].
c) (Facultatif). Ajoutez votre code clé à l'exemple de fichier de configuration.
Dans un éditeur XML, ouvrez le fichier C:\SAPCustomTool\packages\Collaterals\Tools
\CustomizationTool\example_customization_win_boe.xml et remplacez l'expression
PutYourKeyCodehere par votre code clé de la plateforme de BI. Si vous ne saisissez pas votre code clé
dans le fichier de configuration, vous pouvez utiliser la CMC pour le saisir après avoir installé la
plateforme de BI personnalisée.
d) Créez le dossier C:\SAPCustomTool\output.
Ce dossier doit être vide.
e) Exécutez la commande suivante à partir de l'invite de commande :cd C:\SAPCustomTool\packages
\Collaterals\Tools\CustomizationTool
Le dossier CustomizationTool contient le fichier exécutable customizationtool.exe et l'exemple
de fichier de configuration example_customization_win_boe.xml.
2.
Exécutez la commande suivante à partir de l'invite de commande :
customizationtool.exe xml=example_customization_win_boe.xml packageDir=C:
\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDetail=error > C:
\oemlog.log
Assurez-vous que le programme d'installation personnalisé a été créé sous C:\SAPCustomTool\output.
Veillez à ce qu'aucune erreur n'ait été consignée dans le fichier journal oemlog.log.
Remarque
L'outil de personnalisation peut prendre plusieurs minutes pour réaliser l'opération. Vous pouvez vérifier sa
progression en visualisant le fichier journal.
3.
Utilisez C:\SAPCustomTool\output\setup.exe pour exécuter le programme d'installation personnalisé
de la plateforme SAP BusinessObjects Business Intelligence.
La plateforme de BI est installée avec les personnalisations décrites dans le fichier de configuration.
3.3 Démarrage rapide pour la plateforme de Business
Intelligence (Unix ou Linux)
Cette section explique comment exécuter l'outil de personnalisation afin de créer un programme d'installation
personnalisé pour la plateforme SAP BusinessObjects Business Intelligence (Plateforme de BI). Elle utilise
l'exemple de fichier de configuration fourni avec cet outil. A l'issue de ce didacticiel, vous pouvez exécuter votre
package d'installation personnalisé et installer une version personnalisée de la plateforme de BI.
Les personnalisations incluent le changement de type d'installation par défaut, la suppression de fonctionnalités,
le codage en dur du code clé du produit, le changement de dossier d'installation par défaut et le renommage du
produit. Elles sont décrites de façon plus détaillée dans le fichier de configuration.
12
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
1.
Configurez l'outil de personnalisation.
a) Créez un dossier de travail sur votre ordinateur de développement, par exemple : /usr/jdoe/bip/
package.
b) Copiez le contenu du package d'installation de la plateforme de BI sous /usr/jdoe/bip/package.
Le package d'installation contient les dossiers Collaterals, dunit, langs et setup.engine ainsi que
d'autres fichiers binaires. Pour en savoir plus, voir Pour télécharger le programme d'installation [page
13].
c) (Facultatif). Ajoutez votre code clé à l'exemple de fichier de configuration.
Dans un éditeur XML, ouvrez le fichier /usr/jdoe/bip/package/Collaterals/Tools/
CustomizationTool/example_customization_linux_boe.xml et remplacez l'expression
PutYourKeyCodehere par votre code clé de la plateforme de BI. Si vous ne saisissez pas votre code clé
dans le fichier de configuration, vous pouvez utiliser la CMC pour le saisir après avoir installé la
plateforme de BI personnalisée.
d) Créez le dossier /usr/jdoe/bip/output. Ce dossier doit être vide.
e) Remplacez-le par le dossier /usr/jdoe/bip/package/Collaterals/Tools/CustomizationTool.
Ce dossier contient le fichier exécutable customizationtool.sh et l'exemple de fichier de
configuration example_customization_linux_boe.xml.
2.
Exécutez la commande suivante à partir de l'invite de commande :
./customizationtool.sh xml=example_customization_linux_boe.xml packageDir=/usr/
jdoe/bip/package outputDir=/usr/jdoe/bip/output logDetail=error &> custombip.log
Les personnalisations que vous voyez dans le programme d'installation et dans le produit installé sont
décrites dans le fichier de configuration /usr/jdoe/bip/package/Collaterals/Tools/
CustomizationTool/example_customization_linux_boe.xml.
Assurez-vous que le programme d'installation personnalisé a été créé sous /usr/jdoe/bip/output. Veillez
à ce qu'aucune erreur n'ait été consignée dans le fichier journal custombip.log.
Remarque
L'outil de personnalisation peut prendre plusieurs minutes pour réaliser l'opération. Vous pouvez vérifier sa
progression en visualisant le fichier journal.
3.
Depuis l'invite de commande, utilisez /usr/jdoe/bip/output/setup.sh pour exécuter le programme
d'installation de la plateforme de BI/
La plateforme de BI est installée avec les personnalisations décrites dans le fichier de configuration.
3.4
Pour télécharger le programme d'installation
1.
Accédez à https://service.sap.com/bosap-support > Software Downloads (Téléchargements de logiciels)
2.
Dans l'onglet Find your software (Trouver votre logiciel), A-Z Index (Index de A à Z), sélectionnez Installations
and Upgrades (Installations et mises à niveau).
3.
Sélectionnez B > SBOP BI platform (plateforme de BI - anciennement SBOP Enterprise) > SBOP BI
Platform 4.0 (SBOP Plateforme de BI 4.0).
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
13
4.
Sélectionnez Installation and Upgrade (Installation et mise à niveau) et sélectionnez votre plateforme.
5.
Sélectionnez tous les objets intitulés SBOP BI PLATFORM <version> SERVER ainsi que les modules
complémentaires dont vous avez besoin, puis suivez les instructions du site Web pour télécharger et extraire
les objets.
Le téléchargement du logiciel peut prendre un certain temps et il se peut que vous deviez contacter
l'administrateur système pour vous assurer que le pare-feu de votre entreprise n'interrompra pas le processus de
téléchargement.
Les Support Packages et correctifs sont des programmes d'installation contenant des mises à jour pour le logiciel
de la plateforme de BI. Vous pouvez les télécharger depuis https://service.sap.com/bosap-support > Software
Downloads (Téléchargements de logiciels). Dans l'onglet Find your software (Trouver votre logiciel), A-Z Index
(Index de A à Z), cliquez sur Support Packages and Patches (Support Packages et correctifs). Pour en savoir plus
sur l'installation des Support Packages et des correctifs, voir le guide de mise à jour de la plateforme
SAP BusinessObjects Business Intelligence.
3.5
Planification du processus de personnalisation
Pour utiliser l'outil de personnalisation SAP BusinessObjects :
1.
Téléchargez le programme d'installation. Voir Pour télécharger le programme d'installation [page 13].
2.
Décidez quelles personnalisations sont nécessaires. Voir Création du fichier de configuration [page 16].
3.
Ecrivez le fichier de configuration pour spécifier les personnalisations.
4.
Exécutez l'outil de personnalisation pour créer un programme d'installation personnalisé.
5.
Exécutez le programme d'installation personnalisé pour installer une version personnalisée de la plateforme
SAP BusinessObjects Business Intelligence.
3.5.1
Meilleures pratiques
Cette section fournit des recommandations relatives à la création d'un programme d'installation personnalisé.
Validez le fichier de configuration
Vous pouvez valider le fichier de configuration avant d'exécuter l'outil. Utilisez le paramètre de ligne de
commande validate.
Réduisez la taille du produit
Les clients préfèrent un programme d'installation et un programme installé plus petits. Pour garder le produit
aussi petit que possible :
14
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
●
Supprimez tous les packs linguistiques non nécessaires.
●
Supprimez toutes les fonctionnalités non nécessaires.
●
Supprimez tous les éléments du dossier Collaterals non nécessaires.
●
Supprimez la base de données par défaut si elle n'est pas nécessaire.
Attribuez des noms personnalisés de façon cohérente
Le nom du produit et le numéro de version apparaissent à plusieurs endroits du programme d'installation et du
programme installé. Veillez à vérifier les personnalisations aux emplacements suivants :
●
Nom du produit, version du produit et version principale du produit
●
Entré du menu Démarrer de Windows et tous les raccourcis
●
Utilitaire Ajout/Suppression de programmes de Windows
●
Dossier d'installation par défaut
Prenez en compte le changement de nom dans toutes les langues
Il est préférable d'envisager la façon dont apparaît le nom personnalisé dans toutes les langues prises en charge.
Modifiez les programmes d'installation de correctifs pour qu'ils soient
cohérents avec le programme d'installation principale
Vous devez appliquer la même personnalisation aux Support Packages et correctifs qu'à la version principale. Si
vous vendez un programme d'installation principale personnalisé puis essayez de vendre un programme
d'installation de Support Package ou de correctif avec une personnalisation différente, cela peut entraîner des
résultats inattendus qui pourraient ne pas être réparables par les procédures de restauration standard.
Testez la restauration, la modification et la réparation des installations de
Support Packages et de correctifs
La restauration, la modification et la réparation sont prises en charge par les Support Packages et correctifs
personnalisés, à condition qu'ils aient été personnalisés de manière cohérente avec le package d'installation
principale. Il est recommandé de tester ces scénarios.
Liens associés
Paramètres de ligne de commande [page 34]
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
15
3.6
Création du fichier de configuration
La section suivante décrit les personnalisations que vous pouvez réaliser sur le programme d'installation en
modifiant le fichier de configuration :
●
Renommage du produit
○
Personnalisation du nom du produit et du numéro de version
○
Personnalisation des raccourcis du menu Démarrer de Windows
○
Personnalisation de l'utilitaire Ajout/Suppression de programmes de Windows
○
Personnalisation du dossier d'installation
●
Personnalisation de la saisie utilisateur
●
Suppression d'écrans d'installation
●
Incorporation d'un code clé
●
Suppression de fonctionnalités
●
Empêchement des vérifications des prérequis
●
Suppression de packs linguistiques
●
Empêchement de l'exécution de l'outil WDeploy
●
Suppression de la base de données par défaut
●
Modification des ressources
●
○
Modification des images du programme d'installation
○
Modification du contrat de licence
Suppression d'éléments du dossier Collaterals
3.6.1
Présentation du fichier de configuration
L'outil de personnalisation SAP BusinessObjects utilise les informations contenues dans le fichier de configuration
pour réaliser les personnalisations. Le fichier de configuration est un document XML. Vous utilisez les éléments
XML pour décrire vos personnalisations. L'exemple de fichier de configuration est contenu dans ce dossier du
programme d'installation :
Plateforme
Emplacement de l'exemple de fichier de configuration
Windows
Collaterals\Tools\CustomizationTool\example_customization_win_boe.xml
Unix ou Linux
Collaterals/Tools/CustomizationTool/
example_customization_linux_boe.xml
Le fichier doit avoir ce format :
<oem name="<Any name>">
<cloneProduct sourceId="product.businessobjects64-4.0-core-32">
...
...
</cloneProduct>
</oem>
16
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Le fichier de configuration pour le programme d'installation complète peut avoir n'importe quel nom, oem.xml,
par exemple.
Le fichier de configuration du programme d'installation de Support Package est décrit dans la section
Personnalisation de programmes d'installation de mise à jour [page 38].
Remarque
Le fichier de configuration doit être écrit dans une syntaxe XML correcte. Utilisez un éditeur XML pour créer et
modifier le fichier, et vérifiez si le format est correct avant d'exécuter l'outil.
Exemple
Ce fichier d'exemple spécifie les personnalisations suivantes :
●
Changer le nom long du produit pour Custom Company Server pour toutes les langues.
●
Changer le nom court du produit pour Custom CS pour toutes les langues.
●
Supprimer l'écran d'installation intitulé Choose Installation Type et définir le type d'installation sur Custom.
●
Spécifier que les seuls packs linguistiques inclus dans le package d'installation sont l'anglais, le français,
l'allemand, l'italien et le chinois.
<oem name="CustomCompanyServer">
<cloneProduct sourceId="product.businessobjects64-4.0-core-32">
<replaceString id="product.boe64_name" value="Custom Company Server"
lang="all"/>
<replaceString id="product.boe64_shortname" value="Custom CS" lang="all"/>
<replaceProperty id="InstallType" defaultValue="custom"/>
<removeDialog id="ChooseInstallType.dialog"/>
<languageIncludeList value="en;fr;de;it;zh_CN"/>
</cloneProduct>
</oem>
3.6.2
Renommage du produit
Vous pouvez renommer le produit de différentes manières :
●
Personnaliser le nom du produit et le numéro de version.
●
Personnaliser l'entrée de Ajout/Suppression des programmes de Windows. (Windows uniquement)
●
Personnaliser l'entrée du menu Démarrer pour les raccourcis de fonctionnalités. (Windows uniquement)
●
Personnaliser le dossier d'installation par défaut.
Les sections qui suivent expliquent ces étapes.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
17
3.6.2.1
version
Personnalisation du nom du produit et du numéro de
Vous pouvez personnaliser le nom du produit et le numéro de version. Utilisez l'élément replaceString avec l'ID
de chaîne souhaité :
<replaceString id="<string id>" value="<new value>" lang="<language list>"/>
Il existe quatre chaînes représentant le nom du produit et le numéro de version : le nom long du produit, le nom
court du produit, le numéro de version du produit et le numéro de version principale du produit. Le nom complet
du produit est composé du nom long du produit et du numéro de version. Le nom court du produit et la version
principale du produit sont utilisés dans le menu contextuel de Windows.
Tableau 1: Nom du produit et numéro de version
Description de la chaîne
ID de chaîne
Valeur par défaut
Nom long du produit
product.boe64_name
Plateforme SAP BusinessObjects
Business Intelligence
Nom court du produit
product.boe64_shortname
Serveur de la plateforme de BI
Version du produit
product_version
4.1
Version principale du produit
product_majorversion
4
Remarque
Vous devez personnaliser la version du produit et la version principale du produit ensemble. Par exemple, si
vous changez la version du produit pour 1.0, vous devez également personnaliser la version principale du
produit en 1. Dans le cas contraire, le numéro de version dans le menu ne correspondra par au numéro de
version dans le produit.
Vous pouvez spécifier un nouveau nom pour chaque langue.
Exemple
Changez le nom long du produit pour Plateforme de perspective sur les ventes et le nom court du produit pour
Plateforme de ventes pour l'anglais. Changez le nom long du produit pour Plateforme de perspective sur les
ventes (français) et le nom court du produit pour Plateforme des ventes (français) pour le français. Changez la
version du produit pour 1.0 et la version principale du produit pour 1 pour le français et l'anglais. Le nom de
produit et le numéro de version dans les autres langues que l'anglais et le français resteront les valeurs par
défaut.
<replaceString id="product.boe64_name" value="Sales Insight Platform" lang="en"/>
<replaceString id="product.boe64_shortname" value="Sales Platform" lang="en"/>
<replaceString id="product.boe64_name" value="Sales Insight Platform (French)"
lang="fr"/>
<replaceString id="product.boe64_shortname" value="Sales Platform (French)"
lang="fr"/>
<replaceString id="product_version" value="1.0" lang="en;fr"/>
<replaceString id="product_majorversion" value="1" lang="en;fr"/>
18
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
La personnalisation apparaît ci-dessous. Notez que le numéro de version “FP3” n'est pas supprimé :
Pour supprimer les instances de “FP3” du programme d'installation
Lors de l'exécution du programme d'installation, des instances de “FP3” peuvent être visibles dans le nom du
produit. Pour supprimer “FP3”, modifiez les lignes du fichier suivant :
Nom de fichier
Ligne originale
Ligne modifiée
dunit
\product.businessobjects64
-4.0core-32\setup.ui.framework
\uitext
\BusinessObjects64\product
.lang_<code
langue>.uitext.xml
<string
id="productname_patch"
value=" FP3"/>
<string
id="productname_patch"
value=""/>
dunit
\product.businessobjects64
-4.0core-32\setup.ui.framework
\uitext\framework
\setup.ui.framework.lang_<
code langue>.uitext.xml
<string id="product_patch"
value="FP3"/>
<string id="product_patch"
value=""/>
Comme ci-dessus
<string
id="product_patch_prespace"
value=" FP3"/>
<string
id="product_patch_prespace"
value=""/>
Vous devez modifier un fichier pour chaque langue prise en charge par le programme d'installation. Pour obtenir
une liste des codes de langue, voir Codes langue [page 45]. Lors de l'exécution de l'outil de personnalisation puis
du programme d'installation, toutes les instances de “FP3” sont supprimées. Ce processus sera simplifié dans
une version ultérieure.
Exemple
Pour supprimer “FP3” du programme d'installation en anglais, modifiez les fichiers suivants :
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
19
●
product.lang_en.uitext.xml
●
setup.ui.framework.lang_en.uitext.xml
La personnalisation apparaît ci-dessous :
3.6.2.2 Personnalisation des raccourcis du menu Démarrer
de Windows (Windows uniquement)
Le menu Démarrer de Windows contient des raccourcis vers des fonctionnalités telles que la Central Management
Console et la zone de lancement BI. Vous pouvez personnaliser le nom, l'emplacement et l'info-bulle de chaque
raccourci. Les raccourcis que vous ne personnalisez pas seront regroupés dans le menu Démarrer par défaut,
sous Plateforme SAP BusinessObjects 4 de Business Intelligence.
Le menu Démarrer par défaut des installations en anglais se présente comme suit :
Utilisez l'élément shortcut pour personnaliser l'emplacement, le nom du raccourci et l'info-bulle de chaque
fonctionnalité
<shortcut duSourceId="<shortcut deployment unit ID>">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language
list>"/>
20
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
Attribut
Valeur
duSourceId
ID d'unité de déploiement du raccourci à modifier. Les valeurs classiques sont :
●
product.businessobjects64.shortcut.ccm-4.0-core
Central Configuration Manager
●
product.businessobjects64.shortcut.infoview-4.0-core
Zone de lancement BI
●
product.businessobjects64.shortcut.cmc-4.0-core
Central Management Console
Pour obtenir la liste complète des valeurs sourceId, voir ID des unités de déploiement
de raccourci (Windows uniquement) [page 43].
linkFullPath
Chemin d'accès complet au raccourci. Veillez à ajouter .lnk au lien de raccourci, sans
quoi le lien ne sera pas créé. Vous pouvez placer le lien de raccourci dans le menu
Démarrer ou sur le bureau. L'outil de personnalisation SAP BusinessObjects crée les
liens correctement.
Vous pouvez spécifier un lien par langue. Pour obtenir une liste des codes de langue,
voir Codes langue [page 45].
description
Chaîne d'info-bulle à afficher lorsque l'utilisateur survole le raccourci avec la souris.
Vous pouvez spécifier une info-bulle par langue.
Remarque
Vous pouvez personnaliser les liens de raccourci suivants mais pas leur info-bulle :
●
Zone de lancement BI (anciennement InfoView)
●
Documentation en ligne
●
Serveurs WACS stockés dans InfoView
●
Serveur conteneur d'applications Web
Cela sera résolu dans une prochaine version.
Exemple
Dans cet exemple, on personnalise le nom du raccourci de la Central Management Console en Gestionnaire de
perspective sur les ventes (anglais) pour l'anglais et Gestionnaire de perspective sur les ventes pour le français,
et on place les raccourcis sous l'entrée du menu Démarrer nommée Plateforme de perspective sur les ventes 1.
On personnalise également l'info-bulle en Lancer le Gestionnaire de ventes pour l'anglais et Lancer le
Gestionnaire de ventes (français) pour le français. Le nom et l'info-bulle du raccourci restent inchangés dans
toutes les autres langues.
<shortcut duSourceId="product.businessobjects64.shortcut.cmc-4.0core">
<arg id="linkFullPath" value="[programmenufolder]\Sales Insight
Platform 1\Sales Insight Manager.lnk" lang="en"/>
<arg id="linkFullPath" value="[programmenufolder]\Sales Insight Platform 1
(French)\Sales Insight Manager (French).lnk" lang="fr"/>
<arg id="description" value="Launch Sales Manager" lang="en"/>
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
21
lang="fr" />
</shortcut>
<arg id="description" value="Launch Sales Manager (French)"
La personnalisation apparaît ci-dessous :
Modification du raccourci Tomcat
Il existe deux liens pour le raccourci Tomcat : Administration Tomcat et Configuration Tomcat présentés cidessous :
Vous devez effectuer des étapes supplémentaires pour personnaliser ce raccourci. Utilisez cet élément
shortcut pour personnaliser le lien Administration Tomcat. Mentionnez l'élément pathToTarget.
<shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core"
pathToTarget="http://localhost:[TomcatConnectionPort]/manager/html">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language
list>"/>
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
Utilisez cet élément shortcut pour personnaliser le lien Configuration Tomcat. Mentionnez l'élément
pathToTarget.
<shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core"
pathToTarget="[INSTALLDIR]Tomcat6\bin\tomcat6w.exe">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language
list>"/>
22
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
Exemple
Dans cet exemple, on personnalise le nom du raccourci Administration Tomcat en raccourci tomcat 1 (anglais
et français) pour les installations en anglais et en français, et raccourci tomcat 1 (allemand) pour les
installations en allemand. On place les raccourcis dans l'entrée du menu Démarrer nommée Company
Programs . On personnalise l'info-bulle en raccourci tomcat 1 (anglais et français) pour l'anglais et le français et
en raccourci tomcat 1 (autres) pour toutes les autres langues.
<shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core"
pathToTarget="http://localhost:[TomcatConnectionPort]/manager/html">
<arg id="linkFullPath" value="[programmenufolder]\Company Programs
\tomcat(english and french) shortcut1.lnk" lang="en;fr"/>
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat
(German) shortcut1.lnk" lang="de"/>
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat
(all others) shortcut1.lnk" lang="it;zh_cn"/>
<arg id="description" value="tomcat(english and french) shortcut1"
lang="en;fr"/>
<arg id="description" value="tomcat (German) shortcut1" lang="de" />
<arg id="description" value="tomcat (all others) shortcut1"
lang="it;zh_cn" />
</shortcut>
<shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core"
pathToTarget="[INSTALLDIR]Tomcat6\bin\tomcat6w.exe">
<arg id="linkFullPath" value="[programmenufolder]\Company Programs
\tomcat(english and french) shortcut2.lnk" lang="en;fr"/>
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat
(German) shortcut2.lnk" lang="de"/>
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat
(all others) shortcut2.lnk" lang="it;zh_cn"/>
<arg id="description" value="tomcat(english and french) shortcut2"
lang="en;fr"/>
<arg id="description" value="tomcat (German) shortcut2" lang="de" />
<arg id="description" value="tomcat (all others) shortcut2"
lang="it;zh_cn" />
</shortcut>
3.6.2.3 Personnalisation de l'utilitaire Ajout/Suppression de
programmes de Windows (Windows uniquement)
Vous pouvez personnaliser le nom d'affichage, l'éditeur et l'icône dans l'utilitaire Ajout/Suppression de
programmes de Windows. Vous ne pouvez pas personnaliser le numéro de version. Utilisez l'élément suivant :
<arp duSourceId="product.businessobjects64.arp-4.0-core">
<arg id="publisher" value="<publisher name>"/>
<arg id="display_name" value="<product name>" lang="<language list>"/>
<arg id="display_icon" value="<full path to icon>"/>
</arp>
Les icônes affichées dans l'utilitaire Ajout/Suppression de programmes de Windows sont généralement de 16 x 16.
Pour des informations complètes sur la création d'icônes, voir la documentation Windows.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
23
Exemple
Changez le nom du produit dans l'utilitaire Ajout/Suppression de programmes de Windows pour Plateforme de
perspective sur les ventes. Ce changement n'affectera que les installations en anglais. Changez l'éditeur pour
Data Excellence Corp. Remplacez l'icône affichée par celle se trouvant sous C:\SAPCustomTool
\DEC_logo.ico.
Remarque
Pour mettre en pratique cet exemple, vous devez placer une icône nommée DEC_logo.ico à
l'emplacement C:\SAPCustomTool.
<arp duSourceId="product.businessobjects64.arp-4.0-core">
<arg id="publisher" value="Data Excellence Corp"/>
<arg id="display_name" value="Sales Insight Platform" lang="en"/>
<arg id="display_icon" value="C:\SAPCustomTool\DEC_logo.ico"/>
</arp>
La personnalisation apparaît ci-dessous :
3.6.2.4
Personnalisation du dossier d'installation
Vous pouvez personnaliser le dossier d'installation par défaut. Utilisez l'élément replaceProperty avec
id="InstallDir" :
<replaceProperty id="InstallDir" defaultValue="<default installation folder>"/>
Utilisez cet élément aussi bien pour les installations Windows que pour les installations Unix.
Exemple
Changez le dossier d'installation par défaut pour C:\Program Files (x86)\SalesDataInsight.
<replaceProperty id="InstallDir" defaultValue="C:\Program Files
(x86)\SalesDataInsight"/>
24
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
3.6.3
Personnalisation de la saisie utilisateur
Vous pouvez personnaliser la valeur par défaut de la saisie utilisateur recueillie par le programme d'installation.
Utilisez l'élément replaceProperty avec id="<id de propriété>" et la nouvelle valeur par défaut :
<replaceProperty id="<property id>" defaultValue="<value to use as default value>"/>
Pour obtenir une liste complète des ID de propriété, voir ID d'écran d'installation et de propriété [page 46].
Le programme d'installation Windows recueille la saisie utilisateur à l'aide des boîtes de dialogue, cases d'option
et autres éléments de l'interface utilisateur. Le programme d'installation Unix et Linux recueille la saisie utilisateur
à l'aide de l'entrée de console. Les deux programmes d'installation sont personnalisés de la même façon.
Exemple
Dans l'écran d'installation intitulé Choisissez un type d'installation, le type d'installation par défaut est Complet.
Cet exemple illustre le changement du type d'installation par défaut pour Personnalisée/Etendue.
<replaceProperty id="InstallType" defaultValue="custom"/>
La personnalisation apparaît ci-dessous :
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
25
3.6.4
Suppression d'écrans d'installation
Vous pouvez supprimer des écrans d'installation depuis le programme d'installation. Utilisez l'élément
removeDialog avec l'ID d'écran d'installation :
<removeDialog id="<installation screen ID>"/>
Pour obtenir une liste complète des ID d'écrans d'installation, voir ID d'écran d'installation et de propriété [page
46].
Exemple
Cet exemple montre comment supprimer l'écran d'installation intitulé Sélectionner le serveur d'applications
Web Java.
<removeDialog id="ChooseWebAppServer.dialog"/>
3.6.5
Incorporation d'un code clé
Vous pouvez incorporer un code clé dans le programme d'installation de sorte que le client n'ait pas besoin d'en
saisir un. Cette tâche implique :
●
La saisie d'une valeur par défaut pour le code clé
●
La suppression de l'écran d'installation où l'utilisateur saisit un code clé
Exemple
Utilisez l'élément replaceProperty avec id="ProductKey" pour fournir un code clé par défaut. Les codes
clés doivent avoir le format XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX.
Utilisez l'élément removeDialog avec id="EnterProductKey.dialog" pour supprimer l'écran
d'installation demandant la clé de licence.
<replaceProperty id="ProductKey" defaultValue="XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX"/>
<removeDialog id="EnterProductKey.dialog"/>
Liens associés
ID d'écran d'installation et de propriété [page 46]
Personnalisation de la saisie utilisateur [page 25]
Suppression d'écrans d'installation [page 26]
26
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
3.6.6
Suppression de fonctionnalités
La plateforme SAP BusinessObjects Business Intelligence se compose de nombreuses fonctionnalités
facultatives. Vous pouvez supprimer une fonctionnalité depuis le programme d'installation. Utilisez l'élément
removeFeature avec id="<id de la fonctionnalité>" :
<removeFeature id="<Feature ID>"/>
Pour obtenir une liste complète des ID de fonctionnalité, voir ID des fonctionnalités [page 40].
Lorsque vous spécifiez la suppression d'une fonctionnalité, l'outil de personnalisation SAP BusinessObjects
supprime tous les fichiers exécutables, écrans d'installation et autres fichiers appartenant à cette fonctionnalité.
La suppression de fonctionnalités non nécessaires est un bon moyen de réduire la taille du produit personnalisé.
Exemple
Supprimez la fonctionnalité Crystal Reports. Cela supprime tous les serveurs, fichiers et ressources Crystal
Reports.
<removeFeature id="CrystalReportsServers"/>
Liens associés
ID des fonctionnalités [page 40]
3.6.7
Empêchement des vérifications des prérequis
Les prérequis sont des conditions devant être remplies sur l'ordinateur hôte afin que le programme d'installation
réussisse dans sa tâche. Le programme d'installation vérifie l'existence de ces prérequis avant de démarrer et
affiche les résultats sur l'écran Vérification des prérequis. La suppression de l'écran Vérification des prérequis
empêche les vérifications de prérequis d'être effectuées. Utilisez l'élément <removeDialog> avec
id="CheckPreRequisites.dialog".
Remarque
Il est recommandé de supprimer cet écran d'installation uniquement si vous réalisez les vérifications de
prérequis par d'autres moyens. Si les prérequis ne sont pas remplis, le programme d'installation échoue dans
sa tâche.
Exemple
Dans cet exemple, on supprime l'écran Vérification des prérequis et on empêche les vérifications de prérequis
d'être effectuées.
<removeDialog id="CheckPreRequisites.dialog"/>
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
27
3.6.8
Suppression de packs linguistiques
Le programme d'installation permet à l'utilisateur de sélectionner quels packs linguistiques installer. Un pack
linguistique contient des versions traduites de toutes les chaînes utilisées par le produit installé. Par défaut, tous
les packs linguistiques possibles sont inclus dans le programme d'installation. Vous pouvez spécifier quels packs
linguistiques inclure. Utilisez l'élément languageIncludeList avec une liste de codes langue :
<languageIncludeList value="<list of language codes>"/>
Pour obtenir une liste des codes de langue, voir Codes langue [page 45].
Remarque
Les packs linguistiques peuvent être volumineux. Le programme d'installation sera plus petit si moins de packs
linguistiques y sont inclus.
Exemple
Incluez les packs linguistiques anglais, français et allemand dans le programme d'installation. L'utilisateur peut
faire son choix parmi cette liste lors de l'installation.
<languageIncludeList value="en;fr;de"/>
3.6.9
Empêchement de l'exécution de l'outil WDeploy
Si l'utilisateur installe un serveur d'applications Web autre que celui par défaut, l'outil WDeploy s'exécute à l'issue
de l'installation. Sur les plateformes Windows, WDeploy est un outil d'interface graphique utilisateur tandis que,
sur les plateformes Unix et Linux, il s'agit d'un script.
Vous pouvez désactiver cette fonctionnalité. Utilisez l'élément replaceProperty avec defaultValue="0"
Exemple
<replaceProperty id="LaunchWDeploy" defaultValue="0"/>
3.6.10 Suppression de la base de données par défaut
La base de données par défaut est incluse au programme d'installation et les clients peuvent choisir de l'utiliser
comme base de données système. Sybase SQL Anywhere est la base de données par défaut.
Si la base de données par défaut n'est pas requise, vous pouvez la supprimer et forcer les clients à en choisir une
autre. La suppression de la base de données par défaut est un bon moyen de réduire la taille du programme
d'installation.
28
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Suppression de la base de données par défaut
Utilisez l'élément <removeFeature> avec id="PlatformServers.IntegratedDB.SQLAnywhere". Vous
pouvez également supprimer l'écran d'installation intitulé Sélectionnez la base de données existante ou la base de
données par défaut et définir la propriété de saisie utilisateur sur Utilisez une base de données existante.
Exemple
Cet exemple supprime la base de données par défaut. On supprime également l'écran d'installation intitulé
Sélectionnez la base de données existante ou la base de données par défaut et on définit la propriété de saisie
utilisateur sur Utilisez une base de données existante.
<removeFeature id="PlatformServers.IntegratedDB.SQLAnywhere"/>
<removeDialog id="<SelectDataSource.dialog"/>
<replaceProperty id="SelectIntegratedDatabase" defaultValue="0"/>;
3.6.11
Modification des ressources
Le programme d'installation stocke des fichiers image et texte comme ressources dans ce dossier :
\dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources
Vous pouvez personnaliser les ressources de ce dossier. Des ressources couramment utilisées sont :
●
Les images du programme d'installation
●
Le contrat de licence du programme d'installation
Pour personnaliser une ressource :
1.
Créez un dossier de ressources personnalisées, par exemple (sous Windows) : C:\SAPCustomTool
\MyResources. Le dossier peut avoir le nom de votre choix mais doit être visible pour les clients. Utilisez le
même dossier pour toutes les ressources que vous personnalisez.
2.
3.
Créez une ressource portant le même nom et le même chemin d'accès que la ressource originale et placez-la
dans le dossier de ressources personnalisées. Voir les rubriques associées pour des exemples spécifiques.
Ajoutez l'élément <resources> au fichier de configuration pour spécifier l'emplacement du dossier de
ressources personnalisées, par exemple :
<resources cleanTarget="no" sourcePath="C:\SAPCustomTool\MyResources"/>
Attribut cleanTarget
Si vous définissez cleanTarget='yes', l'outil de personnalisation supprimera le dossier resources original et
utilisera uniquement les ressources contenues dans le dossier de ressources personnalisées. Cette option n'est
pas recommandée.
Liens associés
Personnalisation des images dans le programme d'installation [page 30]
Personnalisation du contrat de licence [page 31]
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
29
3.6.11.1 Personnalisation des images dans le programme
d'installation
Vous pouvez personnaliser les images du programme d'installation, notamment l'écran d'accueil, l'image
supérieure de tous les écrans et le panneau d'informations de la boîte de dialogue de progression. Les images
sont stockées sous forme de fichiers dans le dossier de ressources :
dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources
Tableau 2: Fichiers image dans le dossier resources
Nom de
l'image
Nom du fichier Taille (L x H)
Ecran
d'accueil
dialogFull.bmp
500 x 400 px
Image
supérieure
pour tous les
écrans
dialogTop.bmp
500 x 83 px
Panneau
billboard.bmp
d'information
s pour la boîte
de dialogue
de
progression
Image par défaut
500 x 193 px
Vous personnalisez une image en créant un fichier image, en plaçant le fichier dans le dossier de ressources
personnalisées et en ajoutant l'élément resources au fichier de configuration.
30
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Exemple
Personnalisation de l'image de l'écran d'accueil sur les plateformes Windows
1.
Créez un dossier nommé MyResources à l'emplacement C:\SAPCustomTool
2.
Créez un fichier image nommé dialogFull.bmp et placez-le dans le dossier C:\SAPCustomTool
\MyResources
3.
Assurez-vous que l'élément resources se trouve dans le fichier de configuration comme suit :
<resources cleanTarget="no" sourcePath="C:\SAPCustomTool\MyResources"/>
Liens associés
Modification des ressources [page 29]
3.6.11.2
Personnalisation du contrat de licence
Vous pouvez personnaliser le contrat de licence présenté à l'utilisateur au cours de l'installation. Les contrats de
licence sont stockés sous forme de fichiers texte dans le dossier de ressources :
dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources\<code langue>
Par exemple, sur les plateformes Windows, le contrat de licence en anglais se trouve ici :
dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources\en
\license_en.rft
Sur les plateformes Unix et Linux, le contrat de licence en anglais se trouve ici :
dunit/product.businessobjects64-4.0-core-32/setup.ui.framework/resources/en/
license_en.txt
Pour obtenir une liste des codes de langue, voir Codes langue [page 45].
Vous personnalisez le contrat de licence en créant un fichier de licence, en plaçant le fichier dans le dossier de
ressources personnalisées et en ajoutant l'élément resources au fichier de configuration.
Exemple
Personnaliser le contrat de licence en japonais sur les plateformes Windows
Le contrat de licence en japonais se trouve ici :
dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources\ja
\license_ja.rtf
Pour personnaliser le contrat de licence en japonais :
1.
Créez un dossier nommé ja à l'emplacement C:\SAPCustomTool\MyResources.
2.
Créez un fichier de contrat de licence nommé license_ja.rtf et placez-le dans le dossier C:
\SAPCustomTool\MyResources\ja.
3.
Assurez-vous que l'élément resources se trouve dans le fichier de configuration comme suit :
<resources cleanTarget="no" sourcePath="C:\SAPCustomTool\MyResources"/>
Liens associés
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
31
Modification des ressources [page 29]
3.6.12 Suppression d'éléments du dossier Collaterals
Le programme d'installation de la plateforme SAP BusinessObjects Business Intelligence stocke des outils, des
exemples et de la documentation dans le dossier Collaterals du programme d'installation. Par défaut, un
programme d'installation personnalisé contient le dossier Collaterals par défaut avec le même contenu. Vous
pouvez supprimer les éléments non nécessaires du dossier Collaterals afin de réduire la taille du programme
d'installation personnalisé. Utilisez l'élément collaterals avec cleanTarget="yes et
sourcePath="<chemin complet d'accès au dossier Collaterals personnalisé>" :
<collaterals cleanTarget="yes" sourcePath="<full path to custom Collaterals
folder>"/>
Remarque
Vous devez affecter à l'attribut cleanTarget la valeur yes afin que l'outil de personnalisation remplace le
dossier original par le nouveau.
Pour supprimer des éléments du dossier Collaterals
1.
Copiez le contenu du dossier Collaterals existant dans un nouvel emplacement, par exemple (sous
Windows) : C:\SAPCustomTool\Utilities.
2.
Supprimez les éléments de C:\SAPCustomTool\Utilities qui ne sont pas nécessaires pour votre
programme d'installation personnalisé. Pour en savoir plus, voir ci-dessous.
3.
Ajoutez l'élément <collaterals> au fichier de configuration pour spécifier l'emplacement du dossier de
collatéraux personnalisés, par exemple :
<collaterals cleanTarget="yes" sourcePath="C:\SAPCustomTool\Utilities"/>
Tableau 3: Description des éléments du dossier Collaterals
Dossier
Description
Quand supprimer
Collaterals > Add-Ons
> SAP
Fournit la connectivité aux systèmes
SAP.
Supprimez ce dossier s'il n'y a aucun
besoin de connexion aux systèmes
SAP.
Collaterals > Add-Ons
> Subversion
Subversion est le système de contrôle
de version par défaut utilisé par la
Gestion du cycle de vie (LCM).
Supprimez si la fonctionnalité LCM est
supprimée.
Collaterals > Add-Ons
> Tivoli Agent
La fonctionnalité de surveillance des
serveurs peut intégrer IBM Tivoli et cet
élément fournit la connectivité.
Supprimez si l'intégration à IBM Tivoli
n'est pas nécessaire.
32
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Dossier
Description
Quand supprimer
Collaterals >
Customization
Template
Fichiers de modèles requis.
Ne supprimez pas ce dossier.
Collaterals >
DiagnosticsAgent7.3
Agent SAP Solution Manager
Diagnostics (SMD). SMD est utilisé par
les outils Support SAP pour dépanner le
produit installé.
Supprimez si la fonctionnalité SMD est
supprimée.
Collaterals > Docs
Documentation dans toutes les langues
prises en charge par la plateforme SAP
BusinessObjects Business Intelligence.
Supprimez toutes les langues qui ne
sont pas incluses au programme
d'installation personnalisé. Pour
obtenir une liste des codes de langue,
voir Codes langue [page 45].
Collaterals > Tools >
CustomizationTool
Objet de personnalisation SAP
BusinessObjects.
Supprimez ce dossier si les clients
n'ont pas besoin de personnaliser leurs
programmes d'installation.
Collaterals > Tools >
LCM command line tool
Utilitaire de ligne de commande de la
Gestion du cycle de vie (LCM).
Supprimez si la fonctionnalité LCM est
supprimée.
Collaterals > Tools >
wdeploy
WDeploy sert à déployer des
applications Web sur les serveurs
d'applications Web autres que Tomcat.
Suppression déconseillée. Supprimez
seulement si les clients utiliseront
uniquement Tomcat.
3.7
Exécution de l'outil
L'outil de personnalisation SAP BusinessObjects est inclus dans le package d'installation de la plateforme SAP
BusinessObjects Business Intelligence à cet emplacement :
Collaterals\Tools\CustomizationTool
Sur les plateformes Windows, l'outil se nomme customizationtool.exe. Sur les plateformes Unix et Linux,
l'outil se nomme customizationtool.sh.
Cette section explique les paramètres de ligne de commande.
Remarque
L'outil de personnalisation peut prendre plusieurs minutes pour réaliser l'opération. Vous pouvez vérifier sa
progression en visualisant le fichier journal.
Exemple
Dans cet exemple, l'outil de personnalisation est exécuté sur une plateforme Windows. Pour mettre en pratique
cet exemple, vous devez :
●
Créez un fichier de configuration nommé oem.xml à l'emplacement C:\SAPCustomTool.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
33
●
Télécharger le package d'installation de la plateforme SAP BusinessObjects Business Intelligence dans le
dossier C:\SAPCustomTool\packages. Voir Pour télécharger le programme d'installation [page 13].
●
Créez un dossier nommé output à l'emplacement C:\SAPCustomTool.
C:\SAPCustomTool\packages\Collaterals\Tools\CustomizationTool
\customizationtool.exe
xml=C:\SAPCustomTool\oem.xml packageDir=C:\SAPCustomTool\packages outputDir=C:
\SAPCustomTool\output
logDetail=error > C:\oemlog.log
3.7.1
Paramètres de ligne de commande
Tableau 4: Paramètres obligatoires
Paramètre
Description
Exemple (Windows)
xml
Chemin d'accès complet au fichier de
configuration.
xml=example_customization_win_b
oe.xml
packageDir
Chemin d'accès complet au dossier contenant le
programme d'installation que vous modifiez.
packageDir=C:\SAPCustomTool
\packages
Le programme d'installation est téléchargé à partir
du SAP Service Marketplace en vue de démarrer
l'installation de la plateforme SAP
BusinessObjects Business Intelligence. Il contient
les dossiers Collaterals, dunit, langs et
setup.engine ainsi que d'autres fichiers binaires.
outputDir
Chemin d'accès complet au dossier où sera créé le outputDir=C:\SAPCustomTool
programme d'installation personnalisé. Il doit être \output
vide avant l'exécution de l'outil.
Tableau 5: Paramètres facultatifs
Paramètre
Description
Exemple (Windows)
baselinePath
Chemin complet du dossier racine
contenant les versions d'origine non
personnalisées de l'ensemble des
programmes d'installation complets et de
mises à jour que vous avez personnalisés.
Supposez que vous souhaitiez
personnaliser Plateforme SAP
BusinessObjects BI 4.0 Support
Package 5.0 et que vous ayez
personnalisé les précédents
programmes : 4.0 SP2
(installation complète),
Pour spécifier plusieurs dossiers racine,
utilisez un point-virgule (; - Windows) ou
deux-points (; - Unix).
34
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
4.0 SP4. Personnalisez 4.0 Support
Package 5, et fournissez le chemin du
dossier racine vers les packages non
personnalisés pour l'installation complète
4.0 SP2 et l'installation de la mise à jour
SP4. Par exemple, si les packages non
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Paramètre
Description
Exemple (Windows)
personnalisés sont contenus dans la
structure de répertoire suivante :
C:\productUpdates\4.0\
\SP2 Full\
\SP4\
définissez la valeur sur
baselinePath=C:\productUpdates
\4.0\
Voir Personnalisation des programmes
d'installation de mise à jour [page 35]
pour plus d'informations et d'exemples
sur le paramètre baselinePath.
logDetail
Niveau de détail de la journalisation. La
valeur par défaut est info. Valeurs
logDetail=warn
acceptées :
action
●
error
●
warn
●
info
●
debug
●
trace
Mode de l'outil Les valeurs acceptées sont
les suivantes :
●
action=validate
generate (valeur par défaut)
L'outil réalise les personnalisations
spécifiées.
●
validate
L'outil valide le fichier de configuration
mais ne réalise aucune
personnalisation.
Liens associés
Démarrage rapide pour la plateforme de Business Intelligence (Windows) [page 11]
Démarrage rapide pour la plateforme de Business Intelligence (Unix ou Linux) [page 12]
3.8 Personnalisation des programmes d'installation de mise
à jour
Les programmes d'installation de mise à jour sont des versions secondaires, des Support Packages ou des
correctifs qui contiennent des mises à jour pour vos logiciels de la plateforme de BI existants. Les Support
Packages contiennent moins de mises à jour mais sont moins fréquents que les correctifs. Vous pouvez utiliser
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
35
l'outil de personnalisation SAP BusinessObjects pour personnaliser ces programmes d'installation de mise à jour,
mais certaines modifications de la ligne de commande et du fichier de configuration sont nécessaires.
3.8.1
jour
FAQ au sujet des programmes d'installation de mise à
Où peut-on trouver des Support Packages et des correctifs ?
1.
Accédez à https://service.sap.com/bosap-support Téléchargements de logiciels.
2.
Dans l'onglet Recherchez votre logiciel, sous Index A–Z, cliquez sur Support Packages et correctifs.
3.
Sélectionnez
(ENTERPRISE)
B
Plateforme BI SBOP (anciennement SBOP Enterprise)
SBOP BI PLATFORM 4.0
PLATFORM SERVERS 4.0
4.
SBOP BI PLATFORM
Versions de composants logiciels compris
SBOP BI
<plateforme>.
Sélectionnez votre Support Package ou correctif, puis suivez les instructions du site Web pour télécharger et
extraire les objets.
Quelles parties des programmes d'installation de mise à jour puis-je
personnaliser ?
Vous pouvez y personnaliser les mêmes aspects que dans le programme d'installation principale. Les mises à jour
de versions secondaires, de Support Packages et de correctifs contenant moins d'écrans d'installation, toutes les
étapes de personnalisation ne sont pas d'application. Il est recommandé d'exécuter la version secondaire, le
Support Package ou le correctif avant de le personnaliser pour déterminer quelles personnalisations vous
souhaitez.
Comment personnaliser les programmes d'installation de mise à jour ?
Les programmes d'installation de mise à jour utilisent la même architecture qu'un programme d'installation
principal de la plateforme de BI (installation complète), vous pouvez donc utiliser l'outil de personnalisation
comme décrit dans Création du fichier de configuration et Exécution de l'outil, avec certaines modifications
apportées à la commande de ligne et au fichier de configuration. Voir Comment configurer les Supports packages
et les correctifs dans cette section.
36
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Est-il nécessaire de personnaliser et d'installer toutes les versions secondaires
et mises à jour de Support Package et de correctif ?
Non. Comme pour les versions de la plateforme de BI qui ne sont pas personnalisées, vous devez installer
uniquement les mises à jour que vous souhaitez. Il peut s'agir d'une version secondaire, d'un Support Package,
d'un correctif ou d'une combinaison valable de ces trois mises à jour.
Puis-je installer une mise à jour non personnalisée sur une installation
plateforme de BI personnalisée ?
Oui. Des mises à jour personnalisées et non personnalisées peuvent être appliquées à votre installation
personnalisée. Toutefois, les programmes d'installation de version secondaire, de Support Package ou de
correctif non personnalisés n'afficheront pas vos personnalisations de marque ni d'installation (comme les
fonctionnalités supprimées ou les modifications de raccourcis) que vous avez créées pour le programme
d'installation principal.
J'ai livré une version personnalisée de la plateforme de BI à des clients, mais je
veux modifier la personnalisation dans un programme d'installation de mise à
jour. Est-ce possible ?
Ce scénario n'est en effet pas pris en charge. Les personnalisations que vous réalisez sur les programmes
d'installation de mise à jour doivent être cohérentes avec les personnalisations originales.
3.8.2 Démarrage rapide pour les programmes d'installation
de mise à jour
Assurez-vous que vous avez personnalisé et installé le programme d'installation principale, comme la plateforme
SAP BusinessObjects Business Intelligence Feature Pack 3 (installation complète) à l'aide des instructions de
Démarrage rapide pour la plateforme de Business Intelligence (Windows) et que le programme d'installation non
personnalisé se trouve sous C:\SAPCustomTool\packages.
Cette section explique comment exécuter l'outil de personnalisation SAP BusinessObjects pour personnaliser le
programme d'installation d'un Support Package (installation de mise à jour). Elle utilise l'exemple de fichier de
configuration fourni avec l'outil de personnalisation. Remarquez que l'exemple de fichier de configuration contient
l'élément <cloneProduct> pour le programme d'installation principale ainsi que l'élément
<clonePatchProduct> pour un programme d'installation de mise à jour de Support Package.
Remarque
Vous pouvez mettre en pratique cet exemple uniquement si un Support Package est disponible à l'adresse
https://service.sap.com/bosap-support.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
37
1.
Téléchargez le programme d'installation du Support Package de la plateforme de BI 4.0 dans le dossier C:
\SAPCustomTool\SupportPackage.
2.
Assurez-vous que la product_version (version du produit) de l'élément <clonePatchProduct> du fichier
de configuration correspond au numéro de version du Support Package que vous avez téléchargé. Voir
Personnalisation du nom du produit et du numéro de version.
3.
Personnalisez le Support Package de la plateforme de BI 4.0 et placez le programme d'installation
personnalisé sous C:\SAPCustomTool\output\SupportPackage. Utilisez la commande suivante :
customizationtool.exe xml=example_customization_win_boe.xml packageDir=C:
\SAPCustomTool\SupportPackage baselinePath=C:\SAPCustomTool\packages outputDir=C:
\SAPCustomTool\output\SupportPackage logDetail=error > C:\oemlog_SP04.log
4.
Utilisez C:\SAPCustomTool\output\SupportPackage\setup.exe pour exécuter le programme
d'installation personnalisé pour le Support Package de la plateforme de BI 4.0.
3.8.3 Personnalisation de programmes d'installation de mise
à jour
Utilisez l'outil de configuration comme décrit dans Création du fichier de configuration [page 16] et Exécution de
l'outil [page 33] pour personnaliser les programmes d'installation des versions secondaires, des Support
Packages et des correctifs à ces différences près :
●
Le fichier de configuration doit utiliser l'élément clonePatchProduct (avec l'ID de produit correct), au lieu
de l'élément cloneProduct.
●
Le fichier de configuration doit contenir l'élément complet <cloneProduct> pour le package d'installation
principale que vous mettez à jour. Si ce n'est pas le cas, il pourrait en découler des résultats inattendus,
particulièrement lorsque les personnalisations impliquent la suppression de fonctionnalités.
●
Le fichier de configuration ne peut pas contenir plus d'un clonePatchProduct. Si vous personnalisez à la
fois un Support Package et un correctif par exemple, vous devez créer deux fichiers de configuration : un
fichier contenant cloneProduct et clonePatchProduct pour le Support Package, et un autre fichier
contenant cloneProduct et clonePatchProduct pour le correctif.
●
Faites référence à tous les programmes d'installation prérequis à l'aide du paramètre baselinePath.
Tous les éléments et paramètres de commande de ligne des fichiers de configuration peuvent servir à
personnaliser les programmes d'installation, mais tous ne s'appliquent pas à chaque version secondaire, Support
Package ou correctif. Exécutez d'abord le programme d'installation pour la mise à jour pour déterminer ce que
vous devez personnaliser, puis utilisez les informations de Création du fichier de configuration [page 16] et ID et
codes pour la personnalisation de la plateforme de BI [page 40] pour créer le fichier de personnalisation.
Pour spécifier la version du produit dans le fichier de configuration
Le fichier de configuration pour les programmes d'installation de mise à jour doit contenir la version du
produit dans l'élément clonePatchProduct comme illustré ci-dessous :
<oem name="<any name>">
<clonePatchProduct sourceId="<product version>">
...
38
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
</clonePatchProduct>
</oem>
La product version (version du produit) du fichier de configuration doit correspondre au numéro de version du
programme d'installation que vous personnalisez. Pour trouver le numéro de version, cherchez dans le dossier
dunit un dossier portant un nom ayant ce format :
product.boe64.patch-4.x.x.x-core-32
Utilisez le nom de ce dossier comme product version (version du produit).
Exemple
Cet exemple de fichier de configuration présente une personnalisation de la plateforme SAP Crystal
Reports 4.1 de Business Intelligence Patch 1, dont la version du produit est
product.boe64.patch-4.1.0.1-core-32. Le fichier de configuration personnalise le nom long du produit
en Custom Company Server et le nom court du produit en Custom CS.
<oem name="Custom Patch Tool">
<clonePatchProduct sourceId="product.boe64.patch-4.1.0.1-core-32">
...
</clonePatchProduct>
</oem>
Pour utiliser le paramètre baselinePath
Utilisez le paramètre de ligne de commande baselinePath pour faire référence à un dossier racine contenant les
versions d'origine non personnalisées de l'ensemble des précédents programmes d'installation complets ou de
mise à jour que vous avez personnalisés. Cela signifie que vous devez conserver les packages d'installation
d'origine.
Remarque
Ce paramètre remplace le paramètre baselinePackages introduit dans 4.0 Feature Pack 3.
Pour simplifier la valeur du paramètre baselinePath, référencez un seul dossier racine. L'outil de
personnalisation ignorera les fichiers et dossiers inutiles. Autrement, pour spécifier plusieurs dossiers racine,
utilisez un point-virgule (; - Windows) ou deux-points (; - Unix) dans la valeur baselinePath. Prenons les
exemples suivants sous Windows.
Exemple
Personnalisation de 4.0 SP5 Patch 2
Supposez que vous personnalisiez la plateforme BI 4.0 Support Package 5 Patch 2 et que vous ayez
personnalisé les précédents programmes : 4.0 SP2 (installation complète), 4.0 SP4, 4.0 SP5,
4.0 SP5 Patch 1. Supposez que les programmes d'installation non personnalisés se trouvent dans la
structure de répertoire suivante :
C:\productUpdates\4.0\
\SP2 Full\
\SP4\
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
39
\SP5\
\SP5 Patch 1\
Définissez le paramètre baselinePath sur le dossier racine :
baselinePath=C:\productUpdates\4.0\
Exemple
Personnalisation de 4.1 SP 1
Supposez que vous personnalisiez la plateforme BI 4.1 Support Package 1 et que vous ayez personnalisé les
précédents programmes : 4.0 SP2 (installation complète), 4.0 SP4, 4.0 SP5, 4.1. Supposez
que les programmes d'installation non personnalisés se trouvent dans la structure de répertoire suivante :
C:\productUpdates\
\4.0\
\SP2 Full\
\SP4\
\SP5\
\4.1\
\Full\
Définissez le paramètre baselinePath sur le dossier racine :
baselinePath=C:\productUpdates\
3.9
BI
ID et codes pour la personnalisation de la plateforme de
La section suivante contient une liste des ID et codes pouvant être utilisés pour personnaliser le programme
d'installation :
●
ID des fonctionnalités
●
ID des unités de déploiement de raccourci (Windows uniquement)
●
ID de chaîne
●
Codes langue
●
ID d'écran d'installation et de propriété
3.9.1
ID des fonctionnalités
Utilisez ces ID dans l'élément removeFeature pour supprimer des fonctionnalités et leurs composants du
programme d'installation et du produit installé.
Par exemple, cet ID supprimera tous les composants de niveau Web, notamment JavaWebApps1 et tomcat60 :
<removeFeature id="WebTier"/>
●
40
root : supprimer toutes les fonctionnalités
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
○
WebTier (Supprimer tous les composants de niveau Web répertoriés ci-dessous)
○
JavaWebApps1 (Applications Web Java)
○
tomcat60 (Tomcat 6.0)
Remarque
Si vous supprimez la fonctionnalité de niveau Web, les composants de niveau Web seront supprimés
du programme d'installation. Toutefois, la case d'option WebTier restera visible dans l'écran
Choisissez un type d'installation. En d'autres termes, l'utilisateur verra toujours les trois cases
d'option : Complet, Personnalisée/Etendue et Niveau Web. Il s'agit d'un problème connu qui sera
résolu.
○
Servers: (Supprimer tous les composants serveur répertoriés ci-dessous)
○
PlatformServers : (Supprimer tous les serveurs de plateforme répertoriés ci-dessous)
○
CMS (Central Management Server)
○
FRS (File Repository Servers)
○
PlatformServers.IntegratedDB.SQLAnywhere (serveur de base de données fourni Sybase
SQL Anywhere)
○
○
PlatformServers.EventServer
○
PlatformServers.SystemLandscapeSupplier (SLD)
○
PlatformServers.WebAppContainerService (WACS)
○
AdaptiveProcessingServer (traitement de plateforme)
○
AdaptiveJobServer (planification)
○
Platform.RestWebService
○
Platform.Action.Framework.backend : Structure Insight to Action
○
Subversion (Système de contrôle de version Subversion)
ConnectionServices (Supprimer tous les composants de connectivité répertoriés ci-dessous)
○
○
ConnectionProcService
DataFederatorServices : (Supprimer tous les composants de fédération de données répertoriés
ci-dessous)
○
○
○
DataFederatorQueryService
AdvancedAnalysisServices : (Supprimer tous les composants Analysis répertoriés ci-dessous)
○
MultidimensionalAnalysisServices (MDAS)
○
BExWebApplicationsService
CrystalReportsServers : (Supprimer tous les composants SAP Crystal Reports répertoriés cidessous)
○
○
CrystalReportsProcServices (Traitement SAP Crystal Reports)
○
CrystalReportSchedulingServices
○
CrystalReport2011ProcServices (Traitement SAP Crystal Reports 2011)
○
CrystalReport2011SchedulingServices (Planification SAP Crystal Reports 2011)
WebIServers : (Supprimer tous les composants Web Intelligence répertoriés ci-dessous)
○
WebIProcServer (Traitement Web Intelligence)
○
WebISchedulingServices (Planification Web Intelligence)
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
41
○
XcelsiusServers (Dashboards)
○
MobileServices (Supprimer tous les services mobiles répertoriés ci-dessous)
○
○
MobileServers
○
MobileAddon (Plug-in de CMS pour mobile)
IntegrationServers (Supprimer tous les composants d'intégration répertoriés ci-dessous)
○
○
MultitenancyManager
○
AdministratorTools (Supprimer tous les outils d'administration répertoriés ci-dessous)
○
●
42
UpgradeManager (Outil de gestion de mise à niveau)
DeveloperTools (Supprimer tous les composants outils de développement répertoriés ci-dessous)
○
●
BWPublisherServer (Prise en charge de l'authentification SAP BW et de SAP BW Publisher)
BOE64bitNETSDK (SDK .NET de la plateforme SAP BusinessObjects Business Intelligence 64 bits)
DataAccess (Supprimer tous les composants d'accès à la base de données répertoriés ci-dessous)
○
DataAccess.DataFederator
○
DataAccess.HPNeoView
○
DataAccess.MySQL
○
DataAccess.GenericJDBC
○
DataAccess.GenericODBC
○
DataAccess.GenericOLEDB
○
DataAccess.OptionalDataDirectODBC
○
DataAccess.MaxDB
○
DataAccess.SAPHANA
○
DataAccess.Salesforce (Salesforce.com)
○
DataAccess.Netezza
○
DataAccess.Microsoft_AnalyticalServices
○
DataAccess.MicrosoftExchange
○
DataAccess.MicrosoftOutlook
○
DataAccess.Microsoft_SQLServer
○
DataAccess.Microsoft_Access
○
DataAccess.Ingres
○
DataAccess.Greenplum
○
DataAccess.IBMDB2
○
DataAccess.Informix
○
DataAccess.ProgressOpenEdge
○
DataAccess.Oracle
○
DataAccess.Sybase
○
DataAccess.Teradata
○
DataAccess.SAPBW
○
DataAccess.SAPERP
○
DataAccess.OData
○
DataAccess.Excel
○
DataAccess.XMLWebServices
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
●
○
DataAccess.SAP (sécurité et accès aux données pour les systèmes SAP BW et R/3)
○
DataAccess.PersonalFiles
○
DataAccess.JavaBean
○
DataAccess.OpenConnectivity
○
DataAccess.HSQLDB
○
DataAccess.Derby
○
DataAccess.HadoopHive
○
DataAccess.Essbase
○
DataAccess.Peoplesoft (PeopleSoft Enterprise)
○
DataAccess.JDEdwards (JD Edwards EnterpriseOne)
○
DataAccess.Siebel (Serveur Siebel Enterprise)
○
DataAccess.OracleEBS (Oracle E-Business Suite)
○
DataAccess.Universe (Univers SAP BusinessObjects)
○
DataAccess.MyCube (Cube OLAP)
○
DataAccess.XML
○
DataAccess.ADO.NET
○
DataAccess.COMData
○
DataAccess.DataSet (Consommateur de jeux de données)
○
DataAccess.SymantecACT
○
DataAccess.BDE (DLL de base données IDAPI)
○
DataAccess.CDO (Objets de données Crystal)
○
DataAccess.FieldDefinitions
○
DataAccess.FileSystem
○
DataAccess.NTEventLog
○
DataAccess.WebActivityLog
○
DataAccess.Btrieve (Pilote de base de données Pervasive)
○
DataAccess.dBase
○
DataAccess.UWSC (Connecteur universel pour services Web (UWSC))
Samples (Supprimer les exemples de rapport et les sources de données)
Liens associés
Suppression de fonctionnalités [page 27]
3.9.2 ID des unités de déploiement de raccourci (Windows
uniquement)
Utilisez les ID d'unités de déploiement dans l'élément shortcut pour changer l'emplacement et le nom des
raccourcis de programmes dans le menu Démarrer de Windows.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
43
Tableau 6: ID des unités de déploiement de raccourci
ID de l'unité de déploiement de raccourci
Cible du raccourci
product.businessobjects64.shortcut.wdeploy-4 WDeploy
.0-core
product.businessobjects64.shortcut.ccm-4.0core
Central Configuration Manager
product.businessobjects64.shortcut.cmc-4.0core
Central Management Console
product.businessobjects64.shortcut.infoview- Zone de lancement BI (InfoView)
4.0-core
product.businessobjects64.shortcut.odbc-4.0- Administrateur de source de données 32 bits
core
product.businessobjects64.shortcut.onlinedoc Documentation en ligne
-4.0-core
product.businessobjects64.shortcut.tomcat-4. Apache Tomcat. Pour en savoir plus, voir .
0-core
product.businessobjects64.shortcut.upgrade-4 Outil de gestion de mise à niveau
.0-core
product.businessobjects64.shortcut.wacs.info Serveurs WACS stockés dans InfoView
view-4.0-core
product.businessobjects64.shortcut.wacs-4.0- Serveur conteneur d'applications Web
core
Liens associés
Personnalisation des raccourcis du menu Démarrer de Windows (Windows uniquement) [page 20]
3.9.3
ID de chaîne
Vous pouvez modifier la valeur de toutes les chaînes du programme d'installation. Vous pouvez remplacer une
chaîne pour toutes les langues ou pour une langue en particulier. Utilisez l'élément replaceString, par
exemple :
<replaceString id="productname" value="Sales Data Insight lang="all"/>
Tableau 7: Chaînes couramment modifiées
ID de chaîne
Description
product.boe64_name
Nom long du produit
product.boe64_shortname
Nom court du produit
product_version
Version du produit
product_majorversion
Version principale du produit
Liens associés
44
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Personnalisation du nom du produit et du numéro de version [page 18]
3.9.4
Codes langue
L'outil de personnalisation SAP BusinessObjects utilise ces codes langue pour représenter les langues prises en
charge :
langue
Code
Anglais
EN
Tchèque
CS
Danois
DA
Néerlandais
NL
Finnois
FI
Français
FR
Allemand
DE
Hongrois
HU
Italien
IT
Japonais
JA
Coréen
KO
Norvégien (Bokmål)
NB
Polonais
PL
Portugais
PT
Roumain
RO
Russe
RU
Chinois simplifié
zh_CN
Slovaque
SK
Espagnol
ES
Suédois
SV
Thaï
TH
Chinois traditionnel
zh_TW
turc
TR
Liens associés
Personnalisation du nom du produit et du numéro de version [page 18]
Personnalisation des raccourcis du menu Démarrer de Windows (Windows uniquement) [page 20]
Personnalisation de l'utilitaire Ajout/Suppression de programmes de Windows [page 123]
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
45
Suppression de packs linguistiques [page 28]
Personnalisation du contrat de licence [page 31]
3.9.5
ID d'écran d'installation et de propriété
Utilisez les ID des écrans d'installation dans l'élément removeDialog pour supprimer les écrans du programme
d'installation. Utilisez par exemple cet élément pour supprimer l'écran Informations utilisateur :
<removeDialog id="EnterProductKey.dialog"/>
Utilisez les propriétés et les valeurs de propriété pour préremplir les données saisies par l'utilisateur. Utilisez par
exemple cet élément pour définir le type d'installation par défaut sur personnalisé :
<replaceProperty id="InstallType" defaultValue="custom"/>
Remarque
Les valeurs de propriété respectent la casse.
Tableau 8: ID d'écran d'installation et propriétés associées
Titre de l'écran
d'installation
ID de l'écran
d'installation
ID de propriété
Valeur(s) de propriété autorisée(s)
Vérification des
prérequis
CheckPreRequisites
.dialog
Non applicable
Non applicable
Veuillez
sélectionner une
langue
d'installation
SelectUILanguage.d
ialog
SortedAvailableS
etupLanguages
Ensemble de codes langue sous lesquels
peut être exécuté le programme
d'installation, "en:ja", par exemple
SetupUILanguage
Code langue unique représentant la
langue sous laquelle sera exécuté le
programme d'installation, "en", par
exemple
Bienvenue dans
l'Assistant
d'installation...
ShowWelcomeScreen.
dialog
Non applicable
Non applicable
Contrat de licence
ShowLicenseAgreeme
nt.dialog
Non applicable
Non applicable
Informations
utilisateur
EnterProductKey.di
alog
RegisteredUser
Nom d'utilisateur
RegisteredCompan
y
Nom de l'entreprise
ProductKey
Code clé du produit
SelectedLanguage
Packs
L'ensemble des packs linguistiques à
installer, par exemple "en;ja". Pour une
Sélection des
langues
SelectLanguagePack
.dialog
liste des codes langue, voir Codes langue.
46
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Titre de l'écran
d'installation
ID de l'écran
d'installation
ID de propriété
Valeur(s) de propriété autorisée(s)
Choisissez un type
d'installation
ChooseInstallType.
dialog
InstallType
●
par défaut (Complète)
●
personnalisé
●
webtier
Spécifier le dossier ChooseInstallDir.d
ialog
de destination
InstallDir
Dossier d'installation
Sélectionnez la
base de données
existante ou la
base de données
par défaut
SelectDataSource.d
ialog
SelectIntegrated
Database
●
Installation
étendue
ExpandInstallMessa
ge
0 (Utiliser une base de données
existante)
●
1 (Installer et utiliser la base de
données par défaut)
Non applicable
Non applicable
ChooseWebAppServer
Sélectionner le
.dialog
serveur
d'applications Web
Java
WebAppServerType
●
tomcat
●
manuel
●
wacs
Sélection des
fonctions
SelectFeatures.dia
log
Non applicable
Non applicable
Configurer la
gestion des
versions
SelectLCM.dialog
NewOrExistingLCM
●
existante
●
nouvelle
Installation
étendue
ChooseExpandInstal
l.dialog
NewOrExpandInsta
ll
●
nouveau
●
étendue
Configurer
Subversion
SetLCMConfig.dialo
g
LCMName
Nom du référentiel
LCMPort
Port du référentiel
LCMUserName
Utilisateur du référentiel
LCMPassword
Mot de passe du référentiel
LCMPasswordConfi
rm
Confirmer le mot de passe
SIAPort
Port du SIA
SIAName
Nom du nœud
Configurer le
Server Intelligence
Agent (SIA)
GetSIAInfo.dialog
Configurer le
Central
Management
Server (CMS)
GetCMSInfo.dialog
CMSPort
Tout numéro de port valide
Configurer le
compte CMS
GetCMSPassword.dia
log
CMSPassword
Mot de passe du CMS
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
47
Titre de l'écran
d'installation
Configurer Sybase
SQL Anywhere
Configurer
Microsoft SQL
Server 2008
Express
Choisir de
démarrer ou
d'arrêter les
serveurs
ID de l'écran
d'installation
GetSQLAnywhereInfo
.dialog
GetSQLExpressInfo.
dialog
ChooseToEnableServ
ers.dialog
ID de propriété
Valeur(s) de propriété autorisée(s)
CMSPasswordConfi
rm
Mot de passe du CMS
ClusterKey
Clé de cluster du CMS
ClusterKeyConfir
m
Clé de cluster du CMS
SQLAnywhereServe
rName
Le nom de serveur SQL Anywhere (Unix
et Linux uniquement)
SQLAnywherePort
Le port SQL Anywhere
SQLAnywhereAdmin
Password
Le mot de passe administrateur
SQLAnywhere (le nom d'utilisateur est
dba).
SQLExpressAdminP
assword
Mot de passe administrateur SQL
SQLExpressBOEUse
rName
Nom d'utilisateur de la plateforme SAP
BusinessObjects Business Intelligence
SQLExpressBOEUse
rPassword
Mot de passe de la plateforme SAP
BusinessObjects Business Intelligence
EnableServers
●
0 (Arrêter les serveurs lors de
l'installation)
●
1 (Démarrer les serveurs lors de
l'installation)
Configurer Tomcat ●
ShowTomcatInfo. TomcatConnection
Port
dialog
Port de connexion
●
GetTomcatInfo.d TomcatShutdownPo
rt
ialog
Port d'arrêt
Les deux ID de boîte de
dialogue doivent être
inclus au fichier de
configuration afin de
supprimer l'écran
Configurer Tomcat. En
d'autres termes, vous
devez inclure deux
éléments
removeDialog dans
TomcatRedirectPo
rt
Port de redirection
ChooseSMDIntegra
tion
●
nointegrate (Ne pas intégrer)
●
integrate (Intégrer)
votre fichier de
configuration.
Configurer la
connectivité de
l'agent Solution
48
SelectSMDIntegrate
.dialog
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Titre de l'écran
d'installation
ID de l'écran
d'installation
ID de propriété
Valeur(s) de propriété autorisée(s)
ConfigureSMDAgent.
Configurer la
connexion à l'agent dialog
SMD
SMDAgent_HOST
Hôte de l'agent SMD
SMDAgent_PORT
Port de l'agent SMD
Intégration
Introscope
ChooseIntroscope
Integration
●
nointegrate (Ne pas intégrer)
●
integrate (Intégrer)
Manager
Diagnostics (SMD)
Configurer la
connectivité à
Introscope
Enterprise
Manager
SelectIntroscopeIn
tegrate.dialog
ConfigureIntroscop
e.dialog
Introscope_ENT_H
OST
Nom de l'hôte d'Introscope
Introscope_ENT_P
ORT
Numéro du port d'Introscope
Introscope_ENT_H
OST
Hôte d'Enterprise Manager
Introscope_ENT_P
ORT
Port d'Enterprise Manager
Introscope_ENT_I
NSTRUMENTATION
Définissez-le sur true pour indiquer que
vous avez configuré cet écran
d'installation
Configurer le port
d'écoute HTTP
GetWACSPort.dialog
WACSPort
Numéro de port pour le service conteneur
d'applications Web
Sélectionner un
type de base de
données d'audit
existant
SelectAuditDatabas
e.dialog
UsingAuditDBType
●
sybase
●
db2
●
oracle
●
mysql
●
mssql
●
maxdb
●
aucun
●
sybase
●
db2
●
oracle
●
mysql
●
mssql
●
maxdb
Sélectionner le
type de base de
données CMS
existant
SelectCMSDatabase.
dialog
Informations sur le SetRemoteCMSInfo.d
ialog
déploiement du
CMS existant
UsingCMSDBType
RemoteCMSName
Nom du CMS existant
RemoteCMSPort
Numéro de port pour le CMS existant
RemoteCMSAdminNa
me
Nom d'utilisateur de l'administrateur
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
49
Titre de l'écran
d'installation
ID de l'écran
d'installation
ID de propriété
Valeur(s) de propriété autorisée(s)
RemoteCMSAdminPa
ssword
Mot de passe de l'administrateur
La plateforme SAP ShowInstallComplet
eLaunchWDeploy.dia
BusinessObjects
log
Business
Intelligence a été
installée
LaunchWDeploy
●
Configurer la base ExistingAuditDB2.d
de données d'audit ialog
- DB2
ExistingAuditing
DBServer
Nom d'alias DB2
ExistingAuditing
DBUser
Nom d'utilisateur
ExistingAuditing
DBPassword
Mot de passe
ExistingAuditing
DBDatabase
Nom de la base de données d'audit
existante
ExistingAuditing
DBUser
Nom d'utilisateur pour la base de
données existante
ExistingAuditing
DBPassword
Mot de passe de l'utilisateur
ExistingAuditing
DBPort
Numéro de port pour la base de données
existante
ExistingAuditing
DBServer
Nom du serveur MaxDB
ExistingAuditing
DBUser
Nom d'utilisateur
ExistingAuditing
DBPassword
Mot de passe
ExistingAuditing
DBServer
Oracle TNSNAME
ExistingAuditing
DBDatabase
Nom de la base de données SQL
ExistingAuditing
DBServer
Nom du serveur SQL
ExistingAuditing
DBUser
Nom d'utilisateur
ExistingAuditing
DBPassword
Mot de passe
Configurer la base ExistingAuditMaxDB
de données d'audit .dialog
- MaxDB
Configurer la base ExistingAuditOracl
de données d'audit e.dialog
- Oracle
Configurer la base ExistingAuditMSSQL
de données d'audit .dialog
- SQL Server
(ODBC)
50
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
0 (Ne pas lancer l'outil WDeploy après
l'installation)
●
1 (Lancer automatiquement l'outil
WDeploy après l'installation)
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Titre de l'écran
d'installation
ID de l'écran
d'installation
Configurer la base ExistingAuditMySQL
de données d'audit .dialog
- MySQL
Configurer la base ExistingAuditSQLAn
de données d'audit ywhere.dialog
- SQL Anywhere
(ODBC)
Configurer la base ExistingAuditSybas
de données d'audit e.dialog
- Sybase
Configurer la base
de données du
référentiel CMS SQL Anywhere
(ODBC)
ExistingCMSSQLAnyw
here.dialog
Configurer la base
de données du
référentiel CMS DB2
ExistingCMSDB2.dia
log
ID de propriété
Valeur(s) de propriété autorisée(s)
ExistingAuditing
DBUseTrustedConn
ection
Utiliser la connexion sécurisée
ExistingAuditing
DBDSN
Nom de la source de données
ExistingAuditing
DBShowSysDB
Afficher la base de données système
ExistingAuditing
DBDatabase
Nom de la base de données d'audit
ExistingAuditing
DBUser
Nom d'utilisateur
ExistingAuditing
DBPassword
Mot de passe
ExistingAuditing
DBPort
Port MySQL
ExistingAuditing
DBServer
Serveur MySQL
ExistingAuditing
DBUser
Nom d'utilisateur pour la base de
données existante
ExistingAuditing
DBPassword
Mot de passe de l'utilisateur
ExistingAuditing
DBDatabase
Nom de la base de données d'audit
existante
ExistingAuditing
DBUser
Nom d'utilisateur
ExistingAuditing
DBPassword
Mot de passe
ExistingAuditing
DBServer
Nom du service Sybase
ExistingCMSDBDSN
Nom de la source de données
ExistingCMSDBUse
r
Nom d'utilisateur pour la base de
données existante
ExistingCMSDBPas
sword
Mot de passe de l'utilisateur
ExistingCMSDBSer
ver
Nom d'alias DB2
ExistingCMSDBUse
r
Nom d'utilisateur
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
51
Titre de l'écran
d'installation
ID de l'écran
d'installation
ID de propriété
Valeur(s) de propriété autorisée(s)
ExistingCMSDBPas
sword
Mot de passe
ExistingCMSDBRes
et
●
0 (Ne pas réinitialiser la base de
données existante)
●
1 (Réinitialiser la base de données
existante)
Configurer la base
de données du
référentiel du CMS
- MaxDB
ExistingCMSMaxDB.d
ialog
ExistingCMSDBSer
ver
Nom de la base de données du CMS
ExistingCMSDBUse
r
Nom d'utilisateur
ExistingCMSDBPas
sword
Mot de passe
ExistingCMSDBRes
et
●
0 (Ne pas réinitialiser la base de
données existante)
●
1 (Réinitialiser la base de données
existante)
Configurer la base
de données du
référentiel CMS SQL Server
ExistingCMSMSSQL.d
ialog
ExistingCMSDBDat
abase
Serveur MaxDB
ExistingCMSDBPor
t
Port MaxDB
ExistingCMSDBSer
ver
Nom du serveur existant
ExistingCMSDBUse
r
Nom d'utilisateur
ExistingCMSDBPas
sword
Mot de passe
ExistingCMSDBRes
et
●
0 (Ne pas réinitialiser la base de
données existante)
●
1 (Réinitialiser la base de données
existante)
52
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
ExistingCMSDBDat
abase
Nom de la base de données du CMS
ExistingCMSDBUse
TrustedConnectio
n
Utiliser la connexion sécurisée
ExistingCMSDBDSN
Nom de la source de données
ExistingCMSDBSho
wSysDB
Afficher la base de données système
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Titre de l'écran
d'installation
ID de l'écran
d'installation
ID de propriété
Valeur(s) de propriété autorisée(s)
Configurer la base
de données du
référentiel CMS MySQL
ExistingCMSMySQL.d
ialog
ExistingCMSDBSer
ver
Serveur MySQL
ExistingCMSDBUse
r
Nom d'utilisateur
ExistingCMSDBPas
sword
Mot de passe
ExistingCMSDBRes
et
●
0 (Ne pas réinitialiser la base de
données existante)
●
1 (Réinitialiser la base de données
existante)
Configurer la base
de données du
référentiel CMS Oracle
ExistingCMSOracle.
dialog
ExistingCMSDBDat
abase
Nom de la base de données du CMS
ExistingCMSDBPor
t
Port MySQL
ExistingCMSDBSer
ver
Oracle TNSNAME
ExistingCMSDBUse
r
Nom d'utilisateur
ExistingCMSDBPas
sword
Mot de passe
ExistingCMSDBRes
et
●
0 (Ne pas réinitialiser la base de
données existante)
●
1 (Réinitialiser la base de données
existante)
Configurer la base
de données du
référentiel CMS Sybase
Configurer
Subversion
ExistingCMSSybase.
dialog
SetLCMConfig.dialo
g
ExistingCMSDBSer
ver
Nom du service Sybase
ExistingCMSDBUse
r
Nom d'utilisateur
ExistingCMSDBPas
sword
Mot de passe
ExistingCMSDBRes
et
Réinitialiser la base de données existante
LCMName
Nom du référentiel
LCMPort
Port du référentiel
LCMUserName
Utilisateur du référentiel
LCMPassword
Mot de passe
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
53
Titre de l'écran
d'installation
ID de l'écran
d'installation
ID de propriété
Valeur(s) de propriété autorisée(s)
LCMPasswordConfi
rm
Confirmer le mot de passe
La plateforme SAP ShowInstallComplet
e.dialog
BusinessObjects
BI 4.0 FP3 a été
installée
Non applicable
Non applicable
Commencer
l'installation
ShowInstallSummary
.dialog
Non applicable
Non applicable
Etapes de postinstallation
ShowPostInstall.di
alog
Non applicable
Non applicable
Confirmation de
désinstallation
VerifyToRemove.dia
log
Non applicable
Non applicable
La plateforme SAP ShowUninstallCompl
ete.dialog
BusinessObjects
BI 4.0 FP3 a été
désinstallée
Non applicable
Non applicable
Liens associés
Personnalisation de la saisie utilisateur [page 25]
Suppression d'écrans d'installation [page 26]
54
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation du programme d'installation de la plateforme de Business Intelligence
4
Personnalisation d'applications Web
4.1
Introduction
Vous pouvez appliquer votre propre branding (ou "apparence") aux applications Web de la zone de lancement BI,
d'OpenDocument et du visualiseur Crystal Reports JavaScript. Vous pouvez par exemple personnaliser vos
systèmes OEM en y appliquant vos propres éléments d'identité d'entreprise.
Vous pouvez personnaliser les éléments Web et graphiques suivants :
●
Favicon (icône affichée dans la barre d'URL du navigateur)
●
Logos
●
Certains motifs et couleurs d'arrière-plan
●
Certains gifs animés (l'indicateur de progression, par exemple)
●
Certains styles CSS (bordures, espace de remplissage, marges, etc.)
●
Les fichiers JavaScript pour le visualiseur Crystal Reports JavaScript
Vous pouvez personnaliser de nombreux aspects des applications Web de la plateforme de BI et choisir de ne
personnaliser qu'un sous-ensemble de ces options.
A qui s'adressent ces informations ?
Cette section est destinée aux concepteurs, développeurs et administrateurs système d'applications Web qui
personnalisent des applications Web de la plateforme de BI. Une connaissance des bases de la conception de CSS
et des archives d'applications Web Java est nécessaire. Si vous déployez des personnalisations, vous devez aussi
connaître les méthodes d'installation et de déploiement des applications Web de la plateforme de BI sur un
serveur d'applications.
Pour en savoir plus sur l'installation de la plateforme SAP BusinessObjects Business Intelligence, voir le Guide
d'installation de la plateforme de Business Intelligence.
Pour en savoir plus sur le déploiement d'applications Web de la plateforme de BI à l'aide de l'outil WDeploy, voir le
Guide de déploiement d'applications Web.
4.1.1
Notions clés
Pour réaliser et déployer vos personnalisations, vous devez comprendre les concepts suivants :
Package d'installation
Le package d'installation est composé de fichiers binaires téléchargés à partir du SAP Service Marketplace en vue
de démarrer l'installation de la plateforme SAP BusinessObjects Business Intelligence. Il contient les dossiers
Collaterals, dunit, langs et setup.engine ainsi que d'autres fichiers binaires.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
55
Modèle de personnalisation
Le fichier template.zip se trouve dans le dossier Collaterals\CustomizationTemplate de votre package
d'installation et contient les packages de branding (fichiers JAR) à personnaliser avant d'installer la plateforme
SAP BusinessObjects Business Intelligence. Ce fichier est le point de départ de la personnalisation de vos
applications Web.
Fichier WAR BOE
BOE.war est l'archive d'applications Web principale pour la plateforme de BI. La zone de lancement BI,
OpenDocument, le visualiseur Crystal Reports JavaScript et les modifications que vous apportez dans le fichier
template.zip à leurs packages de branding respectifs sont repris dans le programme d'installation au sein de
BOE.war. Pour déployer vos personnalisations et rendre ces applications accessibles à vos clients, vous devez
déployer BOE.war sur votre serveur d'applications Java au cours du processus d'installation ou après.
Packages de branding
Un package de branding est un fichier JAR contenant les ressources personnalisées (CSS, icônes, images, fichiers
JavaScript) que vous incluez au programme d'installation dans le fichier template.zip. Les packages de
branding suivants sont inclus :
●
com.businessobjects.webpath.InfoViewBranding.jar (zone de lancement BI)
Ce package de branding se compose de deux dossiers principaux : un dossier css reprenant un fichier CSS
personnalisé et un dossier images contenant un sous-dossier d'icônes favorites et de thèmes avec des logos,
images et GIF animés personnalisés.
\com.businessobjects.webpath.InfoViewBranding\web
\css
customize.css
\images
favicon.ico
\theme
*.png, *.gif
●
com.businessobjects.webpath.OpenDocumentBranding.jar (OpenDocument)
Ce package de branding se compose de deux dossiers principaux : un dossier css reprenant un fichier CSS
personnalisé et un dossier images contenant un sous-dossier de logos et d'images nommé theme.
\com.businessobjects.webpath.InfoViewBranding\web
\service
\css
customize.css
\images
\theme
*.png
●
com.businessobjects.webpath.CrystalReports_oem.jar (visualiseur Crystal Reports JavaScript)
Ce package de branding se compose de deux ressources principales : un fichier JavaScript contenant des
écouteurs personnalisés vous permettant de définir de nouveaux comportements pour certains événements
56
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
de visualiseur, et un fichier de propriétés JSON pour référencer les fichiers JavaScript ou images que vous
décidez d'utiliser avec le visualiseur.
\com.businessobjects.webpath.CrystalReports_oem\web
CustomListener.js
\WEB-INF\classes
JSAPI-properties.json
\images
*.png
Déploiement d'applications Web
Le programme d'installation de la plateforme SAP BusinessObjects Business Intelligence ne peut effectuer le
déploiement de BOE.war que sur le serveur d'applications Web Tomcat fourni. Les autres serveurs d'applications
Web pris en charge requièrent le déploiement des applications Web une fois l'installation terminée. Il est
recommandé d'utiliser l'outil WDeploy.
4.1.2
Test de vos personnalisations
Avant de réaliser une personnalisation de vos systèmes de production, il est bon de commencer par procéder à un
test de vos personnalisations sur une installation test. Dans une installation par défaut utilisant le serveur Tomcat
fourni, vous pouvez voir immédiatement le résultat de vos changements en apportant des modifications
temporaires aux dossiers webpath.InfoViewBranding, webpath.OpenDocumentBranding et
webpath.CrystalReports_oem dans le répertoire work de Tomcat : \SAP BusinessObjects
\Tomcat6\work\Catalina\localhost\BOE\eclipse\plugins\webpath.OpenDocumentBranding\web
\service. Ces dossiers ont la même structure que les ressources de branding contenues dans template.zip.
Remarque
Le répertoire work de Tomcat n'est pas permanent et vos modifications temporaires seront supprimées au
redémarrage de Tomcat.
4.2
Démarrage rapide
Avant de démarrer, réalisez une copie de sauvegarde de \Collaterals\Tools\CustomizationTemplate
\template.zip à partir de votre package d'installation.
Cette section explique les étapes fondamentales nécessaires à la personnalisation et au déploiement de l'une des
applications Web de la plateforme de BI : la zone de lancement BI. Les étapes présentées sont également
applicables à OpenDocument et au visualiseur Crystal Reports JavaScript.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
57
Remarque
Ce démarrage rapide décrit la personnalisation de bout en bout, notamment la réalisation d'une installation
complète de la plateforme SAP BusinessObjects Business Intelligence et le déploiement de BOE.war sur un
serveur d'applications. Cette procédure peut prendre beaucoup de temps.
1.
Recherchez template.zip dans votre package d'installation de la plateforme SAP BusinessObjects
Business Intelligence sous : \Collaterals\Tools\CustomizationTemplate.
2.
Extrayez le contenu de template.zip dans un dossier de travail.
template.zip contient les packages de branding, \SAP BusinessObjects
Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\eclipse\plugins
\com.businessobjects.webpath.InfoViewBranding.jar par exemple.
3.
Décompressez le package de branding de la zone de lancement BI
com.businessobjects.webpath.InfoViewBranding.jar.
jar xf com.businessobjects.webpath.InfoViewBranding.jar
4.
Personnalisez le favicon par défaut à afficher dans la barre d'URL du navigateur pour la zone de lancement BI.
Le package de branding de la zone de lancement BI contient un exemple de favicon. Copiez \web\sample
\images\favicon.ico un niveau au-dessus de \web\images\favicon.ico.
5.
Recréez un package com.businessobjects.webpath.InfoViewBranding.jar contenant votre nouveau
favicon et incluez-le à template.zip.
Pour recréer un package avec le contenu des dossiers Web et META-INF dans
com.businessobjects.webpath.InfoViewBranding.jar :
jar cf com.businessobjects.webpath.InfoViewBranding.jar web META-INF
6.
Créez un sous-dossier nommé OEMZips sous : \dunit\product.businessobjects64.oemzips-4.0core-nu
7.
Ajoutez template.zip au dossier \OEMZips.
Votre fichier zip personnalisé se trouve désormais sous : \dunit
\product.businessobjects64.oemzips-4.0-core-nu\OEMZips\template.zip
8.
Installez et déployez BOE.war sur votre serveur d'applications Java à l'aide de l'une des options suivantes :
Option
Description
Utiliser le serveur Tomcat fourni
Sélectionné au cours du processus d'installation.
Utiliser votre propre serveur d'applications Java prises
en charge
Réalisé une fois terminée l'exécution du programme
d'installation. Utilisez l'outil WDeploy.
Utilisez setup.exe (Windows) ou setup.sh (Unix) pour démarrer le processus d'installation.
9.
Après une installation et un déploiement réussis, testez vos modifications en accédant à la zone de lancement
BI : http://<nom du serveur Web>:<port>/BOE/BI
Vous pouvez voir le nouveau favicon dans la barre d'URL de votre navigateur :
58
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
4.3
Personnalisation de la zone de lancement BI
Dans le cas de la zone de lancement BI, vous pouvez personnaliser le favicon, le logo, les arrière-plans, les styles
et bien plus encore. La plupart de ces personnalisations impliquent la modification des règles CSS dans le fichier
customize.css. Pour prendre effet, toutes les personnalisations doivent être rendues accessibles dans le
dossier web de com.businessobjects.webpath.InfoViewBranding.jar comme suit :
\web
\css
customize.css
\images
favicon.ico
\theme
*.png, *.gif
Remarque
Le fichier JAR propose des exemples de personnalisation. Par exemple, lorsque vous ouvrez
com.businessobjects.webpath.InfoViewBranding.jar, vous trouvez un dossier web\sample
contenant un exemple de fichier CSS, des exemples d'images et un fichier README.
4.3.1
Pour personnaliser l'image de favicon
La favicon est la petite icône s'affichant dans la barre d'adresses du navigateur lors de l'affichage de la zone de
lancement BI.
Remplacez le fichier favicon.ico stocké dans le dossier web\images par votre propre image
favicon.ico.
4.3.2
Pour personnaliser les logos
Vous pouvez personnaliser les logos utilisés dans la zone de lancement BI en modifiant les règles CSS du fichier
web\css\customize.css. Si vous utilisez des images personnalisées et y faites référence dans le fichier
customize.css, veillez à les placer dans le dossier web\images\theme.
4.3.3 Personnalisation d'autres éléments de l'interface
utilisateur
Vous pouvez personnaliser les logos, arrière-plan, styles et autres éléments d'interface utilisateur de la zone de
lancement BI en modifiant les règles CSS du fichier web\css\customize.css. Si vous utilisez des images
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
59
personnalisées et y faites référence dans le fichier customize.css, veillez à les placer dans le dossier web
\images\theme.
A des fins de référence, le diagramme suivant présente les éléments personnalisés du package de branding
d'exemple. Les nombres dans les infobulles font référence aux sections du fichier customize.css du package de
branding.
1.
(0.1) personnaliser l'arrière-plan des pages et sous-pages (cadres intérieurs)
2.
(0.2) champ de saisie de texte
3.
(0.4) champ de mot de passe
4.
(1.1) conteneur de champs d'authentification
5.
(1.2) conteneur de tout
6.
(1.3) règles horizontales
7.
(1.5) bouton "Se connecter"
8.
(1.6) motif d'arrière-plan de la bannière
9.
(1.7) logo
10. (2.1.1) zone supérieure de la bannière (motif d'arrière-plan)
11. (2.1.2) logo de la bannière
60
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
12. (2.2.1) conteneur d'onglets
13. (2.2.2) onglet actif
14. (2.2.3) onglet inactif
15. (2.3.1) icône de la zone de lancement BI
16. (2.2.4) boutons d'onglet
17. (0.7) bouton fléché
18. (3.1.1) en-tête inactif d'accordéon
19. (3.1.2) en-tête actif d'accordéon
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
61
20. (3.1.3) arrière-plan du tiroir/de l'arborescence d'accordéon
21. (3.3.1) arrière-plan de la barre d'outils
22. (3.4) arrière-plan du pied de page
23. (3.5.2) ligne non activée sélectionnée dans le volet de liste et dans l'arborescence (à gauche)
24. (3.6) barre de redimensionnement du volet de liste en accordéon
62
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
25. (3.2.1) conteneur du volet de liste
26. (3.2.2) intitulé du volet de liste
27. (3.2.3) lignes du volet de liste
28. (3.5.1) ligne activée sélectionnée dans le volet de liste et dans l'arborescence (à gauche)
29. (5.1.2, 5.1.3, 5.1.4) poignée et bouton de redimensionnement
30. (0.8.1) conteneur du menu contextuel
31. (0.8.2) corps du menu contextuel
32. (0.8.3) élément du menu contextuel
33. (0.8.4) élément sélectionné du menu contextuel
34. (0.9) infobulle
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
63
35. (4.1) conteneur des détails
36. (5.2) en-tête des détails
37. (6.1) conteneur de boîte de dialogue simple
38. (6.2.1) en-tête de boîte de dialogue simple
39. (6.2.2) bouton "Fermer" de l'en-tête de boîte de dialogue
40. (6.3) corps de boîte de dialogue simple
64
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
41. (6.4) pied de page de boîte de dialogue simple
42. (6.5) champ de texte de boîte de dialogue simple (remplace le champ de texte général)
43. (6.6) boutons de boîte de dialogue simple
44. (3.3.2, 3.3.3) survol/enfoncement de bouton de la barre d'outils
45. (3.3.4) élément du menu de la barre d'outils
46. (3.3.5) élément survolé du menu de la barre d'outils
47. (3.3.6) séparateur du menu de la barre d'outils
48. (3.3.7) cadre du menu de la barre d'outils
49. (3.3.8) icône d'actualisation du menu de la barre d'outils
50. (7.1.1) en-tête de grande boîte de dialogue
51. (7.1.2) en-tête de grande boîte de dialogue – bouton agrandir (survol)
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
65
52. (7.1.3) en-tête de grande boîte de dialogue – bouton fermer (survol)
53. (7.2.1) panneau de boutons de grande boîte de dialogue
54. (7.3.1) pied de page de grande boîte de dialogue
55. (7.3.2) poignée de redimensionnement de grande boîte de dialogue
56. (7.4.1) conteneur de corps de grande boîte de dialogue
57. (7.4.2) cadre de grande boîte de dialogue
58. (7.4.3) élément sélectionné du volet de navigation de gauche de grande boîte de dialogue
59. (0.3) zone de texte
60. (0.5) bouton
61. (0.6) étiquettes de formulaire
4.3.4 Utilisation des espaces de travail BI et modules
composés
Vous pouvez également utiliser un espace de travail BI ou un module composé comme page d'accueil de votre
zone de lancement BI. Vous pouvez personnaliser l'espace de travail ou le module composé pour l'assortir au
style OEM de votre zone de lancement BI.
Remarque
Le style OEM personnalisé se reflète uniquement sur la page d'accueil. Si le même espace de travail ou module
composé est ouvert en dehors de la page d'accueil (en affichage normal), le style standard est utilisé.
A des fins de référence, le diagramme suivant présente les éléments personnalisés du package de branding
d'exemple. Les nombres dans les infobulles font référence aux sections du fichier customize.css du package de
branding.
66
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
Pour le module ou la page d'accueil par défaut
Les paramètres suivants permettent de personnaliser la page d'accueil par défaut ainsi que tout espace de travail
BI ou module composé défini comme page d'accueil.
1.
(8.1.2) arrière-plan du titre de module
2.
(8.1.3) bordure de module
3.
(8.2.1) arrière-plan du module de la zone de lancement BI
4.
(8.2.2) couleur du texte Afficher plus
Pour l'affichage normal d'un espace de travail BI
Les paramètres suivants permettent de personnaliser l'apparence d'une vue normale d'espace de travail BI.
1.
(8.3.1) conteneur d'onglets supérieurs personnalisés
2.
(8.3.2) conteneur de sous-onglets personnalisés
3.
(8.3.4) onglet supérieur actif
4.
(8.3.5) onglet supérieur inactif
5.
(8.3.6) sous-onglet
4.3.4.1 Pour assortir le style d'un espace de travail BI à celui
de la zone de lancement BI
1.
Ouvrez l'espace de travail BI pour le modifier.
2.
Dans le premier onglet de l'espace de travail, cliquez sur Propriétés.
La boîte de dialogue Propriétés s'affiche.
3.
Sélectionnez l'icône de l'option précédant immédiatement l'(ultime) option Style par défaut.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
67
4.
Cliquez sur OK.
4.3.4.2 Pour assortir le style d'un module composé à celui de
la zone de lancement BI
1.
Dans la page d'accueil de la zone de lancement BI, cliquez sur Préférences.
La boîte de dialogue Préférences – Administrateur apparaît.
2.
Sélectionnez Espaces de travail BI dans la liste Préférences.
3.
Dans la liste du volet principal, sélectionnez Zone de lancement BI.
4.3.5
Pour modifier le nom de la zone de lancement BI
Vous pouvez modifier le nom de la zone de lancement BI afin que l'application se combine à un ensemble
d'applications existant qu'utilise votre société.
Remarque
Vous n'avez pas besoin de modifier les packages de branding pour changer le nom de la zone de lancement BI,
mais vous pouvez également changer les images associées, ce qui nécessites des modifications dans les
packages de branding.
1.
Copiez le fichier BIlaunchpad.properties de
<REPINSTALL>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF
\config\default
vers
<REPINSTALL>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF
\config\custom
Remarque
Ne modifiez pas les fichiers du dossier default. Effectuez toujours vos modifications sur des copies des
fichiers stockés dans le dossier custom.
2.
Modifiez les propriétés suivantes :
app.name=BI launch pad
app.name.greeting=BusinessObjects
app.name.short=BI launch pad
app.url.name=/BI
3.
68
Redéployez BOE.war sur votre serveur d'applications Java.
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
4.4
Personnalisation d'OpenDocument
Dans le cas d'OpenDocument, vous pouvez personnaliser le logo, les arrière-plans et les styles de la page de
connexion. La plupart de ces personnalisations impliquent la modification des règles CSS dans le fichier
customize.css. Pour prendre effet, toutes les personnalisations doivent être rendues accessibles dans le
dossier web\service de com.businessobjects.webpath.OpenDocumentBranding comme suit :
\web
\service
\css
customize.css
\images
\theme
*.png
Remarque
Le fichier JAR propose des exemples de personnalisation. Par exemple, lorsque vous ouvrez
com.businessobjects.webpath.OpenDocumentBranding, vous trouvez un dossier web\sample
contenant un exemple de fichier CSS, des exemples d'images et un fichier README.
A des fins de référence, le diagramme suivant présente les éléments personnalisés du package de branding
d'exemple. Les nombres dans les infobulles font référence aux sections du fichier customize.css du package de
branding.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
69
1.
(0.1) personnaliser l'arrière-plan des pages et sous-pages (cadres intérieurs)
2.
(0.2) champ de saisie de texte
3.
(0.3) champ de mot de passe
4.
(1.1) conteneur de champs d'authentification
5.
(1.2) conteneur de tout
6.
(1.3) règles horizontales
7.
(1.5) bouton "Se connecter"
8.
(1.6) motif d'arrière-plan de la bannière
9.
(1.7) logo
4.5 Personnalisation du visualiseur de Crystal Reports
JavaScript
Cette section explique comment utiliser le visualiseur de rapport contenu dans votre déploiement OEM de la
plateforme SAP BusinessObjects Business Intelligence.
Le visualiseur peut être personnalisé par l'ajout des éléments suivants :
●
Un logo personnalisé
●
Des écouteurs d'événements et d'actions de SAP Crystal Reports JavaScript API
●
Des fichiers CSS
●
Des fichiers ou bibliothèques JavaScript externes
4.5.1
Personnalisation du visualiseur
Vous pouvez reconstituer le fichier template.zip à l'aide des fichiers que vous utilisez pour personnaliser le
visualiseur de rapport.
Le workflow est le suivant :
1.
Extrayez le contenu du fichier template.zip.
2.
Modifiez le fichier com.businessobjects.webpath.CrystalReports_oem.jar.
3.
Activez le comportement de visualiseur personnalisé en attribuant à la propriété crystal_enable_jsapi la
valeur true dans le fichier SAP BusinessObjectsEnterprise XI 4.0\warfiles\webapps\config
\custom\CrystalReports.properties.
4.
Recréez le fichier template.zip.
Remarque
Il est recommandé de créer une copie de sauvegarde du fichier template.zip avant d'en modifier le contenu.
Dans le fichier template.zip, le fichier suivant doit être modifié :
70
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
template.zip
Modifier
Décompressez le fichier .zip et modifiez-le.
SAP
BusinessObjectsEnterprise XI 4.0\warfiles
\webapps\BOE\WEB_INF\eclipse\plugins
\com.businessobjects.webpath.CrystalReport
s_oem.jar
Dans le fichier com.businessobjects.webpath.CrystalReports_oem.jar, modifiez les éléments suivants :
CrystalReports_oem.jar
Modifier
\web
Ajoutez des fichiers JavaScript et CSS personnalisés ou
externes à ce dossier.
\web\CustomListener.js
Ajoutez des écouteurs d'événements de SAP Crystal Reports
JavaScript API aux fonctions OnViewerInit et
OnViewerFail dans le fichier CustomListener.js.
Pour en savoir plus, voir le guide SAP Crystal Reports
JavaScript API.
\WEB-INF\classes\JSAPI-properties.json
Ajoutez un chemin d'accès relatif à toutes les images, tous
les fichiers JavaScript et tous les fichiers CSS ajoutés au
dossier \web. Vous pouvez également modifier le logo
qu'affichera le visualiseur.
Dans l'exemple suivant, un logo, un fichier JavaScript et son
contenu JavaScript, ainsi qu'un fichier CSS sont ajoutés :
{
"logo" :
{
"img" : "images/logo.gif",
"tooltip" : "SAP Crystal Reports",
"url" : "http://
www.businessobjects.com/
ipl/default.asp?
destination=ViewerLogoLink
&product=crystalreports&version=14%2E0"
},
"scripts" :
[
CustomListener.js
\CustomFiles\*.js
],
"styles" :
[
\CustomStyle.css
]
}
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
71
CrystalReports_oem.jar
Modifier
Remarque
Tous les fichiers auxquels fait référence le fichier JSAPIproperties.json doivent être inclus dans le dossier
\web.
72
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation d'applications Web
5
Outil de gestion de l'architecture
mutualisée de la plateforme de Business
Intelligence
5.1
Introduction
L'outil de gestion de l'architecture mutualisée de la plateforme SAP BusinessObjects Business Intelligence est un
programme Java permettant aux partenaires SAP OEM de normaliser et d'automatiser la création d'objets et de
paramètres pour les nouveaux clients dans un déploiement de la plateforme de BI d'architecture mutualisée.
Dans un déploiement mutualisé, plusieurs clients sont hébergés sur une seule instance de la plateforme de BI.
Chaque client a une vue séparée de ses propres données qui ne sont pas visibles pour les autres clients. Il existe
de nombreux exemples de déploiements de clients, par exemple :
●
Clients partageant le même univers et la même base de données.
●
Clients utilisant des univers et bases de données séparés.
Cela s'effectue d'ordinaire manuellement dans le cadre de la configuration de la plateforme de BI pour chaque
client. Vous pouvez par exemple :
1.
Créer des groupes d'utilisateurs séparés pour chaque client
2.
Créer des dossiers séparés pour les documents des clients
3.
Restreindre les vues de données d'univers pour chaque client
4.
Appliquer les paramètres de sécurité appropriés pour isoler l'expérience de chaque client
L'outil de gestion de l'architecture mutualisée automatise ces étapes et d'autres étapes afin de faciliter le
processus de création de clients.
A qui s'adressent ces informations ?
Cette section s'adresse aux administrateurs système et de contenu responsables de la configuration, de la
gestion et de la maintenance d'une installation de la plateforme de BI d'architecture mutualisée. Il est nécessaire
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
73
d'être familier avec les concepts et outils de base utilisés pour gérer une installation de la plateforme de BI. En
fonction des conditions requises du déploiement de vos clients, il peut être nécessaire de comprendre la
conception d'univers pour les rapports et analyses. Toutefois, cette section, qui tient compte des différents
niveaux d'expérience administrative, a pour objectif de fournir des informations contextuelles et conceptuelles
suffisantes pour clarifier l'ensemble des fonctions et des tâches administratives.
Pour en savoir plus sur la configuration de la sécurité et de l'infrastructure du serveur de la plateforme de BI, voir
le Guide d'administration de la plateforme de Business Intelligence.
Pour en savoir plus sur la gestion, la planification et la diffusion de contenu BI dans le référentiel, voir le Guide de
l'utilisateur de la plateforme de Business Intelligence.
Pour en savoir plus sur la conception d'univers classiques (fichiers .unv), voir le guide de l'utilisateur Outil de
conception d'univers.
Conventions
Cette section utilise la terminologie suivante :
Terme
Définition
client
Client de partenaire SAP OEM partageant une unique
instance de l'infrastructure et des services de la plateforme
de BI avec d'autres clients, leurs données et leur expérience
utilisateur restant séparées.
modèle de client
Collection d'objets de référentiel, droits et paramètres
servant de base structurelle à la création des clients dans une
installation de la plateforme de BI d'architecture mutualisée.
jeton modèle
Chaîne utilisée pour identifier un objet modèle ou paramètre
de client afin qu'il soit répliqué par l'outil lors de la création
d'un client.
fichier de configuration client
Fichier de propriétés Java
(tenant_template_def.properties) permettant de
définir des options avant d'exécuter l'outil de gestion de
l'architecture mutualisée.
5.2
Démarrage rapide
Ce démarrage rapide présente une série de tâches pour vous aider à faire vos premiers pas avec l'outil de mise en
service de gestion de l'architecture mutualisée de la plateforme de BI. Ces tâches ont pour objet de vous aider à
vous familiariser avec les étapes essentielles nécessaires à la création de clients sur base d'un modèle. Des liens
vers des instructions détaillées et des informations relatives aux concepts essentiels sont fournis le cas échéant.
Pour utiliser l'outil :
1.
74
L'Outil de gestion d'architecture mutualisée doit être installé (installation par défaut ou sélectionné pendant
une installation personnalisée).
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
2.
Vous devez créer une collection d'objets et de paramètres dans l'installation de votre plateforme de BI
pouvant vous servir de modèle de client.
3.
Vous devez configurer un fichier de définition du client pour chaque nouveau client.
4.
Vous devez exécuter l'outil pour créer un client. L'outil utilise le modèle de client et les paramètres définis
dans le fichier de définition du client pour créer le client.
Ce démarrage rapide vous présente d'abord la méthode de création d'un modèle de client comprenant un unique
groupe d'utilisateurs de la plateforme de BI, deux dossiers publics et des droits accordés sur un dossier. Vous
verrez ensuite comment configurer un fichier de définition des clients et exécuter l'outil à l'aide de ces paramètres
pour mettre en service un nouveau client au cours de l'intégration.
5.2.1
Conditions d'installation
Pour utiliser l'outil de gestion de l'architecture mutualisée, vous devez avoir installé les logiciels suivants :
●
JRE 1.6
●
SAP BusinessObjects Business Intelligence platform 4.0 Feature Pack 3 ou version ultérieure
L'outil de gestion de l'architecture mutualisée est installé par défaut avec la plateforme de BI et se trouve dans le
dossier \java\apps\ :
●
Windows : <REPINSTAL>\SAP BusinessObjects Enterprise XI 4.0\java\apps
\multitenancyManager\jars\
●
Unix : <REPINSTALL>/sap_bobj/enterprise_xi40/java/apps/multitenancyManager/jars/
Si vous avez réalisé une installation personnalisée, vous pouvez ajouter l'outil en modifiant votre installation et en
sélectionnant la fonctionnalité suivante :
●
Windows : Serveurs - Gestionnaire de l'architecture mutualisée
●
Unix : Serveurs - Gestionnaire de l'architecture mutualisée
Pour des instructions détaillées sur la façon de modifier les fonctionnalités installées dans votre déploiement de la
plateforme de BI, voir le Guide d'installation de la plateforme de Business Intelligence.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
75
5.2.2
Créer votre modèle de client
Pour cet exemple de démarrage rapide, créons les objets modèle et paramètres suivants à l'aide de la CMC
(Central Management Console) :
●
Un groupe d'utilisateurs nommé "$TemplateToken$"
●
Un dossier public nommé $TemplateToken$ au niveau racine
●
Une structure de dossier public tenants/$TemplateToken$_temp au niveau racine
●
Des droits affectés au dossier $TemplateToken$
Pour commencer, démarrez la CMC et connectez-vous à l'aide des références de connexion appropriées pour
créer les objets. Par défaut, vous pouvez démarrer la CMC en allant sur http://<<webservername>:
8080/BOE/CMC.
Liens associés
Setting up a tenant template [page 82]
5.2.2.1
Pour créer un groupe d'utilisateurs
1.
Dans la zone de gestion Utilisateurs et groupes de la CMC, cliquez sur Gérer > Nouveau > Nouveau groupe.
La boîte de dialogue Créer un groupe d'utilisateurs s'affiche.
2.
Saisissez le nom du groupe $TemplateToken$ ainsi que sa description.
3.
Cliquez sur OK.
Le groupe d'utilisateurs modèle est créé.
76
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Figure 1: Propriétés : boîte de dialogue $TemplateToken$ pour la création d'un groupe d'utilisateurs client (exemple en anglais)
5.2.2.2
Pour créer un dossier
1.
Dans la zone de gestion Dossiers de la CMC, naviguez jusqu'au dossier public racine.
2.
Cliquez sur Gérer > Nouveau > Dossier.
3.
Saisissez $TemplateToken$ comme nom de votre nouveau dossier.
4.
Cliquez sur OK.
5.
Répétez les étapes 2 à 5 et créez un dossier nommé _clients contenant un sous-dossier nommé
$TemplateToken$_temp.
Les nouveaux dossiers apparaissent dans la liste des dossiers et des objets.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
77
Figure 2: Propriétés : boîte de dialogue $TemplateToken$ pour la création d'un dossier de client (exemple en anglais)
5.2.2.3
Pour définir les droits
1.
Dans la zone de gestion Dossiers de la CMC, sélectionnez le dossier $TemplateToken$.
2.
Cliquez sur Gérer > Sécurité de l'utilisateur.
La boîte de dialogue Sécurité de l'utilisateur apparaît et affiche la liste de contrôle d'accès.
3.
Cliquez sur Ajouter des utilisateurs/groupes principaux.
La boîte de dialogue Ajouter des utilisateurs/groupes principaux s'affiche.
4.
Déplacez le groupe d'utilisateurs modèle "$TemplateToken$" de la liste Utilisateurs/Groupes disponibles vers
la liste Utilisateurs/Groupes sélectionnés.
5.
Cliquez sur Ajouter et affecter la sécurité.
6.
Sélectionnez les niveaux d'accès que vous voulez accorder au groupe d'utilisateurs $TemplateToken$. Par
exemple, Visualiser.
7.
Choisissez d'activer ou non l'héritage de groupe ou de dossier.
8.
Répétez les étapes 1 à 7 et accordez des droits au groupe d'utilisateurs modèle pour accéder au dossier
$TemplateToken$_temp.
Le groupe d'utilisateurs modèle dispose à présent de droits pour accéder aux dossiers de modèles.
78
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Figure 3: Sécurité de l'utilisateur : boîte de dialogue $TemplateToken$ pour la définition des droits d'accès au client (exemple en
anglais)
5.2.3
Configurer votre fichier de définition des clients
Avant de configurer votre fichier de définition des clients, accédez au dossier multitenancyManager et réalisez
une copie de sauvegarde de l'original du fichier tenant_template_def.properties. Le dossier
multitenancyManager se trouve sous :
●
Windows : <REPINSTAL>\SAP BusinessObjects Enterprise XI 4.0\java\apps
\multitenancyManager\jars\
●
Unix : <REPINSTALL>/sap_bobj/enterprise_xi40/java/apps/multitenancyManager/jars/
Dans cette tâche, vous définissez les options dans votre fichier de définition des clients
(tenant_template_def.properties) qui permettra à l'outil de se connecter à votre CMS (Central
Management Server), d'identifier les objets modèle grâce à la chaîne de jeton de modèle et de créer de nouvelles
copies de ces objets avec un nom de client spécifique.
1.
Ouvrez tenant_template_def.properties pour le modifier.
2.
Modifiez les options obligatoires cms, auth, user et password en fonction des informations
d'authentification utilisées pour vous connecter au CMS.
cms=mycmsdomainname:port
auth=secEnterprise
user=Administrator
pwd=mypassword
Les valeurs possibles pour l'option auth sont : secEnterprise, secLDAP, secWinAD et secSAPR3.
3.
Remplacez l'option obligatoire tenantName par le nom du client à créer.
tenantName=abc_customer
4.
Remplacez l'option obligatoire templateToken par la chaîne utilisée pour identifier vos dossiers de modèles
et groupe d'utilisateurs.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
79
Dans cet exemple, utilisez la chaîne "$TemplateToken$" comme dans la précédente tâche du démarrage
rapide “Créer votre modèle de client”.
templateToken=$TemplateToken$
5.
Modifiez l'option obligatoire templateContentFolder pour spécifier les dossiers de modèles de niveau
supérieur.
Dans ce démarrage rapide, vous avez créé deux dossiers de modèles comportant le jeton de modèle dans leur
nom. Séparez les valeurs multiples par un point-virgule et insérez le chemin complet sous le dossier racine
public.
templateContentFolder=$TemplateToken$;_tenants/$TemplateToken$_temp
6.
Enregistrez et fermez tenant_template_def.properties.
Liens associés
Configuring the tenant definition file [page 95]
5.2.4
Exécuter l'outil
Pour exécuter l'outil, accédez au dossier où se trouve l'outil de gestion de l'architecture mutualisée, ouvrez une
invite de commande et exécutez multitenancymanager.jar avec votre fichier de définition des clients
transmis dans l'option -configFile :
java -jar multitenancymanager.jar -configFile tenant_template_def.properties
Remarque
L'outil de gestion de l'architecture mutualisée est installé par défaut avec la plateforme de BI et se trouve dans
le dossier \java\apps\ :
●
Windows : <REPINSTAL>\SAP BusinessObjects Enterprise XI 4.0\java\apps
\multitenancyManager\jars\
●
Unix : <REPINSTALL>/sap_bobj/enterprise_xi40/java/apps/multitenancyManager/jars/
Lorsque le programme a terminé, connectez-vous à la CMC (Central Management Console) et affichez les
dossiers publics, le groupe d'utilisateurs et les paramètres de sécurité récemment créés pour le client
"abc_customer".
80
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Figure 4: Sécurité de l'utilisateur : boîte de dialogue <nom du client> pour l'affichage des droits d'accès au client (exemple en
anglais)
Figure 5: Nouveau groupe d'utilisateurs du client répertorié dans la hiérarchie de groupe dans la zone Utilisateur et Groupes
(exemple en anglais)
Par défaut, un fichier journal nommé multitenancymanager<yyyy><mm><dd><time>.csv est créé dans le
dossier suivant :
●
Windows : <REPINSTALL>\SAP BusinessObjects Enterprise XI 4.0\logging\
●
Unix : <REPINSTAL>/sap_bobj/logging/
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
81
Etapes suivantes
Le démarrage rapide vous a montré comment configurer un modèle de client de base et créer un client avec
quelques objets et paramètres de sécurité simples. L'outil vous permet de recourir à des scénarios plus
complexes cependant, et de répliquer beaucoup d'autres objets, notamment des univers et des informations de
connexion à la base de données de rapports. Reportez-vous aux autres sections de ce guide pour trouver des
informations relatives à la configuration de tous les types d'objets modèle et à diverses configurations facultatives
que vous pouvez réaliser dans le fichier de définition des clients.
Liens associés
Running the tenant provisioning tool [page 101]
Troubleshooting [page 102]
5.3
Configuration d'un modèle de client
Un modèle de client est une collection d'objets de référentiel, droits et paramètres servant de base structurelle
afin de créer des clients dans une installation de la plateforme de BI d'architecture mutualisée. Par exemple, les
clients de votre déploiement peuvent avoir des traits communs, comme des groupes d'utilisateurs ou des
structures de dossiers publics structurellement identiques.
Au lieu de recréer ces objets et paramètres similaires chaque fois qu'un client doit être créé, vous pouvez les créer
une fois pour toutes sous forme de modèle sur la plateforme de BI, puis exécuter l'outil de gestion de
l'architecture mutualisée pour créer des instances de client basées sur ce modèle.
Les différentes parties d'un modèle de client sont identifiées par l'utilisation d'un jeton de modèle. Le jeton de
modèle est une chaîne identifiant un objet ou un paramètre particulier à répliquer par l'outil. Par exemple :
1.
Choisissez la chaîne "$TemplateToken$" comme jeton.
2.
Créez à l'aide de la CMC (Central Management Console) un groupe d'utilisateurs dont le nom contient
"$TemplateToken$", comme "$TemplateToken$" ou "$TemplateToken$_usergroup".
Après avoir exécuté l'outil, un groupe d'utilisateurs est créé pour ce client avec la structure et les paramètres
identiques à ceux du groupe d'utilisateurs modèle. La chaîne de jeton "$TemplateToken$" est remplacée par le
nom réel défini dans le fichier de configuration client.
Les sections suivantes proposent des informations sur l'identification des différents composants de votre modèle
de client à l'aide de votre jeton de modèle et sur le fonctionnement de l'outil en ce qui concerne chaque
composant.
Remarque
Pour des instructions détaillées sur la façon de créer des objets tels que des groupes d'utilisateurs et des
dossiers dans la CMC, voir le Guide d'administration de la plateforme de Business Intelligence.
5.3.1
Dossiers
Pour inclure des dossiers publics à votre modèle :
82
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
1.
Dans la CMC, créez un dossier dont le nom contient le jeton de modèle.
2.
Spécifiez ce dossier à l'aide de l'option templateContentFolder dans le fichier de configuration client avec
une liste séparée par des points-virgules.
Vous devez uniquement spécifier les dossiers de niveau supérieur dans votre modèle lorsque vous exécutez
l'outil ; tous les sous-dossiers et objets contenus dans les dossiers seront également copiés automatiquement.
Dans l'exemple ci-dessous, vous spécifieriez les dossiers $TemplateToken$ et $TemplateToken$_temp dans
votre fichier de configuration. Le dossier Documents et le rapport Crystal seront automatiquement copiés en tant
qu'enfants du dossier de niveau supérieur $TemplateToken$_temp.
Public Folders
$TemplateToken$
Documents
Tenant_report.rpt
Reports Samples
$TemplateToken$_temp
5.3.2
Groupes d'utilisateurs
Pour inclure un groupe d'utilisateurs à votre modèle, créez dans la CMC des groupes dont le nom contient le jeton
de modèle, par exemple, "$TemplateToken$" ou "$TemplateToken$_usergroup".
Il est recommandé que les groupes d'utilisateurs de modèle ne contiennent pas de comptes utilisateur car ils sont
destinés à appartenir à tous les nouveaux groupes d'utilisateurs de client et risquent alors d'entraîner des conflits
d'autorisations. Les clients ne doivent pas partager d'utilisateurs. Créez des groupes d'utilisateurs vides avec des
titres et des descriptions à utiliser comme modèles.
Remarque
Les groupes d'utilisateurs sont automatiquement recherchés par l'outil et ne peuvent être exclus du modèle de
client.
5.3.3
Dossiers d'événements
Pour inclure des dossiers d'événements à votre modèle :
1.
Dans la CMC, créez un dossier d'événements dont le nom contient le jeton de modèle.
2.
Définissez optionIncludeEvents sur true dans le fichier de configuration client.
3.
Spécifiez le dossier d'événements à l'aide de l'option templateEventFolder avec une liste séparée par des
points-virgules.
Vous devez uniquement spécifier les dossiers d'événements de niveau supérieur dans votre modèle lorsque vous
exécutez l'outil ; tous les sous-dossiers et événements contenus dans les dossiers seront également copiés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
83
5.3.4
Catégories
Pour inclure des catégories à votre modèle :
1.
Dans la CMC, créez des catégories dont le nom contient le jeton de modèle.
2.
Définissez optionIncludeCategories sur true dans le fichier de configuration client.
3.
Spécifiez les catégories à l'aide de l'option templateCategoryFolder avec une liste séparée par des pointsvirgules.
5.3.5
Profils
Pour inclure des profils à votre modèle :
1.
Dans la CMC, créez un profil dont le nom contient le jeton de modèle.
2.
Définissez optionIncludeProfiles sur true dans le fichier de configuration client.
Tous les utilisateurs, groupes d'utilisateurs, valeurs de profil et cibles de profils généraux sont copiés dans le
nouveau profil de client.
5.3.6
Paramètres de sécurité
Les niveaux d'accès (groupes de droits) peuvent faire partie de votre modèle de client. Pour inclure des niveaux
d'accès à votre modèle :
1.
Dans la CMC, créez un niveau d'accès dont le nom contient le jeton de modèle.
2.
Définissez optionIncludeLevels sur true dans le fichier de configuration client.
Tous les droits inclus sont copiés sur le nouveau niveau d'accès de client.
En outre, tout droit ou niveau d'accès accordé sur les objets modèle aux utilisateurs ou groupes principaux sont
transférés au nouvel objet modèle. Si l'objet client cible existe déjà avant l'exécution de l'outil (par exemple, lors
de l'exécution à plusieurs reprises de l'outil pour le même client), utilisez l'option optionImportSecMode pour
spécifier la manière exacte dont sont traités les droits des utilisateurs ou groupes principaux existants sur l'objet
client :
●
optionImportSecMode=0 (Mode Fusionner) : fusionne les utilisateurs ou groupes principaux et les droits du
modèle avec l'objet client existant. Préserve les droits initialement accordés à tout utilisateur ou groupe
principal sur l'objet client existant.
Remarque
En cas de conflit, le paramètre du modèle a la priorité lors de la fusion. Par exemple, si l'objet modèle
accorde de manière spécifique un droit à un utilisateur ou groupe principal tandis que l'objet client existant
refuse de manière spécifique le même droit.
●
optionImportSecMode=1 (remplacement au niveau des utilisateurs ou groupes principaux) : remplace les
droits des utilisateurs ou groupes principaux par les droits du modèle. Ajoute les utilisateurs ou groupes
principaux et droits uniques à partir du modèle et préserve les utilisateurs ou groupes principaux et droits
uniques de l'objet client.
84
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
●
optionImportSecMode=2 (remplacement au niveau des objets) : supprime tous les utilisateurs ou groupes
principaux et droits existants sur l'objet client existant et les remplace par les utilisateurs ou groupes
principaux et droits accordés sur l'objet modèle.
Exemple
Prenons un exemple à titre d'illustration. Supposons que vous disposez d'un dossier de modèles
($TemplateToken$) et d'un dossier de client existant (ABC) avec les niveaux d'accès accordés aux utilisateurs
ou groupes principaux comme suit :
Tableau 9: Niveaux d'accès avant
Dossier de modèle = "$TemplateToken$"
Dossier de client = "ABC"
Utilisateur ou
groupe principal
Niveau d'accès
Utilisateur ou
groupe principal
Niveau d'accès
Utilisateur 1
Visualiser
Utilisateur 1
Contrôle total
Utilisateur 2
Visualiser
-
-
Utilisateur 3
Visualiser
Après exécution de l'outil, les autorisations accordées sur le dossier de client ABC basé sur le paramètre
optionImportSecMode sont les suivantes :
Tableau 10: Niveaux d'accès après
Dossier client = "ABC"
Dossier de client = "ABC"
Dossier de client = "ABC"
optionImportSecMode=0
optionImportSecMode=1
optionImportSecMode=2
Utilisateur ou
groupe
principal
Niveau d'accès
Utilisateur ou
groupe
principal
Niveau d'accès
Utilisateur ou
groupe
principal
Niveau d'accès
Utilisateur 1
Contrôle total,
Visualiser
Utilisateur 1
Visualiser
Utilisateur 1
Visualiser
Utilisateur 2
Visualiser
Utilisateur 2
Visualiser
Utilisateur 2
Visualiser
Utilisateur 3
Visualiser
Utilisateur 3
Visualiser
-
-
Le comportement s'applique également aux droits ajoutés individuellement, pas seulement aux niveaux
d'accès.
5.3.7
SAP Crystal Reports 2011
L'outil de gestion de l'architecture mutualisée permet le mappage direct aux données des informations de
connexion des rapports modèle de SAP Crystal Reports 2011 aux paramètres de connexion de nouveaux clients.
Pour mapper les informations de connexion à la source de données de client pour les rapports Crystal :
1.
Créez et téléchargez un jeu de rapports dans un dossier de modèles de la plateforme de BI.
Vous pouvez spécifier les dossiers de modèles dans le fichier de configuration client à l'aide de l'option
templateContentFolder.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
85
2.
Spécifiez les informations DSN du modèle à l'aide de l'option crystalreport.templatedb1 dans le fichier
de configuration client.
Le format de la valeur est <serveur de base de données>;<nom de base de données>;<type de
source de données>;<nom d'utilisateur>;<mot de passe>. Par exemple :
crystalreport.templatedb1=MyTemplateDSN;MyTemplateDatabase;odbc;administrator;pas
sword
Astuce
Pour trouver les valeurs correctes pour <serveur de base de données>;<nom de base de
données>, cliquez avec le bouton droit de la souris sur le rapport dans la CMC et sélectionnez
Configuration de la base de données. Les champs Serveur et Base de données peuvent être copiés dans le
fichier de configuration client.
3.
Spécifiez les informations DSN du nouveau client à l'aide de l'option crystalreport.tenantdb1 dans le
fichier de configuration client.
Le format de la valeur est <serveur de base de données>;<nom de base de données>;<type de
source de données>;<nom d'utilisateur>;<mot de passe>. Par exemple :
crystalreport.tenantdb1=MyTenantDSN;MyTenantDatabase;odbc;tenantname;tenantpwd
Après avoir exécuté l'outil, les rapports Crystal récemment copiés dans les propres dossiers du client sont
mappés à leur propre connexion à la source de données. Vous pouvez spécifier d'autres paires de paramètres
modèle/client en ajoutant les couplages d'options crystalreport.templatedb<n> et
crystalreport.tenantdb<n> au fichier de configuration client. Par exemple, crystalreport.templatedb2
et crystalreport.tenantdb2.
Prêtez attention aux instantanés avant et après du CMS ci-dessous en supposant qu'un client nommé "ABC" est
créé :
Avant
Après
Public Folders
$TemplateToken$_folder
$TemplateToken$_report1.rpt
$TemplateToken$_1report.rpt
$TemplateToken$_report2.rpt
●
Public Folders
$TemplateToken$_folder
$TemplateToken$_report1.rpt
$TemplateToken$_1report.rpt
$TemplateToken$_report2.rpt
ABC_folder
ABC_report1.rpt
ABC_1report.rpt
ABC_report2.rpt
$TemplateToken$_report1 et
$TemplateToken$_1report1 utilisent tous
deux les paramètres DSN
crystalreport.templatedb1.
●
●
tous deux les paramètres DSN
crystalreport.tenantdb1.
$TemplateToken$_report2 utilise les
paramètres DSN
crystalreport.templatedb2.
ABC_report1.rpt et ABC_1report.rpt utilisent
●
ABC_report2.rpt utilise les paramètres DSN
crystalreport.tenantdb2.
86
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Mappage des préfixes de tables
La base de données modèle peut utiliser des préfixes de tables différents de la base de données du nouveau client
vers laquelle vous redirigez les rapports. Dans ce cas, utilisez les options
crystalreport.templatetableprefixes<n> et crystalreport.tenanttableprefixes<n> pour
spécifier la méthode de mappage des tables. Les préfixes sont séparés par des points-virgules et une liste doit se
terminer par un point-virgule pour être en mesure d'identifier les chaînes vides (""). Prenons l'exemple suivant :
templatetableprefixes1=templateprefixa;templateprefixb;;
tenanttableprefixes1=;tenantprefixb;tenantprefixc;
Cela entraîne le mappage suivant :
Préfixe modèle
Mappe vers le préfixe client
templateprefixa
(chaîne vide)
templateprefixb
tenantprefixb
(chaîne vide)
tenantprefixc
Astuce
Pour trouver le nom d'un préfixe de table dans un rapport modèle, cliquez avec le bouton droit de la souris sur
le rapport dans la CMC et sélectionnez Configuration de la base de données. Le champ Préfixe de table fournit le
nom.
Types de source de données pris en charge
L'outil de gestion de l'architecture mutualisée prend en charge la modification des types de connexion directe aux
données suivants. Utilisez ces valeurs dans les options crystalreport.templatedb<n> et
crystalreport.tenantdb<n> :
Tableau 11: Type de source de données SAP Crystal Reports 2011
Type de source de données
odbc
oracle
db2
sybase
Informix
crdb_xml
Pour en savoir plus sur les versions spécifiques de ces bases de données prises en charge par SAP Crystal
Reports 2011, voir la Product Availability Matrix (Plateformes prises en charge/PAR) accessible dans la section
SAP BusinessObjects du SAP Support Portal à l'adresse https://service.sap.com/bosap-support.
Liens associés
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
87
Dossiers [page 82]
5.3.8
SAP Crystal Reports pour Enterprise
L'outil de gestion de l'architecture mutualisée permet de mapper un rapport SAP Crystal Reports pour Enterprise
configurant une connexion directe aux données par le biais d'un objet de connexion CCIS.DataConnection créé
avec l'outil de conception d'information SAP Crystal Reports. Ces objets de connexion se trouvent sur la
plateforme SAP BusinessObjects Business Intelligence et peuvent être visualisés dans le dossier Connections à
l'aide de la CMC (Central Management Console). Les rapports modèles sont mappés aux nouveaux paramètres
de connexion client.
Pour mapper des informations de connexion à une source de données de client pour des rapports utilisant un
objet de connexion, configurez l'option suivante dans le fichier de configuration client :
●
ccis.dataconnection.dbcredentials<n>=<modèle_CCIS.CONN_CUID>;<nom de la source de
données>;<nom de la base de données>;<nom d'utilisateur>;<mot de passe>
●
template_CCIS.CONN_CUID est le CUID d'un objet de connexion modèle.
Astuce
Pour trouver l'objet de connexion associé dans le rapport modèle, cliquez avec le bouton droit de la souris
sur le rapport dans la CMC et sélectionnez
relationnelle figure dans les résultats.
●
Outils
Vérifier les relations . Un objet Connexion
Si vous disposez de plusieurs objets de connexion modèles, ajoutez des options
ccis.dataconnection.dbcredentials supplémentaires. Par exemple :
ccis.dataconnection.dbcredentials2, ccis.dataconnection.dbcredentials3...
ccis.dataconnection.dbcredentialsn
Après avoir exécuté l'outil, les rapports Crystal récemment copiés dans les propres dossiers du client sont
mappés à leur propre connexion à la source de données.
Prêtez attention aux instantanés avant et après du CMS ci-dessous en supposant qu'un client nommé "ABC" est
créé et que le fichier de configuration client est configuré comme suit :
ccis.dataconnection.dbcredentials1=ZZZZZZZZZZ
Type d'objet
Avant
Dossiers et
rapports
Après
Public Folders
$TemplateToken$_folder
$TemplateToken
$_cr4ereport.rpt
Public Folders
$TemplateToken$_folder
$TemplateToken$_cr4ereport.rpt
ABC_folder
ABC_cr4ereport.rpt
$TemplateToken$_cr4ereport.rpt :
●
CUID=XXXXXXXXXX
●
Connexion=$TemplateToken
$_ODBCConnection
$TemplateToken$_cr4ereport.rpt :
●
CUID=XXXXXXXXXX
●
Connexion=$TemplateToken
$_ODBCConnection
ABC_cr4ereport.rpt :
88
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Type d'objet
Avant
Connexions
Après
●
CUID=AAAAAAAAAA
●
Connexion=ABC_ODBCConnection
Connections
$TemplateToken$_unshared
$TemplateToken
$_ODBCConnection
Connections
$TemplateToken$_unshared
$TemplateToken$_ODBCConnection
ABC_unshared
ABC_ODBCConnection
$TemplateToken$_ODBCConnection :
●
CUID=ZZZZZZZZZZ
●
type=CCIS.DataConnection
$TemplateToken$_ODBCConnection :
●
CUID=ZZZZZZZZZZ
●
type=CCIS.DataConnection
ABC_ODBCConnection:
●
CUID=CCCCCCCCCC
●
type=CCIS.DataConnection
Mappage des préfixes de tables
La base de données modèle peut utiliser des préfixes de tables différents de la base de données du nouveau client
vers laquelle vous redirigez les rapports. Dans ce cas, configurez les options suivantes :
●
crystalreport.ccis.dataconnection.templatedb<n>
CUID de l'objet de connexion modèle
●
crystalreport.ccis.dataconnection.templatetableprefixes<n>
Préfixes de table de la source de données modèle
●
crystalreport.ccis.dataconnection.tenanttableprefixes<n>
Préfixes de table de la source de données client de destination du mappage
Les préfixes sont séparés par des points-virgules et une liste doit se terminer par un point-virgule pour être en
mesure d'identifier les chaînes vides (""). Prenons l'exemple suivant :
crystalreport.ccis.dataconnection.templatedb1=ZZZZZZZZZZ
crystalreport.ccis.dataconnection.templatetableprefixes1=templateprefixa;templatepre
fixb;;
crystalreport.ccis.dataconnection.tenanttableprefixes1=;tenantprefixb;tenantprefixc;
Cela entraîne le mappage suivant :
Préfixe modèle
Mappe vers le préfixe client
templateprefixa
(chaîne vide)
templateprefixb
tenantprefixb
(chaîne vide)
tenantprefixc
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
89
Astuce
Pour trouver le nom d'un préfixe de table dans un rapport modèle, affichez les détails de l'objet de connexion
directe aux données à l'aide de l'outil de conception d'information SAP BusinessObjects.
Liens associés
Univers et connexions [page 90]
Dossiers [page 82]
5.3.9
Univers et connexions
L'outil de gestion de l'architecture mutualisée permet de gérer la façon dont les univers de votre client et les
informations de connexion sont traités par le système. Cette rubrique énumère les différents scénarios à
envisager dans cette version.
Remarque
Cette version prend uniquement en charge les univers classiques (fichiers .unv) ; elle ne prend pas en charge
les fichiers .unx.
Univers et connexions non partagés
Dans ce scénario, les rapports et analyses se connectent à différents univers (avec des objets de connexion sousjacents séparés). Cela permet d'automatiser la distribution de rapports modèle tout en isolant les données
accessibles pour chaque client. Pour fournir des objets de connexion et univers non partagés différents pour
chaque client :
1.
Créez une connexion dont le nom contient le jeton de modèle. Enregistrez-la dans un dossier de connexions
modèle dont le nom utilise la chaîne du jeton de modèle.
2.
Créez un univers dont le nom contient le jeton de modèle et qui utilise la connexion modèle à l'étape 1.
Enregistrez-le dans un dossier d'univers dont le nom utilise la chaîne du jeton de modèle.
3.
Créez et téléchargez un jeu de rapports ou d'analyses utilisant l'univers de l'étape 2 dans un dossier de
modèles de la plateforme de BI.
4.
Définissez les options suivantes dans le fichier de configuration client :
Option obligatoire
optionIncludeUniverses
Détails
Définissez-la sur true afin que les univers modèle
soient copiés sur chaque client.
optionIncludeConnections
Définissez-la sur true afin que les connexions modèles
soient copiées sur chaque client.
90
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Option obligatoire
Détails
templateUniverseFolder
Définissez le chemin du dossier contenant vos modèles
d'univers, par exemple, $TemplateToken
$_unshared.
Le chemin est relatif au dossier Universes racine.
templateConnectionFolder
Définissez le chemin du dossier contenant vos modèles
d'univers, par exemple, $TemplateToken
$_unshared.
Le chemin est relatif au dossier Connexions racine.
ccis.dataconnection.dbcredentials1
Définissez les informations DNS de l'objet connexion
modèle à répliquer pour chaque client, par exemple
<CUID>;<nom de la source de données>;<nom
de la base de données>;<nom
d'utilisateur>;<mot de passe>.
<CUID> est le CUID d'un objet de connexion modèle.
Spécifiez les informations de DSN (<nom de la
source de données>, <nom de la base de
données>) de la connexion au nouveau client à créer.
Si vous avez plusieurs objets connexion modèle,
ajoutez d'autres options
ccis.dataconnection.dbcredentials, comme
ccis.dataconnection.dbcredentials2,
ccis.dataconnection.dbcredentials3, ...
ccis.dataconnection.dbcredentialsn.
Remarque
Ces options s'ajoutent à toutes les autres options, telles que les modèles de dossiers, que vous devez
définir pour exécuter l'outil.
Après avoir exécuté l'outil, le nouveau client dispose de ses propres instances des rapports/analyses, univers et
objets de connexion. A titre d'illustration, prenons les captures d'écran avant/après suivantes du CMS, en
supposant que l'outil est exécuté à deux reprises pour créer des clients nommés "ABC" et "DEF". Dans cet
exemple, le CUID dans l'option ccis.dataconnection.dbcredentials1 est défini sur ZZZZZZZZZZ :
Type d'objet
Avant
Dossiers et
rapports
Public Folders
$TemplateToken$_unshared
$TemplateToken$_sales.wid
$TemplateToken$_sales.wid:
●
CUID=XXXXXXXXXX
Après
Public Folders
$TemplateToken$_unshared
$TemplateToken$_sales.wid
ABC_unshared
ABC_sales.wid
DEF_unshared
DEF_sales.wid
$TemplateToken$_sales.wid:
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
91
Type d'objet
Avant
Après
●
●
CUID=XXXXXXXXXX
●
Univers=$TemplateToken
$_ODBCUniverse.unv
Univers=$TemplateToken
$_ODBCUniverse.unv
ABC_sales.wid :
●
CUID=AAAAAAAAAA
●
Univers=ABC_ODBCUniverse.unv
DEF_sales.wid :
Univers
●
CUID=DDDDDDDDDD
●
Univers=DEF_ODBCUniverse.unv
Universes
$TemplateToken$_unshared
$TemplateToken
$_ODBCUniverse.unv
Universes
$TemplateToken$_unshared
$TemplateToken
$_ODBCUniverse.unv
ABC_unshared
ABC_ODBCUniverse.unv
DEF_unshared
DEF_ODBCUniverse.unv
$TemplateToken$_ODBCUniverse.unv :
●
CUID=YYYYYYYYYY
●
Connexion=$TemplateToken
$_ODBCConnection
$TemplateToken$_ODBCUniverse.unv :
●
CUID=YYYYYYYYYY
●
Connexion=$TemplateToken
$_ODBCConnection
ABC_ODBCUniverse.unv :
●
CUID=BBBBBBBBBB
●
Connexion=ABC_ODBCConnection
DEF_ODBCUniverse.unv :
Connexions
●
CUID=EEEEEEEEEE
●
Connexion=DEF_ODBCConnection
Connections
$TemplateToken$_unshared
$TemplateToken
$_ODBCConnection
Connections
$TemplateToken$_unshared
$TemplateToken$_ODBCConnection
ABC_unshared
ABC_ODBCConnection
DEF_unshared
DEF_ODBCConnection
$TemplateToken$_ODBCConnection :
●
CUID=ZZZZZZZZZZ
●
type=CCIS.DataConnection
$TemplateToken$_ODBCConnection :
●
CUID=ZZZZZZZZZZ
●
type=CCIS.DataConnection
ABC_ODBCConnection:
92
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
●
CUID=CCCCCCCCCC
●
type=CCIS.DataConnection
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Type d'objet
Avant
Après
DEF_ODBCConnection:
●
CUID=FFFFFFFFFF
●
type=CCIS.DataConnection
Univers et connexions partagés
Dans ce scénario, les rapports et analyses se connectent aux mêmes univers et objets de connexion. Pour
spécifier un environnement partagé :
1.
Créez une connexion (dont le nom ne peut pas contenir de jeton de modèle). Enregistrez-la dans un dossier
de connexion partagé avec tous les clients.
2.
Créez un univers utilisant la connexion modèle de l'étape 1 (dont le nom ne peut pas contenir de jeton de
modèle). Enregistrez-le dans un dossier d'univers partagé avec tous les clients.
3.
Créez et téléchargez un jeu de rapports ou d'analyses utilisant l'univers de l'étape 2 dans un dossier de
modèles de la plateforme de BI.
4.
Définissez les options suivantes dans le fichier de configuration client :
Option obligatoire
Détails
optionUseSharedUniverses
Définissez-la sur true.
optionUseSharedConnections
Définissez-la sur true.
sharedUniverseFolder
Définissez le chemin du dossier contenant votre
univers partagé, par exemple, SharedUniverses.
Le chemin est relatif au dossier Universes racine.
sharedConnectionFolder
Définissez le chemin du dossier contenant vos modèles
d'univers, par exemple, SharedConnections.
Le chemin est relatif au dossier Connexions racine.
Remarque
Ces options s'ajoutent à toutes les autres options, telles que les modèles de dossiers, que vous devez
définir pour exécuter l'outil.
Après avoir exécuté l'outil, le nouveau client dispose de ses propres instances des rapports/analyses utilisant un
univers et un objet de connexion communs. A titre d'illustration, prenons les captures d'écran avant/après
suivantes du CMS, en supposant que l'outil est exécuté à deux reprises pour créer des clients nommés "ABC" et
"DEF" :
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
93
Type d'objet
Avant
Dossiers et
rapports
Après
Public Folders
$TemplateToken$_unshared
$TemplateToken$_sales.wid
Public Folders
$TemplateToken$_unshared
$TemplateToken$_sales.wid
ABC_unshared
ABC_sales.wid
DEF_unshared
DEF_sales.wid
$TemplateToken$_sales.wid:
●
CUID=XXXXXXXXXX
●
Univers=SharedODBCUniverse.unv
$TemplateToken$_sales.wid:
●
CUID=XXXXXXXXXX
●
Univers=SharedODBCUniverse.unv
ABC_sales.wid :
●
CUID=AAAAAAAAAA
●
Univers=SharedODBCUniverse.unv
DEF_sales.wid :
Univers
●
CUID=DDDDDDDDDD
●
Univers=SharedODBCUniverse.unv
Universes
SharedUniverses
SharedODBCUniverse.unv
Universes
SharedUniverses
SharedODBCUniverse.unv
SharedODBCUniverse.unv :
SharedODBCUniverse.unv :
●
CUID=YYYYYYYYYY
●
CUID=YYYYYYYYYY
●
Connexion=SharedODBCConnection
●
Connexion=SharedODBCConnection
Connexions
Connections
SharedConnections
SharedODBCConnection
Connections
SharedConnections
SharedODBCConnection
SharedODBCConnection :
SharedODBCConnection :
●
CUID=ZZZZZZZZZZ
●
CUID=ZZZZZZZZZZ
●
type=CCIS.DataConnection
●
type=CCIS.DataConnection
Restriction d'accès aux données pour les univers partagés
Lors du partage d'univers entre des clients, vous pouvez limiter les données de l'univers que peut visualiser
chaque client. Cela est possible en accordant à certains groupes d'utilisateurs des droits sur les objets, lignes,
requêtes et autres aspects d'un univers. Pour ce faire, lors de la conception de l'univers, utilisez la boîte de
dialogue Gérer les restrictions d'accès de l'outil de conception d'univers SAP BusinessObjects. Lorsqu'un membre
de ce groupe d'utilisateurs accède à l'univers, la requête générée au moment de l'exécution renvoie uniquement
les données auxquelles le groupe d'utilisateurs a accès.
L'outil de gestion de l'architecture mutualisée aide à automatiser cette tâche. Au lieu de définir les restrictions
d'accès pour un groupe d'utilisateurs spécifique, définissez-les pour le groupe d'utilisateurs modèle (contenant la
94
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
chaîne du jeton de modèle). Assurez-vous que le nom des restrictions que vous créez contient également la
chaîne du jeton de modèle. Après avoir exécuté l'outil, la restriction d'accès sera remplacée par le véritable nom
de client, spécifié par l'option tenantName du fichier de configuration client.
Remarque
Vous devez vous assurer que le groupe d'utilisateurs est également un groupe modèle ($TemplateToken$, par
exemple) afin que des restrictions en conflit mutuel ne soient pas appliquées au même groupe d'utilisateurs
client. Vous ne pouvez pas appliquer plusieurs restrictions au même groupe d'utilisateurs. Pour en savoir plus
sur la manière de définir les restrictions d'accès dans les univers classiques (fichiers .unv), voir le Guide de
l'utilisateur de l'outil de conception d'univers.
5.4
Configuration du fichier de configuration client
La section suivante aborde les options que vous pouvez définir dans le fichier de configuration client
(tenant_template_def.properties).
Tableau 12: Options obligatoires de mise en service des clients
Option
Description
Obligatoire ?
tenantName
Nom du client à ajouter. Cette chaîne remplace toutes les occurrences de la
chaîne templateToken.
Oui
Par exemple, si tenantName=abc, templateToken=$TemplateToken$ et
que vous avez créé un groupe d'utilisateurs nommé "$TemplateToken
$_usergroup", l'outil créera alors un groupe d'utilisateurs nommé
"abc_usergroup".
templateToken
Oui
Chaîne utilisée pour identifier un objet modèle ou paramètre de client pour
qu'il soit répliqué par l'outil lors de la création d'un client. La chaîne
templateToken est remplacée par tenantName lors de l'exécution de l'outil.
Remarque
Choisissez une chaîne unique qui ne se trouve pas couramment dans les
noms d'objet existants au sein de votre installation de la plateforme de BI.
cms
Nom ou adresse IP et port du CMS (Central Management Server) auquel se
connecter. Si aucun port n'est spécifié, 6400 est utilisé par défaut.
Oui
auth
Type d'authentification à utiliser pour la connexion. Les valeurs possibles
sont secEnterprise, secLDAP, secWinAD et secSAPR3.
Oui
user
Nom d'utilisateur du compte utilisé pour se connecter au CMS et exécuter
l'outil.
Oui
pwd
Mot de passe de l'utilisateur.
Oui
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
95
Tableau 13: Options facultatives de mise en service des clients
Option
Description
Obligatoire ?
statusLog
Dossier où est créé le fichier journal. A des fins de dépannage, le fichier Non
journal contient une trace du programme et toutes les erreurs qui sont
survenues. Par exemple :
statusLog=”C:\TenantLogs\”
Le fichier journal est automatiquement nommé sur base de la valeur
tenantName ainsi que de la date et de l'horodatage pour l'exécution du
programme. Par exemple :
multitenancymanager<aaaa><mm><jj><heure>.csv
Si cette option n'est pas spécifiée, l'emplacement par défaut est :
●
Windows : <REPINSTALL>\SAP BusinessObjects
Enterprise XI 4.0\logging\
●
abortANDRollback
Unix : <REPINSTAL>/sap_bobj/logging/
Définissez sur true pour reprendre toutes les modifications si la
Non
validation d'un des nouveaux objets par le CMS échoue. Si cette option
n'est pas spécifiée, le paramètre par défaut est : true.
Remarque
Si la validation de certains objets par le CMS échoue et que
abortANDRollback=false, votre client n'est créé que
partiellement avec les objets dont la validation a réussi. Utilisez le
fichier journal pour dépanner et corriger les erreurs éventuelles,
puis exécutez à nouveau l'outil pour ce client.
optionImportSecMod Indique comment traiter l'importation des paramètres de sécurité
e
(droits) sur les objets créés à partir des objets modèle. Les valeurs
possibles sont :
●
Non
0 - (Mode Fusionner) : Fusionner les utilisateurs ou groupes
principaux et les droits du modèle avec l'objet client existant.
Préserve les droits initialement accordés à tout utilisateur ou
groupe principal sur l'objet client existant.
Remarque
En cas de conflit, le paramètre du modèle a la priorité lors de la
fusion. Par exemple, si le modèle accorde de manière spécifique
un droit à un utilisateur ou groupe principal tandis que le client
existant refuse de manière spécifique ce même droit, le droit est
accordé au nouveau client.
●
1 - (remplacement au niveau des utilisateurs ou groupes
principaux) : remplacer les droits des utilisateurs ou groupes
96
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Option
Description
Obligatoire ?
principaux par les droits du modèle. Ajoute les utilisateurs ou
groupes principaux et droits uniques à partir du modèle et
préserve les utilisateurs ou groupes principaux et droits uniques
de l'objet client.
●
2 - (remplacement au niveau des objets) : supprimer tous les
utilisateurs ou groupes principaux et droits existants sur l'objet
client existant et les remplace par les utilisateurs ou groupes
principaux et droits accordés sur l'objet modèle
Si cette option n'est pas spécifiée, le paramètre par défaut est :1.
Tableau 14: Options de modèle d'objet
Option
Description
Obligatoire ?
templateContentFol
der
Liste séparée par des points-virgules des chemins de dossier
définissant tous les dossiers de modèles de niveau supérieur au sein
du référentiel. Les dossiers de modèles contiennent la chaîne de jeton
de modèle dans leur nom.
Non
Remarque
Les dossiers de niveau supérieur utilisant le jeton de modèle et qui
ne sont pas spécifiés par templateContentFolder sont ignorés
par l'outil.
optionIncludeUnive
rses
Indique si le programme doit rechercher des univers utilisant la chaîne
de jeton de modèle et créer une version de client. Si cette option n'est
pas spécifiée, le paramètre par défaut est : true.
Non
optionIncludeConne
ctions
Indique si le programme doit rechercher des connexions d'univers
utilisant la chaîne de jeton de modèle et créer une version de client. Si
cette option n'est pas spécifiée, le paramètre par défaut est : true.
Non
optionIncludeCateg
ories
Indique si le programme doit rechercher des catégories de la
plateforme de BI utilisant la chaîne de jeton de modèle et créer une
version de client. Si cette option n'est pas spécifiée, le paramètre par
défaut est : true.
Non
optionIncludeProfi
les
Indique si le programme doit rechercher des profils de la plateforme
de BI utilisant la chaîne de jeton de modèle et créer une version de
client. Si cette option n'est pas spécifiée, le paramètre par défaut est :
true.
Non
optionIncludeEvent
s
Indique si le programme doit rechercher des dossiers d'événements
de la plateforme de BI utilisant la chaîne de jeton de modèle et créer
une version de client. Si cette option n'est pas spécifiée, le paramètre
par défaut est : true.
Non
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
97
Option
Description
Obligatoire ?
optionIncludeAcces
sLevels
Indique si le programme doit rechercher des niveaux d'accès (groupes
de droits) de la plateforme de BI utilisant la chaîne de jeton de modèle
et créer une version de client. Si cette option n'est pas spécifiée, le
paramètre par défaut est : true.
Non
optionUseSharedUni
verses
Indique si les rapports modèles et les analyses utilisent des univers
partagés. Utilisation conjointement avec sharedUniverseFolder. Si
Non
cette option n'est pas spécifiée, le paramètre par défaut est : true.
optionUseSharedCon
nections
Indique si les rapports modèle et les analyses utilisent des connexions
partagées. Utilisation conjointement avec
sharedConnectionFolder. Si cette option n'est pas spécifiée, le
Non
paramètre par défaut est : true.
templateUniverseFo
lder
Liste séparée par des points-virgules des chemins de dossier d'univers Non
définissant tous les dossiers d'univers modèles de niveau supérieur au
sein du référentiel. Les dossiers d'univers modèles contiennent la
chaîne de jeton de modèle dans leur nom.
templateConnection
Folder
Liste séparée par des points-virgules des chemins de dossier de
connexion définissant tous les dossiers d'univers modèles de niveau
supérieur au sein du référentiel. Les dossiers de connexions modèle
contiennent la chaîne de jeton de modèle dans leur nom.
Non
templateCategoryFo
lder
Liste séparée par des points-virgules des catégories de la plateforme
de BI. Les catégories de modèle contiennent la chaîne de jeton de
modèle dans leur nom.
Non
templateEventFolde
r
Liste séparée par des points-virgules des dossiers d'événements. Les
dossiers d'événements modèle contiennent la chaîne de jeton de
modèle dans leur nom.
Non
sharedUniverseFold
er
Liste séparée par des points-virgules des chemins de dossier d'univers Non
où se trouvent des univers partagés.
sharedConnectionFo
lder
Liste séparée par des points-virgules des chemins de dossier de
connexions où se trouvent des connexions partagées.
Non
Tableau 15: Options de source de données
Option
Description
Obligatoire ?
crystalreport.temp
latedb<n>
SAP Crystal Reports 2011 uniquement
Non
98
Informations de DSN du rapport modèle. La valeur a pour format
<serveur de base de données>;<nom de base de
données>;<type de source de données>;<couche
réseau>;<nom d'utilisateur>;<mot de passe>
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Option
Description
Obligatoire ?
Astuce
Pour trouver les valeurs correctes pour <serveur de base de
données>;<nom de base de données>, cliquez avec le bouton
droit de la souris sur le rapport dans la CMC et sélectionnez
Configuration de la base de données. Les champs Serveur et Base
de données peuvent être copiés dans le fichier de configuration
client.
Vous pouvez spécifier d'autres modèles et leurs nouveaux paramètres
de client en ajoutant les couplages d'options
crystalreport.templatedb<n> et
crystalreport.tenantdb<n> au fichier de configuration client, par
exemple, crystalreport.templatedb2 et
crystalreport.tenantdb2.
crystalreport.tena
ntdb<n>
Non
SAP Crystal Reports 2011 uniquement
Informations de DSN du nouveau client. La valeur a pour format
<serveur de base de données>;<nom de base de
données>;<type de source de données>;<couche
réseau>;<<nom d'utilisateur>;<mot de passe>.
Vous pouvez spécifier d'autres modèles et leurs nouveaux paramètres
de client en ajoutant les couplages d'options
crystalreport.templatedb<n> et
crystalreport.tenantdb<n> au fichier de configuration client, par
exemple, crystalreport.templatedb2 et
crystalreport.tenantdb2.
crystalreport.temp
latetableprefixes<
n>
Non
SAP Crystal Reports 2011 uniquement
Liste séparée par des points-virgules des préfixes de tables de la base
de données modèle. Mappe les préfixes répertoriés dans l'option
crystalreport.tenanttableprefixes<n>.
Vous pouvez spécifier d'autres modèles et leurs nouveaux paramètres
de client en ajoutant les couplages d'options
crystalreport.templatetableprefixes<n> et
crystalreport.tenanttableprefixes<n> au fichier de
configuration client, par exemple
crystalreport.templatetableprefixes2 et
crystalreport.tenanttableprefixes2.
crystalreport.tena
nttableprefixes<n>
Non
SAP Crystal Reports 2011 uniquement
Liste séparée par des points-virgules des préfixes de tables de la base
de données du client cible. Mappe les préfixes répertoriés dans l'option
crystalreport.templatetableprefixes<n>.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
99
Option
Description
Obligatoire ?
Vous pouvez spécifier d'autres modèles et leurs nouveaux paramètres
de client en ajoutant les couplages d'options
crystalreport.templatetableprefixes<n> et
crystalreport.tenanttableprefixes<n> au fichier de
configuration client, par exemple
crystalreport.templatetableprefixes2 et
crystalreport.tenanttableprefixes2.
crystalreport.ccis
.dataconnection.te
mplatedb<n>
SAP Crystal Reports pour Enterprise uniquement.
Non
Les informations DNS de l'objet connexion modèle à répliquer pour
chaque client, par exemple <CUID>;<nom de la source de
données>;<nom de la base de données>;<nom
d'utilisateur>;<mot de passe>. <CUID> est le CUID d'un objet
de connexion modèle.
Si vous avez plusieurs objets connexion modèle, ajoutez d'autres
options crystalreport.ccis.dataconnection.templatedb,
comme crystalreport.ccis.dataconnection.templatedb2,
crystalreport.ccis.dataconnection.templatedb3, ...
crystalreport.ccis.dataconnection.templatedb<n>.
crystalreport.ccis
.dataconnection.te
mplatetableprefixe
s<n>
SAP Crystal Reports pour Enterprise uniquement.
Non
Liste séparée par des points-virgules des préfixes de tables de la base
de données modèle. Mappe vers les préfixes répertoriés dans l'option
crystalreport.ccis.dataconnection.templatetableprefix
es<n>.
Vous pouvez spécifier d'autres modèles et leurs nouveaux paramètres
de client en ajoutant les couplages d'options
crystalreport.ccis.dataconnection.templatetableprefix
es<n> et
crystalreport.ccis.dataconnection.templatetableprefix
es<n> au fichier de configuration client, par exemple
crystalreport.ccis.dataconnection.templatetableprefix
es2 et
crystalreport.ccis.dataconnection.templatetableprefix
es2.
crystalreport.ccis
.dataconnection.te
nanttableprefixes<
n>
SAP Crystal Reports pour Enterprise uniquement.
Non
Liste séparée par des points-virgules des préfixes de tables de la base
de données du client cible. Mappe vers les préfixes répertoriés dans
l'option
crystalreport.ccis.dataconnection.tenanttableprefixes
<n>.
Vous pouvez spécifier d'autres modèles et leurs nouveaux paramètres
de client en ajoutant les couplages d'options
100
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Option
Description
Obligatoire ?
crystalreport.ccis.dataconnection.tenanttableprefixes
<n> et
crystalreport.ccis.dataconnection.tenanttableprefixes
<n> au fichier de configuration client, par exemple,
crystalreport.ccis.dataconnection.tenanttableprefixes
2 et
crystalreport.ccis.dataconnection.tenanttableprefixes
2.
ccis.dataconnectio
n.dbcrendentials<n
>
Les informations DNS de l'objet connexion modèle à répliquer pour
chaque client, par exemple <CUID>;<nom de la source de
données>;<nom de la base de données>;<nom
Non
d'utilisateur>;<mot de passe>. <CUID> est le CUID d'un objet
de connexion modèle. Spécifiez les informations de DSN (<nom de la
source de données>, <nom de la base de données>) de la
connexion au nouveau client à créer.
Dans le cas des connexions JDBC et OLEDB, les paramètres <nom de
source de données>;<nom de base de données> font
référence à ce qui suit :
●
JDBC Oracle : <nom de l'ordinateur>:<port>;<nom de
service TNS>
●
Toutes les autres sources JDBC : <nom de
l'ordinateur>:<port>;<nom de la base de données>
●
OLEDB : <nom de l'ordinateur>;<nom de la base de
données>
Si vous avez plusieurs objets connexion modèle, ajoutez d'autres
options ccis.dataconnection.dbcredentials, comme
ccis.dataconnection.dbcredentials2,
ccis.dataconnection.dbcredentials3, ...
ccis.dataconnection.dbcredentials<n>.
5.5 Exécution de l'outil de gestion de l'architecture
mutualisée
Pour exécuter l'outil, accédez au dossier où se trouve l'outil de gestion de l'architecture mutualisée, ouvrez une
invite de commande et exécutez multitenancymanager.jar avec votre fichier de définition des clients
transmis dans l'option -configFile :
java -jar multitenancymanager.jar -configFile tenant_template_def.properties
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
101
Remarque
L'outil de gestion de l'architecture mutualisée est installé par défaut avec la plateforme de BI et se trouve dans
le dossier \java\apps\ :
●
Windows : <REPINSTAL>\SAP BusinessObjects Enterprise XI 4.0\java\apps
\multitenancyManager\jars\
●
Unix : <REPINSTALL>/sap_bobj/enterprise_xi40/java/apps/multitenancyManager/jars/
Attention
L'outil de gestion de l'architecture mutualisée crée et valide des objets tels que des groupes d'utilisateurs, des
dossiers, des documents et des univers sur votre référentiel du CMS. Il est recommandé de garder l'option
abortANDRollback définie sur true (il s'agit de la valeur par défaut). L'outil reprend alors toutes les
modifications si la validation d'un des nouveaux objets par le CMS échoue.
Spécification d'options par ligne de commande
Vous pouvez spécifier des options directement dans la ligne de commande. Toute option définie dans la ligne de
commande remplacera le paramètre spécifié dans le fichier de configuration client. Par exemple, vous pouvez
remplacer le nom du client grâce à l'option tenantName comme suit :
java -jar multitenancymanager.jar -configFile tenant_template_def.properties tenantName=xyz_customer
Cela permet d'utiliser un seul fichier de configuration pour traiter un lot de travaux de plusieurs clients ne différant
les uns des autres que par le nom spécifié dans l'option tenantName. Toutes les options du fichier de
configuration peuvent être écrasées par la ligne de commande.
5.6
Dépannage
Prenez en compte les meilleures pratiques suivantes lors du dépannage d'erreurs.
Consulter le fichier journal de l'outil (.csv)
Les messages du programme affichés sur la ligne de commande lors de l'exécution de l'outil de gestion de
l'architecture mutualisée sont enregistrés dans un fichier journal que vous pouvez consulter une fois que le
programme a terminé, avec des détails supplémentaires. Par défaut, un fichier journal nommé
multitenancymanager<yyyy><mm><dd><time>.csv est créé dans le dossier suivant :
●
Windows : <REPINSTALL>\SAP BusinessObjects Enterprise XI 4.0\logging\
●
Unix : <REPINSTAL>/sap_bobj/logging/
102
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Vous pouvez modifier l'emplacement de ce fichier journal à l'aide de l'option statusLog du fichier de
configuration client.
Activer et consulter le fichier du journal des événements (.glf)
Pour faciliter le diagnostic des problèmes, il est recommandé d'activer le suivi. Les messages de niveau système
générés par les serveurs et les applications de la plateforme de BI peuvent être suivis et écrits dans des fichiers
journaux. Ces fichiers journaux contiennent des informations plus détaillées pour le diagnostic des problèmes que
le résultat de ligne de commande ou le fichier journal .csv. Vous pouvez configurer le suivi de l'outil de gestion de
l'architecture mutualisée à l'aide du fichier de configuration BO_trace.ini et déterminer le type et les
commentaires des informations suivies et envoyées au fichier journal. Voir aussi “Pour configurer le suivi pour
l'outil de gestion de l'architecture mutualisée”.
Les messages de suivi sont recueillis dans les fichiers journaux enregistrés sous l'extension générique de fichiers
journaux (.glf). Le nom du fichier .glf est formé par une combinaison abrégée de l'identifiant et du numéro de
référence, par exemple, multitenancymanager_trace.000001.glf. Un nouveau fichier journal de suivi est
créé lorsque le fichier journal approche une taille préconfigurée. Le suivi de l'outil de gestion de l'architecture
mutualisée est créé dans le dossier suivant :
●
Windows : <REPINSTALL>\SAP BusinessObjects Enterprise XI 4.0\logging\
●
Unix : <REPINSTALL>/sap_bobj/enterprise_xi40/logging/
Déterminer l'origine de l'erreur
Les erreurs produites spécifiquement par l'outil de gestion de l'architecture mutualisée sont souvent causées par
des paramètres incorrects dans le fichier de configuration client (tenant_template_def.properties) ou par
des problèmes locaux relatifs à l'ordinateur sur lequel il est exécuté (multitenancymanager.jar). Pour les
erreurs courantes et les éventuelles actions à entreprendre, voir aussi “Erreurs relatives à l'outil de gestion de
l'architecture mutualisée”.
Les erreurs peuvent également émaner des serveurs ou de la structure de sécurité de la plateforme de BI et sont
accompagnées d'un code d'erreur (une chaîne de trois lettres suivie d'un nombre à cinq chiffres). FWB et FWM sont
des codes d'erreur courants. Par exemple :
Enterprise authentication could not log you on. Please make sure your logon
information is correct. (FWB 00008)
Pour obtenir une liste des codes d'erreur possibles et de leurs solutions, voir le guide SAP BusinessObjects
Business Intelligence Suite Error Message Guide.
Liens associés
To configure tracing for the multitenancy management tool [page 109]
Multitenancy management tool errors [page 104]
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
103
5.6.1 Erreurs relatives à l'outil de gestion de l'architecture
mutualisée
Le tableau suivant fournit une liste des erreurs courantes affichées par l'outil de gestion de l'architecture
mutualisée et enregistrées dans le fichier journal .csv.
Erreur
Cause
Action
Fichier de
configuration de
l'application non
valide, erreur lors
de l'analyse de
<<option_de_config>>.
La valeur fournie pour
<<option_de_config>> ne peut
Ouvrez le fichier de configuration
(tenant_template_def.properties) et
pas être traitée par l'outil de
gestion de l'architecture
mutualisée. Cela résulte souvent
d'options obligatoires laissées
vides.
assurez-vous que la valeur de
<<option_de_config>> est correctement
définie. Reportez-vous à la documentation et
aux commentaires du fichier de configuration
pour des exemples.
<<option_de_config>> est le nom de
l'option, tel que templateContentFolder.
Remarque
Aucun fichier journal .csv n'est créé si
cette erreur se produit.
Une erreur inattendue Une exception non spécifiée est
s'est produite.
survenue lors de l'exécution de
l'outil de gestion de l'architecture
mutualisée.
Objets correspondants Aucun objet modèle ne peut être
introuvables à l'aide retrouvé sur base des chemins de
de la requête
modèle spécifiés.
<<requête>>.
Vérifiez le fichier du journal des événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Ouvrez le fichier de configuration
(tenant_template_def.properties) et
assurez-vous que les chemins de modèle
spécifiés sont corrects. Vérifiez les options
suivantes :
●
templateContentFolder
●
templateUniverseFolder
●
templateConnectionFolder
●
templateCategoryFolder
●
templateEventFolder
●
sharedUniverseFolder
●
sharedConnectionFolder
Remarque
Il se peut que vous n'ayez pas de modèle
pour certains types d'objet. Il est
recommandé d'attribuer à l'option
optionInclude concernée la valeur
104
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Erreur
Cause
Action
false dans ce cas. Par exemple,
optionIncludeCategories=false.
Echec de l'extraction Une erreur s'est produite lors de
du/des objet(s).
l'extraction d'objets depuis le CMS
(Central Management Server).
Vérifiez si vous pouvez vous connecter au
CMS. Si le CMS ne peut pas être connecté,
vérifiez les CUID d'objet dans le fichier
journal .csv et assurez-vous qu'ils se
trouvent dans le CMS.
Si le CMS peut être connecté et que les objets
existent, vérifiez le fichier du journal des
événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Echec du mappage
du/des objet(s) du
modèle sur l'/les
objet(s) de la base
de données.
Une erreur s'est produite durant le
mappage d'un objet modèle à un
objet client ou lors de la
récupération de l'objet
d'application du CMS de l'outil de
gestion de l'architecture
mutualisée.
Veillez à disposer d'un espace disque
suffisant dans le répertoire d'accueil de
l'utilisateur du système d'exploitation
exécutant multitenancymanager.jar.
Assurez-vous que le répertoire d'accueil est
accessible en écriture.
Si l'espace disque est suffisant, vérifiez le
fichier du journal des événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Echec de la
sauvegarde.
Une erreur s'est produite lors de la
création d'une sauvegarde des
objets client existants.
Cette erreur peut se produire
lorsque
multitenancymanager.jar est
Echec de la
restauration de la
sauvegarde.
Veillez à disposer d'un espace disque
suffisant dans le répertoire d'accueil de
l'utilisateur du système d'exploitation
exécutant multitenancymanager.jar.
Assurez-vous que le répertoire d'accueil est
accessible en écriture.
exécuté une seconde fois (ou plus)
sur le même client. Le client
existant déjà, les objets client
existants sont sauvegardés
localement par l'outil dans un
fichier BIAR et cette erreur peut
apparaître au cours du processus.
Si l'espace disque est suffisant, vérifiez le
fichier du journal des événements
(multitenancymanager_trace.
Une erreur s'est produite lors de la
restauration de la sauvegarde des
objets client à leur état d'origine.
Veillez à disposer d'un espace disque
suffisant dans le répertoire d'accueil de
l'utilisateur du système d'exploitation
exécutant multitenancymanager.jar.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
00000<n>.glf) pour effectuer une analyse
plus approfondie.
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
105
Erreur
Cause
Action
Cette erreur peut se produire
lorsque
multitenancymanager.jar est
Assurez-vous que le répertoire d'accueil est
accessible en écriture.
Une erreur s'est produite lors de la
tentative de mise à jour de
documents client avec des sources
de données spécifiques au client.
Vérifiez si une erreur plus spécifique est
apparue plus tôt dans le fichier journal .csv.
Si l'espace disque est suffisant, vérifiez le
exécuté une seconde fois (ou plus)
fichier du journal des événements
sur le même client et si une autre
(multitenancymanager_trace.
erreur déclenche une reprise
00000<n>.glf) pour effectuer une analyse
(abortANDRollback=true). Lors
plus approfondie.
de la reprise des modifications,
l'outil tente de restaurer les objets
et paramètres d'origine d'un client
à partir de la sauvegarde locale et
cette erreur peut apparaître au
cours de ce processus.
Echec lors de
l'actualisation
du/des objet(s) de la
base de données ou de
la mise à jour du/des
objet(s) partagé(s).
Cela résulte souvent d'options du fichier de
configuration incorrectes ou incompatibles
telles que :
●
crystalreport.templatedb<n>
●
crystalreport.tenantdb<n>
●
crystalreport.templatetablepref
ixes<n>
●
crystalreport.tenanttableprefix
es<n>
●
crystalreport.ccis.dataconnecti
on.templatedb<n>
●
crystalreport.ccis.dataconnecti
on.templatetableprefixes<n>
●
crystalreport.ccis.dataconnecti
on.tenanttableprefixes<n>
●
ccis.dataconnection.dbcrendenti
als<n>
Le CUID et le nom du rapport ou du document
sont enregistrés.
Si les paramètres de votre fichier de
configuration sont corrects, vérifiez le fichier
du journal des événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Echec du chargement
du plug-in
d'actualisation du
106
Une erreur est survenue lors du
chargement d'un fichier JAR
depuis le dossier
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Par défaut, le dossier docRefreshPlugins
se trouve sous :
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Erreur
Cause
Action
document pour le
type< <TYPE_SI>>.
docRefreshPlugins.
●
<REPINSTALL>\SAP
BusinessObjects
Enterprise XI 4.0\java\apps
\multitenancyManager\jars
\docRefreshPlugins\
●
<REPINSTALL>/sap_bobj/
enterprise_xi40/java/apps/
multitenancyManager/jars/
docRefreshPlugins /
<<TYPE_SI>> fait référence au
type d'objet, par exemple : Webi
(documents Web Intelligence).
Assurez-vous que ce dossier et tous les
fichiers JAR requis sont présents pour les
types d'objet que vous importez ou mettez à
jour, tels que
ccisdataconnectionRefresh.jar,
CrystalReportRefresh.jar,
UniverseRefresh.jar et
WebiRefresh.jar.
Echec de
l'actualisation du
document pour
<<détails du
document>>.
Une erreur s'est produite lors de la
tentative de mise à jour d'un
document client avec une source
de données spécifique au client.
Echec de la
préparation de la
base de données pour
l'importation.
Une erreur s'est produite lors de la
récupération d'objets d'un client à
importer sur le CMS.
Configuration de la
base de données de
modèles
crystalreport.templat
edb<n> ou
configuration de la
base de données
crystalreport.tenantd
b<n> manquante.
Un modèle de mappage client pour
des connexions directes aux
données de SAP Crystal
Reports 2011 est manquant ou n'a
pas été configuré correctement.
Vérifiez le fichier du journal des événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Vérifiez le fichier du journal des événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Ouvrez votre fichier de configuration
(tenant_template_def.properties) et
assurez-vous qu'à chaque option
crystalreport.templatedb<n>
correspond une option
crystalreport.tenantdb<n>.
Vérifiez le fichier du journal des événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Configuration de la
base de données de
modèles non valide,
erreur lors de
l'analyse de
<<option_de_config>>.
La configuration de la base de
données modèle d'un rapport SAP
Crystal Reports 2011 n'a pas le bon
format.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Ouvrez votre fichier de configuration
(tenant_template_def.properties) et
assurez-vous que toutes les options
crystalreport.templatedb<n> sont
définies sur des valeurs valides.
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
107
Erreur
Cause
Action
Pour en savoir plus sur la définition des
options de client pour les connexions directes
SAP Crystal Reports 2011, voir “SAP Crystal
Reports 2011”.
Configuration de la
base de données non
valide, erreur lors
de l'analyse de
crystalreport.tenantd
b<n>.
La configuration de la base de
données client d'un rapport SAP
Crystal Reports 2011 n'a pas le bon
format.
Ouvrez votre fichier de configuration
(tenant_template_def.properties) et
assurez-vous que toutes les options
crystalreport.tenantdb<n> sont
définies sur des valeurs valides.
Pour en savoir plus sur la définition des
options de client pour les connexions directes
SAP Crystal Reports 2011, voir “SAP Crystal
Reports 2011”.
Type de serveur de
Le type de source de données
base de données
spécifié
<<type_de_serveurbd>> (<<type_de_serveurbd>>) pour
.
une connexion directe aux données
de SAP Crystal Reports 2011 n'est
pas pris en charge.
Ouvrez votre fichier de configuration
(tenant_template_def.properties) et
assurez-vous que vous utilisez des types de
source de données pris en charge pour les
rapports modèle et client. Vérifiez les options
suivantes :
●
crystalreport.templatedb<n>
●
crystalreport.tenantdb<n>
Pour obtenir la liste des types de sources de
données prises en charge, voir “SAP Crystal
Reports 2011”.
Incompatibilité de
Le nombre de préfixes de table
préfixes de tables
modèle n'est pas égal à celui de
pour
préfixes de table client.
<<préfixe_modèle>> et
<<préfixe_client>>.
L'un des deux
n'existe pas, ou le
nombre de préfixes ne
correspond pas.
108
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Ouvrez votre fichier de configuration
(tenant_template_def.properties) et
assurez-vous que chaque option de préfixe de
table modèle a un mappage correspondant
vers une option de préfixe de table client avec
un nombre de préfixe égal. Vérifiez les
options Crystal Reports suivantes :
●
crystalreport.templatetablepref
ixes<n>
●
crystalreport.tenanttableprefix
es<n>
●
crystalreport.ccis.dataconnecti
on.templatetableprefixes
●
crystalreport.ccis.dataconnecti
on.tenanttableprefixes
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Erreur
Cause
Action
Astuce
N'oubliez pas de terminer les listes de
préfixes par un point-virgule. Les préfixes
sont séparés par des points-virgules et une
liste doit se terminer par un point-virgule
pour être en mesure d'identifier les chaînes
vides ("").
La configuration de
la base de données
n'est pas valide.
Pour en savoir plus,
voir les éléments
précédents.
La configuration de base de
données d'un rapport Crystal de
client n'est pas valide. L'erreur
peut se produire sur SAP Crystal
Reports 2011 et sur SAP Crystal
Reports pour Enterprise.
Vérifiez si une erreur de mise à jour de la
source de données est apparue plus tôt dans
le fichier journal .csv.
Vérifiez le fichier du journal des événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Une erreur interne
inattendue s'est
produite lors de
l'ouverture d'un
document Crystal
Reports.
Une erreur inattendue s'est
produite lors de la mise à jour d'un
rapport SAP Crystal Reports pour
Enterprise avec une source de
données spécifique au client.
Assurez-vous que le serveur de traitement
Crystal Reports est activé et en cours de
fonctionnement.
Si le serveur fonctionne, vérifiez le fichier du
journal des événements
(multitenancymanager_trace.
00000<n>.glf) pour effectuer une analyse
plus approfondie.
Liens associés
SAP Crystal Reports 2011 [page 85]
5.6.2 Pour configurer le suivi pour l'outil de gestion de
l'architecture mutualisée
1.
Ouvrez le fichier BO_trace.ini.
○
Sous Windows, l'emplacement par défaut est le suivant : <REPINSTALL>\SAP BusinessObjects
Enterprise XI 4.0\conf\.
○
Sous UNIX, l'emplacement par défaut est le suivant : <REPINSTALL>/sap_bobj/enterprise_xi40/
conf/.
2.
Retirez les commentaires des lignes requises sous la section Trace Syntax and Setting.
3.
Ajoutez une instruction IF pour spécifier les paramètres de suivi pour l'outil de gestion de l'architecture
mutualisée.
Par exemple :
if (process == "multitenancymanager")
{
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
109
}
active = true;
importance = xs;
alert = true;
severity = 'S';
keep = false;
size = 100 * 1000;
Astuce
Le processus doit être spécifié comme multitenancymanager pour le paramètre de suivi à appliquer à
l'outil de gestion de l'architecture mutualisée.
Le tableau ci-après répertorie tous les paramètres disponibles pour la configuration du suivi.
Nom du paramètre
Valeurs possibles
Description
active
false, true
Active le suivi pour le processus ou le
serveur en cours si la valeur attribuée
est true. La valeur par défaut est
false.
importance
'<<', '<=', '==', '>=', '>>', xs,
s, m, l, xl
Remarque
Indique le seuil de suivi des messages.
Tous les messages au-delà de ce seuil
font l'objet d'un suivi. La valeur par
défaut est m (medium).
importance = xs est l'option la
plus détaillée et importance =
xl, l'option la moins détaillée.
alert
false, true
Active automatiquement le suivi pour
les événements de serveur graves. La
valeur par défaut est true.
severity
'S', 'W', 'E', 'A', 'F',
success, warning, error,
assert, fatal
Indique le seuil de gravité à partir
duquel les messages font l'objet d'un
suivi. 'S' occupe le plus d'espace
disque. La valeur par défaut est 'E'.
size
Les valeurs possibles sont les entiers
>= 1 000
Indique le nombre maximal de
messages figurant dans le fichier
journal de suivi avant qu'un nouveau
fichier ne soit créé. La valeur par
défaut est 100 000.
keep
false, true
Indique si l'ancien fichier journal doit
être conservé une fois le nouveau
fichier créé. La valeur par défaut est
false.
administrator
Chaînes de caractères ou entiers
Indique l'annotation à utiliser dans le
fichier journal de sortie. Par exemple,
si
administrator = "hello"
110
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
Nom du paramètre
Valeurs possibles
Description
cette chaîne est insérée dans le fichier
journal.
Indique le répertoire du fichier journal
de sortie. Par défaut, les fichiers
journaux sont stockés dans le dossier
Logging.
log_dir
always_close
4.
on, off
Indique si le fichier journal doit être
fermé lorsqu'un message de suivi y a
été consigné. La valeur par défaut est
off.
Enregistrez, puis fermez le fichier BO_trace.ini.
La prochaine fois que vous exécuterez l'outil de gestion de l'architecture mutualisée, un fichier du journal des
événements (multitenancymanager_trace.00000<n>.glf) sera créé.
Au lieu de modifier le fichier par défaut BO_trace.ini, vous pouvez créer une copie de ce fichier spécifiquement
pour l'outil de gestion de l'architecture mutualisée et exporter le fichier du journal des événements vers un
emplacement différent. Par exemple, pour utiliser C:\my_BO_trace.ini pour les paramètres du journal des
événements et exporter le fichier du journal des événements vers C:\myLogging, modifiez l'option suivante du
fichier multitenancymanagerSystem.properties :
<!-- logging -->
<entry key="mtm.systemVar.trace.logDir">C:\myLogging\</entry>
<entry key="mtm.systemVar.trace.iniDir">C:\</entry>
<entry key="mtm.systemVar.trace.iniFile">my_BO_trace.ini</entry>
Remarque
Cela modifiera également l'emplacement d'exportation par défaut du fichier journal .csv
(multitenancymanager<aaaa><mm><jj><heure>.csv).
Pour en savoir plus sur la configuration d'un suivi supplémentaire pour les serveurs de la plateforme de BI et
d'autres applications, voir “Gestion et configuration des journaux” dans le Guide d'administration de la plateforme
SAP BusinessObjects Business Intelligence.
Guide de personnalisation de SAP BusinessObjects OEM
Outil de gestion de l'architecture mutualisée de la plateforme de Business Intelligence
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
111
6 Personnalisation de SAP Crystal
Reports 2011
6.1
Introduction
SAP Crystal Reports 2011 peut être réassemblé et vendu par les partenaires. Vous pouvez personnaliser le
produit installé et le programme d'installation afin de créer une expérience intégrée pour les clients. L'outil de
personnalisation SAP BusinessObjects permet de personnaliser le programme d'installation et le produit installé
par le biais de modifications telles que :
●
Réduction de la taille du produit
●
Renommage du produit
●
Modification des propriétés par défaut du programme d'installation
●
Masquage d'écrans du programme d'installation
Pour réaliser des personnalisations, écrivez un fichier de configuration pour spécifier les personnalisations, puis
exécutez l'outil de personnalisation SAP BusinessObjects pour créer un programme d'installation personnalisé.
Les clients peuvent alors utiliser ce programme d'installation pour installer une version personnalisée du produit.
L'outil de personnalisation peut servir à personnaliser un programme d'installation complète, un programme
d'installation de Support Package et un programme d'installation de correctif.
6.2
Démarrage rapide pour Crystal Reports
Cette section explique comment exécuter l'outil de personnalisation pour créer un programme d'installation pour
SAP Crystal Reports. Elle utilise l'exemple de fichier de configuration fourni avec cet outil. A l'issue de ce
didacticiel, vous pouvez exécuter votre package d'installation personnalisé et installer une version personnalisée
de Crystal Reports.
Les personnalisations comprennent le changement de type d'installation par défaut, la suppression de
fonctionnalités, le codage en dur du code clé du produit, le changement de dossier d'installation par défaut, le
renommage du produit et le changement du raccourci du menu Démarrer de Windows. Ces personnalisations
sont décrites de façon plus détaillée dans le fichier de configuration.
1.
Configurez l'outil de personnalisation SAP BusinessObjects
a) Créez un dossier de travail sur votre ordinateur de développement, par exemple : C:\SAPCustomTool
\packages.
b) Copiez le contenu du package d'installation de Crystal Reports sous C:\SAPCustomTool\packages.
Le package d'installation contient les dossiers Collaterals, dunit, langs et setup.engine ainsi que
d'autres fichiers binaires. Pour en savoir plus, voir Pour télécharger le programme d'installation [page
113].
c) (Facultatif) Ajoutez votre code clé à l'exemple de fichier de configuration.
Dans un éditeur XML, ouvrez le fichier C:\SAPCustomTool\packages\Collaterals\Tools
\CustomizationTool\example_customization_win_cr.xml et remplacez l'expression PLEASE
112
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
SET de <replaceProperty id="ProductKey" defaultValue="PLEASE SET" /> par votre code
clé Crystal Reports.
d) Créez le dossier C:\SAPCustomTool\output.
Remarque
Ce dossier doit être vide.
e) Exécutez la commande suivante à partir de l'invite de commande :cd C:\SAPCustomTool\packages
\Collaterals\Tools\CustomizationTool
Le dossier CustomizationTool contient le fichier exécutable customizationtool.exe et l'exemple
de fichier de configuration example_customization_win_cr.xml.
2.
Exécutez la commande suivante à partir de l'invite de commande :
customizationtool.exe xml=example_customization_win_cr.xml packageDir=C:
\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDetail=error > C:
\oemlog.log
Assurez-vous que le package d'installation personnalisé a été créé sous C:\SAPCustomTool\output. Veillez
à ce qu'aucune erreur n'ait été consignée dans le fichier journal C:\oemlog.log.
Remarque
L'outil de personnalisation peut prendre plusieurs minutes pour réaliser l'opération. Vous pouvez vérifier sa
progression en visualisant le fichier journal.
3.
Utilisez C:\SAPCustomTool\output\setup.exe pour exécuter le programme d'installation personnalisé
de Crystal Reports.
Crystal Reports est installé avec les personnalisations décrites dans le fichier de configuration C:
\SAPCustomTool\packages\Collaterals\Tools\CustomizationTool
\example_customization_win_cr.xml.
6.3
Pour télécharger le programme d'installation
1.
Accédez à https://service.sap.com/bosap-support > Software Downloads (Téléchargements de logiciels)
2.
Dans l'onglet Find your software (Trouver votre logiciel), A-Z Index (Index de A à Z), sélectionnez Installations
and Upgrades (Installations et mises à niveau).
3.
Sélectionnez C > CRYSTAL REPORTS > CRYSTAL REPORTS 2011.
4.
Sélectionnez Installation and Upgrade (Installation et mise à niveau) > WINDOWS
5.
Sélectionnez l'objet intitulé SAP Crystal Reports 2011 <version> Windows (32B), puis suivez les instructions
du site Web pour télécharger et extraire les objets.
Le téléchargement du logiciel peut prendre un certain temps et il se peut que vous deviez contacter
l'administrateur système pour vous assurer que le pare-feu de votre entreprise n'interrompra pas le processus de
téléchargement.
Les Support Packages et correctifs sont des programmes d'installation contenant des mises à jour pour SAP
Crystal Reports. Vous pouvez les télécharger depuis https://service.sap.com/bosap-support. Dans l'onglet Find
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
113
your software (Trouver votre logiciel), A-Z Index (Index de A à Z), cliquez sur Support Packages and Patches
(Support Packages et correctifs). Pour en savoir plus sur l'installation des Support Packages et correctifs, voir
Personnalisation des programmes d'installation de mise à jour [page 138].
6.4
Planification du processus de personnalisation
Pour utiliser l'outil de personnalisation SAP BusinessObjects :
1.
Téléchargez le programme d'installation. Voir Pour télécharger le programme d'installation [page 113].
2.
Décidez quelles personnalisations sont nécessaires. Voir Création du fichier de configuration [page 115].
3.
Ecrivez le fichier de configuration pour spécifier les personnalisations.
4.
Exécutez l'outil de personnalisation pour créer un programme d'installation personnalisé.
5.
Exécutez le programme d'installation personnalisé pour installer une version personnalisée de SAP Crystal
Reports.
6.4.1
Meilleures pratiques
Cette section fournit des recommandations relatives à la création d'un programme d'installation personnalisé.
Validez le fichier de configuration
Vous pouvez valider le fichier de configuration avant d'exécuter l'outil. Utilisez le paramètre de ligne de
commande validate.
Réduisez la taille du produit
Les clients préfèrent un programme d'installation et un programme installé plus petits. Pour garder le produit
aussi petit que possible :
●
Supprimez tous les packs linguistiques non nécessaires.
●
Supprimez toutes les fonctionnalités non nécessaires.
●
Supprimez tous les éléments du dossier Collaterals non nécessaires.
Attribuez des noms personnalisés de façon cohérente
Le nom du produit et le numéro de version apparaissent à plusieurs endroits du programme d'installation et du
programme installé. Veillez à vérifier les personnalisations aux emplacements suivants :
114
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
●
Nom du produit, version du produit et version principale du produit
●
Entré du menu Démarrer de Windows et tous les raccourcis
●
Utilitaire Ajout/Suppression de programmes de Windows
●
Dossier d'installation par défaut
Prenez en compte les changements de nom dans toutes les langues
Il est préférable d'envisager la façon dont apparaît le nom personnalisé dans toutes les langues prises en charge.
Modifiez les programmes d'installation de correctifs pour qu'ils soient
cohérents avec le programme d'installation principale
Vous devez appliquer la même personnalisation aux Support Packages et correctifs qu'à la version principale. Si
vous vendez un programme d'installation principale personnalisé puis essayez de vendre un programme
d'installation de Support Package ou de correctif avec une personnalisation différente, cela peut entraîner des
résultats inattendus qui pourraient ne pas être réparables par les procédures de restauration standard.
Testez la restauration, la modification et la réparation des installations de
Support Packages et de correctifs
La restauration, la modification et la réparation d'installations sont prises en charge par les Support Packages et
correctifs personnalisés, à condition qu'ils aient été personnalisés de manière cohérente avec le package
d'installation principale. Il est recommandé de tester ces scénarios.
Liens associés
Paramètres de ligne de commande [page 136]
6.5
Création du fichier de configuration
La section suivante décrit les personnalisations que vous pouvez réaliser sur le programme d'installation en
modifiant le fichier de configuration :
●
●
Renommage du produit
○
Personnalisation du nom du produit et du numéro de version
○
Personnalisation des raccourcis du menu Démarrer de Windows
○
Personnalisation de l'utilitaire Ajout/Suppression de programmes de Windows
○
Personnalisation du dossier d'installation
Personnalisation de la saisie utilisateur par défaut
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
115
●
Suppression d'écrans d'installation
●
Incorporation d'un code clé
●
Suppression de fonctionnalités
●
Empêchement des vérifications des prérequis
●
Suppression de packs linguistiques
●
Modification des ressources
●
○
Personnalisation des images dans le programme d'installation
○
Personnalisation du contrat de licence
Suppression d'éléments du dossier Collaterals
6.5.1
Présentation du fichier de configuration
L'outil de personnalisation SAP BusinessObjects utilise les informations contenues dans le fichier de configuration
pour réaliser les personnalisations. Le fichier de configuration est un document XML. Vous utilisez les éléments
XML pour décrire vos personnalisations. L'exemple de fichier de configuration est contenu dans ce dossier du
programme d'installation :
Collaterals\Tools\CustomizationTool\example_customization_win_cr.xml
Le fichier doit avoir ce format :
<oem name="<Any name>">
<cloneProduct sourceId="product.crystalreports-4.0-core-32">
...
...
</cloneProduct>
</oem>
Le fichier de configuration pour le programme d'installation complète peut avoir n'importe quel nom, oem.xml,
par exemple.
Le fichier de configuration du programme d'installation de Support Package est décrit dans la section
Personnalisation de programmes d'installation de mise à jour [page 140].
Remarque
Le fichier de configuration doit être écrit dans une syntaxe XML correcte. Utilisez un éditeur XML pour créer et
modifier le fichier, et assurez-vous que le format est correct avant d'exécuter l'outil.
Exemple
Dans cet exemple, on spécifie les personnalisations suivantes :
●
Changer le nom long du produit pour “Custom Company Crystal Reports” pour toutes les langues.
●
Changer le nom court du produit pour “Custom CR” pour toutes les langues.
●
Changer l'éditeur et le nom du produit pour l'entrée de l'utilitaire Ajout/Suppression de programmes de
Windows.
●
Supprimer l'écran d'installation intitulé Choose Installation Type et définir le type d'installation sur Custom.
116
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
●
Spécifier que les seuls packs linguistiques inclus dans le package d'installation sont l'anglais, le français,
l'allemand, l'italien et le chinois.
<oem name="CustomCompanyCrystalReports">
<cloneProduct sourceId="product.crystalreports-4.0-core-32">
<replaceString id="product.cr_name" value="Custom Company Crystal
Reports" lang="all"/>
<replaceString id="product.cr_shortname" value="Custom CR" lang="all"/>
<arp duSourceId="product.crystalreports.arp-4.0-core">
<arg id="publisher" value="Custom Company"/>
<arg id="display_name" value="Custom Company Crystal Reports"/>
</arp>
<replaceProperty id="InstallType" defaultValue="custom"/>
<removeDialog id="ChooseInstallType2.dialog"/>
<languageIncludeList value="en;fr;de;it;zh_CN"/>
</cloneProduct>
</oem>
6.5.2
Renommage du produit
Vous pouvez renommer le produit en personnalisant les éléments suivants :
●
Le nom de produit et le numéro de version
●
L'entrée de Ajout/Suppression des programmes de Windows
●
L'entrée du menu Démarrer pour les raccourcis de fonctionnalités
●
Le dossier d'installation par défaut
Les sections qui suivent expliquent ces personnalisations.
6.5.2.1
version
Personnalisation du nom du produit et du numéro de
Vous pouvez personnaliser le nom du produit et le numéro de version. Utilisez l'élément replaceString avec l'ID
de chaîne souhaité :
<replaceString id="<string id>" value="<new value>" lang="<language list>"/>
Il existe quatre chaînes représentant le nom du produit et le numéro de version : le nom long du produit, le nom
court du produit, le numéro de version du produit et le numéro de version principale du produit. Le nom complet
du produit est composé du nom long du produit et du numéro de version. Le nom court du produit et la version
principale du produit sont utilisés dans le menu contextuel de Windows.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
117
Tableau 16: Nom du produit et numéro de version
Description de la chaîne
ID de chaîne
Valeur par défaut
Nom long du produit
product.cr_name
Crystal Reports
Nom court du produit
product.cr_shortname
Crystal Reports
Version du produit
product_cr_version
2011
Version principale du produit
product_cr_majorversion
2011
Remarque
Vous devez personnaliser la version du produit et la version principale du produit ensemble. Par exemple, si
vous changez la version du produit pour “1.0”, vous devez également personnaliser la version principale du
produit en “1”. Dans le cas contraire, le numéro de version dans le menu ne correspondra par au numéro de
version dans le produit.
Vous pouvez spécifier un nouveau nom pour chaque langue. Pour obtenir une liste des codes de langue, voir
Codes langue [page 146].
Exemple
Dans cet exemple, on procède aux personnalisations suivantes :
●
Changer le nom long du produit pour “Crystal Reports personnalisé Entité” et le nom court du produit pour
“CR personnalisé” pour l'anglais.
●
Changer le nom long du produit pour “Crystal Reports personnalisé Entité (français)” et le nom court du
produit pour “CR personnalisé (français)” pour le français.
●
Changer la version du produit pour “1.0” et la version principale du produit pour “1” pour toutes les langues.
Le nom du produit dans les langues autres que l'anglais et le français restent la valeur par défaut, mais la
version du produit et la version principale seront changées pour toutes les langues.
<replaceString id="product.cr_name" value="Custom Company Crystal Reports"
lang="en"/>
<replaceString id="product.cr_shortname" value="Custom CR" lang="en"/>
<replaceString id="product.cr_name" value="Custom Company Crystal Reports
(French)" lang="fr"/>
<replaceString id="product.cr_shortname" value="Custom CR (French)" lang="fr"/>
<replaceString id="product_cr_version" value="1.0" lang="all"/>
<replaceString id="product_cr_majorversion" value="1" lang="all"/>
Le résultat de la personnalisation apparaît ci-dessous. Notez que le numéro de version “FP3” n'est pas supprimé :
118
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Pour supprimer les instances de “FP3” du programme d'installation
Lors de l'exécution du programme d'installation, des instances de “FP3” peuvent être visibles dans le nom du
produit. Pour supprimer “FP3”, modifiez les lignes du fichier suivant :
Nom de fichier
Ligne originale
Ligne modifiée
dunit
<string id="productname_patch" <string
\product.crystalreports-4.0 value=" FP3"/>
id="productname_patch"
-core-32\setup.ui.framework
value=""/>
\uitext\CrystalReports
\product.lang_<code
langue>.uitext.xml
dunit
<string id="product_patch"
\product.crystalreports-4.0 value="FP3"/>
-core-32\setup.ui.framework
\uitext\framework
\setup.ui.framework.lang_<c
ode langue>.uitext.xml
<string
id="product_patch"
value=""/>
Comme ci-dessus
<string
id="product_patch_prespac
e" value=""/>
<string
id="product_patch_prespace"
value=" FP3"/>
Vous devez modifier un fichier pour chaque langue prise en charge par le programme d'installation. Pour obtenir
une liste des codes de langue, voir Codes langue [page 146]. Lors de l'exécution de l'outil de personnalisation puis
du programme d'installation, toutes les instances de “FP3” sont supprimées. Ce processus sera simplifié dans
une version ultérieure.
Exemple
Pour supprimer “FP3” du programme d'installation en anglais, modifiez les fichiers suivants :
●
product.lang_en.uitext.xml
●
setup.ui.framework.lang_en.uitext
Le résultat de la personnalisation apparaît ci-dessous :
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
119
6.5.2.2 Personnalisation des raccourcis du menu Démarrer
de Windows
Le menu Démarrer de Windows contient des raccourcis pour des fonctionnalités telles que l'Administrateur de
source de données ODBC. Vous pouvez personnaliser le nom, l'emplacement et l'info-bulle de chaque raccourci.
Les raccourcis que vous ne personnalisez pas seront regroupés dans l'entrée de menu Démarrer par défaut
nommée Crystal Reports 2011.
Le menu Démarrer par défaut des installations en anglais se présente comme suit :
Utilisez l'élément shortcut pour personnaliser l'emplacement, le nom du raccourci et l'info-bulle de chaque
fonctionnalité
<shortcut duSourceId="<shortcut deployment unit ID>">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language
list>"/>
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
Attribut
Valeur
duSourceId
ID d'unité de déploiement du raccourci à modifier. Les valeurs classiques sont :
●
120
product.crystalreports.shortcut.crw-4.0-core
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Attribut
Valeur
Crystal Reports 2011
●
product.crystalreports.shortcut.odbc-4.0-core
Administrateur de source de données ODBC
●
product.crystalreports.shortcut.rptpubwiz-4.0-core
Assistant de téléchargement de rapports
Pour obtenir la liste complète des valeurs duSourceId, voir ID des unités de
déploiement de raccourci [page 146].
linkFullPath
Chemin d'accès complet au raccourci. Veillez à ajouter .lnk au lien de raccourci, sans
quoi le lien ne sera pas créé. Vous pouvez placer le lien dans le menu Démarrer ou sur
le bureau. L'outil de personnalisation SAP BusinessObjects crée les liens
correctement.
Vous pouvez spécifier un lien par langue. Pour obtenir une liste des codes de langue,
voir Codes langue [page 146].
description
Chaîne d'info-bulle à afficher lorsque l'utilisateur survole le raccourci avec la souris.
Vous pouvez spécifier une info-bulle par langue.
Exemple
Dans cet exemple, on procède aux personnalisations suivantes :
●
Changer le nom du raccourci Crystal Reports 2011 pour “CR personnalisé Entité” pour l'anglais.
●
Personnaliser l'info-bulle Crystal Reports 2011 en “Lancer CR personnalisé Entité” pour l'anglais.
●
Changer le nom du raccourci “ODBC Data Source Administrator” pour “ODBC personnalisé” pour l'anglais.
●
Personnaliser l'info-bulle “ODBC Data Source Administrator” en “ODBC personnalisé” pour l'anglais.
●
Placer les raccourcis “CR personnalisé Entité” et “ODBC personnalisé” sous l'entrée du menu Démarrer
appelée “Company Programs”.
●
Changer le nom du raccourci “Report Upload Wizard” pour “Assistant personnalisé” pour l'anglais.
●
Placer le raccourci “Assistant personnalisé” sous l'entrée du menu Démarrer appelée “Assistant
personnalisé”.
●
Personnaliser l'info-bulle “Assistant personnalisé” en “Lancer Assistant personnalisé” pour l'anglais.
Le nom et l'info-bulle du raccourci restent inchangés dans toutes les autres langues.
Remarque
Pour mettre en pratique cet exemple, vous devez créer les liens et dossiers suivants :
●
Custom Company CR.lnk
●
Custom ODBC.lnk
●
Custom Wizard.lnk
●
Company Programs
●
Custom Wizard
Placez CR personnalisé Entité.lnk et ODBC personnalisé.lnk dans le dossier Company
Programs et placez Assistant personnalisé.lnk dans le dossier Assistant personnalisé. Placez
ces dossiers au même emplacement que celui vers lequel vous avez l'intention de rediriger le dossier
d'installation.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
121
Dans cet exemple, le dossier d'installation a été redirigé vers le disque C:\. Pour en savoir plus, voir
Personnalisation du dossier d'installation [page 124].
<shortcut duSourceId="product.crystalreports.shortcut.crw-4.0core">
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\Custom
Company CR.lnk" lang="en"/>
<arg id="description" value="Launch Custom Company CR" lang="en"/>
</shortcut>
<shortcut duSourceId="product.crystalreports.shortcut.odbc-4.0core">
<arg id="linkFullPath" value="[programmenufolder]\Company Programs\Custom
ODBC.lnk" lang="en"/>
<arg id="description" value="Custom ODBC" lang="en"/>
</shortcut>
<shortcut duSourceId="product.crystalreports.shortcut.rptpubwiz-4.0core">
<arg id="linkFullPath" value="[programmenufolder]\Custom Wizard\Custom
Wizard.lnk" lang="en"/>
<arg id="description" value="Launch Custom Wizard" lang="en"/>
</shortcut>
Le résultat de la personnalisation apparaît ci-dessous :
Exemple
Dans cet exemple, on conserve le nom par défaut du raccourci de la fonctionnalité “Assistant de
téléchargement de rapports” mais on le place sous l'entrée du menu Démarrer nommée “Assistant
personnalisé” pour toutes les langues. On change également l'info-bulle “Assistant personnalisé” pour “Lancer
Assistant personnalisé” pour toutes les langues.
Remarque
Pour mettre en pratique cet exemple, vous devez placer Assistant de téléchargement de
rapports.lnk dans le dossier Assistant personnalisé. Placez ce dossier au même emplacement que
le dossier d'installation.
122
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Dans cet exemple, le dossier d'installation a été redirigé vers le disque C:\.
<shortcut duSourceId="product.crystalreports.shortcut.rptpubwiz-4.0core">
<arg id="linkFullPath" value="[programmenufolder]\Custom Wizard\Report Upload
Wizard.lnk" lang="all"/>
<arg id="description" value="Launch Custom Wizard" lang="all"/>
</shortcut>
6.5.2.3 Personnalisation de l'utilitaire Ajout/Suppression de
programmes de Windows
Vous pouvez personnaliser le nom d'affichage, l'éditeur et l'icône dans l'utilitaire Ajout/Suppression de
programmes de Windows. Utilisez l'élément suivant :
<arp duSourceId="product.crystalreports.arp-4.0-core">
<arg id="publisher" value="<publisher name>"/>
<arg id="display_name" value="<product name>" lang="<language list>"/>
<arg id="display_icon" value="<full path to icon>"/>
</arp>
Remarque
Le nom d'affichage doit être marqué par une balise lang pour spécifier un nom d'affichage différent pour
chaque langue. Utilisez un point-virgule pour séparer plusieurs langues utilisant le même nom d'affichage. Les
langues non spécifiées utilisent la valeur par défaut.
Pour obtenir une liste des codes de langue, voir Codes langue [page 146].
Remarque
Des étapes supplémentaires doivent être suivies pour que la valeur personnalisée de l'éditeur s'affiche
correctement dans l'utilitaire Ajout/Suppression de programmes. Suivez ces étapes :
1.
Ouvrez le fichier dunit\product.crystalreports.arp-4.0-core-32\seed.xml.
2.
Cherchez l'élément <action id="AddARPEntry">. Vous verrez plusieurs éléments <arg> imbriqués.
3.
Ajoutez la ligne suivante sous <arg name="DISPLAY_NAME" value="[ARP.DISPLAYNAME]" /> :
<arg name="PUBLISHER" value="SAP" />
4.
Enregistrez le fichier.
Après avoir personnalisé le nom de l'éditeur dans le fichier de configuration, exécutez l'outil de
personnalisation, puis installez le produit personnalisé, votre valeur personnalisée pour l'éditeur s'affiche dans
l'utilitaire Ajout/Suppression de programmes. Ce processus sera simplifié dans une version ultérieure.
Les icônes affichées dans l'utilitaire Ajout/Suppression de programmes de Windows sont généralement de
16 x 16. Pour des informations complètes sur la création d'icônes, voir la documentation Windows.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
123
Exemple
Dans cet exemple, on procède aux personnalisations suivantes dans l'utilitaire Ajout/Suppression de
programmes de Windows :
●
Changer le nom de produit pour “Crystal Reports personnalisé Entité Correctif 1” pour l'anglais et le
français.
●
Changer le nom de produit pour “Crystal Reports personnalisé Entité (allemand)” pour l'allemand.
●
Changer l'éditeur pour “Personnalisé Entité”.
●
Remplacer l'icône affichée par l'icône se trouvant sous C:\SAPCustomTool\CC_logo.ico.
Remarque
Pour utiliser cet exemple, vous devez placer une icône nommée CC_logo.ico à l'emplacement C:
\SAPCustomTool.
<arp duSourceId="product.crystalreports.arp-4.0-core">
<arg id="publisher" value="Custom Company"/>
<arg id="display_name" value="Custom Company Crystal Reports Patch 1"
lang="en;fr"/>
<arg id="display_name" value="Custom Company Crystal Reports (German)"
lang="de"/>
<arg id="display_icon" value="C:\SAPCustomTool\CC_logo.ico"/>
</arp>
Le résultat de la personnalisation apparaît ci-dessous :
6.5.2.4
Personnalisation du dossier d'installation
Vous pouvez personnaliser l'emplacement du dossier d'installation par défaut. Utilisez l'élément
replaceProperty avec id="<chemin d'accès au dossier d'installation>" :
<replaceProperty id="InstallDir" defaultValue="<default installation folder>"/>
Exemple
Changez le dossier d'installation par défaut pour C:\MyInstallDIR\CustomCompanyCrystalReports.
<replaceProperty id="InstallDir" defaultValue="C:\MyInstallDIR
\CustomCompanyCrystalReports"/>
124
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
6.5.3
Personnalisation de la saisie utilisateur par défaut
Vous pouvez personnaliser la valeur par défaut de la saisie utilisateur recueillie par le programme d'installation.
Utilisez l'élément replaceProperty avec id="<id de propriété>" et la nouvelle valeur par défaut :
<replaceProperty id="<property id>" defaultValue="<value to use as default value>"/>
Pour obtenir une liste complète des ID de propriété, voir ID d'écran d'installation et de propriété [page 147].
Le programme d'installation Windows recueille la saisie utilisateur à l'aide des boîtes de dialogue, cases d'option
et autres éléments de l'interface utilisateur.
Exemple
Dans l'écran d'installation intitulé Choisissez un type d'installation, le type d'installation par défaut est Standard.
Cet exemple illustre le changement du type d'installation par défaut pour Personnalisée.
<replaceProperty id="InstallType" defaultValue="custom"/>
Le résultat de la personnalisation apparaît ci-dessous :
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
125
6.5.4
Suppression d'écrans d'installation
Vous pouvez supprimer des écrans d'installation depuis le programme d'installation. Utilisez l'élément
removeDialog avec l'ID d'écran d'installation :
<removeDialog id="<installation screen ID>"/>
Pour obtenir une liste complète des ID d'écrans d'installation, voir ID d'écran d'installation et de propriété [page
147].
Exemple
Cet exemple montre comment supprimer l'écran d'installation intitulé Sélection des fonctions.
<removeDialog id="SelectFeatures.dialog"/>
6.5.5
Incorporation d'un code clé
Vous pouvez incorporer un code clé dans le programme d'installation de sorte que le client n'ait pas besoin d'en
saisir un. Cette tâche implique :
●
La saisie d'une valeur par défaut pour le code clé
●
La suppression de l'écran d'installation où l'utilisateur saisit un code clé
Exemple
Utilisez l'élément replaceProperty avec id="ProductKey" pour fournir un code clé par défaut. Les codes
clés doivent avoir le format XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX.
Utilisez l'élément removeDialog avec id="CREnterProductKey.dialog" pour supprimer l'écran
d'installation demandant la clé de licence.
<replaceProperty id="ProductKey" defaultValue="XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX"/>
<removeDialog id="CREnterProductKey.dialog"/>
Liens associés
ID d'écran d'installation et de propriété [page 147]
Personnalisation de la saisie utilisateur par défaut [page 125]
Suppression d'écrans d'installation [page 126]
126
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
6.5.6
Suppression de fonctionnalités
SAP Crystal Reports comporte de nombreuses fonctionnalités facultatives. Vous pouvez supprimer une
fonctionnalité depuis le programme d'installation. Utilisez l'élément removeFeature avec id="<id de la
fonctionnalité>" :
<removeFeature id="<Feature ID>"/>
Pour obtenir une liste complète des ID de fonctionnalité, voir ID des fonctionnalités [page 143].
Lorsque vous spécifiez la suppression d'une fonctionnalité, l'outil de personnalisation SAP BusinessObjects
supprime tous les fichiers exécutables, écrans d'installation et autres fichiers appartenant à cette fonctionnalité.
La suppression de fonctionnalités non nécessaires est un bon moyen de réduire la taille du produit personnalisé.
Exemple
Supprimez la fonctionnalité de création de cartes géographiques. Cet ID supprime la capacité du programme
d'afficher les relations entre des données et des régions géographiques :
<removeFeature id="Mapping"/>
6.5.7
Empêchement des vérifications des prérequis
Les prérequis sont des conditions devant être remplies sur l'ordinateur hôte afin que le programme d'installation
réussisse dans sa tâche. Le programme d'installation vérifie l'existence de ces prérequis avant de démarrer et
affiche les résultats sur l'écran Vérification des prérequis. La suppression de l'écran Vérification des prérequis
empêche les vérifications de prérequis d'être effectuées. Utilisez l'élément <removeDialog> avec
id="CheckPreRequisites.dialog".
Remarque
Il est recommandé de supprimer cet écran d'installation uniquement si vous réalisez les vérifications de
prérequis par d'autres moyens. Si les prérequis ne sont pas remplis, le programme d'installation échoue dans
sa tâche.
Exemple
Dans cet exemple, on supprime l'écran Vérification des prérequis et on empêche les vérifications de prérequis
d'être effectuées.
<removeDialog id="CheckPreRequisites.dialog"/>
6.5.8
Suppression de packs linguistiques
Le programme d'installation permet à l'utilisateur de sélectionner quels packs linguistiques installer. Un pack
linguistique contient des versions traduites de toutes les chaînes utilisées par le produit installé. Par défaut, tous
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
127
les packs linguistiques possibles sont inclus dans le programme d'installation. Vous pouvez spécifier quels packs
linguistiques inclure. Utilisez l'élément languageIncludeList avec une liste de codes langue :
<languageIncludeList value="<list of language codes>"/>
Pour obtenir une liste des codes de langue, voir Codes langue [page 146].
Remarque
Les packs linguistiques peuvent être volumineux. Le programme d'installation sera plus petit si moins de packs
linguistiques y sont inclus.
Exemple
Incluez les packs linguistiques anglais, français et allemand dans le programme d'installation. L'utilisateur peut
faire son choix parmi cette liste lors de l'installation.
<languageIncludeList value="en;fr;de"/>
6.5.9
Modification des ressources
Le programme d'installation stocke des fichiers image et texte comme ressources dans ce dossier :
dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources
Vous pouvez personnaliser les ressources de ce dossier. Des ressources couramment utilisées sont :
●
Les images du programme d'installation
●
Le contrat de licence du programme d'installation
Pour personnaliser une ressource :
1.
Créez un dossier de ressources personnalisées : C:\MyResources, par exemple. Le dossier peut avoir le nom
de votre choix mais doit être visible pour les clients. Utilisez le même dossier pour toutes les ressources que
vous personnalisez.
2.
Créez une ressource portant le même nom et le même chemin d'accès que la ressource originale et placez-la
dans le dossier de ressources personnalisées. Voir les rubriques associées pour des exemples spécifiques.
3.
Ajoutez l'élément <resources> au fichier de configuration pour spécifier l'emplacement du dossier de
ressources personnalisées, par exemple :
<resources cleanTarget="no" sourcePath="C:\MyResources"/>
Attribut cleanTarget
Si vous définissez cleanTarget='yes', l'outil de personnalisation supprimera le dossier resources original et
utilisera uniquement les ressources du dossier de ressources personnalisées. Cette option n'est pas
recommandée.
Liens associés
128
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Personnalisation des images dans le programme d'installation [page 129]
Personnalisation du contrat de licence [page 130]
6.5.9.1
Personnalisation des images dans le programme
d'installation
Vous pouvez personnaliser les images du programme d'installation, notamment l'écran d'accueil, l'image
supérieure de tous les écrans et le panneau d'informations de la boîte de dialogue de progression. Les images
sont stockées sous forme de fichiers dans le dossier de ressources :
dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources
Tableau 17: Fichiers image dans le dossier resources
Nom de l'image
Nom du fichier
Ecran d'accueil
dialogFull.bmp
Image par défaut
dialogTop.bmp
Image supérieure
pour tous les écrans
Panneau
d'informations pour
la boîte de dialogue
de progression
billboard.bmp
Vous personnalisez une image en créant un fichier image, en plaçant le fichier dans le dossier de ressources
personnalisées et en ajoutant l'élément resources au fichier de configuration.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
129
Exemple
Personnalisation de l'image de l'écran d'accueil
1.
Créez un dossier nommé MyResources sur le disque C:\.
2.
Créez un fichier image nommé dialogFull.bmp et placez-le dans le dossier C:\MyResources.
3.
Assurez-vous que l'élément resources se trouve dans le fichier de configuration comme suit :
<resources cleanTarget="no" sourcePath="C:\MyResources"/>
Liens associés
Modification des ressources [page 128]
6.5.9.2
Personnalisation du contrat de licence
Vous pouvez personnaliser le contrat de licence présenté à l'utilisateur au cours de l'installation. Les contrats de
licence sont stockés sous forme de fichiers texte dans le dossier de ressources :
dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources\<code langue>
Par exemple, le contrat de licence en anglais se trouve ici :
dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources\en
\license_en.rft
Pour obtenir une liste des codes de langue, voir Codes langue [page 146].
Vous personnalisez le contrat de licence en créant un fichier de licence, en plaçant le fichier dans le dossier de
ressources personnalisées et en ajoutant l'élément resources au fichier de configuration.
Exemple
Personnaliser le contrat de licence en anglais
Le contrat de licence en anglais se trouve ici :
dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources\en
\license_en.rtf
Pour personnaliser le contrat de licence en anglais :
1.
Créez un dossier nommé MyResources sur le disque C:\.
2.
Créez un dossier nommé en et placez-le dans le dossier C:\MyResources.
3.
Créez un fichier de contrat de licence nommé license_en.rtf et placez-le dans le dossier C:
\MyResources\en.
4.
Assurez-vous que l'élément resources se trouve dans le fichier de configuration comme suit :
<resources cleanTarget="no" sourcePath="C:\MyResources"/>
Liens associés
Modification des ressources [page 128]
130
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
6.5.10 Suppression d'éléments du dossier Collaterals
Le programme d'installation de SAP Crystal Reports stocke des outils, des exemples et de la documentation dans
le dossier Collaterals du programme d'installation. Par défaut, un programme d'installation personnalisé
fourni aux clients contient également le dossier Collaterals avec le même contenu. Vous pouvez supprimer les
éléments non souhaités du dossier Collaterals afin de réduire la taille du programme d'installation
personnalisé. Utilisez l'élément collaterals avec cleanTarget="yes et sourcePath="<chemin complet
d'accès au dossier Collaterals personnalisé>" :
<collaterals cleanTarget="yes" sourcePath="<full path to custom Collaterals
folder>"/>
Remarque
Vous devez attribuer à l'attribut cleanTarget la valeur yes afin que l'outil de personnalisation remplace le
dossier original par le nouveau.
Pour supprimer des éléments du dossier Collaterals
1.
Copiez le contenu du dossier Collaterals existant dans un nouvel emplacement, par exemple : C:
\MesCollatéraux.
2.
Supprimez les éléments de C:\SAPCustomTool\Collaterals qui ne sont pas nécessaires pour votre
programme d'installation personnalisé.
3.
Ajoutez l'élément <collaterals> au fichier de configuration pour spécifier l'emplacement du dossier de
collatéraux personnalisés, par exemple :
<collaterals cleanTarget="yes" sourcePath="C:\MyCollaterals"/>
Tableau 18: Description des éléments du dossier Collaterals
Dossier
Description
Quand supprimer
Collaterals > AddOns > SAP
Fournit la connectivité aux systèmes
SAP.
Supprimez ce dossier s'il n'y a aucun
besoin de connexion aux systèmes SAP.
Collaterals >
CustomizationTempla
te
Contient le fichier d'exemple
template.zip pour les
Supprimez ce dossier si les clients n'ont
pas besoin de fournir un fichier d'exemple
template.zip.
Collaterals > Docs
personnalisations du concepteur de
rapports.
Documentation dans toutes les langues
prises en charge par Crystal Reports.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Supprimez toutes les langues qui ne sont
pas incluses au programme d'installation
personnalisé. Pour obtenir une liste des
codes de langue, voir Codes langue [page
146].
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
131
Dossier
Description
Quand supprimer
Collaterals > Tools
> CustomizationTool
Objet de personnalisation SAP
BusinessObjects.
Supprimez ce dossier si les clients n'ont
pas besoin de personnaliser leurs
programmes d'installation.
6.6
Personnalisation du concepteur de rapports
Vous pouvez personnaliser les propriétés suivantes du concepteur de rapports :
●
Ecran de présentation
●
Page Démarrer
●
Valeurs de chaîne du menu
Vous pouvez réaliser ces personnalisations après l'installation du programme. Vous pouvez également déployer
vos personnalisations sur votre package d'installation personnalisé, les personnalisations sont ainsi appliquées
lorsque l'utilisateur installe le programme.
6.6.1
Personnalisation de l'écran de présentation
Lorsque Crystal Reports démarre, un écran de présentation se charge. Vous pouvez remplacer cet écran de
présentation par votre propre bitmap.
Remarque
La procédure suivante suppose que vous avez déjà installé Crystal Reports. Si vous souhaitez déployer l'écran
de présentation dans votre programme d'installation personnalisé, renommez le fichier bitmap à utiliser
comme écran de présentation splash.bmp et suivez les instructions se trouvant dans Déploiement du fichier
de personnalisation OEM [page 135].
1.
Renommez le fichier bitmap à utiliser comme écran de présentation splash.bmp.
Remarque
Le fichier bitmap doit être un fichier .bmp valide et n'est pas limité en taille.
2.
Placez splash.bmp dans le même dossier que crw32.exe.
Par défaut, crw32.exe se trouve à l'emplacement suivant :
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects
Enterprise XI 4.0\win32_x86
Lors de l'exécution de Crystal Reports, splash.bmp devrait se charger. S'il ne se charge pas, l'écran de
présentation par défaut se charge à sa place.
132
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
6.6.2
Personnalisation de la page de démarrage
Vous pouvez modifier le contenu de la page de démarrage avec votre propre fichier HTML. La plupart des
personnalisations concerneront la partie supérieure de la page de démarrage. Vous pouvez également supprimer
la partie inférieure, qui contient des liens vers des pages Web de SAP Crystal Reports.
Remarque
La procédure suivante suppose que vous avez déjà installé Crystal Reports. Si vous souhaitez déployer la page
de démarrage dans votre programme d'installation personnalisé, renommez le fichier HTML à utiliser comme
page de démarrage start.html et suivez les instructions se trouvant dans Déploiement du fichier de
personnalisation OEM [page 135].
1.
Renommez le fichier HTML à utiliser comme page de démarrage start.html.
2.
Placez start.html dans le sous-dossier Start Page\<code langue>, en fonction des langues à prendre
en charge.
Remarque
Par défaut, le chemin d'accès au sous-dossier est :
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects
Enterprise XI 4.0\win32_x86\Start Page\<code langue>
Pour obtenir une liste des codes langue, voir Codes langue [page 146].
Astuce
Si start.html utilise des images, placez-les à l'emplacement suivant :
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects
Enterprise XI 4.0\win32_x86\Start Page\image
Votre fichier HTML doit utiliser des chemins d'accès relatifs pointant vers ce dossier.
Lors de l'exécution de Crystal Reports, la page de démarrage s'affiche avec les personnalisations de start.html.
6.6.3
Personnalisation des chaînes de menu
Vous pouvez modifier les valeurs de chaîne de menu contenant le nom du produit SAP Crystal Reports. Ces
valeurs sont :
Nom de la propriété
Description
Emplacement
Valeur par défaut
ProductName
Nom du produit
Titre de la fenêtre
SAP Crystal Reports
CrystalReportHelp
Aide du produit
Menu Aide
Aide SAP Crystal Reports
AboutCrystalReport
A propos de l'aide Menu Aide
du produit
A propos de SAP Crystal Reports
Pour personnaliser ces chaînes, un fichier XML est nécessaire. Le nom du fichier XML doit avoir le format suivant :
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
133
crw_oem_res_<code langue>.xml
Par exemple, le nom du fichier XML anglais est :
crw_oem_res_en.xml
Pour obtenir une liste des codes de langue, voir Codes langue [page 146].
Remarque
Si vous avez déjà installé Crystal Reports, le fichier XML doit être placé dans le même dossier que crw32.exe.
Par défaut, il se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects
Enterprise XI 4.0\win32_x86
Lors de l'exécution de Crystal Reports dans une certaine langue, le fichier XML de langue correspondant est
chargé.
Remarque
Si vous voulez déployer les chaînes personnalisées dans votre programme d'installation, suivez les instructions
se trouvant dans Déploiement du fichier de personnalisation OEM [page 135].
Exemple
Dans cet exemple, on procède aux personnalisations suivantes :
●
Changez la valeur ProductName pour Custom CR
●
Changez la valeur CrystalReportHelp pour Custom CR help
●
Changez la valeur AboutCrystalReport pour About Custom CR
<Root>
<ProductName>Custom CR</ProductName>
<MainFrameMenu>
<Help>
<CrystalReportHelp>Custom CR help</CrystalReportHelp>
<AboutCrystalReport>About Custom CR</AboutCrystalReport>
</Help>
</MainFrameMenu>
</Root>
Remarque
●
Pour prendre en charge plusieurs langues, le codage d'attribution doit être UTF-8 : <?xml
version="1.0" encoding="UTF-8"?>. En outre, lors de l'enregistrement du fichier XML à l'aide d'un
éditeur de texte, sélectionnez UTF-8 dans le menu Codage.
●
Gardez le nom et la valeur de la propriété sur la même ligne. Par exemple, ceci est accepté :
<ProductName>Custom CR</ProductName>
134
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Ceci ne l'est pas : Les chaînes modifiées contiendront des caractères non reconnaissables lors de
l'exécution de Crystal Reports :
<ProductName>
Custom CR
</ProductName>
6.6.4
Déploiement du fichier de personnalisation OEM
Après avoir préparé vos fichiers personnalisés (images de démarrage, page de démarrage et chaînes de menu),
vous pouvez déployer vos personnalisations dans le package d'installation. Placez les fichiers personnalisés dans
un fichier compressé.
1.
Créez un fichier compressé nommé template.zip.
2.
Placez les fichiers personnalisés dans le fichier compressé.
Remarque
La structure du dossier au sein du fichier compressé doit correspondre à la structure du dossier où vous
souhaitez placer les fichiers, relativement au dossier d'installation. Les fichiers doivent être placés dans
template.zip à l'emplacement suivant : SAP BusinessObjects Enterprise XI 4.0\win32_x86.
Par exemple, les fichiers personnalisés suivants sont placés à ces emplacements dans template.zip :
3.
Fichier personnalisé
Emplacement dans template.zip
splash.bmp
SAP BusinessObjects
Enterprise XI 4.0\win32_x86
start.html (pour l'anglais)
SAP BusinessObjects
Enterprise XI 4.0\win32_x86\Start Page\en
crw_oem_res_en.xml
SAP BusinessObjects
Enterprise XI 4.0\win32_x86
Copiez le fichier compressé à l'emplacement suivant :
dunit\product.crystalreports.oemzips-4.0-core-nu\OEMZips
Remarque
Il se peut que vous ayez à créer manuellement le dossier OEMZips.
4.
Exécutez le programme d'installation.
Le contenu de template.zip sera décompressé dans le dossier d'installation.
Remarque
Dans le package d'installation de SAP Crystal Reports se trouve un exemple de fichier compressé situé sous :
Collaterals\CustomizationTemplate\template.zip
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
135
6.7
Exécution de l'outil
L'outil de personnalisation SAP BusinessObjects customizationtool.exe est inclus dans le package
d'installation de SAP Crystal Reports à cet emplacement :
Collaterals\Tools\CustomizationTool
Cette section explique les paramètres de ligne de commande utilisés pour l'outil.
Remarque
L'outil de personnalisation SAP BusinessObjects peut prendre plusieurs minutes pour réaliser l'opération. Vous
pouvez vérifier sa progression en visualisant le fichier journal.
Exemple
Cet exemple présente l'exécution de l'outil de personnalisation et la création d'un fichier journal situé sur le
disque C:\. Pour mettre en pratique cet exemple, procédez de la manière suivante :
●
Créez un fichier de configuration nommé oem.xml à l'emplacement C:\SAPCustomTool.
●
Téléchargez le package d'installation de Crystal Reports à l'emplacement C:\SAPCustomTool
\packages. Voir Pour télécharger le programme d'installation [page 113].
●
Créez un dossier nommé output à l'emplacement C:\SAPCustomTool.
●
Exécutez la commande suivante à partir de l'invite de commande :cd C:\SAPCustomTool\packages
\Collaterals\Tools\CustomizationTool
customizationtool.exe xml=C:\SAPCustomTool\oem.xml packageDir=C:\SAPCustomTool
\packages
outputDir=C:\SAPCustomTool\output logDetail=error > C:\oemlog.log
Pour en savoir plus sur l'exécution de l'outil de personnalisation SAP BusinessObjects, voir Démarrage rapide pour
Crystal Reports [page 112].
6.7.1
Paramètres de ligne de commande
Tableau 19: Paramètres obligatoires
Paramètre
Description
Exemple
xml
Chemin d'accès complet au fichier de
configuration.
xml=C:\SAPCustomTool\oem.xml
Le fichier de configuration pour le programme
d'installation complète peut avoir n'importe quel
nom.
packageDir
136
Chemin d'accès complet au dossier contenant le
programme d'installation que vous modifiez.
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
packageDir=C:\SAPCustomTool
\packages
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Paramètre
Description
Exemple
Le programme d'installation est téléchargé à
partir du SAP Service Marketplace en vue de
démarrer l'installation de SAP Crystal Reports. Il
contient les dossiers Collaterals, dunit,
langs et setup.engine ainsi que d'autres
fichiers binaires.
outputDir
Chemin d'accès complet au dossier où sera créé
le programme d'installation personnalisé. Il doit
être vide avant l'exécution de l'outil.
outputDir=C:\SAPCustomTool
\output
Tableau 20: Paramètres facultatifs
Paramètre
Description
Exemple
baselinePath
Chemin complet du dossier racine
contenant les versions d'origine non
personnalisées de l'ensemble des
programmes d'installation complets et de
mises à jour que vous avez personnalisés.
Supposez que vous souhaitiez
personnaliser SAP Crystal Reports 2011
Support Package 5 et que vous ayez
personnalisé les précédents
programmes : 2011 (installation
Utilisez un point-virgule (;) pour séparer les complète), 2011 SP4. Personnalisez
2011 Support Package 5, et fournissez le
dossiers racine.
chemin du dossier racine vers les
packages non personnalisés pour la
version majeure 2011 et la version
Support Package 4. Par exemple, si les
packages non personnalisés sont
contenus dans la structure de répertoire
suivante :
C:\productUpdates\2011\
\2011 Full\
\SP4\
définissez la valeur sur
baselinePath=C:\productUpdates
\2011\
Voir Personnalisation des programmes
d'installation de mise à jour [page 138]
pour plus d'informations et d'exemples
sur le paramètre baselinePath.
logDetail
Niveau de détail suivi dans le fichier journal. logDetail=warn
La valeur par défaut est info. Les valeurs
suivantes sont acceptées :
●
error
●
warn
●
info
●
debut
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
137
Paramètre
Description
●
trace
Mode de l'outil Les valeurs suivantes sont
acceptées :
action
●
Exemple
action=validate
generate (valeur par défaut)
L'outil réalise les personnalisations
spécifiées.
●
validate
L'outil valide le fichier de configuration
mais ne réalise aucune
personnalisation.
Liens associés
Démarrage rapide pour Crystal Reports [page 112]
6.8 Personnalisation des programmes d'installation de mise
à jour
Les programmes d'installation de mise à jour sont les Support Packages ou les correctifs qui contiennent les
mises à jour de vos logiciels SAP Crystal Reports existants. Les Support Packages contiennent moins de mises à
jour mais sont moins fréquents que les correctifs. Vous pouvez utiliser l'outil de personnalisation SAP
BusinessObjects pour personnaliser ces programmes d'installation mais certaines modifications de la ligne de
commande et du fichier de configuration sont nécessaires.
6.8.1
jour
FAQ au sujet des programmes d'installation de mise à
Où peut-on trouver des Support Packages et des correctifs ?
1.
Accédez à https://service.sap.com/bosap-support > Software Downloads (Téléchargements de logiciels)
2.
Dans l'onglet Find your software (Trouver votre logiciel), A-Z Index (Index de A à Z), cliquez sur Support
Packages and Patches (Support Packages et correctifs).
3.
Sélectionnez C > CRYSTAL REPORTS > CRYSTAL REPORTS 2011 > Comprised Software Component Versions
(Versions des composants logiciels contenus) > CRYSTAL REPORTS 2011 > Windows Server on IA32 32bit
(Serveur Windows sur IA32 32 bits).
4.
Sélectionnez votre Support Package ou correctif, puis suivez les instructions du site Web pour télécharger et
extraire les objets.
138
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Quelles parties des programmes d'installation de mise à jour puis-je
personnaliser ?
Vous pouvez y personnaliser les mêmes aspects que dans le programme d'installation principale. Les Support
Packages et les mises à jour de correctifs contenant moins d'écrans d'installation, toutes les étapes de
personnalisation ne sont pas d'application. Il est recommandé d'exécuter le Support Package ou correctif avant
de le personnaliser pour déterminer quelles personnalisations vous souhaitez.
Comment personnaliser les programmes d'installation de mise à jour ?
Les programmes d'installation de mise à jour utilisent la même architecture que le programme d'installation
principal de Crystal Reports (installation complète), vous pouvez donc utiliser l'outil de personnalisation comme
décrit dans Création du fichier de configuration [page 115] et Exécution de l'outil [page 136] avec certaines
modifications apportées à la commande de ligne et au fichier de configuration. Pour en savoir plus, voir
Personnalisation de programmes d'installation de mise à jour [page 140] dans cette section.
Est-il nécessaire de personnaliser et d'installer toutes les mises à jour de
Support Package et de correctif ?
Non. Comme pour les versions de Crystal Reports qui ne sont pas personnalisées, vous ne devez installer que les
mises à jour que vous souhaitez. Il peut s'agir d'un Support Package, d'un correctif ou des deux.
Puis-je installer une mise à jour non personnalisée sur une installation Crystal
Reports personnalisée ?
Oui. Les Support Packages et correctifs personnalisés et non personnalisés peuvent être appliqués à votre
installation personnalisée. Toutefois les programmes d'installation de Support Packages et correctifs non
personnalisés n'afficheront pas votre personnalisation ni les personnalisations d'installation que vous avez créées
pour le programme d'installation principal.
J'ai livré une version personnalisée de Crystal Reports à des clients, mais je
veux modifier la personnalisation dans un programme d'installation de mise à
jour. Est-ce possible ?
Ce scénario n'est en effet pas pris en charge. Les personnalisations que vous réalisez sur les Support Packages et
correctifs doivent être cohérentes avec les personnalisations originales.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
139
6.8.2 Démarrage rapide pour les programmes d'installation
de mise à jour
Assurez-vous que vous avez personnalisé et installé le programme d'installation principale (complète) (SAP
Crystal Reports) à l'aide des instructions de Démarrage rapide pour Crystal Reports [page 112], et que le package
d'installation non personnalisé se trouve sous C:\SAPCustomTool\packages.
Cette section explique comment exécuter l'outil de personnalisation SAP BusinessObjects pour personnaliser le
programme d'installation d'un Support Package. Elle utilise l'exemple de fichier de configuration fourni avec l'outil
de personnalisation. Remarquez que l'exemple de fichier de configuration contient l'élément <cloneProduct>
pour le programme d'installation principale ainsi que l'élément <clonePatchProduct> pour un programme
d'installation de Support Package.
Remarque
Vous pouvez mettre en pratique cet exemple uniquement si un Support Package est disponible sur https://
service.sap.com/bosap-support.
1.
Téléchargez le programme d'installation du Support Package de Crystal Reports dans le dossier C:
\SAPCustomTool\SupportPackage.
2.
Assurez-vous que la valeur product_cr_version de l'élément <clonePatchProduct> du fichier de
configuration correspond au numéro de version du Support Package que vous avez téléchargé. Voir
Personnalisation du nom du produit et du numéro de version [page 117].
3.
Exécutez la commande suivante à partir de l'invite de commande :cd C:\SAPCustomTool\packages
\Collaterals\Tools\CustomizationTool
4.
Personnalisez le Support Package de Crystal Reports et placez le programme d'installation personnalisé sous
C:\SAPCustomTool\output\SupportPackage à l'aide de la commande suivante :
customizationtool.exe xml=example_customization_win_cr.xml packageDir=C:
\SAPCustomTool\SupportPackage baselinePath=C:\SAPCustomTool\packages outputDir=C:
\SAPCustomTool\output\SupportPackage logDetail=error > C:\oemlog_SP02.log
5.
Utilisez C:\SAPCustomTool\output\SupportPackage\setup.exe pour exécuter le programme
d'installation personnalisé pour le Support Package de Crystal Reports.
6.8.3 Personnalisation de programmes d'installation de mise
à jour
Utilisez l'outil de configuration comme décrit dans Création du fichier de configuration [page 115] et Exécution de
l'outil [page 136] pour personnaliser les programmes d'installation des Support Packages et correctifs à ces
différences près :
●
Le fichier de configuration doit utiliser l'élément clonePatchProduct (avec l'ID de produit correct), au lieu
de l'élément cloneProduct.
●
Le fichier de configuration doit contenir l'élément complet <cloneProduct> pour le package d'installation
principale que vous mettez à jour. Si ce n'est pas le cas, il pourrait en découler des résultats inattendus,
particulièrement lorsque les personnalisations impliquent la suppression de fonctionnalités.
140
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
●
Le fichier de configuration ne peut pas contenir plus d'un clonePatchProduct. Si vous personnalisez à la
fois un Support Package et un correctif, vous devez créer deux fichiers de configuration : un fichier contenant
cloneProduct et clonePatchProduct pour le Support Package, et un autre fichier contenant
cloneProduct et clonePatchProduct pour le correctif.
●
Faites référence à tous les programmes d'installation prérequis à l'aide de la commande baselinePath.
Tous les éléments et paramètres de commande de ligne des fichiers de configuration peuvent servir à
personnaliser les programmes d'installation, mais tous ne s'appliquent pas à chaque Support Package ou
correctif. Exécutez d'abord le programme d'installation pour le Support Package ou le correctif pour déterminer
ce que vous devez personnaliser, puis utilisez les informations de Création du fichier de configuration [page 115] et
ID et codes pour la personnalisation de Crystal Reports [page 143] pour créer le fichier de personnalisation.
Pour spécifier la version du produit dans le fichier de configuration
Le fichier de configuration pour les programmes d'installation de mise à jour doit contenir la version du
produit dans l'élément clonePatchProduct comme illustré ci-dessous :
<oem name="<any name>">
<clonePatchProduct sourceId="<product version>">
...
</clonePatchProduct>
</oem>
La product version (version du produit) du fichier de configuration doit correspondre au numéro de version du
programme d'installation que vous personnalisez. Pour trouver le numéro de version, cherchez dans le dossier
dunit un dossier portant un nom ayant ce format :
product.cr.patch-4.x.x.x-core-32
Vous pouvez utiliser le nom de ce dossier comme product version (version du produit).
Exemple
Cet exemple de fichier de configuration présente une personnalisation de SAP Crystal Reports 2011 Patch 1,
dont la version de produit est product.cr.patch-4.1.0.1-core-32. Le fichier de configuration
personnalise le nom long du produit en Custom Company Crystal Reports et le nom court du produit en
Custom CR.
<oem name="Custom Patch Tool">
<clonePatchProduct sourceId="product.cr.patch-4.1.0.1-core-32">
...
</clonePatchProduct>
</oem>
Pour utiliser le paramètre baselinePath
Utilisez le paramètre de ligne de commande baselinePath pour faire référence à un dossier racine contenant les
versions d'origine non personnalisées de l'ensemble des précédents programmes d'installation complets ou de
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
141
mise à jour que vous avez personnalisés. Cela signifie que vous devez conserver les packages d'installation
d'origine.
Remarque
Ce paramètre remplace le paramètre baselinePath introduit dans 2011 Feature Pack 3.
Pour simplifier la valeur du paramètre baselinePath, référencez un seul dossier racine. L'outil de
personnalisation ignorera les fichiers et dossiers inutiles. Autrement, pour spécifier plusieurs dossiers racine,
utilisez un point-virgule (;) dans la valeur baselinePath. Prenons les exemples suivants.
Exemple
Personnalisation de Crystal Reports 2011 SP5
Supposez que vous personnalisiez Crystal Reports 2011 Support Package 5 et que vous ayez personnalisé les
précédents programmes : 2011 (installation complète), 2011 SP4. Supposez que les programmes
d'installation non personnalisés se trouvent dans la structure de répertoire suivante :
C:\productUpdates\2011\
\2011 Full\
\SP4\
Définissez le paramètre baselinePath sur :
baselinePath=C:\productUpdates\2011\
Exemple
Personnalisation de Crystal Reports 2011 SP5 Patch 2
Supposez que vous personnalisiez Crystal Reports 2011 Support Package 5 Patch 2 et que vous ayez
personnalisé les précédents programmes : 2011 (installation complète), 2011 SP4, 2011 SP5,
2011 SP5 Patch 1. Supposez que les programmes d'installation non personnalisés se trouvent dans la
structure de répertoire suivante :
C:\productUpdates\2011\
\2011 Full\
\SP4\
\SP5\
\SP5 Patch 1\
Définissez le paramètre baselinePath sur :
baselinePath=C:\productUpdates\2011\
Liens associés
Paramètres de ligne de commande [page 136]
142
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
6.9
ID et codes pour la personnalisation de Crystal Reports
La section suivante contient une liste des ID et codes pouvant être utilisés pour personnaliser le programme
d'installation :
●
ID des fonctionnalités
●
ID des unités de déploiement de raccourci
●
ID de chaîne
●
Codes langue
●
ID d'écran d'installation et de propriété
6.9.1
ID des fonctionnalités
Utilisez les ID des fonctionnalités dans l'élément removeFeature pour supprimer des fonctionnalités et leurs
composants du programme d'installation et du produit installé.
Par exemple, cet ID supprimera la prise en charge de l'affichage des relations entre données et régions
géographiques : <removeFeature id="Mapping"/>
Les fonctionnalités des composants suivants peuvent être supprimées :
●
Accès aux données
●
Intégration du système Enterprise
●
Prise en charge de l'exportation
●
Autre
Tableau 21: Accès aux données
ID de fonctionnalité
Description
DataAccess
Accès aux données
Access
Microsoft Access
ADO.NET
ADO.NET
BDE
DLL de base de données IDAPI
Btrieve
Pilote de base de données Pervasive
COMData
Fournisseur de données COM
Comm_Rep
Commande dans le référentiel
DB2
IBM DB2
dBase
dBase
Exchange
Microsoft Exchange
FieldDefinitions
Définitions des champs
FileSystem
Système de fichiers
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
143
ID de fonctionnalité
Description
HPNeoview
HP Neoview
Informix
Informix
JavaData
Java Data Provider
JDBC
Pilote de données JDBC (JNDI)
MicrosoftOutlook
Microsoft Outlook
MyCube
Cube OLAP
MYSQL_DataAccess
MySQL
NCRTeradata
NCRTeradata
NETEZZA
NETEZZA
NTEventLog
Journal des événements NT
OLE_DB_Data
Données OLE DB
OptionalDataDirectODBC
ODBC DataDirect
Oracle
Oracle
Progress.OpenEdge
Progress OpenEdge
RDO
ODBC RDO
SFORCE
Salesforce.com Driver
SIEBEL
Siebel
Sybase
Sybase
SymantecACT
ACT!
Univers
Univers BusinessObjects
UWSC
Connecteur universel pour services Web
WebActivityLog
Journal des activités Web
XML
Pilote XML
Tableau 22: Intégration du système Enterprise
ID de fonctionnalité
Description
IntegrationOptions
Options d'intégration
EBS
Oracle E-Business Suite
JDE
JD Edwards EnterpriseOne
PSFT
Peoplesoft Enterprise
SAP
Solutions SAP
SIEBEL
Siebel
144
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Tableau 23: Prise en charge de l'exportation
ID de fonctionnalité
Description
Application
Exportation vers une application
CharacterSeparated
Format délimité par des caractères
CrystalReports
Format Crystal Reports
DiskFile
Exportation vers un fichier
Excel
Format Microsoft Excel 97-2003
ExchangeFolders
Dossier Exchange
HTML
Formats HTML 3.2 et HTML 4.0 (DHTML)
LegacyXMLExport
Format XML antérieur
LotusNotes
Document Lotus Notes
LotusNotesMail
Lotus Domino
ODBC
Exportation vers n'importe lequel de vos formats
ODBC installés
PDF
Format PDF
Record
Format Style d'enregistrement
ReportDefinition
Format Définition de rapport
RichTextFormat
RTF
Texte
Formats texte
WordforWindows
Format Microsoft Word 97-2003
XMLExport
Document XML
Tableau 24: Autre
ID de fonctionnalité
Description
CrystalReportsRoot
Crystal Reports 2011
crw
Crystal Reports Designer
Mappage
Création de cartes géographiques
MicrosoftMail
Destination de Microsoft Mail
PGEditor
Diagrammes personnalisés
UploadWizard
Assistant de téléchargement de rapports
Liens associés
Suppression de fonctionnalités [page 127]
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
145
6.9.2
ID des unités de déploiement de raccourci
Utilisez les ID d'unités de déploiement dans l'élément shortcut pour changer l'emplacement et le nom des
raccourcis de programmes dans le menu Démarrer de Windows.
Tableau 25: ID des unités de déploiement de raccourci
ID de l'unité de déploiement de raccourci
Cible du raccourci
product.crystalreports.shortcut.crw-4.0-core Crystal Reports 2011
Administrateur de source de données ODBC
product.crystalreports.shortcut.odbc-4.0core
product.crystalreports.shortcut.rptpubwiz-4. Assistant de téléchargement de rapports
0-core
Liens associés
Personnalisation des raccourcis du menu Démarrer de Windows [page 120]
6.9.3
ID de chaîne
Vous pouvez modifier la valeur de toutes les chaînes du programme d'installation. Vous pouvez remplacer une
chaîne pour toutes les langues ou pour une langue en particulier. Utilisez l'élément replaceString, par
exemple :
<replaceString id="product.cr_name" value="Custom Company Crystal Reports lang="all"/>
Tableau 26: Chaînes couramment modifiées
ID de chaîne
Description
product.cr_name
Nom long du produit
product.cr_shortname
Nom court du produit
product_cr_version
Version du produit
product_cr_majorversion
Version principale du produit
Liens associés
Personnalisation du nom du produit et du numéro de version [page 117]
6.9.4
Codes langue
L'outil de personnalisation SAP BusinessObjects utilise ces codes langue pour représenter les langues prises en
charge :
Langue
Code
Anglais
EN
146
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Langue
Code
Tchèque
CS
Danois
DA
Néerlandais
NL
Finnois
FI
Français
FR
Allemand
DE
Hongrois
HU
Italien
IT
Japonais
JA
Coréen
KO
Norvégien (Bokmål)
NB
Polonais
PL
Portugais
PT
Roumain
RO
Russe
RU
Chinois simplifié
zh_CN
Slovaque
SK
Espagnol
ES
Suédois
SV
Thaï
TH
Chinois traditionnel
zh_TW
turc
TR
Liens associés
Personnalisation du nom du produit et du numéro de version [page 117]
Personnalisation des raccourcis du menu Démarrer de Windows [page 120]
Personnalisation de l'utilitaire Ajout/Suppression de programmes de Windows [page 123]
Suppression de packs linguistiques [page 127]
Personnalisation du contrat de licence [page 130]
Personnalisation des chaînes de menu [page 133]
6.9.5
ID d'écran d'installation et de propriété
Utilisez les ID des écrans d'installation dans l'élément removeDialog pour supprimer les écrans du programme
d'installation. Utilisez par exemple cet élément pour supprimer l'écran Sélection des fonctions :
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
147
<removeDialog id="SelectFeatures.dialog"/>
Utilisez les ID de propriété et les valeurs de propriété pour préremplir les données saisies par l'utilisateur. Utilisez
par exemple cet élément pour définir le type d'installation par défaut sur personnalisé :
<replaceProperty id="InstallType" defaultValue="custom"/>
Tableau 27: ID d'écran
Titre de l'écran
d'installation
ID de l'écran d'installation
ID de propriété dans
l'écran d'installation
Valeurs de
propriété
Veuillez sélectionner une
langue d'installation
SelectUILanguage.dialog
SortedAvailableSetup
Languages
Ensemble des
codes langue
représentant les
langues
d'installation
prises en charge
SetupUILanguage
Code langue
unique
représentant la
langue
d'installation
Installation impossible
SharedAlwaysFailure.dialo
g
Non applicable
Non applicable
Choisissez un type
d'installation
ChooseInstallType2.dialog
InstallType
●
par défaut
(Standard)
●
personnali
sé
Vérification des prérequis
CheckPreRequisites.dialog
Non applicable
Non applicable
Bienvenue dans l'Assistant
d'installation...
ShowWelcomeScreen.dialog
Non applicable
Non applicable
Contrat de licence
ShowLicenseAgreement.dial
og
Non applicable
Non applicable
Informations utilisateur
CREnterProductKey.dialog
RegisteredUser
Votre Nom
d'utilisateur
RegisteredCompany
Nom de
l'entreprise
ProductKey
Votre Code clé du
produit
Spécifier le dossier de
destination
ChooseInstallDir.dialog
InstallDir
Chemin d'accès
au dossier
d'installation
Sélection des langues
SelectLanguagePack.dialog
SelectedLanguagePack
s
Tableau des
codes langue
Sélection des fonctions
SelectFeatures.dialog
Non applicable
Non applicable
148
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Titre de l'écran
d'installation
ID de l'écran d'installation
ID de propriété dans
l'écran d'installation
Valeurs de
propriété
SAP Crystal Reports 2011 a
été installé
ShowInstallComplete.dialo
g
Non applicable
Non applicable
SAP Crystal Reports 2011 a
été installé
ShowInstallComplete_Patch
Update.dialog
Non applicable
Non applicable
Commencer l'installation
ShowInstallSummary.dialog
Non applicable
Non applicable
Confirmation de
désinstallation
VerifyToRemove.dialog
Non applicable
Non applicable
Option de service de mise à
jour Web
ShowPrivacyStatement.dial
og
DisableWebUpdateServ
ice
●
0 (Activer le
service de
mise à jour
Web)
●
1 (Désactiver
le service de
mise à jour
Web)
SAP Crystal Reports 2011 a
été désinstallé
ShowUninstallComplete.dia
log
Guide de personnalisation de SAP BusinessObjects OEM
Personnalisation de SAP Crystal Reports 2011
Non applicable
Non applicable
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
149
www.sap.com/contactsap
© 2013 SAP AG ou société affiliée SAP. Tous droits réservés.
Toute reproduction ou communication de la présente publication,
même partielle, par quelque procédé et à quelque fin que ce soit, est
interdite sans l'autorisation expresse et préalable de SAP AG. Les
informations contenues dans ce document peuvent être modifiées
par SAP AG sans préavis.
Certains logiciels commercialisés par SAP AG et ses distributeurs
contiennent des composants logiciels qui sont la propriété
d'éditeurs tiers. Les spécifications des produits peuvent varier d’un
pays à l’autre.
Elles sont fournies par SAP AG et ses filiales (« Groupe SAP »)
uniquement à titre informatif, sans engagement ni garantie
d'aucune sorte. Le Groupe SAP ne pourra en aucun cas être tenu
responsable des erreurs ou omissions relatives à ces informations.
Les seules garanties fournies pour les produits et les services du
Groupe SAP sont celles énoncées expressément à titre de garantie
accompagnant, le cas échéant, lesdits produits et services. Aucune
des informations contenues dans ce document ne saurait constituer
une garantie supplémentaire.
SAP et tous les autres produits et services SAP mentionnés dans ce
document, ainsi que leurs logos respectifs, sont des marques
commerciales ou des marques déposées de SAP AG en Allemagne
ainsi que dans d'autres pays.
Pour plus d'informations sur les marques déposées, voir http://
www.sap.com/corporate-en/legal/copyright/index.epx.
">