Suite SAP BusinessObjects Business Intelligence
Version du document : 4.1 Support Package 3 - 2014-04-03
Guide de personnalisation de SAP
BusinessObjects BI
Table des matières
2
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Table des matières
Guide de personnalisation de SAP BusinessObjects BI
Table des matières
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
3
4
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Table des matières
1 Historique du document
Le tableau suivant fournit une présentation des principaux enrichissements apportés à ce document :
Version
Suite SAP BusinessObjects 4.1 de
Business Intelligence
Suite SAP BusinessObjects Business
Intelligence 4.1 Support Package 1
Date
Mai 2013
Août 2013
Description
Première version de ce document.
●
Installation sur des plateformes Red Hat Linux non prises en charge
●
Mise à jour de la section
Personnalisation du dossier d'installation
répertoire d'installation par défaut doit être un sous-dossier de
Program Files (x86) .
Suite SAP BusinessObjects Business
Intelligence 4.1 Support Package 2
Novembre 2013
●
SAP System Landscape Directory
(SLD) est désormais une fonctionnalité masquée et installée automatiquement, de sorte que toute référence au code de fonctionnalité
PlatformServers.SystemLandscape
Supplier a été supprimée.
Guide de personnalisation de SAP BusinessObjects BI
Historique du document
©
2014 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 vous permettant de personnaliser la plateforme SAP BusinessObjects Business Intelligence, SAP Crystal Reports Designer et SAP
Crystal Reports pour Enterprise. Ce guide vous indique comment utiliser ces outils et modèles afin de créer les personnalisations que vous souhaitez.
En fonction des besoins de vos clients, vous pouvez supprimer des Feature Packs et packs linguistiques pour réduire la taille du programme d'installation et du produit installé. Pour différencier votre système et appliquer votre propre branding d'entreprise, vous pouvez personnaliser l'apparence de vos produits, notamment le nom du produit, les logos, les couleurs et d'autres éléments de l'interface utilisateur. Votre personnalisation peut être aussi simple qu'un changement de logo ou aussi détaillée qu'un changement complet d'apparence.
Le plus grand avantage consiste en ce que vos personnalisations sont prises en charge tout au long du cycle de vie des produits. La gestion de vos modifications se fait facilement lors des mises à niveau et mises à jour ultérieures.
Ce guide s'adresse à toute personne souhaitant personnaliser les produits de la suite SAP BusinessObjects
Business Intelligence. La lecture du document dans son intégralité n'est pas nécessaire ; la section
[page 8] décrit les workflows correspondant à chaque zone principale de la personnalisation de produit et vous indique où trouver les informations dont vous avez besoin.
Conventions du guide
Les variables suivantes sont utilisées dans ce guide.
Variable
<REPINSTALL>
Description
Chemin d'accès à l'installation de la plateforme de BI. Sur un ordinateur fonctionnant sous Windows, le chemin d'accès par défaut est : C:\Program Files
(x86)\SAP BusinessObjects\
.
2.1.1 Terminologie
La documentation de la plateforme de BI utilise la terminologie suivante :
Terme produits de modules complémentaires
Définition
Produits utilisant la plateforme de BI mais disposant de leur propre programme d'installation, tels que SAP Bu sinessObjects Explorer.
6
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Démarrage
Terme
Magasin de données d'audit
Plateforme de BI base de données fournie, serveur d'applications Web fourni cluster mettre en cluster
Définition
Base de données utilisée pour stocker les données d'audit
Abréviation pour Plateforme SAP BusinessObjects Bu siness Intelligence
Base de données ou serveur d'applications Web ac compagnant la plateforme de BI
Au moins deux serveurs CMS (Central Management
Servers) travaillant ensemble et utilisant une seule base de données du CMS.
Pour créer un cluster
Par exemple, pour créer un cluster :
1. Installez un CMS et une base de données du CMS sur l'ordinateur A.
2. Installez un CMS sur l'ordinateur B.
3. Dirigez le CMS installé sur l'ordinateur B vers la base de données du CMS installée sur l'ordinateur
A.
clé de cluster
CMS
Base de données du CMS déploiement l'installation ordinateur version principale
Utilisée pour déchiffrer les clés de la base de données du CMS
Vous pouvez changer de clé de cluster dans le CCM mais vous ne pouvez pas réinitialiser la clé comme un mot de passe. Elle renferme un contenu chiffré et il est essentiel de ne pas la perdre.
Abréviation pour Central Management Server
Base de données utilisée par le CMS pour stocker les informations relatives à la plateforme de BI
Logiciel de la plateforme de BI installé, configuré et exécuté sur un ou plusieurs ordinateurs.
Une instance des fichiers de la plateforme de BI créée par le programme d'installation sur un ordinateur
Ordinateur sur lequel le logiciel de la plateforme de BI est installé
Version complète du logiciel, telle que 4.0
Guide de personnalisation de SAP BusinessObjects BI
Démarrage
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
7
Terme migration version secondaire nœud correctif promotion serveur
Server Intelligence Agent
Support Package
Serveurs d'applications Web mise à niveau
Définition
Processus de transfert de contenu BI depuis une ver sion principale précédente (par exemple, depuis XI 3.1)
à l'aide de l'outil de gestion de mise à niveau.
Ce terme ne concerne pas les déploiements de même version principale. Voir promotion.
Version comportant certains composants, telle que 4.1
Groupe de serveurs de la plateforme de BI qui s'exécu tent sur le même ordinateur et sont gérés par le même
SIA (Server Intelligence Agent)
Petite mise à jour concernant une version de Support
Package spécifique
Processus de transfert de contenu BI entre des dé ploiements de même version principale (par exemple, de 4.0 vers 4.0) à l'aide de l'application de gestion des promotions
Un processus de la plateforme de BI. Un serveur hé berge un ou plusieurs services.
Processus gérant un groupe de serveurs, notamment l'arrêt, le démarrage et le redémarrage des serveurs
Mises à jour logicielle concernant une version secon daire ou principale
Serveur traitant du contenu dynamique. Par exemple, le serveur d'applications Web fourni pour 4.1 est Tom cat 7.
La planification, la préparation, la migration et le posttraitement nécessaires à la réalisation d'un processus de migration
2.2 Avant de commencer
Ce guide traite des différents types de personnalisation 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.
8
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
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.
[page 14] 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.
[page 60] 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.
Personnalisation du visualiseur de Crystal Reports JavaScript
[page 68] 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 BI
Démarrage
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
9
10
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Démarrage
2.2.2 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 71].
● 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.
[page 71] 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.
Personnalisation du concepteur de rapports
Le diagramme qui suit illustre le workflow où sont réalisés tous les types de personnalisation :
Guide de personnalisation de SAP BusinessObjects BI
Démarrage
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
11
12
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Démarrage
2.2.3 Personnalisation de SAP Crystal Reports pour
Enterprise
Vous pouvez apporter certaines personnalisations à SAP Crystal Reports for Enterprise afin de personnaliser l'apparence du programme et d'améliorer l'expérience client de vos utilisateurs :
● Personnaliser le programme d'installation en modifiant son apparence, en masquant des écrans inopportuns et en supprimant des fichiers non utilisés afin de réduire la taille du produit installé sur les ordinateurs clients.
Pour en savoir plus, consultez le
[page 109] pour la section “Personnalisation de SAP Crystal
Reports pour Enterprise” de ce document.
● Personnalisez le concepteur de rapports en modifiant l'écran de présentation ou la page de démarrage par défaut. Vous pouvez également personnaliser le nom du produit, les menus et d'autres atouts du concepteur de rapports.
Pour en savoir plus, consultez le
Personnalisation du concepteur de rapports
“Personnalisation de SAP Crystal Reports pour Enterprise” de ce document.
Guide de personnalisation de SAP BusinessObjects BI
Démarrage
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
13
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.
14
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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 du serveur
[page 16].
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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
15
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 du serveur
[page 16].
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 du serveur
1. Accédez à
https://service.sap.com/support
> Téléchargements de logiciels.
2. Dans l'onglet Find your software (Trouver votre logiciel), sous A–Z Index (Index de A à Z), cliquez sur
Installations and Upgrades (Installations et mises à niveau).
3. Sélectionnez B Plateforme SBOP BI - anciennement SBOP Enterprise SBOP BI PLATFORM
(ENTERPRISE) SBOP BI PLATFORM 4.1 .
16
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
4. Sélectionnez Installation et mise à niveau, puis votre plateforme.
5. Sélectionnez tous les packages 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 packages.
Le téléchargement du logiciel peut être long et vous pouvez éventuellement avoir à contacter l'administrateur système pour vérifier que le pare-feu de votre société n'interrompra pas le processus de téléchargement.
Les Support Packages et les correctifs sont des programmes d'installation qui contiennent des mises à jour pour le logiciel de la plateforme de BI. Vous pouvez les télécharger depuis
https://service.sap.com/support
>
Software Downloads (Téléchargements de logiciels). Dans l'onglet Find your software (Trouver votre logiciel), sous 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 les guides de mise à jour de la suite 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 du serveur
[page
16].
2. Décidez quelles personnalisations sont nécessaires. Voir
Création du fichier de configuration
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 :
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
17
● 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.
Informations associées
Paramètres de ligne de commande
[page 39]
18
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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
Windows
Unix ou Linux
Emplacement de l'exemple de fichier de configuration
Collaterals\Tools\CustomizationTool\example_customization_win_boe.xml
Collaterals/Tools/CustomizationTool/example_customiza tion_linux_boe.xml
Le fichier doit avoir ce format :
<oem name="<Any name>">
<cloneProduct sourceId="product.businessobjects644.0core32">
...
...
</cloneProduct>
</oem>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
19
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 43].
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.businessobjects644.0core32">
<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.
20
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
3.6.2.1 Personnalisation du nom du produit et du numéro de version
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.
Table 1 : Nom du produit et numéro de version
Description de la chaîne ID de chaîne
Nom long du produit product.boe64_name
Nom court du produit
Version du produit
Version principale du produit product.boe64_shortname
product_version product_majorversion
Valeur par défaut
Plateforme SAP BusinessObjects Bu siness Intelligence
Serveur de la plateforme de BI
4.1
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"/>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
21
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 dunit\product.businessob jects644.0core32\se tup.ui.framework\uitext
\BusinessObjects64\pro duct.lang_<code lan gue>.uitext.xml
Ligne originale
<string id="product name_patch" value=" FP3"/>
Ligne modifiée
<string id="product name_patch" value=""/> dunit\product.businessob jects644.0core32\se tup.ui.framework\uitext
\framework\setup.ui.frame work.lang_<code lan gue>.uitext.xml
Comme ci-dessus
<string id="product_patch" value="FP3"/>
<string id="product_patch" value=""/>
<string id="pro duct_patch_prespace" value="
FP3"/>
<string id="pro duct_patch_prespace" va lue=""/>
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
[page 50]. 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.xml
La personnalisation apparaît ci-dessous :
22
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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>"/>
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
23
Attribut duSourceId linkFullPath description
Valeur
ID d'unité de déploiement du raccourci à modifier. Les valeurs classiques sont :
● product.businessobjects64.shortcut.ccm4.0core
Central Configuration Manager
● product.businessobjects64.shortcut.infoview4.0core
Zone de lancement BI
● product.businessobjects64.shortcut.cmc4.0core
Central Management Console
Pour obtenir la liste complète des valeurs sourceId, voir
ID des unités de déploiement de raccourci (Windows uniquement)
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
[page 50].
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.cmc4.0 core">
<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"/>
<arg id="description" value="Launch Sales Manager (French)" lang="fr" />
</shortcut>
24
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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.tomcat4.0core" 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.tomcat4.0core" pathToTarget="[INSTALLDIR]tomcat\bin\tomcat7w.exe">
<arg id="linkFullPath" value="<full path to shortcut link>" lang="<language list>"/>
<arg id="description" value="<tooltip string>" lang="<language list>"/>
</shortcut>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
25
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.tomcat4.0core" 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.tomcat4.0core" pathToTarget="[INSTALLDIR]tomcat\bin\tomcat7w.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.arp4.0core">
<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.
26
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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.arp4.0core">
<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.
Remarque
Dans les installations Windows, le dossier d'installation par défaut doit être un sous-dossier de C:\Program
Files (x86). Il ne peut pas s'agir d'un sous-dossier de C:\Program Files (x64).
Exemple
Changez le dossier d'installation par défaut pour C:\Program Files (x86)\SalesDataInsight.
<replaceProperty id="InstallDir" defaultValue="C:\Program Files
(x86)\SalesDataInsight"/>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
27
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 51].
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 :
28
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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
51].
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 XXXXXXXXXXXXXXXXXXXXXXXXXXXX.
Utilisez l'élément removeDialog avec id="EnterProductKey.dialog" pour supprimer l'écran d'installation demandant la clé de licence.
<replaceProperty id="ProductKey" defaultValue="XXXXXXXXXXXXXXXXXXXXXXXXXXXX"/>
<removeDialog id="EnterProductKey.dialog"/>
Informations associées
ID d'écran d'installation et de propriété
[page 51]
Personnalisation de la saisie utilisateur
[page 28]
Suppression d'écrans d'installation
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
29
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
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é.
Remarque
Ne supprimez pas chaque composant d'accès à la base de données. Vous devez laisser au moins un composant d'accès à la base de données afin que le serveur de connexion soit lancé et fonctionne correctement.
Exemple
Supprimez la fonctionnalité Crystal Reports. Cela supprime tous les serveurs, fichiers et ressources Crystal
Reports.
<removeFeature id="CrystalReportsServers"/>
Informations associées
[page 45]
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.
30
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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"/>
3.6.8 Installation sur des plateformes Red Hat Linux non prises en charge
Le programme d'installation de la plateforme de BI ne vous permet pas d'effectuer d'installation sur des plateformes non prises en charge. Néanmoins, certaines plateformes telles que les clones Red Hat, bien que non prises en charge, peuvent héberger une installation de plateforme de BI. Vous pouvez supprimer les vérifications de prérequis afin de permettre à l'installation de la plateforme de BI de s'exécuter sur des plateformes non prises en charge à l'aide des tâches suivantes :
1. Supprimez les vérifications de ressources dans setup.sh.
2. Supprimez la vérification des prérequis dans product.seed.xml.
3. Vérifiez manuellement le respect des prérequis correspondant à la plateforme de votre choix.
1. Supprimez la section suivante dans le fichier setup.sh. Cette section vérifie la disponibilité de ressources dans le répertoire /etc/redhatrelease et doit être supprimée.
# Verify that the system has the libraries required to run the setupengine.
# Because the setup engine is 32bit, it requires 32bit libraries, however
# some linux distrobutions do not ship 32bit binaries by default, therefore
# we need to check for glibc2.121.7.el6.i686 or higher on RedHat and libstdc+
+3332bi
# on SuSE osname=`uname s` if [ "$osname" = "Linux" ]; then
if [ f "/etc/redhatrelease" ]; then
version="`cat /etc/redhatrelease | sed 's/.* \([09,.]*\) .*/\1/'`"
if [ "$version" = "6.0" ]; then
glibc="`rpm qa | grep glibc.*i686 | awk F '{ if (NF == 3) split($2,a,"."); if (((a[1] == 2) && (a[2] >= 12)) || ( a[1] > 2)) glibcFound =
"true"} END { print glibcFound }'`"
if [ "$glibc" = "" ]; then
requiredLibs=$requiredLibs" glibc2.121.7.el6.i686 or higher."
fi
fi
fi
if [ f "/etc/SuSErelease" ]; then
version="`cat /etc/SuSErelease | grep "VERSION = 11"`"
if [ "$version" != "" ]; then
libstd="`rpm q a | grep libstdc++3332bit`"
if [ "$libstd" = "" ]; then
requiredLibs="$requiredLibs libstdc++3332bit"
fi
fi
fi
if [ "$requiredLibs" != "" ]; then
echo "Installation aborted. The following libraries are required to run the installer:$requiredLibs"
exit 0
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
31
fi fi
2. Supprimez la section suivante dans le fichier dunit/product.businessobjects644.0core32/ product.seed.xml. Cette section utilise le fichier /etc/redhatrelease pour vérifier les correctifs installés et doit être supprimée.
<prerequisite id="CheckPatchLevel" description="#prerequisite.CheckPatchLevel.description#" reason="[CheckPatchLevelFailReason]" type="warn">
<condition property="IsFailedPatchLevelCheck" value="0"/>
</prerequisite>
3. Assurez-vous que le système d'exploitation sur lequel le programme d'installation personnalisé est destiné à s'exécuter respecte tous les prérequis et que toutes les bibliothèques nécessaires sont installées. Examinez les sections que vous avez supprimées de setup.sh et de product.seed.xml. Consultez également la documentation suivante :
○ Product Availability Matrix (plateformes prises en charge/PAR), disponible dans la section SAP
BusinessObjects du SAP Support Portal à l'adresse :
https://service.sap.com/bosap-support
.
○ Spécifications supplémentaires requises pour Red Hat Linux du Guide d'installation de la plateforme de
Business Intelligence pour Unix.
3.6.9 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
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"/>
32
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
3.6.10 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.11 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. La base de données par défaut est Sybase SQL Anywhere.
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.
Pour supprimer 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
Dans cet exemple, on 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.12 Modification des ressources
Le programme d'installation stocke des fichiers image et texte comme ressources dans ce dossier :
\dunit\product.businessobjects644.0core32\setup.ui.framework\resources
Vous pouvez personnaliser les ressources de ce dossier. Des ressources couramment utilisées sont :
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
33
● 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. 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:\SAPCustomTool\MyResources"/>
cleanTarget
Si vous définissez l'attribut 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.
Informations associées
Personnalisation des images dans le programme d'installation
Personnalisation du contrat de licence
[page 36]
3.6.12.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.businessobjects644.0core32\setup.ui.framework\resources
34
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Table 2 : Fichiers image dans le dossier resources
Nom de l'image
Nom du fi chier
Taille (L x H) Image par défaut
Ecran d'ac cueil dialog
Full.bmp
500 x 400 px
Image supéri eure pour tous les
écrans dialog
Top.bmp
Panneau d'in formations pour la boîte de dialogue de progres sion
500 x 83 px billboard.bmp 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.
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"/>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
35
Informations associées
3.6.12.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.businessobjects644.0core32\setup.ui.framework\resources\<code langue>
Par exemple, sur les plateformes Windows, le contrat de licence en anglais se trouve ici : dunit\product.businessobjects644.0core32\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.businessobjects644.0core32/setup.ui.framework/resources/en/ license_en.txt
Pour obtenir une liste des codes de langue, voir
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.businessobjects644.0core32\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"/>
Informations associées
36
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
3.6.13 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"/>
Table 3 : Description des éléments du dossier Collaterals
Dossier
Collaterals > AddOns
> SAP
Description
Fournit la connectivité aux systèmes
SAP.
Quand supprimer
Supprimez ce dossier s'il n'y a aucun besoin de connexion aux systèmes
SAP.
Supprimez si la fonctionnalité LCM est supprimée.
Collaterals > AddOns
> Subversion
Subversion est le système de contrôle de version par défaut utilisé par la Ges tion du cycle de vie (LCM).
Collaterals > AddOns
> Tivoli Agent
La fonctionnalité de surveillance des serveurs peut intégrer IBM Tivoli et cet
élément fournit la connectivité.
Collaterals > Custo mization Template
Fichiers de modèles requis.
Collaterals > Diag nosticsAgent7.3
Supprimez si l'intégration à IBM Tivoli n'est pas nécessaire.
Ne supprimez pas ce dossier.
Agent SAP Solution Manager Diagnos tics (SMD). SMD est utilisé par les outils
Supprimez si la fonctionnalité SMD est supprimée.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
37
Dossier
Collaterals > Docs
Collaterals > Tools >
CustomizationTool
Collaterals > Tools >
LCM command line tool
Collaterals > Tools > wdeploy
Description
Support SAP pour dépanner le produit installé.
Documentation dans toutes les langues prises en charge par la plateforme SAP
BusinessObjects Business Intelligence.
Objet de personnalisation SAP Busines sObjects.
Utilitaire de ligne de commande de la
Gestion du cycle de vie (LCM).
WDeploy sert à déployer des applica tions Web sur les serveurs d'applica tions Web autres que Tomcat.
Quand supprimer
Supprimez toutes les langues qui ne sont pas incluses au programme d'ins tallation personnalisé. Pour obtenir une liste des codes de langue, voir
Supprimez ce dossier si les clients n'ont pas besoin de personnaliser leurs programmes d'installation.
Supprimez si la fonctionnalité LCM est supprimée.
Suppression déconseillée. Supprimez seulement si les clients utiliseront uni quement 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.
● 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 du serveur
[page 16].
● Créez un dossier nommé output à l'emplacement C:\SAPCustomTool.
C:\SAPCustomTool\packages\Collaterals\Tools\CustomizationTool
\customizationtool.exe
38
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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
Table 4 : Paramètres obligatoires
Paramètre Description
xml
Chemin d'accès complet au fichier de configura tion.
packageDir
Exemple (Windows) xml=example_customiza tion_win_boe.xml
Chemin d'accès complet au dossier contenant le programme d'installation que vous modifiez.
Le programme d'installation est téléchargé à partir du SAP Service Marketplace en vue de démarrer l'installation de la plateforme SAP BusinessOb jects Business Intelligence. Il contient les dossiers
Collaterals, dunit, langs et setup.engine ainsi que d'autres fichiers binaires.
packageDir=C:\SAPCustomTool
\packages
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\out put
Table 5 : Paramètres facultatifs
Paramètre Description
baselinePath
Chemin complet du dossier racine conte nant les versions d'origine non personnali sées de l'ensemble des programmes d'ins tallation complets et de mises à jour que vous avez personnalisés.
Pour spécifier plusieurs dossiers racine, uti lisez un point-virgule (; - Windows) ou deux-points (; - Unix).
Exemple (Windows)
Supposez que vous souhaitiez personna liser Plateforme SAP BusinessObjects
BI 4.0 Support Package 5.0 et que vous ayez personnalisé les précédents pro grammes : 4.0 SP2 (installation complète), 4.0 SP4. Personnalisez
4.0 Support Package 5, et fournissez le chemin du dossier racine vers les packa ges non personnalisés pour l'installation complète 4.0 SP2 et l'installation de la mise à jour SP4. Par exemple, si les pac kages non personnalisés sont contenus dans la structure de répertoire suivante :
C:\productUpdates\4.0\
\SP2 Full\
\SP4\ définissez la valeur sur baseline
Path=C:\productUpdates\4.0\
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
39
Paramètre
logDetail action
Description Exemple (Windows)
Personnalisation des programmes d'installation de mise à jour
pour plus d'informations et d'exemples sur le paramètre baselinePath.
logDetail=warn Niveau de détail de la journalisation. La va leur par défaut est
info
. Valeurs accep tées :
● error
● warn
● info
● debug
● trace
Mode de l'outil Les valeurs acceptées sont les suivantes :
● 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 personnalisa tion.
action=validate
Informations associées
Démarrage rapide pour la plateforme de Business Intelligence (Windows)
[page 14]
Démarrage rapide pour la plateforme de Business Intelligence (Unix ou Linux)
[page 15]
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 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.
40
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
3.8.1 FAQ au sujet des programmes d'installation de mise à jour
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 B > Plateforme SBOP BI (anciennement SBOP Enterprise) > SBOP BI PLATFORM
(ENTERPRISE) > SBOP BI PLATFORM 4.1 > Versions de composants logiciels compris > SBOP BI
PLATFORM SERVERS 4.1 >
<plateforme>
.
4. 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 que le 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
[page 19] et dans
[page 38] avec certaines modifications apportées à la commande de ligne et au fichier de configuration. Voir
Personnalisation de programmes d'installation de mise à jour
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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
41
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 principal, comme la plateforme
SAP BusinessObjects Business Intelligence Support Package 4 (installation complète) à l'aide des instructions de
Démarrage rapide pour la plateforme de Business Intelligence (Windows)
[page 14] et que le programme d'installation non personnalisée 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 sur
https:// service.sap.com/bosap-support
.
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 :
42
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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 19] et
[page 38] 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 initial complet <cloneProduct> utilisé lors de la personnalisation du package d'installation principale que vous mettez à jour, sans modifications. Vous ne devez pas ajouter ou supprimer de fonctionnalités dans l'élément <cloneProduct>, car cela pourrait entraîner 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 de la commande baselinePackages.
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
ID et codes pour la personnalisation de la plateforme de BI
[page 45] 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 Support Packages et les correctifs 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 :
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
43
product.boe64.patch4.x.x.xcore32
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.patch4.1.0.1core32. 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.patch4.1.0.1core32">
...
</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 pointvirgule (; - 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\
\SP5\
\SP5 Patch 1\
Définissez le paramètre baselinePath sur le dossier racine : baselinePath=C:\productUpdates\4.0\
44
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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 ID et codes pour la personnalisation de la plateforme de
BI
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
IntegratedTomcat :
<removeFeature id="WebTier"/>
● ○ root : (Supprimer toutes les fonctionnalités)
○ WebTier : (Supprimer tous les composants de niveau Web répertoriés ci-dessous)
○ JavaWebApps1 Applications Web Java
○ IntegratedTomcat (Installer le serveur d'applications Web Tomcat fourni)
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
45
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 (Supprime le serveur de base de données Sybase SQL Anywhere fourni)
○ PlatformServers.EventServer
○ 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 : (Supprime 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 : (supprime tous les composants Analysis répertoriés cidessous)
○ MultidimensionalAnalysisServices (MDAS)
○ BExWebApplicationsService
○ CrystalReportsServers : (Supprime 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 : (Supprime tous les composants Web Intelligence répertoriés ci-dessous)
○ WebIProcServer (Traitement Web Intelligence)
○ WebISchedulingServices (Planification Web Intelligence)
○ XcelsiusServers (Dashboards)
○ MobileServices
○ MobileServers
46
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
○ MobileAddon (Plug-in de CMS pour mobile)
○ IntegrationServers : (Supprime tous les composants d'intégration répertoriés ci-dessous)
○ BWPublisherServer (Prise en charge de l'authentification SAP BW et de SAP BW
Publisher)
○ MultitenancyManager
○ AdministratorTools : (Supprime tous les outils d'administration répertoriés ci-dessous)
○ UpgradeManager (Outil de gestion de mise à niveau)
○ DeveloperTools : (Supprime tous les composants d'outils de développement répertoriés ci-dessous)
○ BOE64bitNETSDK (SDK .NET de la plateforme SAP BusinessObjects Business Intelligence 64 bits)
○ DataAccess (Supprime tous les composants d'accès à la base de données répertoriés ci-dessous)
Remarque
Ne supprimez pas chaque composant d'accès à la base de données. Vous devez laisser au moins un composant d'accès à la base de données afin que le serveur de connexion soit lancé et fonctionne correctement.
○ 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
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
47
○ DataAccess.XMLWebServices
○ DataAccess.OData
○ DataAccess.Excel
○ 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 de 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 de sources de données)
Informations associées
Suppression de fonctionnalités
48
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
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.
Table 6 : ID des unités de déploiement de raccourci
ID de l'unité de déploiement de raccourci product.businessobjects64.shortcut.wde ploy4.0core
Cible du raccourci
WDeploy product.businessobjects64.shortcut.ccm4.0 core product.businessobjects64.shortcut.cmc4.0 core
Central Configuration Manager
Central Management Console product.businessobjects64.shortcut.info view4.0core
Zone de lancement BI (InfoView) product.businessobjects64.shortcut.odbc4.0 core
Administrateur de source de données 32 bits
Documentation en ligne product.businessobjects64.shortcut.online doc4.0core product.businessobjects64.shortcut.tom cat4.0core
Apache Tomcat.
product.businessobjects64.shortcut.up grade4.0core product.businessobjects64.shortcut.wacs.in foview4.0core
Outil de gestion de mise à niveau
Serveurs WACS stockés dans InfoView product.businessobjects64.shortcut.wacs4.0 core
Serveur conteneur d'applications Web
Informations associées
Personnalisation des raccourcis du menu Démarrer de Windows (Windows uniquement)
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"/>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
49
Table 7 : Chaînes couramment modifiées
ID de chaîne product.boe64_name
product.boe64_shortname
product_version product_majorversion
Description
Nom long du produit
Nom court du produit
Version du produit
Version principale du produit
Informations associées
Personnalisation du nom du produit et du numéro de version
[page 21]
3.9.4 Codes langue
L'outil de personnalisation SAP BusinessObjects utilise ces codes langue pour représenter les langues prises en charge : langue
Anglais
Tchèque
Danois
Code
EN
CS
DA
NL
FI
Néerlandais
Finnois
Français
Allemand
Hongrois
Italien
Japonais
Coréen
FR
DE
HU
IT
JA
KO
NB
PL
Norvégien (Bokmål)
Polonais
Portugais
Roumain
Russe
Chinois simplifié
PT
RO
RU zh_CN
50
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
langue
Slovaque
Espagnol
Suédois
Thaï
Chinois traditionnel turc
Code
SK
ES
SV
TH zh_TW
TR
Informations associées
Personnalisation du nom du produit et du numéro de version
Personnalisation des raccourcis du menu Démarrer de Windows (Windows uniquement)
Personnalisation de l'utilitaire Ajout/Suppression de programmes de Windows (Windows uniquement)
[page 26]
Suppression de packs linguistiques
[page 32]
Personnalisation du contrat de licence
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.
Table 8 : ID d'écran d'installation et propriétés associées
Titre de l'écran d'installation
ID de l'écran d'installa tion
ID de propriété
Vérifier les prére quis
CheckPreRequisi tes.dialog
Non applicable
Sélectionner la lan gue du programme d'installation
SelectUILan guage.dialog
SortedAvailableSetu pLanguages
Valeur(s) de propriété autorisée(s)
Non applicable
Ensemble de codes langue sous les quels peut être exécuté le pro gramme d'installation, "en:ja", par exemple
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 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'installa tion
ID de propriété
SetupUILanguage
Valeur(s) de propriété autorisée(s)
Code langue unique représentant la langue sous laquelle sera exécuté le programme d'installation, "en", par exemple
Non applicable
Bienvenue dans l'Assistant d'instal lation...
ShowWelcome
Screen.dialog
Contrat de licence
ShowLicenseAgree ment.dialog
Configurer l'enre gistrement du pro duit
EnterProduct
Key.dialog
Sélectionner les packs linguistiques
Sélectionner un type d'installation
Configurer le dos sier de destination
Sélectionnez la base de données existante ou la base de données par défaut
Installation éten due
ChooseInstall
Dir.dialog
SelectData
Source.dialog
ExpandInstallMes sage.dialog
Sélectionner le ser veur d'applications
Web Java
ChooseWebAppSer ver.dialog
InstallDir
SelectIntegratedDa tabase
Non applicable
WebAppServerType
Sélection des fonc tions
SelectFeatu res.dialog
Sélectionner le contrôle de version
SelectLCM.dialog
Sélectionner Nou velle installation ou
SelectLanguage
Pack.dialog
ChooseInstall
Type.dialog
ChooseExpandIns tall.dialog
Non applicable
Non applicable
RegisteredUser
RegisteredCompany
ProductKey
SelectedLanguage
Packs
InstallType
Non applicable
NewOrExistingLCM
NewOrExpandInstall
Non applicable
Nom d'utilisateur
Nom de l'entreprise
Code clé du produit
L'ensemble des packs linguistiques à installer, "en:ja", par exemple.
Pour une liste des codes langue, voir
● par défaut (Complète)
● personnalisé
● webtier
Dossier d'installation
● 0 (Utiliser une base de données existante)
● 1 (Installer et utiliser la base de données par défaut)
Non applicable
● tomcat
● manuel
● wacs
Non applicable
● existante
● nouvelle
● nouvelle
● étendue
52
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Titre de l'écran d'installation
Installation éten due
ID de l'écran d'installa tion
Configurer Subver sion
SetLCMConfig.dia log
ID de propriété
LCMName
LCMPort
LCMUserName
LCMPassword
LCMPasswordConfirm
GetSIAInfo.dialog
SIAPort
SIAName
Configurer le Ser ver Intelligence
Agent (SIA)
Configurer le Cen tral Management
Server (CMS)
Configurer le compte CMS
GetCMSInfo.dialog
GetCMSPass word.dialog
CMSPort
CMSPassword
CMSPasswordConfirm
ClusterKey
ClusterKeyConfirm
Configurer Sybase
SQL Anywhere
Sélectionner Dé marrage automati que du serveur
GetSQLAnywhe reInfo.dialog
ChooseToEnableSer vers.dialog
SQLAnywhereServer
Name
SQLAnywherePort
SQLAnywhereAdmin
Password
EnableServers
Valeur(s) de propriété autorisée(s)
Nom du référentiel
Port du référentiel
Utilisateur du référentiel
Mot de passe du référentiel
Confirmer le mot de passe
Port du SIA
Nom du nœud
Tout numéro de port valide
Mot de passe du CMS
Mot de passe du CMS
Clé de cluster du CMS
Clé de cluster du CMS
Nom du serveur SQL Anywhere
(Unix et Linux uniquement)
Port SQL Anywhere
Mot de passe de l'administrateur
SQL Anywhere (le nom d'utilisateur est dba)
● 0 (Arrêter les serveurs lors de l'installation)
● 1 (Démarrer les serveurs lors de l'installation)
Configurer Tomcat ● ShowTomca tInfo.dialog
● GetTomca tInfo.dialog
Les deux ID de boîte de dialogue doivent être in clus au fichier de confi guration afin de suppri mer l'écran Configurer
Tomcat. En d'autres ter
TomcatConnectionPort Port de connexion
TomcatShutdownPort Port d'arrêt
TomcatRedirectPort
Port de redirection
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 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'installa tion
ID de propriété Valeur(s) de propriété autorisée(s)
Sélectionner un type de base de données d'audit existant
mes, vous devez inclure deux éléments remo veDialog dans votre fi chier de configuration.
Sélectionner la connexion à l'agent
Solution Manager
Diagnostics (SMD)
SelectSMDInte grate.dialog
Configurer la con nexion à l'agent
SMD
Sélectionnez la connexion à Intro scope Enterprise
Manager
ConfigureSMDA gent.dialog
SelectIntrosco peIntegrate.dialog
ChooseSMDIntegration ● nointegrate (Ne pas intégrer)
SMDAgent_HOST
SMDAgent_PORT
ChooseIntroscopeIn tegration
● integrate (Intégrer)
Hôte de l'agent SMD
Port de l'agent SMD
● nointegrate (Ne pas intégrer)
● integrate (Intégrer)
Configurer la con nectivité à Intro scope Enterprise
Manager
Configurer le port d'écoute HTTP
ConfigureIntro scope.dialog
Introscope_ENT_HOST Nom de l'hôte d'Introscope
Introscope_ENT_PORT Numéro du port d'Introscope
Introscope_ENT_HOST
Hôte d'Enterprise Manager
Introscope_ENT_PORT
Port d'Enterprise Manager
Introscope_ENT_INS
TRUMENTATION
GetWACSPort.dialog WACSPort
Définissez-le sur true pour indiquer que vous avez configuré cet écran d'installation
Numéro de port pour le service con teneur d'applications Web
SelectAuditData base.dialog
UsingAuditDBType
● sybase
● db2
● oracle
● mysql
● mssql
● maxdb
● aucun
Sélectionner le type de base de données du CMS existant
SelectCMSData base.dialog
UsingCMSDBType
● sybase
● db2
● oracle
● mysql
● mssql
● maxdb
54
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Titre de l'écran d'installation
ID de l'écran d'installa tion
Informations sur le déploiement du
CMS existant
SetRemoteCM
SInfo.dialog
ID de propriété
RemoteCMSName
RemoteCMSPort
Valeur(s) de propriété autorisée(s)
Nom du CMS existant
Numéro de port pour le CMS exi stant
RemoteCMSAdminName Nom d'utilisateur de l'administrateur
RemoteCMSAdminPass word
Mot de passe de l'administrateur
La plateforme SAP
BusinessObjects
Business Intelli gence a été instal lée
ShowInstallComple teLaunchWDe ploy.dialog
LaunchWDeploy
● 0 (Ne pas lancer l'outil WDeploy après l'installation)
● 1 (Lancer automatiquement l'outil WDeploy après l'installa tion)
Configurer la base de données d'audit
- DB2
ExistingAu ditDB2.dialog
ExistingAuditingDB
Server
ExistingAuditingDBU ser
ExistingAuditingDB
Password
Configurer la base de données du ré férentiel CMS -
SQL Anywhere
(ODBC)
ExistingCMSSQLA nywhere.dialog
ExistingCMSDBDSN
ExistingCMSDBUser
ExistingCMSDBPass word
Configurer la base de données d'audit
- SQL Anywhere
( ODBC)
ExistingAuditSQLA nywhere.dialog
ExistingAuditingDB
Database
ExistingAuditingDBU ser
Configurer la base de données d'audit
- MaxDB
ExistingAudit
MaxDB.dialog
ExistingAuditingDB
Password
ExistingAuditingDB
Database
ExistingAuditingDBU ser
ExistingAuditingDB
Password
ExistingAuditingDB
Port
ExistingAuditingDB
Server
Nom d'alias DB2
Nom d'utilisateur
Mot de passe
Nom de la source de données
Nom d'utilisateur pour la base de données existante
Mot de passe de l'utilisateur
Nom de la base de données d'audit existante
Nom d'utilisateur pour la base de données existante
Mot de passe de l'utilisateur
Nom de la base de données d'audit existante
Nom d'utilisateur pour la base de données existante
Mot de passe de l'utilisateur
Numéro de port pour la base de don nées existante
Nom du serveur MaxDB
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
55
Titre de l'écran d'installation
ID de l'écran d'installa tion
Configurer la base de données d'audit
- SQL Server
(ODBC)
ExistingAu ditMSSQL.dialog
ID de propriété
ExistingAuditingDB
Database
ExistingAuditingDB
Server
Valeur(s) de propriété autorisée(s)
Nom de la base de données SQL
Nom du serveur SQL
ExistingAuditingDBU ser
ExistingAuditingDB
Password
ExistingAuditingDBU seTrustedConnection
ExistingAudi tingDBDSN
Nom d'utilisateur
Mot de passe
Utiliser la connexion sécurisée
Nom de la source de données
Configurer la base de données d'audit
- MySQL
ExistingAudit
MySQL.dialog
ExistingAuditingDBS howSysDB
ExistingAuditingDB
Database
ExistingAuditingDBU ser
ExistingAuditingDB
Password
Afficher la base de données système
Nom de la base de données d'audit
Nom d'utilisateur
Mot de passe
Configurer la base de données d'audit
- Oracle
ExistingAuditOra cle.dialog
ExistingAuditingDB
Port
ExistingAuditingDB
Server
ExistingAuditingDBU ser
ExistingAuditingDB
Password
Port MySQL
Serveur MySQL
Nom d'utilisateur
Mot de passe
Configurer la base de données d'audit
- Sybase
ExistingAuditSy base.dialog
ExistingAuditingDB
Server
ExistingAuditingDBU ser
ExistingAuditingDB
Password
ExistingAuditingDB
Server
Oracle TNSNAME
Nom d'utilisateur
Mot de passe
Nom du service Sybase
Configurer la base de données du ré
Exi stingCMSDB2.dialog
ExistingCMSDBServer
Nom d'alias DB2
ExistingCMSDBUser
Nom d'utilisateur
56
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Titre de l'écran d'installation
férentiel CMS -
DB2
ID de l'écran d'installa tion
ID de propriété
ExistingCMSDBPass word
Valeur(s) de propriété autorisée(s)
Mot de passe
ExistingCMSDBReset
● 0 (Ne pas réinitialiser la base de données existante)
● 1 (Réinitialiser la base de don nées existante)
Configurer la base de données du ré férentiel du CMS -
MaxDB
ExistingCMS
MaxDB.dialog
ExistingCMSDBServer Nom de la base de données du CMS
ExistingCMSDBUser
ExistingCMSDBPass word
ExistingCMSDBReset
Nom d'utilisateur
Mot de passe
● 0 (Ne pas réinitialiser la base de données existante)
● 1 (Réinitialiser la base de don nées existante)
Configurer la base de données du ré férentiel CMS -
SQL Server
ExistingCMSDBData base
Serveur MaxDB
Exi stingCMSMSSQL.dia log
ExistingCMSDBPort
ExistingCMSDBServer
ExistingCMSDBUser
Port MaxDB
Nom du serveur existant
Nom d'utilisateur
ExistingCMSDBPass word
Mot de passe
ExistingCMSDBReset
● 0 (Ne pas réinitialiser la base de données existante)
● 1 (Réinitialiser la base de don nées existante)
Configurer la base de données du ré férentiel CMS -
MySQL
ExistingCMS
MySQL.dialog
ExistingCMSDBData base
Nom de la base de données du CMS
ExistingCMSDBUse
TrustedConnection
ExistingCMSDBDSN
Utiliser la connexion sécurisée
ExistingCMSDBShow
SysDB
Nom de la source de données
Afficher la base de données système
ExistingCMSDBServer Serveur MySQL
ExistingCMSDBUser
Nom d'utilisateur
ExistingCMSDBPass word
Mot de passe
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
57
Titre de l'écran d'installation
Configurer la base de données du ré férentiel CMS -
Oracle
ID de l'écran d'installa tion
ID de propriété
ExistingCMSDBReset
ExistingCMSOra cle.dialog
Valeur(s) de propriété autorisée(s)
● 0 (Ne pas réinitialiser la base de données existante)
● 1 (Réinitialiser la base de don nées existante)
ExistingCMSDBData base
Nom de la base de données du CMS
ExistingCMSDBPort Port MySQL
ExistingCMSDBServer Oracle TNSNAME
ExistingCMSDBUser
ExistingCMSDBPass word
Nom d'utilisateur
Mot de passe
ExistingCMSDBReset
● 0 (Ne pas réinitialiser la base de données existante)
● 1 (Réinitialiser la base de don nées existante)
Configurer la base de données du ré férentiel CMS - Sy base
Configurer Subver sion
ExistingCMSSy base.dialog
SetLCMConfig.dia log
ExistingCMSDBServer
Nom du service Sybase
ExistingCMSDBUser
ExistingCMSDBPass word
Nom d'utilisateur
Mot de passe
ExistingCMSDBReset
LCMName
LCMPort
LCMUserName
LCMPassword
LCMPasswordConfirm
La plateforme SAP
BusinessObjects
Business Intelli gence a été instal lée
ShowInstallCom plete.dialog
La plateforme SAP
BusinessObjects
Business Intelli gence a été instal lée
ShowInstallComple teMultiCheck box.dialog
Non applicable
LaunchWDeploy
Réinitialiser la base de données exi stante
Nom du référentiel
Port du référentiel
Utilisateur du référentiel
Mot de passe
Confirmer le mot de passe
Non applicable
● 0 (Ne pas lancer l'outil WDeploy après l'installation)
● 1 (Lancer automatiquement l'outil WDeploy après l'installa tion)
58
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
Titre de l'écran d'installation
ID de l'écran d'installa tion
ID de propriété
LaunchSSW
ViewLogButton
Commencer l'ins tallation
Etapes de post-in stallation
ShowInstallSum mary.dialog
ShowPostIns tall.dialog
Confirmation de désinstallation
VerifyToRe move.dialog
La plateforme SAP
BusinessObjects
Business Intelli gence a été désin stallée
ShowUninstallCom plete.dialog
Non applicable
Non applicable
Non applicable
Non applicable
Informations associées
Personnalisation de la saisie utilisateur
[page 28]
Suppression d'écrans d'installation
Valeur(s) de propriété autorisée(s)
● 0 (Ne pas lancer l'Assistant de configuration du système après l'installation)
● 1 (Lancer automatiquement l'Assistant de configuration du système après l'installation)
● 0 (Ne pas afficher le fichier jour nal après l'installation)
● 1 (Afficher automatiquement le fichier journal après l'installa tion)
Non applicable
Non applicable
Non applicable
Non applicable
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation du programme d'installation de la plateforme de Business Intelligence
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
59
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 de la plateforme de BI 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.
60
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
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
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
61
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
\WEBINF\classes
JSAPIproperties.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\Tomcat\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.
62
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
Remarque
Ce démarrage rapide décrit une 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\WEBINF\eclipse\plugins
\com.businessobjects.webpath.InfoViewBranding.jarpar 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 METAINF dans com.businessobjects.webpath.InfoViewBranding.jar : jar cf com.businessobjects.webpath.InfoViewBranding.jar web METAINF
6. Créez un sous-dossier nommé OEMZips sous : \dunit\product.businessobjects64.oemzips4.0 corenu
7. Ajoutez template.zip au dossier \OEMZips.
Votre fichier zip se trouve désormais sous : \dunit\product.businessobjects64.oemzips4.0core 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 :
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
63
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.
64
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
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 de votre zone de lancement BI.
Remarque
Le style 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.
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
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
65
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.
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.
66
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
1. Copiez le fichier BIlaunchpad.properties de
<REPINSTALL>
\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEBINF
\config\default vers
<REPINSTALL>
\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEBINF
\config\custom
Remarque
Ne modifiez pas les fichiers du dossier default. Effectuez toujours vos modifications sur des copies des fichiers stockées 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. Redéployez BOE.war sur votre serveur d'applications Java.
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 BI
Personnalisation d'applications Web
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
67
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 montre comment personnaliser le visualiseur de rapport inclus dans le déploiement de la plateforme de BI.
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
68
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
● 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é : template.zip
SAP
BusinessObjectsEnterprise XI 4.0\warfiles
\webapps\BOE\WEB_INF\eclipse\plugins
\com.businessobjects.webpath.CrystalReport
s_oem.jar
Modifier
Décompressez le fichier .zip et modifiez-le.
Dans le fichier com.businessobjects.webpath.CrystalReports_oem.jar, modifiez les éléments suivants :
CrystalReports_oem.jar
\web
Modifier
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.
\WEBINF\classes\JSAPIproperties.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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
69
CrystalReports_oem.jar
Modifier
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
]
}
Remarque
Tous les fichiers auxquels fait référence le fichier JSAPI properties.json
doivent être inclus dans le dossier
\web .
70
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation d'applications Web
5 Personnalisation de SAP Crystal
Reports 2011
5.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 SAP Crystal Reports 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 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.
5.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
Téléchargement du programme d'installation
[page
72].
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
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
71
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.
5.3 Téléchargement du programme d'installation
1. Accédez à
https://service.sap.com/bosap-support
> 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
72
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
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 correctifs, voir
Personnalisation des programmes d'installation de mise à jour
5.4 Planification du processus de personnalisation
Pour utiliser l'outil de personnalisation SAP BusinessObjects :
1. Téléchargez le programme d'installation. Voir
Téléchargement du programme d'installation
[page 72].
2. Décidez quelles personnalisations sont nécessaires. Voir
Création du fichier de configuration
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.
5.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 :
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
73
● 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.
Informations associées
Paramètres de ligne de commande
[page 95]
5.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
74
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
○ 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
● 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
5.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.crystalreports4.0core32">
...
...
</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
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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
75
● 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.
● 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.crystalreports4.0core32">
<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.arp4.0core">
<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>
5.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.
5.5.2.1 Personnalisation du nom du produit et du numéro de version
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.
76
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
Table 9 : Nom du produit et numéro de version
Description de la chaîne ID de chaîne
Nom long du produit product.cr_name
Nom court du produit
Version du produit product.cr_shortname
product_cr_version
Version principale du produit product_cr_majorversion
Valeur par défaut
Crystal Reports
Crystal Reports
2011
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
[page 106].
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é :
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
77
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.crystalre ports4.0core32\se tup.ui.framework\uitext
\CrystalReports\pro duct.lang_<code langue>.ui text.xml
<string id="productname_patch" <string id="product value=" FP3"/> name_patch" value=""/> dunit\product.crystalre ports4.0core32\se tup.ui.framework\uitext
\framework\setup.ui.frame work.lang_<code langue>.ui text.xml
<string id="product_patch" va lue="FP3"/>
<string id="pro duct_patch" value=""/>
Comme ci-dessus <string id="product_patch_pre space" value=" FP3"/>
<string id="pro duct_patch_prespace" va lue=""/>
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
[page 106]. 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 :
78
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
5.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 duSourceId
Valeur
ID d'unité de déploiement du raccourci à modifier. Les valeurs classiques sont :
● product.crystalreports.shortcut.crw4.0core
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
79
Attribut linkFullPath description
Valeur
Crystal Reports 2011
● product.crystalreports.shortcut.odbc4.0core
Administrateur de source de données ODBC
● product.crystalreports.shortcut.rptpubwiz4.0core
Assistant de téléchargement de rapports
Pour obtenir la liste complète des valeurs duSourceId, voir
ID des unités de déploie ment de raccourci
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 correcte ment.
Vous pouvez spécifier un lien par langue. Pour obtenir une liste des codes de langue, voir
[page 106].
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.
80
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
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 83].
<shortcut duSourceId="product.crystalreports.shortcut.crw4.0 core">
<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.odbc4.0 core">
<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.rptpubwiz4.0 core">
<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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
81
Dans cet exemple, le dossier d'installation a été redirigé vers le disque C:\.
<shortcut duSourceId="product.crystalreports.shortcut.rptpubwiz4.0 core">
<arg id="linkFullPath" value="[programmenufolder]\Custom Wizard\Report Upload
Wizard.lnk" lang="all"/>
<arg id="description" value="Launch Custom Wizard" lang="all"/>
</shortcut>
5.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.arp4.0core">
<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
[page 106].
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.arp4.0core32\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.
82
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
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.arp4.0core">
<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 :
5.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"/>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
83
5.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 107].
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 :
84
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
5.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
107].
Exemple
Cet exemple montre comment supprimer l'écran d'installation intitulé Sélection des fonctions.
<removeDialog id="SelectFeatures.dialog"/>
5.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 XXXXXXXXXXXXXXXXXXXXXXXXXXXX.
Utilisez l'élément removeDialog avec id="CREnterProductKey.dialog" pour supprimer l'écran d'installation demandant la clé de licence.
<replaceProperty id="ProductKey" defaultValue="XXXXXXXXXXXXXXXXXXXXXXXXXXXX"/>
<removeDialog id="CREnterProductKey.dialog"/>
Informations associées
ID d'écran d'installation et de propriété
[page 107]
Personnalisation de la saisie utilisateur par défaut
[page 84]
Suppression d'écrans d'installation
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
85
5.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
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"/>
5.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"/>
5.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
86
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
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
[page 106].
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"/>
5.5.9 Modification des ressources
Le programme d'installation stocke des fichiers image et texte comme ressources dans ce dossier : dunit\product.crystalreports4.0core32\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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
87
Informations associées
Personnalisation des images dans le programme d'installation
Personnalisation du contrat de licence
[page 89]
5.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.crystalreports4.0core32\setup.ui.framework\resources
Table 10 : Fichiers image dans le dossier resources
Nom de l'image Nom du fichier Image par défaut
Ecran d'accueil dialogFull.bmp
Image supérieure pour tous les écrans dialogTop.bmp
Panneau d'informa tions pour la boîte de dialogue de pro gression 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.
88
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
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"/>
Informations associées
5.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.crystalreports4.0core32\setup.ui.framework\resources\<code langue>
Par exemple, le contrat de licence en anglais se trouve ici : dunit\product.crystalreports4.0core32\setup.ui.framework\resources\en
\license_en.rft
Pour obtenir une liste des codes de langue, voir
[page 106].
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.crystalreports4.0core32\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"/>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
89
Informations associées
5.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"/>
Table 11 : Description des éléments du dossier Collaterals
Dossier
Collaterals > Add
Ons > SAP
Collaterals > Cus tomizationTemplate
Description
Fournit la connectivité aux systèmes
SAP.
Contient le fichier d'exemple tem plate.zip pour les personnalisations du concepteur de rapports.
Quand supprimer
Supprimez ce dossier s'il n'y a aucun be soin de connexion aux systèmes SAP.
Supprimez ce dossier si les clients n'ont pas besoin de fournir un fichier d'exemple template.zip.
Collaterals > Docs
Documentation dans toutes les langues prises en charge par Crystal Reports.
Supprimez toutes les langues qui ne sont pas incluses au programme d'installation
90
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
Dossier Description Quand supprimer personnalisé. Pour obtenir une liste des codes de langue, voir
[page
106].
Collaterals > Tools
> CustomizationTool
Objet de personnalisation SAP Busines sObjects.
Supprimez ce dossier si les clients n'ont pas besoin de personnaliser leurs pro grammes d'installation.
5.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.
5.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 94].
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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
91
5.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 94].
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
[page 106].
Conseil
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.
5.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é
ProductName
CrystalReportHelp
AboutCrystalReport
Description
Nom du produit
Aide du produit
A propos de l'aide du produit
Emplacement
Titre de la fenêtre
Menu Aide
Menu Aide
Valeur par défaut
SAP Crystal Reports
Aide SAP Crystal Reports
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 :
92
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
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
[page 106].
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
Déploiement du fichier de personnalisation OEM
[page 94].
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="UTF8"?>. 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>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
93
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>
5.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 :
Fichier personnalisé splash.bmp
Emplacement dans template.zip
SAP BusinessObjects Enter prise XI 4.0\win32_x86 start.html (pour l'anglais) crw_oem_res_en.xml
SAP BusinessObjects Enter prise XI 4.0\win32_x86\Start Page\en
SAP BusinessObjects Enter prise XI 4.0\win32_x86
3. Copiez le fichier compressé à l'emplacement suivant : dunit\product.crystalreports.oemzips4.0corenu\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
94
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
5.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
Téléchargement du programme d'installation
● 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
5.7.1 Paramètres de ligne de commande
Table 12 : Paramètres obligatoires
Paramètre Description
xml
Chemin d'accès complet au fichier de configura tion.
Le fichier de configuration pour le programme d'installation complète peut avoir n'importe quel nom.
packageDir
Chemin d'accès complet au dossier contenant le programme d'installation que vous modifiez.
Exemple xml=C:\SAPCustomTool\oem.xml
packageDir=C:\SAPCustomTool\pac kages
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
95
Paramètre
outputDir
Description Exemple
Le programme d'installation est téléchargé à par tir du SAP Service Marketplace en vue de démar rer l'installation de SAP Crystal Reports. Il con tient les dossiers Collaterals, dunit, langs et setup.engine ainsi que d'autres fichiers binai res.
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\out put
Table 13 : Paramètres facultatifs
Paramètre Description
baselinePath
Exemple
Chemin complet du dossier racine conte nant les versions d'origine non personnali sées de l'ensemble des programmes d'ins tallation complets et de mises à jour que vous avez personnalisés.
Utilisez un point-virgule (;) pour séparer les dossiers racine.
Supposez que vous souhaitiez personnali ser SAP Crystal Reports 2011 Support
Package 5 et que vous ayez personnalisé les précédents programmes : 2011 (in stallation complète), 2011 SP4.
Personnalisez 2011 Support Package 5, et fournissez le chemin du dossier racine vers les packages non personnalisés pour la version majeure 2011 et la version Sup port Package 4. Par exemple, si les packa ges non personnalisés sont contenus dans la structure de répertoire suivante :
C:\productUpdates\2011\
\2011 Full\
\SP4\
logDetail
définissez la valeur sur baseline
Path=C:\productUpdates\2011\
Voir
Personnalisation des programmes d'installation de mise à jour
[page 97] pour plus d'informations et d'exemples sur le paramètre baselinePath.
Niveau de détail suivi dans le fichier journal.
La valeur par défaut est info. Les valeurs suivantes sont acceptées :
● error
● warn
● info
● debut
● trace logDetail=warn
96
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
Paramètre
action
Description Exemple
Mode de l'outil Les valeurs suivantes sont acceptées :
● 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 personnalisa tion.
action=validate
Informations associées
Démarrage rapide pour Crystal Reports
5.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.
5.8.1 FAQ au sujet des programmes d'installation de mise à jour
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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
97
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
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 99] 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.
98
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
5.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 71], 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 76].
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.
5.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 95] 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.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
99
● 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
ID et codes pour la personnalisation de Crystal Reports
[page 102] 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.patch4.x.x.xcore32
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.patch4.1.0.1core32. 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.patch4.1.0.1core32">
...
</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
100
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
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 pointvirgule (;) 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\
Informations associées
Paramètres de ligne de commande
[page 95]
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
101
5.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é
5.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
Table 14 : Accès aux données
ID de fonctionnalité
DataAccess
Access
ADO.NET
BDE
Btrieve
COMData
Comm_Rep
DB2 dBase
Exchange
FieldDefinitions
FileSystem
Description
Accès aux données
Microsoft Access
ADO.NET
DLL de base de données IDAPI
Pilote de base de données Pervasive
Fournisseur de données COM
Commande dans le référentiel
IBM DB2 dBase
Microsoft Exchange
Définitions des champs
Système de fichiers
102
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
ID de fonctionnalité
HPNeoview
Informix
JavaData
JDBC
MicrosoftOutlook
MyCube
MYSQL_DataAccess
NCRTeradata
NETEZZA
NTEventLog
OLE_DB_Data
OptionalDataDirectODBC
Oracle
Progress.OpenEdge
RDO
SFORCE
SIEBEL
Sybase
SymantecACT
Univers
UWSC
WebActivityLog
XML
Table 15 : Intégration du système Enterprise
ID de fonctionnalité
IntegrationOptions
EBS
JDE
PSFT
SAP
SIEBEL
Description
HP Neoview
Informix
Java Data Provider
Pilote de données JDBC (JNDI)
Microsoft Outlook
Cube OLAP
MySQL
NCRTeradata
NETEZZA
Journal des événements NT
Données OLE DB
ODBC DataDirect
Oracle
Progress OpenEdge
ODBC RDO
Salesforce.com Driver
Siebel
Sybase
ACT!
Univers BusinessObjects
Connecteur universel pour services Web
Journal des activités Web
Pilote XML
Description
Options d'intégration
Oracle E-Business Suite
JD Edwards EnterpriseOne
Peoplesoft Enterprise
Solutions SAP
Siebel
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
103
Table 16 : Prise en charge de l'exportation
ID de fonctionnalité
Application
CharacterSeparated
CrystalReports
DiskFile
Excel
ExchangeFolders
HTML
LegacyXMLExport
LotusNotes
LotusNotesMail
ODBC
Record
ReportDefinition
RichTextFormat
Texte
WordforWindows
XMLExport
Table 17 : Autre
ID de fonctionnalité
CrystalReportsRoot crw
Mappage
MicrosoftMail
PGEditor
UploadWizard
Informations associées
Suppression de fonctionnalités
104
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Description
Exportation vers une application
Format délimité par des caractères
Format Crystal Reports
Exportation vers un fichier
Format Microsoft Excel 97-2003
Dossier Exchange
Formats HTML 3.2 et HTML 4.0 (DHTML)
Format XML antérieur
Document Lotus Notes
Lotus Domino
Exportation vers n'importe lequel de vos formats
ODBC installés
Format PDF
Format Style d'enregistrement
Format Définition de rapport
RTF
Formats texte
Format Microsoft Word 97-2003
Document XML
Description
Crystal Reports 2011
Crystal Reports Designer
Création de cartes géographiques
Destination de Microsoft Mail
Diagrammes personnalisés
Assistant de téléchargement de rapports
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
5.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.
Table 18 : ID des unités de déploiement de raccourci
ID de l'unité de déploiement de raccourci Cible du raccourci product.crystalreports.shortcut.crw4.0core Crystal Reports 2011 product.crystalreports.shortcut.odbc4.0 core
Administrateur de source de données ODBC product.crystalreports.shortcut.rptpub wiz4.0core
Assistant de téléchargement de rapports
Informations associées
Personnalisation des raccourcis du menu Démarrer de Windows
[page 79]
5.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"/>
Table 19 : Chaînes couramment modifiées
ID de chaîne product.cr_name
product.cr_shortname
product_cr_version product_cr_majorversion
Description
Nom long du produit
Nom court du produit
Version du produit
Version principale du produit
Informations associées
Personnalisation du nom du produit et du numéro de version
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
105
5.9.4 Codes langue
L'outil de personnalisation SAP BusinessObjects utilise ces codes langue pour représenter les langues prises en charge :
Langue
Anglais
Tchèque
Danois
Code
EN
CS
DA
NL
FI
Néerlandais
Finnois
Français
Allemand
Hongrois
Italien
Japonais
Coréen
FR
DE
HU
IT
JA
KO
NB
PL
Norvégien (Bokmål)
Polonais
Portugais
Roumain
Russe
Chinois simplifié
Slovaque
Espagnol
Suédois
Thaï
Chinois traditionnel turc
PT
RO
RU zh_CN
SK
ES
SV
TH zh_TW
TR
Informations associées
Personnalisation du nom du produit et du numéro de version
[page 76]
Personnalisation des raccourcis du menu Démarrer de Windows
[page 79]
Personnalisation de l'utilitaire Ajout/Suppression de programmes de Windows
Suppression de packs linguistiques
[page 86]
106
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
Personnalisation du contrat de licence
Personnalisation des chaînes de menu
5.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 :
<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"/>
Table 20 : ID d'écran
Titre de l'écran d'installa tion
Veuillez sélectionner une langue d'installation
ID de l'écran d'installation
SelectUILanguage.dialog
ID de propriété dans l'écran d'installation
SortedAvailableSetu pLanguages
SetupUILanguage
Valeurs de pro priété
Ensemble des co des langue repré sentant les lan gues d'installa tion prises en charge
Code langue uni que représentant la langue d'instal lation
Non applicable
Installation impossible
Choisissez un type d'instal lation
SharedAlwaysFailure.dia log
Non applicable
ChooseInstallType2.dialog
InstallType
Vérification des prérequis
Bienvenue dans l'Assistant d'installation...
Contrat de licence
Informations utilisateur
CheckPreRequisites.dialog
ShowWelcomeScreen.dialog
ShowLicenseAgreement.dia log
CREnterProductKey.dialog
Non applicable
Non applicable
Non applicable
RegisteredUser
● par défaut
(Standard)
● personna lisé
Non applicable
Non applicable
Non applicable
RegisteredCompany
Votre Nom d'utili
sateur
Nom de l'entre prise
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
107
Titre de l'écran d'installa tion
Spécifier le dossier de desti nation
ID de l'écran d'installation
ChooseInstallDir.dialog
ID de propriété dans l'écran d'installation
ProductKey
InstallDir
Sélection des langues
Sélection des fonctions
SelectLanguagePack.dialog
SelectedLanguage
Packs
SelectFeatures.dialog
Non applicable
SAP Crystal Reports 2011 a
été installé
ShowInstallComplete.dia log
SAP Crystal Reports 2011 a
été installé
ShowInstallComplete_Pat chUpdate.dialog
Non applicable
Non applicable
Commencer l'installation
Confirmation de désinstalla tion
ShowInstallSummary.dialog
Non applicable
VerifyToRemove.dialog
Non applicable
Option de service de mise à jour Web
ShowPrivacyStatement.dia log
DisableWebUpdateSer vice
Valeurs de pro priété
Votre Code clé du
produit
Chemin d'accès au dossier d'ins tallation
Tableau des co des langue
Non applicable
Non applicable
Non applicable
Non applicable
Non applicable
SAP Crystal Reports 2011 a
été désinstallé
ShowUninstallCom plete.dialog
Non applicable
● 0 (Activer le service de mise à jour
Web)
● 1 (Désactiver le service de mise à jour
Web)
Non applicable
108
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports 2011
6 Personnalisation de SAP Crystal Reports pour Enterprise
6.1 Introduction
SAP Crystal Reports pour Enterprise peut être réassemblé et vendu par des 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 SAP Crystal Reports pour Enterprise et son programme d'installation par le biais de modifications telles que :
● Réduction de la taille du produit
● Changement du nom du produit
● Modification des propriétés par défaut du programme d'installation
● Masquage d'écrans dans le programme d'installation
Pour réaliser des personnalisations, vous devez écrire un fichier de configuration pour spécifier les personnalisations, puis exécuter 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.
6.2 Démarrage rapide de Crystal Reports pour Enterprise
Cette section explique comment exécuter l'outil de personnalisation pour créer un programme d'installation personnalisé pour SAP Crystal Reports pour Enterprise. Les personnalisations incluent la modification du type d'installation par défaut, la suppression des écrans d'installation et le changement de nom du produit. A l'issue de ce didacticiel, vous pouvez exécuter votre package d'installation personnalisé et installer une version personnalisée de Crystal Reports pour Enterprise.
1. Configurez l'outil de personnalisation SAP BusinessObjects a) Créez le dossier de travail suivant sur votre ordinateur de développement : C:\SAPCustomTool
\packages b) Copiez le contenu du package d'installation de Crystal Reports pour Enterprise sous C:\SAPCustomTool
\packages.
Le programme d'installation contient les dossiers Collaterals, dunit, langs et setup.engine ainsi que d'autres fichiers binaires. Pour en savoir plus sur le téléchargement du programme d'installation,voir
Téléchargement du programme d'installation
c) Depuis le package d'installation de la plateforme de BI, copiez le dossier Collaterals\Tools et collezle sous le chemin C:\SAPCustomTool\packages\Collaterals.
Le dossier Tools contient l'outil de personnalisation SAP BusinessObjects que vous devez utiliser pour personnaliser Crystal Reports pour Enterprise. Pour en savoir plus sur le téléchargement du package
d'installation de la plateforme de BI, voir
Pour télécharger le programme d'installation du serveur
[page
16].
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
109
d) Créez le dossier suivant : C:\SAPCustomTool\output
Remarque
Ce dossier doit être vide pour que l'outil de personnalisation puisse fonctionner.
2. Créez le fichier de configuration.
a) Copiez-collez le code suivant dans un éditeur de texte :
<oem name="CustomCompanyCrystalReports">
<cloneProduct sourceId="product.crystalreportsjava4.0core32">
<! Remove the ProductKey dialog and set the default product key >
<removeDialog id="CREnterProductKey.dialog"/>
<replaceProperty id="ProductKey" defaultValue="PLEASE SET"/>
<! Set the default installation type to "Custom" >
<replaceProperty id="InstallType" defaultValue="custom"/>
<! Specify the languages to keep in the OEM package. All other language packs will be removed >
<languageIncludeList value="en;fr;de"/>
<! Update the product name in each language. Rebrands the UI dialog title. >
<! The value for the lang attribute can be a single language code,
"all", or a CSV "en;fr;ja" >
<replaceString id="product.crjava_name" value="Custom Company Crystal
Reports" lang="all"/>
<! Create a custom Windows Add/Remove Programs entry with a new display name and publisher >
<arp duSourceId="product.crystalreportsjava.arp4.0core">
<arg id="publisher" value="Custom Company"/>
<arg id="display_name" value="Custom Company Crystal Reports for
Enterprise" lang="all"/>
</arp>
<! Create a new Crystal Reports shortcut in the Start menu by specifying where you want it with the fullLinkPath argument. Set its tooltip description with the description argument >
<shortcut duSourceId="product.crystalreportsjava.shortcut4.0 core">
<arg id="linkFullPath" value="[programmenufolder]\Custom Company
\Custom CR for Enterprise.lnk" lang="en"/>
<arg id="description" value="Launch Custom CR for Enterprise" lang="en"/>
</shortcut>
</cloneProduct>
</oem> b) Enregistrez le fichier sous C:\SAPCustomTool\packages\Collaterals\Tools
\CustomizationTool\example_customization_win_cre.xml
3. Exécutez la commande suivante à partir de l'invite de commande : cd C:\SAPCustomTool\packages\Collaterals\Tools\CustomizationTool
Le dossier CustomizationTool contient un exécutable appelé customizationtool.exe ainsi que le fichier de configuration que vous avez créé à l'étape précédente
(example_customization_win_cre.xml).
110
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
4. Exécutez la commande suivante à partir de l'invite de commande : customizationtool.exe xml=example_customization_win_cre.xml packageDir=C:
\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDetail=error > 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 (C:\oemlog.log).
Assurez-vous que le package d'installation personnalisé a été créé dans le dossier C:\SAPCustomTool
\output. Veillez à ce qu'aucune erreur n'ait été consignée dans le fichier journal.
5. Utilisez C:\SAPCustomTool\output\setup.exe pour exécuter le programme d'installation personnalisé de Crystal Reports pour Enterprise.
Une fois que vous avez exécuté le programme d'installation, Crystal Reports pour Enterprise est installé avec les personnalisations décrites dans le fichier de configuration situé sous C:\SAPCustomTool\packages
\Collaterals\Tools\CustomizationTool\example_customization_win_cre.xml.
6.3 Téléchargement du programme d'installation
1. Accédez à
https://service.sap.com/bosap-support
et sélectionnez Software Downloads
(Téléchargements de logiciels).
2. Dans l'onglet Find your software (Recherchez votre logiciel), sous A-Z Index, sélectionnez Installations and
Upgrades (Installations et mises à niveau).
3. Sélectionnez B SBOP BI platform (former SBOP Enterprise) SBOP BI PLATFORM (ENTERPRISE) .
4. Sélectionnez SBOP BI Platform 4.1.
5. Sélectionnez Installation and Upgrade (Installation et mise à niveau) WINDOWS .
6. Sélectionnez l'objet intitulé SAP Crystal Reports for Enterprise 4.1
<version>
Windows (32B), puis suivez les instructions du site Web pour télécharger et extraire les objets.
Remarque
Le téléchargement du logiciel peut prendre un certain temps et il se peut que vous deviez contacter l'administrateur système pour vérifier que le pare-feu de votre entreprise n'interrompt pas le processus de téléchargement.
6.4 Planification du processus de personnalisation
Pour utiliser l'outil de personnalisation SAP BusinessObjects, réalisez les actions suivantes :
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
111
1. Téléchargez le programme d'installation SAP Crystal Reports pour Enterprise.
Pour en savoir plus, voir
Téléchargement du programme d'installation
2. Configurez l'outil de personnalisation SAP BusinessObjects en copiant le dossier Collaterals\Tools du programme d'installation de la plateforme de BI vers le sous-dossier Collaterals dans votre dossier de travail.
Pour en savoir plus sur le téléchargement du programme d'installation de la plateforme de BI, voir
Pour télécharger le programme d'installation du serveur
3. Décidez quelles personnalisations sont nécessaires.
4. Ecrivez le fichier de configuration pour spécifier les personnalisations.
Pour en savoir plus, voir
Création du fichier de configuration
[page 113].
5. Exécutez l'outil de personnalisation pour créer un programme d'installation personnalisé.
6. Exécutez le programme d'installation personnalisé pour installer une version personnalisée de SAP Crystal
Reports pour Enterprise.
6.4.1 Meilleures pratiques
Cette section fournit des recommandations relatives à la création d'un programme d'installation personnalisé.
Valider 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éduire la taille du produit
Les clients préfèrent un programme d'installation et un produit installé plus petits. Pour garder le produit aussi petit que possible, réalisez les actions suivantes :
● Supprimez tous les packs linguistiques non nécessaires.
● Supprimez tous les éléments du dossier Collaterals non nécessaires.
Attribuer 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 produit installé. Veillez à vérifier les personnalisations aux emplacements suivants :
● Nom et version du produit dans le programme d'installation et dans le produit.
● Entrée du menu Démarrer de Windows.
● Utilitaire Ajout/Suppression de programmes de Windows.
112
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Prendre 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.
Informations associées
Paramètres de ligne de commande
[page 134]
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 :
● Changement du nom du produit, ce qui implique les actions suivantes :
○ 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 de la saisie utilisateur par défaut
● Suppression d'écrans d'installation
● Annulation des vérifications des prérequis
● Suppression des packs linguistiques
● Modification des ressources, ce qui implique les actions suivantes :
○ Modification des images dans le programme d'installation
○ Modification 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.
Le fichier doit avoir ce format :
<oem name="<Any name>">
<cloneProduct sourceId="product.crystalreportsjava4.0core32">
...
...
</cloneProduct>
</oem>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
113
Le fichier de configuration pour le programme d'installation complet peut avoir n'importe quel nom. Par exemple, il peut s'appeler oem.xml.
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 procède aux personnalisations suivantes :
● Modification du nom long du produit par Custom Company Crystal Reports for Enterprise pour toutes les langues.
● Modification de l'éditeur et du nom du produit pour l'entrée de l'utilitaire Ajout/Suppression de
programmes de Windows.
● Suppression de l'écran d'installation intitulé Choose Installation Type (Sélectionner le type d'installation) et définition du type d'installation sur Custom (Personnalisé).
● Le package d'installation comprend uniquement les packs linguistiques anglais, français et allemand.
<oem name="CustomCompanyCrystalReportsforEnterprise">
<cloneProduct sourceId="product.crystalreportsjava4.0core32">
<replaceString id="product.crjava_name" value="Custom Company Crystal
Reports for Enterprise" lang="all"/>
<arp duSourceId="product.crystalreportsjava.arp4.0core">
<arg id="publisher" value="Custom Company"/>
<arg id="display_name" value="Custom Company Crystal Reports for
Enterprise" lang="all"/>
</arp>
<replaceProperty id="InstallType" defaultValue="custom"/>
<removeDialog id="ChooseInstallType2.dialog"/>
<languageIncludeList value="en;fr;de"/>
</cloneProduct>
</oem>
6.5.2 Changement du nom 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 du menu Démarrer et les raccourcis
● L'entrée de Ajout/Suppression des programmes de Windows
Les sections qui suivent expliquent ces personnalisations.
114
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
6.5.2.1 Personnalisation du nom du produit et du numéro de version
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="
<ID chaîne>
" value="
<nouvelle valeur>
" lang="
<liste de langue>
"/>
Le nom complet du produit est composé du nom long du produit et du numéro de version.
Table 21 : Nom du produit et numéro de version
Description de la chaîne ID de chaîne
Nom long du produit product.crjava_name
Version du produit product_version
Valeur par défaut
Crystal Reports pour Enterprise
4.1
Vous pouvez spécifier un nom et un numéro de version différents pour chaque langue. Pour obtenir une liste des
[page 136].
Exemple
Dans cet exemple, on procède aux personnalisations suivantes :
● Modification du nom long du produit par “Custom Company Crystal Reports for Enterprise” pour l'anglais.
● Modification du nom long du produit par “Custom Company Crystal Reports for Enterprise (French)” pour le français.
● Modification de la version de produit par 1.0 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 conserveront les valeurs par défaut.
<replaceString id="product.crjava_name" value="Custom Company Crystal Reports for
Enterprise" lang="en"/>
<replaceString id="product.crjava_name" value="Custom Company Crystal Reports for
Enterprise (French)" lang="fr"/>
<replaceString id="product_version" value="1.0" lang="en;fr"/>
Pour supprimer les instances de “SP3” du programme d'installation
Lors de l'exécution du programme d'installation, des instances de “SP3” peuvent être visibles dans le nom du produit. Pour supprimer “SP3”, modifiez les lignes des fichiers suivants :
Nom de fichier dunit\product.crystalre portsjava4.0core32\se tup.ui.framework\uitext
Ligne originale Ligne modifiée
<string id="productname_patch" <string id="product value="#product_patch#"/> name_patch" value=""/>
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
115
Nom de fichier
\CrystalReportsJava\pro duct.lang_<code langue>.ui text.xml
Ligne originale Ligne modifiée dunit\product.crystalre portsjava4.0core32\se tup.ui.framework\uitext
\framework\setup.ui.frame work.lang_<code langue>.ui text.xml
<string id="product_patch" va lue=" SP3"/>
<string id="pro duct_patch" value=""/>
Comme ci-dessus
<string id="product_patch_pre space" value=" SP3"/>
<string id="pro duct_patch_prespace" va lue=""/>
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
[page 136]. Lors de l'exécution de l'outil de personnalisation puis du programme d'installation, toutes les instances de “SP3” sont supprimées.
Exemple
Pour supprimer “SP3” du programme d'installation en anglais, modifiez les fichiers suivants :
● product.lang_en.uitext.xml
● setup.ui.framework.lang_en.uitext
6.5.2.2 Personnalisation du raccourci du menu Démarrer de
Windows
Le menu Démarrer de Windows contient un raccourci pour SAP Crystal Reports pour Enterprise. Le raccourci se trouve sous une entrée du menu Démarrer et porte le nom SAP Crystal Reports pour Enterprise 4. Vous pouvez personnaliser le nom, l'emplacement et l'info-bulle du raccourci pour chaque langue.
Utilisez l'élément shortcut pour personnaliser le nom, l'emplacement et l'info-bulle du raccourci :
<shortcut duSourceId="
<ID de l'unité de déploiement de raccourci>
">
<arg id="linkFullPath" value="
<Chemin d'accès complet au lien du raccourci>
" lang="
<liste de langue>
"/>
<arg id="description" value="
<chaîne d'info-bulle>
" lang="
<liste de langue>
"/>
</shortcut>
Attribut duSourceId linkFullPath
Valeur
L'ID de l'unité de déploiement du raccourci à modifier : product.crystalreportsjava.shortcut4.0
Le 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
116
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Attribut description
Valeur ou sur le bureau. L'outil de personnalisation SAP BusinessObjects créera le lien correc tement.
Vous pouvez spécifier un lien par langue. Pour obtenir une liste des codes de langue,
[page 136].
La chaîne d'info-bulle à afficher lorsque l'utilisateur survole le raccourci avec la souris.
Vous pouvez spécifier une info-bulle par langue. Pour obtenir une liste des codes de
[page 136].
Exemple
Dans cet exemple, on procède aux personnalisations suivantes :
● Modification du nom du raccourci par “Custom CR for Enterprise” pour l'anglais.
● Modification de la chaîne d'info-bulle de “Custom CR for Enterprise” par “Launch CR for Enterprise” pour l'anglais.
● Déplacement du raccourci “Custom CR for Enterprise” sous l'entrée du menu Démarrer appelée “Custom
Company”.
Le nom et l'info-bulle du raccourci restent inchangés dans toutes les autres langues.
<shortcut duSourceId="product.crystalreportsjava.shortcut4.0 core">
<arg id="linkFullPath" value="[programmenufolder]\Custom Company\Custom CR for
Enterprise.lnk" lang="en"/>
<arg id="description" value="Launch Custom CR for Enterprise" lang="en"/>
</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.crystalreportsjava.arp4.0core">
<arg id="publisher" value="
<nom éditeur>
"/>
<arg id="display_name" value="
<Nom du produit>
" lang="
<liste de langue>
"/>
<arg id="display_icon" value="
<chemin d'accès complet à l'icône>
"/>
</arp>
Remarque
Pour obtenir une liste des codes de langue, voir
La taille des icônes affichées dans l'utilitaire Ajout/Suppression de programmes de Windows est 16 x 16 pixels.
Pour des informations complètes sur la création d'icônes, voir la documentation Windows.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
117
Exemple
Dans cet exemple, on procède aux personnalisations suivantes dans l'utilitaire Ajout/Suppression de programmes de Windows :
● Modification du nom du produit dans l'utilitaire Ajout/Suppression de programmes de Windows par
“Custom Company Crystal Reports for Enterprise”.
● Modification de l'éditeur par “Custom Company”.
● Remplacement de l'icône affichée par celle se trouvant sous C:\SAPCustomTool\CC_logo.ico.
Remarque
Pour utiliser cet exemple, vous devez placer une icône nommée CC_logo.ico sous : C:\SAPCustomTool
<arp duSourceId="product.crystalreportsjava.arp4.0core">
<arg id="display_name" value="Custom Company Crystal Reports for Enterprise" lang="all"/>
<arg id="publisher" value="Custom Company"/>
<arg id="display_icon" value="C:\SAPCustomTool\CC_logo.ico"/>
</arp>
6.5.3 Personnalisation de la saisie utilisateur par défaut
Le programme d'installation recueille la saisie utilisateur à l'aide des boîtes de dialogue, cases d'option et autres
éléments de l'interface utilisateur. Vous pouvez personnaliser la valeur par défaut de la saisie utilisateur. Utilisez l'élément replaceProperty avec l'ID de propriété et la nouvelle valeur par défaut :
<replaceProperty id="
<ID de propriété>
" defaultValue="
<valeur à utiliser comme valeur par défaut>
"/>
Pour obtenir une liste complète des ID de propriété, voir
ID d'écran d'installation et de propriété
[page 138].
Exemple
Dans l'écran d'installation intitulé Sélectionner un type d'installation, le type d'installation par défaut est
Standard. Cet exemple modifie le type d'installation par défaut par Custom (Personnalisé).
<replaceProperty id="InstallType" defaultValue="custom"/>
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="
<ID d'écran d'installation>
"/>
118
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Pour obtenir une liste complète des ID d'écrans d'installation, voir
ID d'écran d'installation et de propriété
[page
138].
Exemple
Cet exemple supprime l'écran d'installation appelé Select Features (Sélectionner les fonctionnalités).
<removeDialog id="SelectFeatures.dialog"/>
6.5.5 Annulation 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érifier les prérequis. La suppression de l'écran Vérifier les prérequis empêche les vérifications de prérequis d'être effectuées. Pour supprimer l'écran, 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 échouera.
Exemple
Cet exemple supprime l'écran Check Prerequisites (Vérifier les prérequis) et empêche les vérifications de prérequis d'être effectuées.
<removeDialog id="CheckPreRequisites.dialog"/>
6.5.6 Suppression de packs linguistiques
Le programme d'installation offre à l'utilisateur la possibilité de sélectionner les packs linguistiques qu'il souhaite installer. Un pack linguistique contient les versions traduites de toutes les chaînes utilisées par le produit. 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 des codes de langue :
<languageIncludeList value="
<liste des codes de langue>
"/>
Pour obtenir une liste des codes de langue, voir
[page 136].
Remarque
Les packs linguistiques peuvent être volumineux. Vous pouvez réduire la taille du programme d'installation en incluant moins de packs linguistiques.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
119
Exemple
Cet exemple inclut 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.7 Modification des ressources
Le programme d'installation stocke des fichiers image et texte comme ressources dans ce dossier : dunit\product.crystalreportsjava4.0core32\setup.ui.framework\resources
Vous pouvez personnaliser les ressources de ce dossier. Les ressources couramment personnalisées sont :
● Les images du programme d'installation
● Le contrat de licence
Pour personnaliser une ressource, effectuez les actions suivantes :
1. Créez un dossier pour les ressources personnalisées.
Par exemple : C:\MyResources
Le dossier peut avoir le nom de votre choix, mais n'oubliez pas qu'il sera visible par 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 d'origine et placez-la dans le dossier des ressources personnalisées.
Pour voir des exemples de cette étape, consultez la section “Informations associées”.
3. Ajoutez l'élément <resources> au fichier de configuration pour spécifier l'emplacement du dossier des ressources personnalisées.
Par exemple : <resources cleanTarget="no" sourcePath="C:\MyResources"/>
Remarque
Si vous spécifiez l'attribut cleanTarget="yes", l'outil de personnalisation supprimera le dossier resources d'origine et utilisera uniquement les ressources contenues dans le dossier des ressources personnalisées.
Cette option n'est pas recommandée.
Informations associées
Personnalisation des images dans le programme d'installation
Personnalisation du contrat de licence
[page 121]
120
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
6.5.7.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 des ressources qui se trouve à l'emplacement suivant : dunit\product.crystalreportsjava4.0core32\setup.ui.framework\resources
Table 22 : Fichiers image dans le dossier des ressources
Image Nom de fichier
Ecran d'accueil dialogFull.bmp
Image supérieure pour tous les
écrans dialogTop.bmp
Panneau d'informations pour la boîte de dialogue de progression billboard.bmp
Résolution
500 x 400 pixels
500 x 83 pixels
500 x 193 pixels
Pour modifier une image, vous devez créer un fichier image, le placer dans le dossier des ressources personnalisées et ajouter l'élément resources au fichier de configuration.
Exemple
Modification de l'image de l'écran d'accueil
1. Créez le dossier suivant : C:\MyResources.
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"/>
Informations associées
6.5.7.2 Personnalisation du contrat de licence
Vous pouvez modifier le contrat de licence présenté à l'utilisateur dans le programme d'installation. Les contrats de licence sont stockés sous forme de fichiers texte dans le dossier des ressources, à l'emplacement suivant : dunit\product.crystalreportsjava4.0core32\setup.ui.framework\resources\
<code de langue>
Par exemple, le contrat de licence en anglais se trouve sous :
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
121
dunit\product.crystalreportsjava4.0core32\setup.ui.framework\resources\en
\license_en.rft
Pour obtenir une liste des codes de langue, voir
Pour modifier le contrat de licence, vous devez créer un fichier de licence, le placer dans le dossier des ressources personnalisées et ajouter l'élément resources au fichier de configuration.
Exemple
Modification du contrat de licence en anglais
Le contrat de licence en anglais se trouve sous : dunit\product.crystalreportsjava4.0core32\setup.ui.framework\resources\en
\license_en.rtf
Pour modifier le contrat de licence en anglais :
1. Créez le dossier suivant : C:\MyResources.
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:\SAPCustomTool\MyResources"/>
Informations associées
6.5.8 Suppression d'éléments du dossier Collaterals
Le programme d'installation de SAP Crystal Reports pour Enterprise 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 le chemin complet d'accès au dossier Collaterals personnalisé :
<collaterals cleanTarget="yes" sourcePath="
<chemin d'accès complet au dossier
Collaterals personnalisé>
"/>
Remarque
Vous devez affecter à l'attribut cleanTarget la valeur yes afin que l'outil de personnalisation remplace le dossier d'origine par le dossier personnalisé.
122
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Pour supprimer des éléments du dossier Collaterals
1. Copiez le contenu du dossier Collaterals dans un nouvel emplacement.
Par exemple, copiez le contenu dans C:\MyCollaterals.
2. Supprimez les éléments du dossier C:\MyCollaterals 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 collaterals personnalisé.
Par exemple :
<collaterals cleanTarget="yes" sourcePath="C:\MyCollaterals"/>
Table 23 : Description des éléments du dossier Collaterals
Dossier Description
Collaterals > Docs
Quand supprimer
Documentation dans toutes les langues prises en charge par Crystal Reports pour Enterprise.
Supprimez toutes les langues qui ne sont pas incluses dans le programme d'installa tion personnalisé. Pour obtenir une liste
[page 136].
Collaterals > Tools
> CustomizationTool
Outil de personnalisation SAP Busines sObjects.
Supprimez ce dossier si les clients n'ont pas besoin de personnaliser leurs pro grammes d'installation.
6.6 Personnalisation du concepteur de rapports
Vous pouvez personnaliser les parties suivantes du concepteur de rapports Crystal Reports pour Enterprise :
● L'écran de présentation
● La page de démarrage
● Le menu, y compris les éléments suivants :
○ Les chaînes du menu contenant le nom du produit “Crystal Reports pour Enterprise”.
○ L'élément de menu Enregistrer.
○ Les liens dans le menu Aide.
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 pour Enterprise démarre, un écran de présentation se charge. Vous pouvez remplacer cet écran de présentation par votre propre fichier bitmap. Si vous remplacez l'écran de présentation, le texte par défaut (le numéro de version et le copyright) qui s'affiche avec l'écran de présentation par défaut est supprimé.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
123
Remarque
La procédure suivante suppose que vous avez déjà installé Crystal Reports pour Enterprise. 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 130].
1. Renommez votre fichier bitmap splash.bmp.
Le fichier bitmap doit être un fichier .bmp valide et n'est pas limité en taille. La taille recommandée est toutefois de 410 x 253 pixels.
2. Placez splash.bmp dans le même dossier que CrystalReports.exe.
Par défaut, CrystalReports.exe se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for Enterprise XI 4.0
Lorsque Crystal Reports pour Enterprise est exécuté, le fichier splash.bmp doit se charger et le texte par défaut ne s'affiche pas. Si votre fichier bitmap ne se charge pas, alors l'écran de présentation par défaut se charge et le texte pas défaut s'affiche.
6.6.1.1 Suppression de la barre de progression sur l'écran de présentation
Lorsque vous personnalisez votre écran de présentation, vous pouvez également supprimer la barre de progression de l'écran. Pour ce faire, vous devez spécifier l'attribut show_splash_progressbar dans un fichier .properties. Le nom de ce fichier doit être cr_oem_config.properties et doit être placé dans le dossier configuration.
Remarque
La procédure suivante suppose que vous avez déjà installé Crystal Reports pour Enterprise. Si vous souhaitez déployer cette personnalisation dans votre programme d'installation personnalisé, spécifiez l'attribut show_splash_progressbar=no dans un fichier nommé cr_oem_config.properties puis suivez les
Déploiement du fichier de personnalisation OEM
1. (Facultatif) Si vous n'avez pas encore le fichier cr_oem_config.properties, créez-le et enregistrez-le dans le dossier configuration.
Remarque
○ Par défaut, le dossier configuration se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for Enterprise XI
4.0\configuration
○ Ce fichier .properties est utilisé pour les personnalisations qui n'exigent pas de chaînes localisées ; le nom du fichier ne contient pas de code de langue.
○ Le fichier doit utiliser l'encodage UTF-8 afin de prendre en charge plusieurs langues.
124
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
2. Ouvrez le fichier cr_oem_config.properties dans un éditeur de texte et ajoutez l'attribut suivant : show_splash_progressbar=no
3. Enregistrez le fichier.
Lorsque Crystal Reports pour Enterprise démarre, la barre de progression ne s'affiche pas sur l'écran de présentation.
Informations associées
Attributs pour les fichiers .properties
6.6.2 Masquage des éléments de la page de démarrage
Vous pouvez choisir de masquer la partie supérieure ou inférieure de la page de démarrage, ou les deux.
Pour réaliser ces personnalisations, vous devez spécifier des attributs dans un fichier .properties. Le nom de ce fichier doit être cr_oem_config.properties et doit être placé dans le dossier configuration.
Remarque
● Par défaut, le dossier configuration se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for Enterprise XI
4.0\configuration
● Ce fichier .properties est utilisé pour les personnalisations qui n'exigent pas de chaînes localisées ; le nom du fichier ne contient pas de code de langue.
● Le fichier doit utiliser l'encodage UTF-8 afin de prendre en charge plusieurs langues.
Pour masquer ou afficher l'historique de fichier qui apparaît en haut de la page de démarrage, utilisez l'attribut show_startpage_history : show_startpage_history=
<Oui ou Non>
Pour masquer ou afficher le flux en ligne qui apparaît en bas de la page de démarrage, utilisez l'attribut show_startpage_onlinefeed : show_startpage_onlinefeed=
<Oui ou Non>
Si vous modifiez le contenu de la page de démarrage en utilisant votre propre fichier HTML, votre fichier remplace le flux en ligne même si vous avez spécifié show_startpage_onlinefeed=yes dans le fichier .properties.
Pour en savoir plus sur cette personnalisation, voir
Personnalisation de la page de démarrage
[page 126].
Exemple
Cet exemple masque les parties supérieures et inférieures de la page de démarrage.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
125
Si vous avez modifié le contenu de la page de démarrage à l'aide de votre propre fichier HTML, le contenu de votre fichier apparaîtra en haut de la page. Dans le cas contraire, la page de démarrage sera vide.
show_startpage_history=no show_startpage_onlinefeed=no
Remarque
Si vous souhaitez déployer ces personnalisations dans votre programme d'installation personnalisé, ajoutez les attributs à un fichier nommé cr_oem_config.properties puis suivez les instructions indiquées dans
Déploiement du fichier de personnalisation OEM
[page 130]
Informations associées
Attributs pour les fichiers .properties
[page 131]
6.6.2.1 Personnalisation de la page de démarrage
Vous pouvez modifier le contenu de la page de démarrage en utilisant votre propre fichier HTML.
Remarque
La procédure suivante suppose que vous avez déjà installé Crystal Reports pour Enterprise. Si vous souhaitez déployer la page de démarrage dans votre programme d'installation personnalisé, renommez le fichier HTML que vous souhaitez utiliser pour la page de démarrage startpage_
<code de langue>
.html, en fonction de la langue souhaitée pour la page de démarrage, puis suivez les instructions indiquées dans
Déploiement du fichier de personnalisation OEM
[page 130].
1. Renommez votre fichier HTML startpage_
<code de langue>
.html.
Par exemple, le fichier HTML pour la page de démarrage en anglais doit s'appeler startpage_en.html.
Remarque
Pour obtenir une liste des codes de langue, voir
2. Placez le fichier startpage_
<code de langue>
.html dans le dossier configuration.
Par défaut, le dossier configuration se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for Enterprise XI
4.0\configuration
Lorsque Crystal Reports pour Enterprise est exécuté, la page de démarrage s'affiche avec les personnalisations réalisées dans le fichier startpage_
<code de langue>
.html. Ce contenu personnalisé remplace le flux en ligne qui apparaît en bas de la page de démarrage par défaut.
126
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Si la partie inférieure de la page de démarrage est masquée, le contenu du fichier startpage_
<code de langue>
.html apparaît en haut de la page de démarrage. Pour en savoir plus sur cette personnalisation, voir
Masquage des éléments de la page de démarrage
[page 125].
6.6.3 Personnalisation des chaînes dans le programme
Vous pouvez modifier les chaînes suivantes dans le programme, qui contiennent le nom du produit “SAP Crystal
Reports pour Enterprise” par défaut :
Nom de la propriété product_name help_help_menutitle help_about_menutitle
Description
Le nom du pro duit.
Emplacement
Titre de la fenêtre
Le point de menu
Aide du produit.
Menu Aide
Le point de menu
A propos de
<nom de produit>
.
Menu Aide
Valeur par défaut
SAP Crystal Reports pour Enter prise
Aide de SAP Crystal Reports pour
Enterprise
A propos de SAP Crystal Reports pour Enterprise
Pour personnaliser ces chaînes, vous devez spécifier des attributs dans un fichier .properties spécifique à la langue. Le fichier doit s'appeler cr_oem_config_
<code langue>
.properties, et il doit être placé dans le dossier configuration.
Remarque
● Par défaut, le dossier configuration se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for Enterprise XI
4.0\configuration
● Pour obtenir une liste des codes de langue, voir
[page 136].
Exemple
Dans cet exemple, on procède aux personnalisations suivantes :
● Modification du nom du produit dans le titre de la fenêtre par “Custom CR for Enterprise”.
● Modification du texte du point de menu Aide du produit par “Custom CR for Enterprise help”.
● Modification du texte du point de menu A propos de
<nom du produit>
par “About Custom CR for
Enterprise”.
product_name=Custom CR for Enterprise help_help_menutitle=Custom CR for Enterprise help help_about_menutitle=About Custom CR for Enterprise
Remarque
Si vous souhaitez déployer ces personnalisations dans votre programme d'installation personnalisé, ajoutez les attributs à un fichier nommé cr_oem_config.properties puis suivez les instructions indiquées dans
Déploiement du fichier de personnalisation OEM
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
127
Informations associées
Attributs pour les fichiers .properties
[page 131]
6.6.4 Personnalisation du menu Aide
Vous pouvez apporter les modifications suivantes au menu Aide :
● Masquer le point de menu Enregistrer.
● Rediriger les liens suivants :
○
○
Aide
Aide
Nous contacter
Documentation
6.6.4.1 Masquage du point de menu Enregistrer.
Vous pouvez masquer le point de menu Aide Enregistrer si vous n'avez pas besoin que vos clients enregistrent le produit. Pour réaliser cette personnalisation, vous devez spécifier la valeur de l'attribut show_help_register_menu dans un fichier .properties : show_help_register_menu=
<Oui ou Non>
Le nom du fichier .properties doit être cr_oem_config.properties et le fichier doit être placé dans le dossier configuration.
Remarque
● Par défaut, le dossier configuration se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for Enterprise XI
4.0\configuration
● Ce fichier .properties est utilisé pour les personnalisations qui n'exigent pas de chaînes localisées ; le nom du fichier ne contient pas de code de langue.
● Le fichier doit utiliser l'encodage UTF-8 afin de prendre en charge plusieurs langues.
Exemple
Cet exemple masque le point de menu Aide Enregistrer .
show_help_register_menu=no
Remarque
Si vous souhaitez déployer cette personnalisation dans votre programme d'installation personnalisé, ajoutez l'attribut à un fichier nommé cr_oem_config.properties puis suivez les instructions indiquées dans
Déploiement du fichier de personnalisation OEM
[page 130]
128
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Informations associées
Attributs pour les fichiers .properties
6.6.4.2 Redirection des liens dans le menu Aide
Par défaut, les éléments Nous contacter et Documentation du menu Aide renvoient vers du contenu SAP. Vous pouvez modifier ces éléments pour qu'ils amènent à votre contenu.
Les deux éléments peuvent renvoyer vers une URL ou un chemin d'accès. Il n'existe aucune restriction concernant le type de fichier utilisé. Toutefois, vous ne pouvez pas fournir un chemin d'accès relatif.
Pour réaliser ces personnalisations, vous devez spécifier des attributs dans un fichier .properties. Le fichier doit s'appeler cr_oem_config.properties et doit être placé dans le dossier configuration.
Remarque
● Par défaut, le dossier configuration se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for Enterprise XI
4.0\configuration
● Ce fichier .properties est utilisé pour les personnalisations qui n'exigent pas de chaînes localisées ; le nom du fichier ne contient pas de code de langue.
● Le fichier doit utiliser l'encodage UTF-8 afin de prendre en charge plusieurs langues.
Pour rediriger le lien du point de menu Nous contacter, utilisez l'attribut help_contactus_location : help_contactus_location=
<URL ou chemin d'accès>
Pour rediriger le lien du point de menu Documentation, utilisez l'attribut help_documentation_location : help_documentation_location=
<URL ou chemin d'accès>
Exemple
Dans cet exemple, on procède aux personnalisations suivantes :
● Redirection du point de menu Nous contacter pour envoyer vers la page d'accueil SAP.
● Redirection du point de menu Documentation pour renvoyer vers C:\example.txt
Pour utiliser cet exemple, vous devez créer un fichier texte appelé example.txt et le placer dans le lecteur C:
\.
help_contactus_location=http://www.sap.com/index.html
help_documentation_location=C:\example.txt
Remarque
Si vous souhaitez déployer ces personnalisations dans votre programme d'installation personnalisé, ajoutez les attributs à un fichier nommé cr_oem_config.properties puis suivez les instructions indiquées dans
Déploiement du fichier de personnalisation OEM
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
129
Informations associées
Attributs pour les fichiers .properties
[page 131]
6.6.5 Modification des images dans la boîte de dialogue A propos
La boîte de dialogue A propos s'affiche en cliquant sur Help A propos de
<produit>
. Elle contient deux images de la marque SAP : en haut se trouve la bannière avec inscrit “SAP Crystal Reports pour Enterprise” et en bas se trouve le logo SAP.
Vous pouvez remplacer ces deux images par vos propres fichiers bitmap.
Remarque
La procédure suivante suppose que vous avez déjà installé Crystal Reports pour Enterprise. Si vous souhaitez déployer la bannière et le logo dans votre programme d'installation personnalisé, renommez les fichiers bitmap que vous souhaitez utiliser about_banner.bmp et about_logo.bmp puis suivre les instructions indiquées
Déploiement du fichier de personnalisation OEM
[page 130].
1. Renommez la bannière de remplacement about_banner.bmp.
Le fichier bitmap doit être un fichier .bmp valide et n'est pas limité en taille. La taille recommandée de la bannière est 500 x 90 pixels. Si la taille du fichier bitmap est différente, le fichier sera redimensionné pour correspondre à cette taille.
2. Renommez le logo de remplacement about_logo.bmp.
Le fichier bitmap doit être un fichier .bmp valide et n'est pas limité en taille. La taille recommandée du logo est
100 x 100 pixels. Si la taille du fichier bitmap est différente, le fichier sera redimensionné pour correspondre à cette taille.
3. Placez les deux fichiers bitmap dans le même dossier que CrystalReports.exe.
Par défaut, CrystalReports.exe se trouve sous :
C:\Program Files (x86)\SAP BusinessObjects\Crystal Reports for Enterprise XI 4.0
Lorsque vous cliquez sur Aide A propos de
<produit>
dans Crystal Reports pour Enterprise, la boîte de dialogue A propos apparaît et vos fichiers bitmap s'affichent. S'ils ne chargent pas, la bannière et le logo par défaut s'affichent.
6.6.6 Déploiement du fichier de personnalisation OEM
Après avoir préparé vos fichiers personnalisés (tels que les images de démarrage, la page de démarrage et les fichiers .properties), vous pouvez déployer vos personnalisations dans le package d'installation.
1. Créez un fichier compressé nommé template.zip.
2. Placez les fichiers personnalisés dans le fichier .zip.
130
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Remarque
La structure du dossier dans le fichier .zip doit correspondre à la structure du dossier où vous souhaitez placer les fichiers, relativement au dossier d'installation. Les fichiers doivent être placés dans un dossier
Crystal Reports for Enterprise XI 4.0 dans template.zip.
Par exemple, les fichiers personnalisés suivants doivent être placés dans les emplacements indiqués dans le fichier template.zip :
Fichier personnalisé splash.bmp
Emplacement dans template.zip
Crystal Reports for Enterprise XI 4.0
about_banner.bmp
about_logo.bmp
startpage_en.html
cr_oem_config.properties
cr_oem_config_en.properties
Crystal Reports for Enterprise XI 4.0
Crystal Reports for Enterprise XI 4.0
Crystal Reports for Enterprise XI
4.0\configuration
Crystal Reports for Enterprise XI
4.0\configuration
Crystal Reports for Enterprise XI
4.0\configuration
3. Copiez le fichier .zip à l'emplacement suivant dans votre package d'installation personnalisé : dunit\product.crystalreportsjava.oemzips4.0corenu\OEMZips
Remarque
Il est possible que vous deviez créer le dossier OEMZips manuellement.
4. Exécutez le programme d'installation.
Le contenu de template.zip sera décompressé dans le dossier d'installation.
6.6.7 Attributs pour les fichiers .properties
Vous pouvez modifier plusieurs attributs du concepteur de rapports dans Crystal Reports pour Enterprise. Les attributs qui ne requièrent pas de chaînes localisées et ceux nécessitant des chaînes localisées sont spécifiés dans des fichiers .properties distincts.
Attributs ne nécessitant pas de chaînes localisées
Vous pouvez utiliser ces attributs pour apporter des modifications telles que le masquage de parties du concepteur de rapports. Par exemple, vous pouvez masquer l'historique de fichiers qui apparaît en haut de la page de démarrage avec l'attribut show_startpage_history=no. Il est également possible de masquer le flux en ligne en bas de la page de démarrage en utilisant l'attribut show_startpage_onlinefeed=no.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
131
Les attributs qui ne requièrent pas de chaînes localisées sont spécifiés dans le fichier cr_oem_config.properties. Le fichier doit utiliser l'encodage UTF-8 afin de prendre en charge plusieurs langues.
Table 24 : Attributs ne nécessitant pas de chaînes localisées
Attribut Valeurs possibles show_splash_progressbar =yes show_startpage_history show_startpage_onlinefeed
=no
=yes
=no
=yes
=no
Description
Affiche la barre de progression sur l'écran de présentation.
Masque la barre de progression sur l'écran de présentation.
Affiche la section supérieure de la page de démarrage.
Masque la section supérieure de la page de démarrage.
Affiche la section inférieure de la page de démarrage.
Masque la section inférieure de la page de démarrage.
show_help_register_menu =yes
=no
Affiche le point de menu Aide Enre gistrer .
Masque le point de menu Aide Enre gistrer .
help_contactus_location =
<URL ou chemin d'accès>
Redirige le point de menu Aide Nous contacter vers une URL ou un chemin d'accès personnalisé(e).
Remarque
● Il n'existe aucune restriction quant au type de fichier pouvant être uti lisé.
● Les chemins d'accès relatifs ne sont pas pris en charge.
help_documentation_location =
<URL ou chemin d'accès>
Redirige le point de menu Aide Do cumentation vers une URL ou un che min d'accès personnalisé(e).
Remarque
● Il n'existe aucune restriction quant au type de fichier pouvant être uti lisé.
132
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Attribut Valeurs possibles Description
● Les chemins d'accès relatifs ne sont pas pris en charge.
Attributs nécessitant des chaînes localisées
Vous pouvez utiliser ces attributs pour modifier les chaînes dans Crystal Reports pour Enterprise. Par exemple, vous pouvez modifier le nom de produit qui apparaît dans le titre de la fenêtre avec l'attribut product_name=Custom CR for Enterprise.
Les attributs qui nécessitent des chaînes localisées sont spécifiés dans un fichier .properties spécifique à la langue. Le fichier doit s'appeler cr_oem_config_
<code langue>
.properties.
Remarque
Pour obtenir une liste des codes de langue, voir
Table 25 : Attributs nécessitant des chaînes localisées
Attribut product_name help_help_menutitle
Valeurs possibles
=
<Nom du produit>
Description
Remplace SAP Crystal Reports for Enter
prise dans le titre de la fenêtre par
<Nom du produit>
=
<Aide du produit>
Remplace SAP Crystal Reports for En terprise help dans le menu Aide par
<Aide du produit>
.
help_about_menutitle =A propos de
<produit>
Remplace About SAP Crystal Reports for Enterprise dans le menu Aide par A propos de
<produit>
.
Informations associées
Suppression de la barre de progression sur l'écran de présentation
[page 124]
Personnalisation de la page de démarrage
Personnalisation des chaînes dans le programme
[page 127]
Masquage du point de menu Enregistrer.
Redirection des liens dans le menu Aide
[page 129]
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
133
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 pour Enterprise à cet emplacement :
Collaterals\Tools\CustomizationTool
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 Crystal Reports pour Enterprise dans le dossier C:\SAPCustomTool
\packages
Téléchargement du programme d'installation
[page 111].
● Dans C:\SAPCustomTool, créez un dossier appelé output
● Exécutez la commande suivante à partir de l'invite de commande : cd C:\SAPCustomTool\packages\Collaterals\Tools\CustomizationTool
Après avoir réalisé les tâches ci-dessus, exécutez l'outil de personnalisation en exécutant la commande suivante à partir de l'invite de commande : customizationtool.exe xml=C:\SAPCustomTool\oem.xml packageDir=C:\SAPCustomTool
\packages outputDir=C:\SAPCustomTool\output logDetail=error > C:\oemlog.log
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.
Pour en savoir plus sur l'exécution de l'outil de personnalisation SAP BusinessObjects, voir
Crystal Reports pour Enterprise
6.7.1 Paramètres de ligne de commande
Cette section explique les paramètres de ligne de commande utilisés pour l'outil de personnalisation. Certains paramètres sont obligatoires tandis que d'autres sont facultatifs.
Table 26 : Paramètres obligatoires
Paramètre Description
xml
Chemin d'accès complet au fichier de configura tion.
Exemple xml=C:\SAPCustomTool\oem.xml
134
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Paramètre
packageDir outputDir
Description Exemple
Le fichier de configuration pour le programme d'installation complet peut avoir n'importe quel nom.
Chemin d'accès complet au dossier contenant le programme d'installation que vous modifiez.
Le programme d'installation est téléchargé à par tir de SAP Service Marketplace. Il contient les dos siers Collaterals, dunit, langs et setup.en gine ainsi que d'autres fichiers binaires.
packageDir=C:\SAPCustomTool\pac kages
Chemin d'accès complet au dossier où sera créé le programme d'installation personnalisé.
Ce dossier doit être vide pour pouvoir exécuter l'outil.
outputDir=C:\SAPCustomTool\out put
Table 27 : Paramètres facultatifs
Paramètre Description
logDetail
Niveau de détail de la journalisation.
La valeur par défaut est info. Les valeurs suivantes sont acceptées :
● error
● warn
● info
● debut
● trace
action
Exemple logDetail=warn
Mode de l'outil
La valeur par défaut est generate. Les va leurs suivantes sont acceptées :
● generate
L'outil réalise les personnalisations spécifiées.
● validate
L'outil valide le fichier de configuration mais ne réalise aucune personnalisa tion.
action=validate
Informations associées
Démarrage rapide de Crystal Reports pour Enterprise
[page 109]
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
135
6.8 ID et codes pour la personnalisation de Crystal Reports pour Enterprise
La section suivante contient une liste de tous les ID et codes pouvant être utilisés pour personnaliser le programme d'installation, notamment :
● Les ID de chaîne
● Les codes de langue
● Les ID d'écran d'installation et de propriété
6.8.1 ID de chaîne
Vous pouvez modifier les chaînes pour le nom de produit et le numéro de version dans le programme d'installation. Vous pouvez remplacer une chaîne pour toutes les langues ou pour une langue en particulier.
Pour remplacer une chaîne, utilisez l'élément replaceString. Par exemple :
<replaceString id="product.crjava_name" value="Custom Company Crystal Reports lang="all"/>
Table 28 : Chaînes couramment modifiées
ID de chaîne product.crjava_name
product_version
Description
Nom long du produit
Version du produit
Informations associées
Personnalisation du nom du produit et du numéro de version
[page 115]
6.8.2 Codes de langue
L'outil de personnalisation SAP BusinessObjects utilise les codes de langue suivants pour représenter les langues prises en charge.
Remarque
● Si vous incluez plusieurs langues dans le même élément, les codes de langue doivent être séparés par un point-virgule.
● Si vous souhaitez qu'une personnalisation s'applique à toutes les langues prises en charge, utilisez la valeur all plutôt que les codes de langue.
136
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Langue
Anglais
Tchèque
Danois
Néerlandais
Finnois
Français
Allemand
Hongrois
Italien
Japonais
Coréen
Norvégien (Bokmål)
Polonais
Portugais
Roumain
Russe
Chinois simplifié
Slovaque
Espagnol
Suédois
Thaï
Chinois traditionnel
Turc
PL
PT
RO
RU
IT
JA
KO
NB
FI
FR
DE
HU
Code
EN
CS
DA
NL zh_CN
SK
ES
SV
TH zh_TW
TR
Informations associées
Personnalisation du nom du produit et du numéro de version
Personnalisation du raccourci du menu Démarrer de Windows
[page 116]
Personnalisation de l'utilitaire Ajout/Suppression de programmes de Windows
Suppression de packs linguistiques
[page 119]
Personnalisation du contrat de licence
Personnalisation des chaînes dans le programme
[page 127]
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
137
6.8.3 ID d'écran d'installation et de propriété
Les ID d'écran d'installation sont utilisés dans l'élément removeDialog. Cet élément permet de supprimer des
écrans du programme d'installation. Utilisez par exemple cet élément pour supprimer l'écran Sélectionner les
fonctionnalités :
<removeDialog id="SelectFeatures.dialog"/>
Les ID de propriété sont utilisés dans l'élément replaceProperty. Cet élément permet de modifier la saisie utilisateur par défaut pour les champs et les paramètres dans le programme d'installation. Utilisez par exemple cet élément pour définir le type d'installation par défaut sur Personnalisé :
<replaceProperty id="InstallType" defaultValue="custom"/>
Table 29 : ID d'écran
Titre de l'écran d'installa tion
ID de l'écran d'installation
Sélectionner la langue d'ins tallation
SelectUILanguage.dialog
Installation impossible
SharedAlwaysFailure.dia log
ID de propriété dans l'écran d'installation
Non applicable
Non applicable
Vérifier les prérequis
Bienvenue dans l'Assistant d'installation...
CheckPreRequisites.dialog
ShowWelcomeScreen.dialog
Non applicable
Non applicable
Contrat de licence
ShowLicenseAgreement.dia log
Configurer l'enregistrement du produit
CREnterProductKey.dialog
Non applicable
ProductKey
SelectLanguagePack.dialog
Non applicable
Sélectionner les packs lin guistiques
Sélectionner un type d'ins tallation
ChooseInstallType2.dialog
InstallType
Valeurs de pro priété
Non applicable
Non applicable
Non applicable
Non applicable
Non applicable
Votre code clé du produit
Non applicable
● default
(Standard)
● custom
Non applicable
Sélectionner les fonctionna lités
SelectFeatures.dialog
Commencer l'installation
Non applicable
ShowInstallSummary.dialog
Non applicable
SAP Crystal Reports pour
Enterprise 4.1 SP3 a été in stallé
SAP Crystal Reports pour
Enterprise 4 FP3 a été in stallé
ShowInstallComplete.dia log
ShowInstallComplete_Pat chUpdate.dialog
Non applicable
Non applicable
Non applicable
Non applicable
Non applicable
138
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
Titre de l'écran d'installa tion
Maintenance de l'applica tion
ID de l'écran d'installation
RunMaintenance.dialog
Confirmation de désinstalla tion
VerifyToRemove.dialog
SAP Crystal Reports pour
Enterprise 4.1 SP3 a été désinstallé
ShowUninstallCom plete.dialog
ID de propriété dans l'écran d'installation
Non applicable
Non applicable
Non applicable
Valeurs de pro priété
Non applicable
Non applicable
Non applicable
Guide de personnalisation de SAP BusinessObjects BI
Personnalisation de SAP Crystal Reports pour Enterprise
©
2014 SAP AG ou société affiliée SAP. Tous droits réservés.
139
www.sap.com/contactsap
©
2014 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
.

Enlace público actualizado
El enlace público a tu chat ha sido actualizado.