Guide de personnalisation de SAP BusinessObjects BI ■ SAP BusinessObjects Business Intelligence Suite 4.1 Support Package 1 2013-09-19 Copyright © 2013 SAP AG ou société affiliée SAP. Tous droits réservés.Toute reproduction ou communication de la présente publication, même partielle, par quelque procédé et à quelque fin que ce soit, est interdite sans l'autorisation expresse et préalable de SAP AG. Les informations contenues dans ce document peuvent être modifiées par SAP AG sans préavis. Certains logiciels commercialisés par SAP AG et ses distributeurs contiennent des composants logiciels qui sont la propriété d'éditeurs tiers. Les spécifications des produits peuvent varier d’un pays à l’autre. Elles sont fournies par SAP AG et ses filiales (« Groupe SAP ») uniquement à titre informatif, sans engagement ni garantie d'aucune sorte. Le Groupe SAP ne pourra en aucun cas être tenu responsable des erreurs ou omissions relatives à ces informations. Les seules garanties fournies pour les produits et les services du Groupe SAP sont celles énoncées expressément à titre de garantie accompagnant, le cas échéant, lesdits produits et services. Aucune des informations contenues dans ce document ne saurait constituer une garantie supplémentaire. SAP et tous les autres produits et services SAP mentionnés dans ce document, ainsi que leurs logos respectifs, sont des marques commerciales ou des marques déposées de SAP AG en Allemagne ainsi que dans d'autres pays. Pour plus d'informations sur les marques déposées, voir http://www.sap.com/france/about-sap/legal/copyright.epx. 2013-09-19 Table des matières 3 Chapitre 1 Historique du document..........................................................................................................7 Chapitre 2 Démarrage..............................................................................................................................9 2.1 2.1.1 2.2 2.2.1 2.2.2 A propos de ce guide...............................................................................................................9 Chapitre 3 Personnalisation du programme d'installation de la plateforme de Business Intelligence....17 3.1 3.2 3.3 3.4 3.5 3.5.1 3.6 3.6.1 3.6.2 3.6.3 3.6.4 3.6.5 3.6.6 3.6.7 3.6.8 3.6.9 3.6.10 3.6.11 3.6.12 3.6.13 3.7 3.7.1 Introduction............................................................................................................................17 Terminologie............................................................................................................................9 Avant de commencer.............................................................................................................11 Personnalisation de la plateforme SAP BusinessObjects Business Intelligence .....................12 Personnalisation de SAP Crystal Reports..............................................................................13 Démarrage rapide pour la plateforme de Business Intelligence (Windows).............................17 Démarrage rapide pour la plateforme de Business Intelligence (Unix ou Linux).......................18 Pour télécharger le programme d'installation du serveur.........................................................20 Planification du processus de personnalisation ......................................................................20 Meilleures pratiques...............................................................................................................21 Création du fichier de configuration........................................................................................22 Présentation du fichier de configuration..................................................................................22 Renommage du produit..........................................................................................................24 Personnalisation de la saisie utilisateur...................................................................................31 Suppression d'écrans d'installation.........................................................................................32 Incorporation d'un code clé....................................................................................................33 Suppression de fonctionnalités..............................................................................................33 Empêchement des vérifications des prérequis........................................................................34 Installation sur des plateformes Red Hat Linux non prises en charge......................................34 Suppression de packs linguistiques........................................................................................36 Empêchement de l'exécution de l'outil WDeploy....................................................................36 Suppression de la base de données par défaut......................................................................36 Modification des ressources .................................................................................................37 Suppression d'éléments du dossier Collaterals......................................................................40 Exécution de l'outil.................................................................................................................42 Paramètres de ligne de commande........................................................................................43 2013-09-19 Table des matières 4 3.8 3.8.1 3.8.2 3.8.3 3.9 3.9.1 3.9.2 3.9.3 3.9.4 3.9.5 Personnalisation des programmes d'installation de mise à jour...............................................45 Chapitre 4 Personnalisation d'applications Web....................................................................................67 4.1 4.1.1 4.1.2 4.2 4.3 4.3.1 4.3.2 4.3.3 4.3.4 4.3.5 4.4 4.5 4.5.1 Introduction............................................................................................................................67 Chapitre 5 Personnalisation de SAP Crystal Reports 2011....................................................................85 5.1 5.2 5.3 5.4 5.4.1 5.5 5.5.1 5.5.2 5.5.3 5.5.4 5.5.5 5.5.6 5.5.7 Introduction............................................................................................................................85 FAQ au sujet des programmes d'installation de mise à jour....................................................45 Démarrage rapide pour les programmes d'installation de mise à jour......................................46 Personnalisation de programmes d'installation de mise à jour.................................................47 ID et codes pour la personnalisation de la plateforme de BI...................................................49 ID des fonctionnalités.............................................................................................................50 ID des unités de déploiement de raccourci (Windows uniquement)........................................53 ID de chaîne...........................................................................................................................54 Codes langue.........................................................................................................................54 ID d'écran d'installation et de propriété..................................................................................56 Notions clés ..........................................................................................................................67 Test de vos personnalisations................................................................................................69 Démarrage rapide..................................................................................................................69 Personnalisation de la zone de lancement BI..........................................................................71 Pour personnaliser l'image de favicon.....................................................................................71 Pour personnaliser les logos..................................................................................................71 Personnalisation d'autres éléments de l'interface utilisateur...................................................72 Utilisation des espaces de travail BI et modules composés....................................................78 Pour modifier le nom de la zone de lancement BI...................................................................79 Personnalisation d'OpenDocument........................................................................................80 Personnalisation du visualiseur de Crystal Reports JavaScript...............................................81 Personnalisation du visualiseur...............................................................................................82 Démarrage rapide pour Crystal Reports.................................................................................85 Téléchargement du programme d'installation..........................................................................86 Planification du processus de personnalisation.......................................................................87 Meilleures pratiques...............................................................................................................87 Création du fichier de configuration........................................................................................88 Présentation du fichier de configuration..................................................................................89 Renommage du produit..........................................................................................................90 Personnalisation de la saisie utilisateur par défaut..................................................................98 Suppression d'écrans d'installation.........................................................................................99 Incorporation d'un code clé....................................................................................................99 Suppression de fonctionnalités............................................................................................100 Empêchement des vérifications des prérequis......................................................................100 2013-09-19 Table des matières 5.5.8 5.5.9 5.5.10 5.6 5.6.1 5.6.2 5.6.3 5.6.4 5.7 5.7.1 5.8 5.8.1 5.8.2 5.8.3 5.9 5.9.1 5.9.2 5.9.3 5.9.4 5.9.5 Suppression de packs linguistiques......................................................................................101 Annexe A Informations supplémentaires.............................................................................................125 Index 5 Modification des ressources................................................................................................101 Suppression d'éléments du dossier Collaterals....................................................................104 Personnalisation du concepteur de rapports.........................................................................105 Personnalisation de l'écran de présentation..........................................................................106 Personnalisation de la page de démarrage...........................................................................106 Personnalisation des chaînes de menu.................................................................................107 Déploiement du fichier de personnalisation OEM.................................................................108 Exécution de l'outil...............................................................................................................109 Paramètres de ligne de commande......................................................................................110 Personnalisation des programmes d'installation de mise à jour.............................................112 FAQ au sujet des programmes d'installation de mise à jour .................................................112 Démarrage rapide pour les programmes d'installation de mise à jour ...................................113 Personnalisation de programmes d'installation de mise à jour...............................................114 ID et codes pour la personnalisation de Crystal Reports......................................................116 ID des fonctionnalités...........................................................................................................116 ID des unités de déploiement de raccourci...........................................................................120 ID de chaîne.........................................................................................................................120 Codes langue.......................................................................................................................121 ID d'écran d'installation et de propriété................................................................................122 127 2013-09-19 Table des matières 6 2013-09-19 Historique du document Historique du document Le tableau suivant fournit une présentation des principaux enrichissements apportés à ce document : Version 7 Date Description Suite SAP BusinessObjects 4.1 de Mai 2013 Business Intelligence Première version de ce document. Suite SAP BusinessObjects Busine- Août 2013 ss Intelligence 4.1 Support Package 1 • • Ajout de la section Installation sur des plateformes Red Hat Linux non prises en charge. Mise à jour de la section Personnalisation du dossier d'installation. Le répertoire d'installation par défaut doit être un sous-dossier de Program Files (x86). 2013-09-19 Historique du document 8 2013-09-19 Démarrage Démarrage 2.1 A propos de ce guide La suite SAP BusinessObjects Business Intelligence fournit un ensemble d'outils et de modèles qui vous permettent de personnaliser la plateforme SAP BusinessObjects Business Intelligence et le concepteur SAP Crystal Reports. 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 Avant de commencer 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 Description REPINSTALL 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 9 2013-09-19 Démarrage La documentation de la plateforme de BI utilise la terminologie suivante : Base de données du CMS Base de données utilisée par le CMS pour stocker les informations relatives à la plateforme de BI. base de données fournie, serveur d'applications Web fourni Base de données et serveur d'applications Web accompagnant la plateforme de BI. clé de cluster Utilisée pour déchiffrer les clés de la base de données du CMS. Vous pouvez changer de clé de cluster à l'aide du CCM mais vous ne pouvez pas réinitialiser cette clé comme un mot de passe. Il s'agit d'une clé de chiffrement à l'aide de laquelle le contenu est chiffré, raison pour laquelle il est essentiel de ne pas la perdre. cluster Un cluster est constitué d'au moins deux serveurs CMS (Central Management Servers) travaillant ensemble et utilisant une seule base de données système du CMS. CMS Le Central Management Server. Correctif Petites mises à jour concernant une version de Support Package spécifique. déploiement Le logiciel de la plateforme de BI installé, configuré et s'exécutant sur un ou plusieurs ordinateurs. l'installation Une instance des fichiers de la plateforme de BI créée par le programme d'installation sur un ordinateur. Magasin de données d'audit Base de données utilisée pour stocker les données d'audit. mettre en cluster Mettre en cluster signifie 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. migration Processus de transfert de contenu Business Intelligence depuis une version principale précédente (par exemple, depuis XI 3.1) à l'aide de l'outil de gestion de mise à niveau. Ne peut être utilisée pour des déploiements avec la même version principale, voir “promotion”. mise à niveau L'ensemble de la planification, de la préparation, de la migration et du post-traitement nécessaire à la réalisation d'un processus de migration. nœud 10 2013-09-19 Démarrage Groupe de serveurs de la plateforme de BI qui s'exécutent sur le même ordinateur et sont gérés par le même SIA (Server Intelligence Agent). ordinateur Le logiciel de la plateforme de BI est installé sur un ordinateur. Plateforme de BI Version abrégée de plateforme SAP BusinessObjects Business Intelligence. produits de modules complémentaires Produits fonctionnant avec la plateforme de BI mais disposant de leur propre programme d'installation, tel SAP BusinessObjects Explorer. promotion Processus de transfert de contenu Business Intelligence 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. Server Intelligence Agent Un SIA est un processus gérant un groupe de serveurs. Les tâches de gestion incluent l'arrêt, le démarrage et le redémarrage des serveurs. serveur Un processus de la plateforme de BI. Un serveur héberge un ou plusieurs services. Serveurs d'applications Web Un serveur d'applications Web traite du contenu dynamique. Par exemple, le serveur d'applications Web fourni pour 4.1 est Tomcat 7. Support Package Mises à jour concernant une version secondaire ou principale. version principale Versions logicielles telles que 4.0. version secondaire Versions logicielles telles que 4.1. 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. 11 2013-09-19 Démarrage 2.2.1 Personnalisation de la plateforme SAP BusinessObjects Business Intelligence Vous pouvez personnaliser de nombreux aspects du déploiement de la plateforme de Business Intelligence : • Personnaliser le programme d'installation. Vous pouvez supprimer des fonctionnalités, des packs linguistiques et des ressources afin de réduire la taille du produit installé, renommer le produit, changer les images, masquer les écrans d'installation non désirés, incorporer un code clé et préremplir la saisie utilisateur. Voir Introduction pour “Personnalisation du programme d'installation de la plateforme de Business Intelligence” dans ce document. • Personnaliser les applications Web de la zone de lancement BI et OpenDocument. Vous pouvez changer les titres et les URL utilisés pour accéder aux applications Web. Vous pouvez changer l'apparence et le branding de ces applications à l'aide d'images et de feuilles de style en cascade (CSS) personnalisées. Voir Introduction pour “Personnalisation d'applications Web” dans ce document. • Personnaliser le visualiseur de rapports de l'API JavaScript de Crystal Reports. Vous pouvez changer le logo et personnaliser le style visuel du visualiseur à l'aide d'images personnalisées et de feuilles de style en cascade (CSS). Vous pouvez ajouter vos propres écouteurs d'événements et d'actions à l'API JavaScript existante, ou ajouter vos propres fichiers JavaScript externes. Voir Personnalisation du visualiseur de Crystal Reports JavaScript 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 : 12 2013-09-19 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. 13 2013-09-19 Démarrage • Si vous souhaitez personnaliser le programme d'installation de SAP Crystal Reports, vous pouvez en modifier l'apparence, masquer les écrans d'assistant non souhaités par les utilisateurs et supprimer les fonctionnalités non utilisées afin de réduire la taille du produit installé sur les ordinateurs client. Voir Introduction pour “Personnalisation de SAP Crystal Reports 2011” dans ce document. • Si vous souhaitez personnaliser le concepteur de rapports, vous pouvez modifier l'écran de présentation ou la page de démarrage. Vous pouvez également personnaliser le nom du produit, les menus et d'autres atouts du concepteur de rapports. Voir Personnalisation du concepteur de rapports dans ce document. Le diagramme qui suit illustre le workflow où sont réalisés tous les types de personnalisation : 14 2013-09-19 Démarrage 15 2013-09-19 Démarrage 16 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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. 17 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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. a. Créez un dossier de travail sur votre ordinateur de développement, par exemple : C:\SAPCus tomTool\packages. b. Copiez le contenu du package d'installation de la plateforme de BI sous C:\SAPCustomTool\pa ckages. 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. c. (Facultatif). Ajoutez votre code clé à l'exemple de fichier de configuration. Dans un éditeur XML, ouvrez le fichier C:\SAPCustomTool\packages\Collate rals\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\pa ckages\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 package Dir=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDe tail=error > C:\oemlog.log Assurez-vous que le programme d'installation personnalisé a été créé sous C:\SAPCustom Tool\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) 18 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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. 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/pa ckage. 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. 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/Cu stomizationTool/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/Customiza tionTool. 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 package Dir=/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/Cu stomizationTool/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/ 19 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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. 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. Remarque : 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://ser vice.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. 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. 20 2013-09-19 Personnalisation du programme d'installation de la plateforme de 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 : • • • • 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. 21 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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. Rubriques associées • Paramètres de ligne de commande 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 : 22 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Plateforme Emplacement de l'exemple de fichier de configuration Windows Collaterals\Tools\CustomizationTool\example_customiza tion_win_boe.xml Unix ou Linux Collaterals/Tools/CustomizationTool/example_customization_li nux_boe.xml Le fichier doit avoir ce format : <oem name="<Any name>"> <cloneProduct sourceId="product.businessobjects64-4.0-core-32"> ... ... </cloneProduct> </oem> Le fichier de configuration pour le programme d'installation complète peut avoir n'importe quel nom, oem.xml, par exemple. Le fichier de configuration du programme d'installation de Support Package est décrit dans la section Personnalisation de programmes d'installation de mise à jour. Remarque : Le fichier de configuration doit être écrit dans une syntaxe XML correcte. Utilisez un éditeur XML pour créer et modifier le fichier, et vérifiez si le format est correct avant d'exécuter l'outil. Exemple : Ce fichier d'exemple spécifie les personnalisations suivantes : • Changer le nom long du produit pour Custom Company Server pour toutes les langues. • Changer le nom court du produit pour Custom CS pour toutes les langues. • Supprimer l'écran d'installation intitulé "Choose Installation Type" et définir le type d'installation sur Custom. • Spécifier que les seuls packs linguistiques inclus dans le package d'installation sont l'anglais, le français, l'allemand, l'italien et le chinois. <oem name="CustomCompanyServer"> <cloneProduct sourceId="product.businessobjects64-4.0-core-32"> <replaceString id="product.boe64_name" value="Custom Company Server" lang="all"/> <replaceString id="product.boe64_shortname" value="Custom CS" lang="all"/> <replaceProperty id="InstallType" defaultValue="custom"/> <removeDialog id="ChooseInstallType.dialog"/> <languageIncludeList value="en;fr;de;it;zh_CN"/> </cloneProduct> </oem> 23 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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. 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 replaceS tring avec l'ID de chaîne souhaité : <replaceString id="<string id>" value="<new value>" lang="<language list>"/> Il existe quatre chaînes représentant le nom du produit et le numéro de version : le nom long du produit, le nom court du produit, le numéro de version du produit et le numéro de version principale du produit. Le nom complet du produit est composé du nom long du produit et du numéro de version. Le nom court du produit et la version principale du produit sont utilisés dans le menu contextuel de Windows. Tableau 3-2 : Nom du produit et numéro de version Description de la chaîne ID de chaîne Valeur par défaut Nom long du produit product.boe64_name Plateforme SAP BusinessObjects Business Intelligence Nom court du produit product.boe64_shortname Serveur de la plateforme de BI Version du produit product_version 4.1 Version principale du produit product_majorversion 4 Remarque : Vous devez personnaliser la version du produit et la version principale du produit ensemble. Par exemple, si vous changez la version du produit pour 1.0, vous devez également personnaliser la version principale 24 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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"/> 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 : 25 Nom de fichier Ligne originale Ligne modifiée dunit\product.busines sobjects64-4.0-core32\setup.ui.frame work\uitext\BusinessOb jects64\product.la ng_<code langue>.ui text.xml <string id="product name_patch" value=" FP3"/> <string id="product name_patch" value=""/> 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Nom de fichier Ligne originale Ligne modifiée dunit\product.busines sobjects64-4.0-core32\setup.ui.frame work\uitext\frame work\setup.ui.frame work.lang_<code la ngue>.uitext.xml <string id="produ ct_patch" value="FP3"/> <string id="produ ct_patch" value=""/> Comme ci-dessus <string id="produ ct_patch_prespace" va lue=" FP3"/> <string id="produ ct_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 Codes langue. 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 : 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 26 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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> Attribut Valeur ID d'unité de déploiement du raccourci à modifier. Les valeurs classiques sont : • product.businessobjects64.shortcut.ccm-4.0-core Central Configuration Manager • product.businessobjects64.shortcut.infoview-4.0-core Zone de lancement BI duSourceId • product.businessobjects64.shortcut.cmc-4.0-core Central Management Console Pour obtenir la liste complète des valeurs sourceId, voir ID des unités de déploiement de raccourci (Windows uniquement). 27 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Attribut Valeur linkFullPath Chemin d'accès complet au raccourci. Veillez à ajouter .lnk au lien de raccourci, sans quoi le lien ne sera pas créé. Vous pouvez placer le lien de raccourci dans le menu Démarrer ou sur le bureau. L'outil de personnalisation SAP BusinessObjects crée les liens correctement. Vous pouvez spécifier un lien par langue. Pour obtenir une liste des codes de langue, voir Codes langue. description Chaîne d'info-bulle à afficher lorsque l'utilisateur survole le raccourci avec la souris. Vous pouvez spécifier une info-bulle par langue. Remarque : Vous pouvez personnaliser les liens de raccourci suivants mais pas leur info-bulle : • Zone de lancement BI (anciennement InfoView) • Documentation en ligne • Serveurs WACS stockés dans InfoView • Serveur conteneur d'applications Web Cela sera résolu dans une prochaine version. Exemple : Dans cet exemple, on personnalise le nom du raccourci de la Central Management Console en Gestionnaire de perspective sur les ventes (anglais) pour l'anglais et Gestionnaire de perspective sur les ventes pour le français, et on place les raccourcis sous l'entrée du menu Démarrer nommée Plateforme de perspective sur les ventes 1. On personnalise également l'info-bulle en Lancer le Gestionnaire de ventes pour l'anglais et Lancer le Gestionnaire de ventes (français) pour le français. Le nom et l'info-bulle du raccourci restent inchangés dans toutes les autres langues. <shortcut duSourceId="product.businessobjects64.shortcut.cmc-4.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> La personnalisation apparaît ci-dessous : 28 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Modification du raccourci Tomcat Il existe deux liens pour le raccourci Tomcat : "Administration Tomcat" et "Configuration Tomcat" présentés ci-dessous : Vous devez effectuer des étapes supplémentaires pour personnaliser ce raccourci. Utilisez cet élément shortcut pour personnaliser le lien "Administration Tomcat". Mentionnez l'élément pathToTarget. <shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core" pathToTarget="http://localhost:[To mcatConnectionPort]/manager/html"> <arg id="linkFullPath" value="<full path to shortcut link>" lang="<language list>"/> <arg id="description" value="<tooltip string>" lang="<language list>"/> </shortcut> Utilisez cet élément shortcut pour personnaliser le lien "Configuration Tomcat". Mentionnez l'élément pathToTarget. <shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core" pathToTarget="[INSTALLDIR]tom cat\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> Exemple : Dans cet exemple, on personnalise le nom du raccourci "Administration Tomcat" en raccourci tomcat 1 (anglais et français) pour les installations en anglais et en français, et raccourci tomcat 1 (allemand) pour les installations en allemand. On place les raccourcis dans l'entrée du menu Démarrer nommée Company Programs . On personnalise l'info-bulle en raccourci tomcat 1 (anglais et français) pour l'anglais et le français et en raccourci tomcat 1 (autres) pour toutes les autres langues. <shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core" pathToTarget="http://localhost:[To 29 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence mcatConnectionPort]/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" la ng="de"/> <arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat (all others) shortcut1.lnk" lang="it;zh_cn"/> <arg id="description" value="tomcat(english and french) shortcut1" lang="en;fr"/> <arg id="description" value="tomcat (German) shortcut1" lang="de" /> <arg id="description" value="tomcat (all others) shortcut1" lang="it;zh_cn" /> </shortcut> <shortcut duSourceId="product.businessobjects64.shortcut.tomcat-4.0-core" pathToTarget="[INSTALLDIR]tom cat\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" la ng="de"/> <arg id="linkFullPath" value="[programmenufolder]\Company Programs\tomcat (all others) shortcut2.lnk" lang="it;zh_cn"/> <arg id="description" value="tomcat(english and french) shortcut2" lang="en;fr"/> <arg id="description" value="tomcat (German) shortcut2" lang="de" /> <arg id="description" value="tomcat (all others) shortcut2" lang="it;zh_cn" /> </shortcut> 3.6.2.3 Personnalisation de l'utilitaire Ajout/Suppression de programmes de Windows (Windows uniquement) Vous pouvez personnaliser le nom d'affichage, l'éditeur et l'icône dans l'utilitaire "Ajout/Suppression de programmes" de Windows. Vous ne pouvez pas personnaliser le numéro de version. Utilisez l'élément suivant : <arp duSourceId="product.businessobjects64.arp-4.0-core"> <arg id="publisher" value="<publisher name>"/> <arg id="display_name" value="<product name>" lang="<language list>"/> <arg id="display_icon" value="<full path to icon>"/> </arp> Les icônes affichées dans l'utilitaire "Ajout/Suppression de programmes" de Windows sont généralement de 16 x 16. Pour des informations complètes sur la création d'icônes, voir la documentation Windows. Exemple : Changez le nom du produit dans l'utilitaire Ajout/Suppression de programmes de Windows pour Plateforme de perspective sur les ventes. Ce changement n'affectera que les installations en anglais. Changez l'éditeur pour Data Excellence Corp. Remplacez l'icône affichée par celle se trouvant sous C:\SAPCustomTool\DEC_logo.ico. Remarque : Pour mettre en pratique cet exemple, vous devez placer une icône nommée DEC_logo.ico à l'emplacement C:\SAPCustomTool. <arp duSourceId="product.businessobjects64.arp-4.0-core"> <arg id="publisher" value="Data Excellence Corp"/> <arg id="display_name" value="Sales Insight Platform" lang="en"/> <arg id="display_icon" value="C:\SAPCustomTool\DEC_logo.ico"/> </arp> 30 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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. 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"/> 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é. 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. 31 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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 : 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é. 32 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Exemple : Cet exemple montre comment supprimer l'écran d'installation intitulé "Sélectionner le serveur d'applications Web Java". <removeDialog id="ChooseWebAppServer.dialog"/> 3.6.5 Incorporation d'un code clé Vous pouvez incorporer un code clé dans le programme d'installation de sorte que le client n'ait pas besoin d'en saisir un. Cette tâche implique : • La saisie d'une valeur par défaut pour le code clé • La suppression de l'écran d'installation où l'utilisateur saisit un code clé Exemple : Utilisez l'élément replaceProperty avec id="ProductKey" pour fournir un code clé par défaut. Les codes clés doivent avoir le format XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX. Utilisez l'élément removeDialog avec id="EnterProductKey.dialog" pour supprimer l'écran d'installation demandant la clé de licence. <replaceProperty id="ProductKey" defaultValue="XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX"/> <removeDialog id="EnterProductKey.dialog"/> Rubriques associées • ID d'écran d'installation et de propriété • Personnalisation de la saisie utilisateur • Suppression d'écrans d'installation 3.6.6 Suppression de fonctionnalités La plateforme SAP BusinessObjects Business Intelligence se compose de nombreuses fonctionnalités facultatives. Vous pouvez supprimer une fonctionnalité depuis le programme d'installation. Utilisez l'élément removeFeature avec id="<id de la fonctionnalité>" : <removeFeature id="<Feature ID>"/> Pour obtenir une liste complète des ID de fonctionnalité, voir ID des fonctionnalités. 33 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Lorsque vous spécifiez la suppression d'une fonctionnalité, l'outil de personnalisation SAP BusinessObjects supprime tous les fichiers exécutables, écrans d'installation et autres fichiers appartenant à cette fonctionnalité. La suppression de fonctionnalités non nécessaires est un bon moyen de réduire la taille du produit personnalisé. Exemple : Supprimez la fonctionnalité Crystal Reports. Cela supprime tous les serveurs, fichiers et ressources Crystal Reports. <removeFeature id="CrystalReportsServers"/> Rubriques associées • ID des fonctionnalités 3.6.7 Empêchement des vérifications des prérequis Les prérequis sont des conditions devant être remplies sur l'ordinateur hôte afin que le programme d'installation réussisse dans sa tâche. Le programme d'installation vérifie l'existence de ces prérequis avant de démarrer et affiche les résultats sur l'écran "Vérification des prérequis". La suppression de l'écran "Vérification des prérequis" empêche les vérifications de prérequis d'être effectuées. Utilisez l'élément <removeDialog> avec id="CheckPreRequisites.dialog". Remarque : Il est recommandé de supprimer cet écran d'installation uniquement si vous réalisez les vérifications de prérequis par d'autres moyens. Si les prérequis ne sont pas remplis, le programme d'installation échoue dans sa tâche. Exemple : Dans cet exemple, on supprime l'écran "Vérification des prérequis" et on empêche les vérifications de prérequis d'être effectuées. <removeDialog id="CheckPreRequisites.dialog"/> 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 34 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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 : • Supprimez les vérifications de ressources dans setup.sh. • Supprimez la vérification des prérequis dans product.seed.xml. • 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/redhat-release 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 glibc-2.12-1.7.el6.i686 or higher on RedHat and libstdc++33-32bi # on SuSE osname=`uname -s` if [ "$osname" = "Linux" ]; then if [ -f "/etc/redhat-release" ]; then version="`cat /etc/redhat-release | sed 's/.* \([0-9,.]*\) .*/\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" glibc-2.12-1.7.el6.i686 or higher." fi fi fi if [ -f "/etc/SuSE-release" ]; then version="`cat /etc/SuSE-release | grep "VERSION = 11"`" if [ "$version" != "" ]; then libstd="`rpm -q -a | grep libstdc++33-32bit`" if [ "$libstd" = "" ]; then requiredLibs="$requiredLibs libstdc++33-32bit" fi fi fi if [ "$requiredLibs" != "" ]; then echo "Installation aborted. The following libraries are required to run the installer:$requiredLibs" exit 0 fi fi 2. Supprimez la section suivante dans le fichier dunit/product.businessobjects64-4.0-core32/product.seed.xml. Cette section utilise le fichier /etc/redhat-release pour vérifier les correctifs installés et doit être supprimée. <prerequisite id="CheckPatchLevel" description="#prerequisite.CheckPatchLevel.description#" reason="[Check PatchLevelFailReason]" 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 produ ct.seed.xml. Consultez également la documentation suivante : • • 35 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. 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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 Codes langue. Remarque : Les packs linguistiques peuvent être volumineux. Le programme d'installation sera plus petit si moins de packs linguistiques y sont inclus. Exemple : Incluez les packs linguistiques anglais, français et allemand dans le programme d'installation. L'utilisateur peut faire son choix parmi cette liste lors de l'installation. <languageIncludeList value="en;fr;de"/> 3.6.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 defaultVa lue="0" Exemple : <replaceProperty id="LaunchWDeploy" defaultValue="0"/> 3.6.11 Suppression de la base de données par défaut 36 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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.businessobjects64-4.0-core-32\setup.ui.framework\resources Vous pouvez personnaliser les ressources de ce dossier. Des ressources couramment utilisées sont : • Les images du programme d'installation • Le contrat de licence du programme d'installation Pour personnaliser une ressource : 1. Créez un dossier de ressources personnalisées, par exemple (sous Windows) : C:\SAPCustom Tool\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"/> 37 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Attribut cleanTarget Si vous définissez cleanTarget='yes', l'outil de personnalisation supprimera le dossier resources original et utilisera uniquement les ressources contenues dans le dossier de ressources personnalisées. Cette option n'est pas recommandée. Rubriques associées • Personnalisation des images dans le programme d'installation • Personnalisation du contrat de licence 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.businessobjects64-4.0-core-32\setup.ui.framework\resources Tableau 3-5 : Fichiers image dans le dossier resources Nom de l'image Nom du fichier Taille (L x H) Ecran d'accueil dialog Full.bmp 500 x 400 px 38 Image par défaut 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Nom de l'image Nom du fichier Taille (L x H) Image supérieure pour tous les écrans dialog Top.bmp 500 x 83 px Panneau d'informations pour la boîte de dialogue de progression billboard.bmp 500 x 193 px Image par défaut 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:\SAPCustom Tool\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"/> Rubriques associées • Modification des ressources 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.businessobjects64-4.0-core-32\setup.ui.framework\resources\<code langue> Par exemple, sur les plateformes Windows, le contrat de licence en anglais se trouve ici : 39 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\resources\en\li cense_en.rft Sur les plateformes Unix et Linux, le contrat de licence en anglais se trouve ici : dunit/product.businessobjects64-4.0-core-32/setup.ui.framework/resources/en/li cense_en.txt Pour obtenir une liste des codes de langue, voir Codes langue. Vous personnalisez le contrat de licence en créant un fichier de licence, en plaçant le fichier dans le dossier de ressources personnalisées et en ajoutant l'élément resources au fichier de configuration. Exemple : Personnaliser le contrat de licence en japonais sur les plateformes Windows Le contrat de licence en japonais se trouve ici : dunit\product.businessobjects64-4.0-core-32\setup.ui.framework\re sources\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"/> Rubriques associées • Modification des ressources 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>"/> 40 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Remarque : Vous devez affecter à l'attribut cleanTarget la valeur yes afin que l'outil de personnalisation remplace le dossier original par le nouveau. Pour supprimer des éléments du dossier Collaterals 1. Copiez le contenu du dossier Collaterals existant dans un nouvel emplacement, par exemple (sous Windows) : C:\SAPCustomTool\Utilities. 2. Supprimez les éléments de C:\SAPCustomTool\Utilities qui ne sont pas nécessaires pour votre programme d'installation personnalisé. Pour en savoir plus, voir ci-dessous. 3. Ajoutez l'élément <collaterals> au fichier de configuration pour spécifier l'emplacement du dossier de collatéraux personnalisés, par exemple : <collaterals cleanTarget="yes" sourcePath="C:\SAPCustomTool\Utilities"/> Tableau 3-6 : Description des éléments du dossier Collaterals 41 Dossier Description Quand supprimer Collaterals > Add-Ons > SAP Fournit la connectivité aux systèmes SAP. Supprimez ce dossier s'il n'y a aucun besoin de connexion aux systèmes SAP. Collaterals > Add-Ons > Subversion Subversion est le système de contrôle de version par défaut utilisé par la Gestion du cycle de vie (LCM). Supprimez si la fonctionnalité LCM est supprimée. Collaterals > Add-Ons > Tivoli Agent La fonctionnalité de surveillance des serveurs peut intégrer IBM Tivoli et cet élément fournit la connectivité. Supprimez si l'intégration à IBM Tivoli n'est pas nécessaire. Collaterals > Customization Template Fichiers de modèles requis. Ne supprimez pas ce dossier. Collaterals > DiagnosticsAgent7.3 Agent SAP Solution Manager Diagnostics (SMD). SMD est utilisé par les outils Support SAP pour dépanner le produit installé. Supprimez si la fonctionnalité SMD est supprimée. Collaterals > Docs Documentation dans toutes les langues prises en charge par la plateforme SAP BusinessObjects Business Intelligence. Supprimez toutes les langues qui ne sont pas incluses au programme d'installation personnalisé. Pour obtenir une liste des codes de langue, voir Codes langue. 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Dossier Description Quand supprimer Collaterals > Tools > CustomizationTool Objet de personnalisation SAP BusinessObjects. Supprimez ce dossier si les clients n'ont pas besoin de personnaliser leurs programmes d'installation. Collaterals > Tools > LCM command line tool Utilitaire de ligne de commande de la Gestion du cycle de vie (LCM). Supprimez si la fonctionnalité LCM est supprimée. Collaterals > Tools > wdeploy WDeploy sert à déployer des applications Web sur les serveurs d'applications Web autres que Tomcat. Suppression déconseillée. Supprimez seulement si les clients utiliseront uniquement Tomcat. 3.7 Exécution de l'outil L'outil de personnalisation SAP BusinessObjects est inclus dans le package d'installation de la plateforme SAP BusinessObjects Business Intelligence à cet emplacement : Collaterals\Tools\CustomizationTool Sur les plateformes Windows, l'outil se nomme customizationtool.exe. Sur les plateformes Unix et Linux, l'outil se nomme customizationtool.sh. Cette section explique les paramètres de ligne de commande. Remarque : L'outil de personnalisation peut prendre plusieurs minutes pour réaliser l'opération. Vous pouvez vérifier sa progression en visualisant le fichier journal. Exemple : Dans cet exemple, l'outil de personnalisation est exécuté sur une plateforme Windows. Pour mettre en pratique cet exemple, vous devez : • Créez un fichier de configuration nommé oem.xml à l'emplacement C:\SAPCustomTool. • 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. • Créez un dossier nommé output à l'emplacement C:\SAPCustomTool. C:\SAPCustomTool\packages\Collaterals\Tools\CustomizationTool\customizationtool.exe xml=C:\SAPCustomTool\oem.xml packageDir=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDetail=error > C:\oemlog.log 42 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 3.7.1 Paramètres de ligne de commande Tableau 3-7 : Paramètres obligatoires Paramètre Description Exemple (Windows) xml Chemin d'accès complet au fichier de configuration. xml=example_customiza tion_win_boe.xml Chemin d'accès complet au dossier contenant le programme d'installation que vous modifiez. packageDir outputDir 43 Le programme d'installation est téléchargé à partir du SAP Service Marketplace en vue de démarrer l'installation de la plateforme SAP BusinessObjects Business Intelligence. Il contient les dossiers Collaterals, dunit, langs et setup.engine ainsi que d'autres fichiers binaires. 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. packageDir=C:\SAPCustom Tool\packages outputDir=C:\SAPCustom Tool\output 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Tableau 3-8 : Paramètres facultatifs Paramètre baselinePath Description Chemin complet du dossier racine contenant les versions d'origine non personnalisées de l'ensemble des programmes d'installation complets et de mises à jour que vous avez personnalisés. Pour spécifier plusieurs dossiers racine, utilisez un point-virgule (; - Windows) ou deux-points (; - Unix). Exemple (Windows) Supposez que vous souhaitiez personnaliser Plateforme SAP BusinessObjects BI 4.0 Support Package 5.0 et que vous ayez personnalisé les précédents programmes : 4.0 SP2 (installation complète), 4.0 SP4. Personnalisez 4.0 Support Package 5, et fournissez le chemin du dossier racine vers les packages non personnalisés pour l'installation complète 4.0 SP2 et l'installation de la mise à jour SP4. Par exemple, si les packages non 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\ Voir Personnalisation des programmes d'installation de mise à jour pour plus d'informations et d'exemples sur le paramètre baseline Path. logDetail 44 Niveau de détail de la journalisation. La valeur par défaut est info. Valeurs acceptées : • error • warn • info • debug • trace logDetail=warn 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Paramètre Description Exemple (Windows) 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. action • action=validate validate L'outil valide le fichier de configuration mais ne réalise aucune personnalisation. Rubriques associées • Démarrage rapide pour la plateforme de Business Intelligence (Windows) • Démarrage rapide pour la plateforme de Business Intelligence (Unix ou Linux) 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. 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 > 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 B > SBOP BI platform (former SBOP Enterprise) > SBOP BI PLATFORM (ENTERPRISE) > SBOP BI PLATFORM 4.1 > Comprised Software Component Versions > SBOP BI PLATFORM SERVERS 4.1 > <plateforme>. 45 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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 et dans Exécution de l'outil avec certaines modifications apportées à la commande de ligne et au fichier de configuration. Voir Personnalisation de programmes d'installation de mise à jour dans cette section. 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 ne devez installer que les mises à jour que vous souhaitez. Il peut s'agir d'une version secondaire, d'un Support Package, d'un correctif ou d'une combinaison valable de ces trois mises à jour. Puis-je installer une mise à jour non personnalisée sur une installation plateforme de BI personnalisée ? Oui. Des mises à jour personnalisées et non personnalisées peuvent être appliquées à votre installation personnalisée. Toutefois, les programmes d'installation de version secondaire, de Support Package ou de correctif non personnalisés n'afficheront pas vos personnalisations de marque ni d'installation (comme les fonctionnalités supprimées ou les modifications de raccourcis) que vous avez créées pour le programme d'installation principal. J'ai livré une version personnalisée de la plateforme de BI à des clients, mais je veux modifier la personnalisation dans un programme d'installation de mise à jour. Est-ce possible ? Ce scénario n'est en effet pas pris en charge. Les personnalisations que vous réalisez sur les programmes d'installation de mise à jour doivent être cohérentes avec les personnalisations originales. 3.8.2 Démarrage rapide pour les programmes d'installation de mise à jour Assurez-vous que vous avez personnalisé et installé le programme d'installation 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) et que le programme d'installation non personnalisée se trouve sous C:\SAPCustomTool\packages. 46 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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 : customizationtool.exe xml=example_customization_win_boe.xml package Dir=C:\SAPCustomTool\SupportPackage baselinePath=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output\SupportPackage logDetail=error > C:\oe mlog_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 et Exécution de l'outil pour personnaliser les programmes d'installation des versions secondaires, des Support Packages et des correctifs à ces différences près : • • • 47 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. 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence • Faites référence à tous les programmes d'installation prérequis à l'aide de la commande baseli nePackages. 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 et ID et codes pour la personnalisation de la plateforme de BI 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 : product.boe64.patch-4.x.x.x-core-32 Utilisez le nom de ce dossier comme product version (version du produit). Exemple : Cet exemple de fichier de configuration présente une personnalisation de la plateforme SAP Crystal Reports 4.1 de Business Intelligence Patch 1, dont la version du produit est product.boe64.patch4.1.0.1-core-32. Le fichier de configuration personnalise le nom long du produit en Custom Company Server et le nom court du produit en Custom CS. <oem name="Custom Patch Tool"> <clonePatchProduct sourceId="product.boe64.patch-4.1.0.1-core-32"> ... </clonePatchProduct> </oem> Pour utiliser le paramètre baselinePath Utilisez le paramètre de ligne de commande baselinePath pour faire référence à un dossier racine contenant les versions d'origine non personnalisées de l'ensemble des précédents programmes d'installation complets ou de mise à jour que vous avez personnalisés. Cela signifie que vous devez conserver les packages d'installation d'origine. Remarque : Ce paramètre remplace le paramètre baselinePackages introduit dans 4.0 Feature Pack 3. Pour simplifier la valeur du paramètre baselinePath, référencez un seul dossier racine. L'outil de personnalisation ignorera les fichiers et dossiers inutiles. Autrement, pour spécifier plusieurs dossiers 48 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence racine, utilisez un point-virgule (; - Windows) ou deux-points (; - Unix) dans la valeur baselinePath. Prenons les exemples suivants sous Windows. Exemple : Personnalisation de 4.0 SP5 Patch 2 Supposez que vous personnalisiez la plateforme BI 4.0 Support Package 5 Patch 2 et que vous ayez personnalisé les précédents programmes : 4.0 SP2 (installation complète), 4.0 SP4, 4.0 SP5, 4.0 SP5 Patch 1. Supposez que les programmes d'installation non personnalisés se trouvent dans la structure de répertoire suivante : C:\productUpdates\4.0\ \SP2 Full\ \SP4\ \SP5\ \SP5 Patch 1\ Définissez le paramètre baselinePath sur le dossier racine : baselinePath=C:\productUpdates\4.0\ Exemple : Personnalisation de 4.1 SP 1 Supposez que vous personnalisiez la plateforme BI 4.1 Support Package 1 et que vous ayez personnalisé les précédents programmes : 4.0 SP2 (installation complète), 4.0 SP4, 4.0 SP5, 4.1. Supposez que les programmes d'installation non personnalisés se trouvent dans la structure de répertoire suivante : C:\productUpdates\ \4.0\ \SP2 Full\ \SP4\ \SP5\ \4.1\ \Full\ Définissez le paramètre baselinePath sur le dossier racine : baselinePath=C:\productUpdates\ 3.9 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é 49 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence 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) 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/EtendueNiveau Web. Il s'agit d'un problème connu qui sera résolu. • Servers : (Supprimer tous les composants serveur répertoriés ci-dessous) • 50 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 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence • AdvancedAnalysisServices : (supprime tous les composants Analysis répertoriés ci-dessous) • MultidimensionalAnalysisServices (MDAS) • BExWebApplicationsService • CrystalReportsServers : (Supprime tous les composants SAP Crystal Reports répertoriés ci-dessous) • 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) • • • • XcelsiusServers (Dashboards) MobileServices • • • • • MobileServers 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) • 51 WebIProcServer (Traitement Web Intelligence) WebISchedulingServices (Planification Web Intelligence) 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) • DataAccess.DataFederator • DataAccess.HPNeoView • DataAccess.MySQL • DataAccess.GenericJDBC • DataAccess.GenericODBC • DataAccess.GenericOLEDB • DataAccess.OptionalDataDirectODBC • DataAccess.MaxDB • DataAccess.SAPHANA 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • • 52 DataAccess.Salesforce (Salesforce.com) DataAccess.Netezza DataAccess.Microsoft_AnalyticalServices DataAccess.MicrosoftExchange DataAccess.MicrosoftOutlook DataAccess.Microsoft_SQLServer DataAccess.Microsoft_Access DataAccess.Ingres DataAccess.Greenplum DataAccess.IBMDB2 DataAccess.Informix DataAccess.ProgressOpenEdge DataAccess.Oracle DataAccess.Sybase DataAccess.Teradata DataAccess.SAPBW DataAccess.SAPERP DataAccess.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 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence • • • • • • • 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) Rubriques associées • Suppression de fonctionnalités 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. Tableau 3-9 : ID des unités de déploiement de raccourci 53 ID de l'unité de déploiement de raccourci Cible du raccourci product.businessobjects64.shortcut.wde ploy-4.0-core WDeploy product.businessobjects64.shortcut.ccm4.0-core Central Configuration Manager product.businessobjects64.shortcut.cmc4.0-core Central Management Console product.businessobjects64.shortcut.in foview-4.0-core Zone de lancement BI (InfoView) product.businessobjects64.short cut.odbc-4.0-core Administrateur de source de données 32 bits product.businessobjects64.shortcut.on linedoc-4.0-core Documentation en ligne product.businessobjects64.shortcut.to mcat-4.0-core Apache Tomcat. Pour en savoir plus, voir Modification du raccourci Tomcat. product.businessobjects64.shortcut.up grade-4.0-core Outil de gestion de mise à niveau 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence ID de l'unité de déploiement de raccourci Cible du raccourci product.businessobjects64.shortcut.wa cs.infoview-4.0-core Serveurs WACS stockés dans InfoView product.businessobjects64.shortcut.wa cs-4.0-core Serveur conteneur d'applications Web Rubriques 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"/> Tableau 3-10 : Chaînes couramment modifiées ID de chaîne Description product.boe64_name Nom long du produit product.boe64_shortname Nom court du produit product_version Version du produit product_majorversion Version principale du produit Rubriques associées • Personnalisation du nom du produit et du numéro de version 3.9.4 Codes langue 54 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence L'outil de personnalisation SAP BusinessObjects utilise ces codes langue pour représenter les langues prises en charge : 55 langue Code Anglais EN Tchèque CS Danois DA Néerlandais NL Finnois FI Français FR Allemand DE Hongrois HU Italien IT Japonais JA Coréen KO Norvégien (Bokmål) NB Polonais PL Portugais PT Roumain RO Russe RU Chinois simplifié zh_CN Slovaque SK Espagnol ES Suédois SV Thaï TH Chinois traditionnel zh_TW turc TR 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Rubriques 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) • Suppression de packs linguistiques • 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. Tableau 3-12 : ID d'écran d'installation et propriétés associées Titre de l'écran d'installation ID de l'écran d'installation ID de propriété Valeur(s) de propriété autorisée(s) "Vérifier les prérequis" CheckPreRequi sites.dialog Non applicable Non applicable SortedAvailableSe tupLanguages Ensemble de codes langue sous lesquels peut être exécuté le programme d'installation, "en:ja", par exemple SetupUILanguage Code langue unique représentant la langue sous laquelle sera exécuté le programme d'installation, "en", par exemple Non applicable Non applicable "Sélectionner la langue du programme d'installation" "Bienvenue dans l'Assistant d'installation..." 56 SelectUILan guage.dialog ShowWelcomeS creen.dialog 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation ID de l'écran d'installation ID de propriété Valeur(s) de propriété autorisée(s) "Contrat de licence" ShowLicenseA greement.dialog Non applicable Non applicable RegisteredUser "Nom d'utilisateur" RegisteredCompany "Nom de l'entreprise" ProductKey "Code clé du produit" SelectedLanguage Packs L'ensemble des packs linguistiques à installer, "en:ja", par exemple. Pour une liste des codes langue, voir Codes langue. "Configurer l'enregistrement du produit" 57 EnterProduct Key.dialog "Sélectionner les packs linguistiques" SelectLanguage Pack.dialog "Sélectionner un type d'installation" ChooseInstall Type.dialog InstallType • • • "Configurer le dossier de destination" ChooseInstall Dir.dialog InstallDir Dossier d'installation par défaut (Complète) personnalisé webtier "Sélectionnez la base de données existante ou la base de données par défaut" SelectData Source.dialog SelectIntegrated Database • "Installation étendue" ExpandInstallMe ssage.dialog Non applicable Non applicable "Sélectionner le serveur d'applications Web Java" ChooseWebAppSer ver.dialog WebAppServerType • • • "Sélection des fonctions" SelectFea tures.dialog Non applicable Non applicable "Sélectionner le contrôle de version" SelectLCM.dia log NewOrExistingLCM • • • 0 (Utiliser une base de données existante) 1 (Installer et utiliser la base de données par défaut) tomcat manuel wacs existante nouvelle 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation ID de l'écran d'installation ID de propriété Valeur(s) de propriété autorisée(s) "Sélectionner Nouvelle installation ou Installation étendue" ChooseExpandIns tall.dialog NewOrExpandIns tall • • LCMName Nom du référentiel LCMPort Port du référentiel LCMUserName Utilisateur du référentiel LCMPassword Mot de passe du référentiel LCMPasswordCon firm Confirmer le mot de passe SIAPort Port du SIA SIAName Nom du nœud CMSPort Tout numéro de port valide CMSPassword Mot de passe du CMS CMSPasswordCon firm Mot de passe du CMS ClusterKey Clé de cluster du CMS ClusterKeyConfirm Clé de cluster du CMS SQLAnywhereServer Name Nom du serveur SQL Anywhere (Unix et Linux uniquement) SQLAnywherePort Port SQL Anywhere SQLAnywhereAdmin Password Mot de passe de l'administrateur SQL Anywhere (le nom d'utilisateur est dba) "Configurer Subversion" "Configurer le Server Intelligence Agent (SIA)" GetSIAInfo.dia log "Configurer le Central Management Server (CMS)" GetCMSInfo.dia log "Configurer le compte CMS" "Configurer Sybase SQL Anywhere" "Sélectionner Démarrage automatique du serveur" 58 SetLCMCon fig.dialog GetCMSPass word.dialog GetSQLAnywhereI nfo.dialog • ChooseToEnable Servers.dialog EnableServers • nouvelle étendue 0 (Arrêter les serveurs lors de l'installation) 1 (Démarrer les serveurs lors de l'installation) 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation ID de l'écran d'installation ID de propriété Valeur(s) de propriété autorisée(s) • TomcatConnection Port Port de connexion TomcatShutdown Port Port d'arrêt Les deux ID de boîte de dialogue doivent être inclus au fichier de configuration afin de supprimer l'écran "Configurer Tomcat". En d'autres termes, vous devez inclure deux éléments remo veDialog dans votre fichier de configuration. TomcatRedirect Port Port de redirection "Sélectionner la connexion à l'agent Solution Manager Diagnostics (SMD)" SelectSMDInte grate.dialog ChooseSMDIntegra tion "Configurer la connexion à l'agent SMD" ConfigureSMDAge nt.dialog • "Configurer Tomcat" ShowTomcatIn fo.dialog GetTomcatIn fo.dialog • • SMDAgent_HOST Hôte de l'agent SMD SMDAgent_PORT Port de l'agent SMD • ChooseIntroscopeI ntegration "Sélectionnez la connexion à Introscope Enterprise Manager" 59 SelectIntrosco peIntegrate.dia log nointegrate (Ne pas intégrer) integrate (Intégrer) • nointegrate (Ne pas intégrer) integrate (Intégrer) Introscope_ENT_HO ST Nom de l'hôte d'Introscope Intro scope_ENT_PORT Numéro du port d'Introscope 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation "Configurer la connectivité à Introscope Enterprise Manager" ConfigureIntro scope.dialog "Configurer le port d'écoute HTTP" GetWACSPort.dia log "Sélectionner un type de base de données d'audit existant" "Sélectionner le type de base de données du CMS existant" "Informations sur le déploiement du CMS existant" "La plateforme SAP BusinessObjects Business Intelligence a été installée" 60 ID de l'écran d'installation SelectAuditData base.dialog SelectCMSData base.dialog SetRemoteCMSIn fo.dialog ID de propriété Valeur(s) de propriété autorisée(s) Introscope_ENT_HO ST Hôte d'Enterprise Manager Intro scope_ENT_PORT Port d'Enterprise Manager Introscope_ENT_IN STRUMENTATION Définissez-le sur true pour indiquer que vous avez configuré cet écran d'installation WACSPort Numéro de port pour le service conteneur d'applications Web UsingAuditDBType • • • • • • • sybase db2 oracle mysql mssql maxdb aucun UsingCMSDBType • • • • • • sybase db2 oracle mysql mssql maxdb RemoteCMSName Nom du CMS existant RemoteCMSPort Numéro de port pour le CMS existant RemoteCMSAdmin Name Nom d'utilisateur de l'administrateur RemoteCMSAdminPas sword Mot de passe de l'administrateur • ShowInstallCom pleteLaunchWDe ploy.dialog LaunchWDeploy • 0 (Ne pas lancer l'outil WDeploy après l'installation) 1 (Lancer automatiquement l'outil WDeploy après l'installation) 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation "Configurer la base de données d'audit DB2" "Configurer la base de données du référentiel CMS - SQL Anywhere (ODBC)" "Configurer la base de données d'audit SQL Anywhere ( ODBC)" "Configurer la base de données d'audit MaxDB" 61 ID de l'écran d'installation ExistingAu ditDB2.dialog ExistingCMSSQLA nywhere.dialog ExistingAuditSQ LAnywhere.dia log ExistingAudit MaxDB.dialog ID de propriété Valeur(s) de propriété autorisée(s) ExistingAuditi ngDBServer Nom d'alias DB2 ExistingAuditingD BUser Nom d'utilisateur ExistingAuditi ngDBPassword Mot de passe ExistingCMSDBDSN Nom de la source de données ExistingCMSDBUser Nom d'utilisateur pour la base de données existante ExistingCMSDBPass word Mot de passe de l'utilisateur ExistingAuditi ngDBDatabase Nom de la base de données d'audit existante ExistingAuditingD BUser Nom d'utilisateur pour la base de données existante ExistingAuditi ngDBPassword Mot de passe de l'utilisateur ExistingAuditi ngDBDatabase Nom de la base de données d'audit existante ExistingAuditingD BUser Nom d'utilisateur pour la base de données existante ExistingAuditi ngDBPassword Mot de passe de l'utilisateur ExistingAuditi ngDBPort Numéro de port pour la base de données existante ExistingAuditi ngDBServer Nom du serveur MaxDB 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation "Configurer la base de données d'audit SQL Server (ODBC)" "Configurer la base de données d'audit MySQL" "Configurer la base de données d'audit Oracle" 62 ID de l'écran d'installation ExistingAuditM SSQL.dialog ExistingAuditMy SQL.dialog ExistingAuditO racle.dialog ID de propriété Valeur(s) de propriété autorisée(s) ExistingAuditi ngDBDatabase Nom de la base de données SQL ExistingAuditi ngDBServer Nom du serveur SQL ExistingAuditingD BUser Nom d'utilisateur ExistingAuditi ngDBPassword Mot de passe ExistingAuditingD BUseTrustedConnec tion Utiliser la connexion sécurisée ExistingAuditi ngDBDSN Nom de la source de données ExistingAuditi ngDBShowSysDB Afficher la base de données système ExistingAuditi ngDBDatabase Nom de la base de données d'audit ExistingAuditingD BUser Nom d'utilisateur ExistingAuditi ngDBPassword Mot de passe ExistingAuditi ngDBPort Port MySQL ExistingAuditi ngDBServer Serveur MySQL ExistingAuditingD BUser Nom d'utilisateur ExistingAuditi ngDBPassword Mot de passe ExistingAuditi ngDBServer Oracle TNSNAME 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation "Configurer la base de données d'audit Sybase" "Configurer la base de données du référentiel CMS - DB2" "Configurer la base de données du référentiel du CMS MaxDB" 63 ID de l'écran d'installation ExistingAuditSy base.dialog ExistingCM SDB2.dialog ID de propriété Valeur(s) de propriété autorisée(s) ExistingAuditingD BUser Nom d'utilisateur ExistingAuditi ngDBPassword Mot de passe ExistingAuditi ngDBServer Nom du service Sybase ExistingCMSDBSer ver Nom d'alias DB2 ExistingCMSDBUser Nom d'utilisateur ExistingCMSDBPass word Mot de passe • ExistingCM SMaxDB.dialog 0 (Ne pas réinitialiser la base de données existante) 1 (Réinitialiser la base de données existante) ExistingCMSDBRe set • ExistingCMSDBSer ver Nom de la base de données du CMS ExistingCMSDBUser Nom d'utilisateur ExistingCMSDBPass word Mot de passe • 0 (Ne pas réinitialiser la base de données existante) 1 (Réinitialiser la base de données existante) ExistingCMSDBRe set • ExistingCMSDBData base Serveur MaxDB ExistingCMSDBPort Port MaxDB 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation ID de l'écran d'installation ID de propriété Valeur(s) de propriété autorisée(s) ExistingCMSDBSer ver Nom du serveur existant ExistingCMSDBUser Nom d'utilisateur ExistingCMSDBPass word Mot de passe • "Configurer la base de données du référentiel CMS - SQL Server" "Configurer la base de données du référentiel CMS - MySQL" 64 ExistingCMSMSS QL.dialog ExistingCMSMyS QL.dialog 0 (Ne pas réinitialiser la base de données existante) 1 (Réinitialiser la base de données existante) ExistingCMSDBRe set • ExistingCMSDBData base Nom de la base de données du CMS ExistingCMSDBUse TrustedConnection Utiliser la connexion sécurisée ExistingCMSDBDSN Nom de la source de données ExistingCMSDBShow SysDB Afficher la base de données système ExistingCMSDBSer ver Serveur MySQL ExistingCMSDBUser Nom d'utilisateur ExistingCMSDBPass word Mot de passe • 0 (Ne pas réinitialiser la base de données existante) 1 (Réinitialiser la base de données existante) ExistingCMSDBRe set • ExistingCMSDBData base Nom de la base de données du CMS ExistingCMSDBPort Port MySQL 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation "Configurer la base de données du référentiel CMS Oracle" "Configurer la base de données du référentiel CMS - Sybase" "Configurer Subversion" "La plateforme SAP BusinessObjects Business Intelligence a été installée" 65 ID de l'écran d'installation ExistingCMSO racle.dialog ID de propriété Valeur(s) de propriété autorisée(s) ExistingCMSDBSer ver Oracle TNSNAME ExistingCMSDBUser Nom d'utilisateur ExistingCMSDBPass word Mot de passe • ExistingCMSSy base.dialog SetLCMCon fig.dialog ShowInstallCom plete.dialog 0 (Ne pas réinitialiser la base de données existante) 1 (Réinitialiser la base de données existante) ExistingCMSDBRe set • ExistingCMSDBSer ver Nom du service Sybase ExistingCMSDBUser Nom d'utilisateur ExistingCMSDBPass word Mot de passe ExistingCMSDBRe set Réinitialiser la base de données existante LCMName Nom du référentiel LCMPort Port du référentiel LCMUserName Utilisateur du référentiel LCMPassword Mot de passe LCMPasswordCon firm Confirmer le mot de passe Non applicable Non applicable 2013-09-19 Personnalisation du programme d'installation de la plateforme de Business Intelligence Titre de l'écran d'installation ID de l'écran d'installation ID de propriété Valeur(s) de propriété autorisée(s) • LaunchWDeploy • • "La plateforme SAP BusinessObjects Business Intelligence a été installée" ShowInstallCom pleteMultiCheck box.dialog LaunchSSW • • ViewLogButton • 0 (Ne pas lancer l'outil WDeploy après l'installation) 1 (Lancer automatiquement l'outil WDeploy après l'installation) 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 journal après l'installation) 1 (Afficher automatiquement le fichier journal après l'installation) "Commencer l'installation" ShowInstallSum mary.dialog Non applicable Non applicable "Etapes de post-installation" ShowPostIns tall.dialog Non applicable Non applicable "Confirmation de désinstallation" VerifyToRe move.dialog Non applicable Non applicable "La plateforme SAP BusinessObjects Business Intelligence a été désinstallée" ShowUninstallCo mplete.dialog Non applicable Non applicable Rubriques associées • Personnalisation de la saisie utilisateur • Suppression d'écrans d'installation 66 2013-09-19 Personnalisation d'applications Web 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 : 67 2013-09-19 Personnalisation d'applications Web 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. 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 • 68 com.businessobjects.webpath.CrystalReports_oem.jar (visualiseur Crystal Reports JavaScript) 2013-09-19 Personnalisation d'applications Web 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 de visualiseur, et un fichier de propriétés JSON pour référencer les fichiers JavaScript ou images que vous décidez d'utiliser avec le visualiseur. \com.businessobjects.webpath.CrystalReports_oem\web CustomListener.js \WEB-INF\classes JSAPI-properties.json \images *.png Déploiement d'applications Web Le programme d'installation de la plateforme SAP BusinessObjects Business Intelligence ne peut effectuer le déploiement de BOE.war que sur le serveur d'applications Web Tomcat fourni. Les autres serveurs d'applications Web pris en charge requièrent le déploiement des applications Web une fois l'installation terminée. Il est recommandé d'utiliser l'outil WDeploy. 4.1.2 Test de vos personnalisations Avant de réaliser une personnalisation de vos systèmes de production, il est bon de commencer par procéder à un test de vos personnalisations sur une installation test. Dans une installation par défaut utilisant le serveur Tomcat fourni, vous pouvez voir immédiatement le résultat de vos changements en apportant des modifications temporaires aux dossiers webpath.InfoViewBranding, webpath.Ope nDocumentBranding et webpath.CrystalReports_oem dans le répertoire work de Tomcat : \SAP BusinessObjects\Tomcat\work\Catalina\localhost\BOE\eclipse\plugins\web path.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\CustomizationTe mplate\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. 69 2013-09-19 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 Enter prise XI 4.0\warfiles\webapps\BOE\WEB-INF\eclipse\plugins\com.businessob jects.webpath.InfoViewBranding.jarpar exemple. 3. Décompressez le package de branding de la zone de lancement BI com.businessobjects.web path.InfoViewBranding.jar. jar xf com.businessobjects.webpath.InfoViewBranding.jar 4. Personnalisez le favicon par défaut à afficher dans la barre d'URL du navigateur pour la zone de lancement BI. Le package de branding de la zone de lancement BI contient un exemple de favicon. Copiez \web\sample\images\favicon.ico un niveau au-dessus de \web\images\favicon.ico. 5. Recréez un package com.businessobjects.webpath.InfoViewBranding.jar contenant votre nouveau favicon et incluez-le à template.zip. Pour recréer un package avec le contenu des dossiers web et META-INF dans com.businessob jects.webpath.InfoViewBranding.jar : jar cf com.businessobjects.webpath.InfoViewBranding.jar web META-INF 6. Créez un sous-dossier nommé OEMZips sous : \dunit\product.businessobjects64.oem zips-4.0-core-nu. 7. Ajoutez template.zip au dossier \OEMZips. Votre fichier zip se trouve désormais sous : \dunit\product.businessobjects64.oemzips4.0-core-nu\OEMZips\template.zip. 8. Installez et déployez BOE.war sur votre serveur d'applications Java à l'aide de l'une des options suivantes : Option Description Utiliser le serveur Tomcat fourni Sélectionné au cours du processus d'installation. Utiliser votre propre serveur d'appli- Réalisé une fois terminée l'exécution du programme d'inscations Java prises en charge tallation. 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 de noms>:<port>/BOE/BI Vous pouvez voir le nouveau favicon dans la barre d'URL de votre navigateur : 70 2013-09-19 Personnalisation d'applications Web 4.3 Personnalisation de la zone de lancement BI Dans le cas de la zone de lancement BI, vous pouvez personnaliser le favicon, le logo, les arrière-plans, les styles et bien plus encore. La plupart de ces personnalisations impliquent la modification des règles CSS dans le fichier customize.css. Pour prendre effet, toutes les personnalisations doivent être rendues accessibles dans le dossier web de com.businessobjects.webpath.InfoViewBrandi ng.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. 71 2013-09-19 Personnalisation d'applications Web 4.3.3 Personnalisation d'autres éléments de l'interface utilisateur Vous pouvez personnaliser les logos, arrière-plan, styles et autres éléments d'interface utilisateur de la zone de lancement BI en modifiant les règles CSS du fichier web\css\customize.css. Si vous utilisez des images personnalisées et y faites référence dans le fichier customize.css, veillez à les placer dans le dossier web\images\theme. A des fins de référence, le diagramme suivant présente les éléments personnalisés du package de branding d'exemple. Les nombres dans les infobulles font référence aux sections du fichier custo mize.css du package de branding. 1. 2. 3. 4. 5. 6. 7. 8. 9. 72 (0.1) personnaliser l'arrière-plan des pages et sous-pages (cadres intérieurs) (0.2) champ de saisie de texte (0.4) champ de mot de passe (1.1) conteneur de champs d'authentification (1.2) conteneur de tout (1.3) règles horizontales (1.5) bouton "Se connecter" (1.6) motif d'arrière-plan de la bannière (1.7) logo 2013-09-19 Personnalisation d'applications Web 10. 11. 12. 13. 14. 15. (2.1.1) zone supérieure de la bannière (motif d'arrière-plan) (2.1.2) logo de la bannière (2.2.1) conteneur d'onglets (2.2.2) onglet actif (2.2.3) onglet inactif (2.3.1) icône de la zone de lancement BI 16. (2.2.4) boutons d'onglet 17. (0.7) bouton fléché 18. (3.1.1) en-tête inactif d'accordéon 19. (3.1.2) en-tête actif d'accordéon 73 2013-09-19 Personnalisation d'applications Web 20. 21. 22. 23. 24. 74 (3.1.3) arrière-plan du tiroir/de l'arborescence d'accordéon (3.3.1) arrière-plan de la barre d'outils (3.4) arrière-plan du pied de page (3.5.2) ligne non activée sélectionnée dans le volet de liste et dans l'arborescence (à gauche) (3.6) barre de redimensionnement du volet de liste en accordéon 2013-09-19 Personnalisation d'applications Web 25. 26. 27. 28. 29. 30. 31. 32. 33. (3.2.1) conteneur du volet de liste (3.2.2) intitulé du volet de liste (3.2.3) lignes du volet de liste (3.5.1) ligne activée sélectionnée dans le volet de liste et dans l'arborescence (à gauche) (5.1.2, 5.1.3, 5.1.4) poignée et bouton de redimensionnement (0.8.1) conteneur du menu contextuel (0.8.2) corps du menu contextuel (0.8.3) élément du menu contextuel (0.8.4) élément sélectionné du menu contextuel 34. (0.9) infobulle 75 2013-09-19 Personnalisation d'applications Web 35. (4.1) conteneur des détails 36. (5.2) en-tête des détails 37. 38. 39. 40. 41. 42. 43. 76 (6.1) conteneur de boîte de dialogue simple (6.2.1) en-tête de boîte de dialogue simple (6.2.2) bouton "Fermer" de l'en-tête de boîte de dialogue (6.3) corps de boîte de dialogue simple (6.4) pied de page de boîte de dialogue simple (6.5) champ de texte de boîte de dialogue simple (remplace le champ de texte général) (6.6) boutons de boîte de dialogue simple 2013-09-19 Personnalisation d'applications Web 77 44. 45. 46. 47. 48. 49. (3.3.2, 3.3.3) survol/enfoncement de bouton de la barre d'outils (3.3.4) élément du menu de la barre d'outils (3.3.5) élément survolé du menu de la barre d'outils (3.3.6) séparateur du menu de la barre d'outils (3.3.7) cadre du menu de la barre d'outils (3.3.8) icône d'actualisation du menu de la barre d'outils 50. 51. 52. 53. 54. 55. 56. (7.1.1) en-tête de grande boîte de dialogue (7.1.2) en-tête de grande boîte de dialogue – bouton agrandir (survol) (7.1.3) en-tête de grande boîte de dialogue – bouton fermer (survol) (7.2.1) panneau de boutons de grande boîte de dialogue (7.3.1) pied de page de grande boîte de dialogue (7.3.2) poignée de redimensionnement de grande boîte de dialogue (7.4.1) conteneur de corps de grande boîte de dialogue 2013-09-19 Personnalisation d'applications Web 57. 58. 59. 60. 61. (7.4.2) cadre de grande boîte de dialogue (7.4.3) élément sélectionné du volet de navigation de gauche de grande boîte de dialogue (0.3) zone de texte (0.5) bouton (0.6) étiquettes de formulaire 4.3.4 Utilisation des espaces de travail BI et modules composés Vous pouvez également utiliser un espace de travail BI ou un module composé comme page d'accueil de votre zone de lancement BI. Vous pouvez personnaliser l'espace de travail ou le module composé pour l'assortir au style 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 custo mize.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. 2. 3. 4. 78 (8.1.2) arrière-plan du titre de module (8.1.3) bordure de module (8.2.1) arrière-plan du module de la zone de lancement BI (8.2.2) couleur du texte Afficher plus 2013-09-19 Personnalisation d'applications Web 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. 2. 3. 4. 5. (8.3.1) conteneur d'onglets supérieurs personnalisés (8.3.2) conteneur de sous-onglets personnalisés (8.3.4) onglet supérieur actif (8.3.5) onglet supérieur inactif (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é. 79 2013-09-19 Personnalisation d'applications Web Remarque : Vous n'avez pas besoin de modifier les packages de branding pour changer le nom de la zone de lancement BI, mais vous pouvez également changer les images associées, ce qui nécessites des modifications dans les packages de branding. 1. Copiez le fichier BIlaunchpad.properties de <INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\config\default vers <INSTALLDIR>\SAP BusinessObjects Enterprise XI 4.0\warfiles\webapps\BOE\WEB-INF\config\custom Remarque : Ne modifiez pas les fichiers du dossier default. Effectuez toujours vos modifications sur des copies des fichiers stocké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.OpenDocument Branding 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 custo mize.css du package de branding. 80 2013-09-19 Personnalisation d'applications Web 1. 2. 3. 4. 5. 6. 7. 8. 9. (0.1) personnaliser l'arrière-plan des pages et sous-pages (cadres intérieurs) (0.2) champ de saisie de texte (0.3) champ de mot de passe (1.1) conteneur de champs d'authentification (1.2) conteneur de tout (1.3) règles horizontales (1.5) bouton "Se connecter" (1.6) motif d'arrière-plan de la bannière (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 • Des fichiers CSS • Des fichiers ou bibliothèques JavaScript externes 81 2013-09-19 Personnalisation d'applications Web 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_en able_jsapi la valeur true dans le fichier SAP BusinessObjectsEnterprise XI 4.0\war files\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 Modifier SAP BusinessObjectsEnterprise XI 4.0\warfiles\we bapps\BOE\WEB_INF\eclipse\plugins\com.businessob jects.webpath.CrystalReports_oem.jar Décompressez le fichier .zip et modifiez-le. Dans le fichier com.businessobjects.webpath.CrystalReports_oem.jar, modifiez les éléments suivants : 82 2013-09-19 Personnalisation d'applications Web CrystalReports_oem.jar Modifier \web Ajoutez des fichiers JavaScript et CSS personnalisés ou externes à ce dossier. \web\CustomListe ner.js Ajoutez des écouteurs d'événements de SAP Crystal Reports JavaScript API aux fonctions OnViewerInit et OnViewerFail dans le fichier Cu stomListener.js. Pour en savoir plus, voir le guide SAP Crystal Reports JavaScript API. \WEB-INF\classes\JSA Ajoutez un chemin d'accès relatif à toutes les images, tous les fichiers PI-properties.json JavaScript et tous les fichiers CSS ajoutés au dossier \web. Vous pouvez également modifier le logo qu'affichera le visualiseur. Dans l'exemple suivant, un logo, un fichier JavaScript et son contenu JavaScript, ainsi qu'un fichier CSS sont ajoutés : { "logo" : { "img" : "images/logo.gif", "tooltip" : "SAP Crystal Reports", "url" : "http://www.businessobjects.com/ ipl/default.asp?destination=ViewerLogoLink &product=crystalreports&version=14%2E0" }, "scripts" : [ CustomListener.js \CustomFiles\*.js ], "styles" : [ \CustomStyle.css ] } Remarque : Tous les fichiers auxquels fait référence le fichier JSAPI-proper ties.json doivent être inclus dans le dossier \web. 83 2013-09-19 Personnalisation d'applications Web 84 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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:\SAPCus tomTool\packages. 85 2013-09-19 Personnalisation de SAP Crystal Reports 2011 b. Copiez le contenu du package d'installation de Crystal Reports sous C:\SAPCustomTool\pa ckages. 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. c. (Facultatif) Ajoutez votre code clé à l'exemple de fichier de configuration. Dans un éditeur XML, ouvrez le fichier C:\SAPCustomTool\packages\Collate rals\Tools\CustomizationTool\example_customization_win_cr.xml et remplacez l'expression PLEASE SET de <replaceProperty id="ProductKey" defaultVa lue="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\pa ckages\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 package Dir=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDe tail=error > C:\oemlog.log Assurez-vous que le package d'installation personnalisé a été créé sous C:\SAPCustomTool\out put. 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_custo mization_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 86 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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. 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 vous assurer que le pare-feu de votre entreprise n'interrompra pas le processus de téléchargement. Les Support Packages et correctifs sont des programmes d'installation contenant des mises à jour pour SAP Crystal Reports. Vous pouvez les télécharger depuis https://service.sap.com/bosap-support. Dans l'onglet "Find 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. 2. 3. 4. 5. Téléchargez le programme d'installation. Voir Téléchargement du programme d'installation. Décidez quelles personnalisations sont nécessaires. Voir Création du fichier de configuration. Ecrivez le fichier de configuration pour spécifier les personnalisations. Exécutez l'outil de personnalisation pour créer un programme d'installation personnalisé. 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 : • • • 87 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. 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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 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. Rubriques associées • Paramètres de ligne de commande 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 • Personnalisation des raccourcis du menu Démarrer de Windows • Personnalisation de l'utilitaire "Ajout/Suppression de programmes" de Windows • Personnalisation du dossier d'installation • • • 88 Personnalisation de la saisie utilisateur par défaut Suppression d'écrans d'installation Incorporation d'un code clé 2013-09-19 Personnalisation de SAP Crystal Reports 2011 • • • • 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.crystalreports-4.0-core-32"> ... ... </cloneProduct> </oem> Le fichier de configuration pour le programme d'installation complète peut avoir n'importe quel nom, oem.xml, par exemple. Le fichier de configuration du programme d'installation de Support Package est décrit dans la section Personnalisation de programmes d'installation de mise à jour. Remarque : Le fichier de configuration doit être écrit dans une syntaxe XML correcte. Utilisez un éditeur XML pour créer et modifier le fichier, et assurez-vous que le format est correct avant d'exécuter l'outil. Exemple : Dans cet exemple, on spécifie les personnalisations suivantes : • Changer le nom long du produit pour “Custom Company Crystal Reports” pour toutes les langues. • Changer le nom court du produit pour “Custom CR” pour toutes les langues. • Changer l'éditeur et le nom du produit pour l'entrée de l'utilitaire "Ajout/Suppression de programmes de Windows". • Supprimer l'écran d'installation intitulé "Choose Installation Type" et définir le type d'installation sur "Custom". 89 2013-09-19 Personnalisation de SAP Crystal Reports 2011 • Spécifier que les seuls packs linguistiques inclus dans le package d'installation sont l'anglais, le français, l'allemand, l'italien et le chinois. <oem name="CustomCompanyCrystalReports"> <cloneProduct sourceId="product.crystalreports-4.0-core-32"> <replaceString id="product.cr_name" value="Custom Company Crystal Reports" lang="all"/> <replaceString id="product.cr_shortname" value="Custom CR" lang="all"/> <arp duSourceId="product.crystalreports.arp-4.0-core"> <arg id="publisher" value="Custom Company"/> <arg id="display_name" value="Custom Company Crystal Reports"/> </arp> <replaceProperty id="InstallType" defaultValue="custom"/> <removeDialog id="ChooseInstallType2.dialog"/> <languageIncludeList value="en;fr;de;it;zh_CN"/> </cloneProduct> </oem> 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 replaceS tring 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. 90 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Tableau 5-1 : Nom du produit et numéro de version Description de la chaîne ID de chaîne Valeur par défaut Nom long du produit product.cr_name Crystal Reports Nom court du produit product.cr_shortname Crystal Reports Version du produit product_cr_version 2011 Version principale du produit product_cr_majorversion 2011 Remarque : Vous devez personnaliser la version du produit et la version principale du produit ensemble. Par exemple, si vous changez la version du produit pour “1.0”, vous devez également personnaliser la version principale du produit en “1”. Dans le cas contraire, le numéro de version dans le menu ne correspondra par au numéro de version dans le produit. Vous pouvez spécifier un nouveau nom pour chaque langue. Pour obtenir une liste des codes de langue, voir Codes langue. 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é : 91 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Pour supprimer les instances de “FP3” du programme d'installation Lors de l'exécution du programme d'installation, des instances de “FP3” peuvent être visibles dans le nom du produit. Pour supprimer “FP3”, modifiez les lignes du fichier suivant : Nom de fichier Ligne originale Ligne modifiée dunit\product.crystalre ports-4.0-core-32\se tup.ui.framework\ui text\CrystalReports\pro duct.lang_<code la ngue>.uitext.xml <string id="product name_patch" value=" FP3"/> <string id="product name_patch" value=""/> dunit\product.crystalre ports-4.0-core-32\se tup.ui.framework\ui text\framework\se tup.ui.framework.la ng_<code langue>.ui text.xml <string id="product_patch" value="FP3"/> <string id="produ ct_patch" value=""/> Comme ci-dessus <string id="produ ct_patch_prespace" value=" FP3"/> <string id="produ ct_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 Codes langue. 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 : 92 2013-09-19 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> 93 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Attribut Valeur ID d'unité de déploiement du raccourci à modifier. Les valeurs classiques sont : • product.crystalreports.shortcut.crw-4.0-core Crystal Reports 2011 • product.crystalreports.shortcut.odbc-4.0-core Administrateur de source de données ODBC duSourceId • product.crystalreports.shortcut.rptpubwiz-4.0-core Assistant de téléchargement de rapports Pour obtenir la liste complète des valeurs duSourceId, voir ID des unités de déploiement de raccourci. linkFullPath Chemin d'accès complet au raccourci. Veillez à ajouter .lnk au lien de raccourci, sans quoi le lien ne sera pas créé. Vous pouvez placer le lien dans le menu Démarrer ou sur le bureau. L'outil de personnalisation SAP BusinessObjects crée les liens correctement. Vous pouvez spécifier un lien par langue. Pour obtenir une liste des codes de langue, voir Codes langue. description Chaîne d'info-bulle à afficher lorsque l'utilisateur survole le raccourci avec la souris. Vous pouvez spécifier une info-bulle par langue. Exemple : Dans cet exemple, on procède aux personnalisations suivantes : • Changer le nom du raccourci Crystal Reports 2011 pour “CR personnalisé Entité” pour l'anglais. • Personnaliser l'info-bulle Crystal Reports 2011 en “Lancer CR personnalisé Entité” pour l'anglais. • Changer le nom du raccourci “ODBC Data Source Administrator” pour “ODBC personnalisé” pour l'anglais. • Personnaliser l'info-bulle “ODBC Data Source Administrator” en “ODBC personnalisé” pour l'anglais. • Placer les raccourcis “CR personnalisé Entité” et “ODBC personnalisé” sous l'entrée du menu Démarrer appelée “Company Programs”. • Changer le nom du raccourci “Report Upload Wizard” pour “Assistant personnalisé” pour l'anglais. • Placer le raccourci “Assistant personnalisé” sous l'entrée du menu Démarrer appelée “Assistant personnalisé”. • Personnaliser l'info-bulle “Assistant personnalisé” en “Lancer Assistant personnalisé” pour l'anglais. Le nom et l'info-bulle du raccourci restent inchangés dans toutes les autres langues. Remarque : Pour mettre en pratique cet exemple, vous devez créer les liens et dossiers suivants : 94 2013-09-19 Personnalisation de SAP Crystal Reports 2011 • • • • • 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. Dans cet exemple, le dossier d'installation a été redirigé vers le disque C:\. Pour en savoir plus, voir Personnalisation du dossier d'installation. <shortcut duSourceId="product.crystalreports.shortcut.crw-4.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.odbc-4.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.rptpubwiz-4.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. 95 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Dans cet exemple, le dossier d'installation a été redirigé vers le disque C:\. <shortcut duSourceId="product.crystalreports.shortcut.rptpubwiz-4.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.arp-4.0-core"> <arg id="publisher" value="<publisher name>"/> <arg id="display_name" value="<product name>" lang="<language list>"/> <arg id="display_icon" value="<full path to icon>"/> </arp> Remarque : Le nom d'affichage doit être marqué par une balise lang pour spécifier un nom d'affichage différent pour chaque langue. Utilisez un point-virgule pour séparer plusieurs langues utilisant le même nom d'affichage. Les langues non spécifiées utilisent la valeur par défaut. Pour obtenir une liste des codes de langue, voir Codes langue. Remarque : Des étapes supplémentaires doivent être suivies pour que la valeur personnalisée de l'éditeur s'affiche correctement dans l'utilitaire Ajout/Suppression de programmes. Suivez ces étapes : 1. Ouvrez le fichier dunit\product.crystalreports.arp-4.0-core-32\seed.xml. 2. Cherchez l'élément <action id="AddARPEntry">. Vous verrez plusieurs éléments <arg> imbriqués. 3. Ajoutez la ligne suivante sous <arg name="DISPLAY_NAME" value="[ARP.DISPLAYNAME]" /> : <arg name="PUBLISHER" value="SAP" /> 4. Enregistrez le fichier. Après avoir personnalisé le nom de l'éditeur dans le fichier de configuration, exécutez l'outil de personnalisation, puis installez le produit personnalisé, votre valeur personnalisée pour l'éditeur s'affiche dans l'utilitaire Ajout/Suppression de programmes. Ce processus sera simplifié dans une version ultérieure. Les icônes affichées dans l'utilitaire Ajout/Suppression de programmes de Windows sont généralement de 16 x 16. Pour des informations complètes sur la création d'icônes, voir la documentation Windows. 96 2013-09-19 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.arp-4.0-core"> <arg id="publisher" value="Custom Company"/> <arg id="display_name" value="Custom Company Crystal Reports Patch 1" lang="en;fr"/> <arg id="display_name" value="Custom Company Crystal Reports (German)" lang="de"/> <arg id="display_icon" value="C:\SAPCustomTool\CC_logo.ico"/> </arp> Le résultat de la personnalisation apparaît ci-dessous : 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 repla ceProperty 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\CustomCompanyCrystalRe ports. <replaceProperty id="InstallDir" defaultValue="C:\MyInstallDIR\CustomCompanyCrystalReports"/> 97 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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é. 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 : 98 2013-09-19 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é. 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 XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX. Utilisez l'élément removeDialog avec id="CREnterProductKey.dialog" pour supprimer l'écran d'installation demandant la clé de licence. <replaceProperty id="ProductKey" defaultValue="XXXXX-XXXXXXX-XXXXXXX-XXXXXXX-XX"/> <removeDialog id="CREnterProductKey.dialog"/> Rubriques associées • ID d'écran d'installation et de propriété • Personnalisation de la saisie utilisateur par défaut • Suppression d'écrans d'installation 99 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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 ID des fonctionnalités. 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"/> 100 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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 les packs linguistiques possibles sont inclus dans le programme d'installation. Vous pouvez spécifier quels packs linguistiques inclure. Utilisez l'élément languageIncludeList avec une liste de codes langue : <languageIncludeList value="<list of language codes>"/> Pour obtenir une liste des codes de langue, voir Codes langue. 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.crystalreports-4.0-core-32\setup.ui.framework\resources Vous pouvez personnaliser les ressources de ce dossier. Des ressources couramment utilisées sont : • Les images du programme d'installation • Le contrat de licence du programme d'installation Pour personnaliser une ressource : 1. Créez un dossier de ressources personnalisées : C:\MyResources, par exemple. Le dossier peut avoir le nom de votre choix mais doit être visible pour les clients. Utilisez le même dossier pour toutes les ressources que vous personnalisez. 2. Créez une ressource portant le même nom et le même chemin d'accès que la ressource originale et placez-la dans le dossier de ressources personnalisées. Voir les rubriques associées pour des exemples spécifiques. 3. Ajoutez l'élément <resources> au fichier de configuration pour spécifier l'emplacement du dossier de ressources personnalisées, par exemple : 101 2013-09-19 Personnalisation de SAP Crystal Reports 2011 <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. Rubriques associées • Personnalisation des images dans le programme d'installation • Personnalisation du contrat de licence 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.crystalreports-4.0-core-32\setup.ui.framework\resources Tableau 5-4 : Fichiers image dans le dossier resources 102 Nom de l'image Nom du fichier Ecran d'accueil dialog Full.bmp Image par défaut 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Nom de l'image Nom du fichier Image supérieure pour tous les écrans dialog Top.bmp Panneau d'informations pour la boîte de dialogue de progression bill board.bmp Image par défaut 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 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"/> Rubriques associées • Modification des ressources 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.crystalreports-4.0-core-32\setup.ui.framework\resources\<code langue> Par exemple, le contrat de licence en anglais se trouve ici : dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources\en\li cense_en.rft 103 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Pour obtenir une liste des codes de langue, voir Codes langue. Vous personnalisez le contrat de licence en créant un fichier de licence, en plaçant le fichier dans le dossier de ressources personnalisées et en ajoutant l'élément resources au fichier de configuration. Exemple : Personnaliser le contrat de licence en anglais Le contrat de licence en anglais se trouve ici : dunit\product.crystalreports-4.0-core-32\setup.ui.framework\resources\en\li cense_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"/> Rubriques associées • Modification des ressources 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 cleanTar get="yes et sourcePath="<chemin complet d'accès au dossier Collaterals perso nnalisé>" : <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. 104 2013-09-19 Personnalisation de SAP Crystal Reports 2011 2. Supprimez les éléments de C:\SAPCustomTool\Collaterals qui ne sont pas nécessaires pour votre programme d'installation personnalisé. 3. Ajoutez l'élément <collaterals> au fichier de configuration pour spécifier l'emplacement du dossier de collatéraux personnalisés, par exemple : <collaterals cleanTarget="yes" sourcePath="C:\MyCollaterals"/> Tableau 5-5 : Description des éléments du dossier Collaterals Dossier Description Quand supprimer Collaterals > Add-Ons > SAP Fournit la connectivité aux systèmes SAP. Supprimez ce dossier s'il n'y a aucun besoin de connexion aux systèmes SAP. Collaterals > CustomizationTemplate Contient le fichier d'exemple tem plate.zip pour les personnalisations du concepteur de rapports. 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 personnalisé. Pour obtenir une liste des codes de langue, voir Codes langue. Collaterals > Tools > CustomizationTool Objet de personnalisation SAP BusinessObjects. Supprimez ce dossier si les clients n'ont pas besoin de personnaliser leurs programmes 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. 105 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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. 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. 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. 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 : 106 2013-09-19 Personnalisation de SAP Crystal Reports 2011 C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\win32_x86\Start Page\<code langue> Pour obtenir une liste des codes langue, voir Codes langue. 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é Description Emplacement Valeur par défaut ProductName Nom du produit Titre de la fenêtre SAP Crystal Reports CrystalReportHelp Aide du produit Menu Aide Aide SAP Crystal Reports AboutCrystalReport A propos de l'aide du produit Menu Aide 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 : crw_oem_res_<code langue>.xml Par exemple, le nom du fichier XML anglais est : crw_oem_res_en.xml Pour obtenir une liste des codes de langue, voir Codes langue. 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 : 107 2013-09-19 Personnalisation de SAP Crystal Reports 2011 C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\win32_x86 Lors de l'exécution de Crystal Reports dans une certaine langue, le fichier XML de langue correspondant est chargé. Remarque : Si vous voulez déployer les chaînes personnalisées dans votre programme d'installation, suivez les instructions se trouvant dans Déploiement du fichier de personnalisation OEM. 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 ver sion="1.0" encoding="UTF-8"?>. En outre, lors de l'enregistrement du fichier XML à l'aide d'un éditeur de texte, sélectionnez UTF-8 dans le menu Codage. Gardez le nom et la valeur de la propriété sur la même ligne. Par exemple, ceci est accepté : <ProductName>Custom CR</ProductName> 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é. 108 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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 tem plate.zip : Fichier personnalisé Emplacement dans template.zip splash.bmp SAP BusinessObjects Enterprise XI 4.0\win32_x86 start.html (pour l'anglais) SAP BusinessObjects Enterprise XI 4.0\win32_x86\Start Page\en crw_oem_res_en.xml SAP BusinessObjects Enterprise XI 4.0\win32_x86 3. Copiez le fichier compressé à l'emplacement suivant : dunit\product.crystalreports.oemzips-4.0-core-nu\OEMZips Remarque : Il se peut que vous ayez à créer manuellement le dossier OEMZips. 4. Exécutez le programme d'installation. Le contenu de template.zip sera décompressé dans le dossier d'installation. Remarque : Dans le package d'installation de SAP Crystal Reports se trouve un exemple de fichier compressé situé sous : Collaterals\CustomizationTemplate\template.zip 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. 109 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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\pa ckages. Voir 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\pa ckages\Collaterals\Tools\CustomizationTool customizationtool.exe xml=C:\SAPCustomTool\oem.xml packageDir=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output logDetail=error > C:\oemlog.log Pour en savoir plus sur l'exécution de l'outil de personnalisation SAP BusinessObjects, voir Démarrage rapide pour Crystal Reports. 5.7.1 Paramètres de ligne de commande Tableau 5-8 : Paramètres obligatoires Paramètre Description Exemple Chemin d'accès complet au fichier de configuration. xml Le fichier de configuration pour le programme d'installation complète peut avoir n'importe quel nom. xml=C:\SAPCustomTool\oem.xml Chemin d'accès complet au dossier contenant le programme d'installation que vous modifiez. packageDir 110 Le programme d'installation est téléchargé à partir du SAP Service Marketplace en vue de démarrer l'installation de SAP Crystal Reports. Il contient les dossiers Collate rals, dunit, langs et setup.engine ainsi que d'autres fichiers binaires. packageDir=C:\SAPCustom Tool\packages 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Paramètre Description Exemple 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:\SAPCustom Tool\output Tableau 5-9 : Paramètres facultatifs Paramètre baselinePath Description Exemple Chemin complet du dossier racine contenant les versions d'origine non personnalisées de l'ensemble des programmes d'installation complets et de mises à jour que vous avez personnalisés. Supposez que vous souhaitiez personnaliser SAP Crystal Reports 2011 Support Package 5 et que vous ayez personnalisé les précédents programmes : 2011 (installation 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 Support Package 4. Par exemple, si les packages non personnalisés sont contenus dans la structure de répertoire suivante : Utilisez un point-virgule (;) pour séparer les dossiers racine. C:\productUpdates\2011\ \2011 Full\ \SP4\ définissez la valeur sur baseline Path=C:\productUpdates\2011\ Voir Personnalisation des programmes d'installation de mise à jour pour plus d'informations et d'exemples sur le paramètre baseline Path. logDetail 111 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 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Paramètre 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. action • action=validate validate L'outil valide le fichier de configuration mais ne réalise aucune personnalisation. Rubriques 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. 112 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Quelles parties des programmes d'installation de mise à jour puis-je personnaliser ? Vous pouvez y personnaliser les mêmes aspects que dans le programme d'installation principale. Les Support Packages et les mises à jour de correctifs contenant moins d'écrans d'installation, toutes les étapes de personnalisation ne sont pas d'application. Il est recommandé d'exécuter le Support Package ou correctif avant de le personnaliser pour déterminer quelles personnalisations vous souhaitez. Comment personnaliser les programmes d'installation de mise à jour ? Les programmes d'installation de mise à jour utilisent la même architecture que le programme d'installation principal de Crystal Reports (installation complète), vous pouvez donc utiliser l'outil de personnalisation comme décrit dans Création du fichier de configuration et Exécution de l'outil avec certaines modifications apportées à la commande de ligne et au fichier de configuration. Pour en savoir plus, voir Personnalisation de programmes d'installation de mise à jour 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. 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, 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. 113 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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. 3. Exécutez la commande suivante à partir de l'invite de commande :cd C:\SAPCustomTool\pa ckages\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 package Dir=C:\SAPCustomTool\SupportPackage baselinePath=C:\SAPCustomTool\packages outputDir=C:\SAPCustomTool\output\SupportPackage logDetail=error > C:\oe mlog_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 et Exécution de l'outil 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. 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 baseli nePath. 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 114 2013-09-19 Personnalisation de SAP Crystal Reports 2011 configuration et ID et codes pour la personnalisation de Crystal Reports pour créer le fichier de personnalisation. Pour spécifier la version du produit dans le fichier de configuration Le fichier de configuration pour les programmes d'installation de mise à jour doit contenir la version du produit dans l'élément clonePatchProduct comme illustré ci-dessous : <oem name="<any name>"> <clonePatchProduct sourceId="<product version>"> ... </clonePatchProduct> </oem> La product version (version du produit) du fichier de configuration doit correspondre au numéro de version du programme d'installation que vous personnalisez. Pour trouver le numéro de version, cherchez dans le dossier dunit un dossier portant un nom ayant ce format : product.cr.patch-4.x.x.x-core-32 Vous pouvez utiliser le nom de ce dossier comme product version (version du produit). Exemple : Cet exemple de fichier de configuration présente une personnalisation de SAP Crystal Reports 2011 Patch 1, dont la version de produit est product.cr.patch-4.1.0.1-core-32. Le fichier de configuration personnalise le nom long du produit en Custom Company Crystal Reports et le nom court du produit en Custom CR. <oem name="Custom Patch Tool"> <clonePatchProduct sourceId="product.cr.patch-4.1.0.1-core-32"> ... </clonePatchProduct> </oem> Pour utiliser le paramètre baselinePath Utilisez le paramètre de ligne de commande baselinePath pour faire référence à un dossier racine contenant les versions d'origine non personnalisées de l'ensemble des précédents programmes d'installation complets ou de mise à jour que vous avez personnalisés. Cela signifie que vous devez conserver les packages d'installation d'origine. Remarque : Ce paramètre remplace le paramètre baselinePath introduit dans 2011 Feature Pack 3. Pour simplifier la valeur du paramètre baselinePath, référencez un seul dossier racine. L'outil de personnalisation ignorera les fichiers et dossiers inutiles. Autrement, pour spécifier plusieurs dossiers racine, utilisez un point-virgule (;) dans la valeur baselinePath. Prenons les exemples suivants. Exemple : Personnalisation de Crystal Reports 2011 SP5 Supposez que vous personnalisiez Crystal Reports 2011 Support Package 5 et que vous ayez personnalisé les précédents programmes : 2011 (installation complète), 2011 SP4. 115 2013-09-19 Personnalisation de SAP Crystal Reports 2011 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\ Rubriques associées • Paramètres de ligne de commande 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 116 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Utilisez les ID des fonctionnalités dans l'élément removeFeature pour supprimer des fonctionnalités et leurs composants du programme d'installation et du produit installé. Par exemple, cet ID supprimera la prise en charge de l'affichage des relations entre données et régions géographiques : <removeFeature id="Mapping"/> Les fonctionnalités des composants suivants peuvent être supprimées : • Accès aux données • Intégration du système Enterprise • Prise en charge de l'exportation • Autre Tableau 5-10 : Accès aux données 117 ID de fonctionnalité Description DataAccess Accès aux données Access Microsoft Access ADO.NET ADO.NET BDE DLL de base de données IDAPI Btrieve Pilote de base de données Pervasive COMData Fournisseur de données COM Comm_Rep Commande dans le référentiel DB2 IBM DB2 dBase dBase Exchange Microsoft Exchange FieldDefinitions Définitions des champs FileSystem Système de fichiers HPNeoview HP Neoview Informix Informix JavaData Java Data Provider JDBC Pilote de données JDBC (JNDI) MicrosoftOutlook Microsoft Outlook MyCube Cube OLAP 2013-09-19 Personnalisation de SAP Crystal Reports 2011 ID de fonctionnalité Description MYSQL_DataAccess MySQL NCRTeradata NCRTeradata NETEZZA NETEZZA NTEventLog Journal des événements NT OLE_DB_Data Données OLE DB OptionalDataDirectODBC ODBC DataDirect Oracle Oracle Progress.OpenEdge Progress OpenEdge RDO ODBC RDO SFORCE Salesforce.com Driver SIEBEL Siebel Sybase Sybase SymantecACT ACT! Univers Univers BusinessObjects UWSC Connecteur universel pour services Web WebActivityLog Journal des activités Web XML Pilote XML Tableau 5-11 : Intégration du système Enterprise 118 ID de fonctionnalité Description IntegrationOptions Options d'intégration EBS Oracle E-Business Suite JDE JD Edwards EnterpriseOne PSFT Peoplesoft Enterprise SAP Solutions SAP SIEBEL Siebel 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Tableau 5-12 : Prise en charge de l'exportation ID de fonctionnalité Description Application Exportation vers une application CharacterSeparated Format délimité par des caractères CrystalReports Format Crystal Reports DiskFile Exportation vers un fichier Excel Format Microsoft Excel 97-2003 ExchangeFolders Dossier Exchange HTML Formats HTML 3.2 et HTML 4.0 (DHTML) LegacyXMLExport Format XML antérieur LotusNotes Document Lotus Notes LotusNotesMail Lotus Domino ODBC Exportation vers n'importe lequel de vos formats ODBC installés PDF Format PDF Record Format Style d'enregistrement ReportDefinition Format Définition de rapport RichTextFormat RTF Texte Formats texte WordforWindows Format Microsoft Word 97-2003 XMLExport Document XML Tableau 5-13 : Autre 119 ID de fonctionnalité Description CrystalReportsRoot Crystal Reports 2011 crw Crystal Reports Designer Mappage Création de cartes géographiques MicrosoftMail Destination de Microsoft Mail 2013-09-19 Personnalisation de SAP Crystal Reports 2011 ID de fonctionnalité Description PGEditor Diagrammes personnalisés UploadWizard Assistant de téléchargement de rapports Rubriques associées • Suppression de fonctionnalités 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. Tableau 5-14 : 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.0-core Crystal Reports 2011 product.crystalreports.shortcut.odbc4.0-core Administrateur de source de données ODBC product.crystalreports.shortcut.rptpub wiz-4.0-core Assistant de téléchargement de rapports Rubriques associées • Personnalisation des raccourcis du menu Démarrer de Windows 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"/> 120 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Tableau 5-15 : Chaînes couramment modifiées ID de chaîne Description product.cr_name Nom long du produit product.cr_shortname Nom court du produit product_cr_version Version du produit product_cr_majorversion Version principale du produit Rubriques associées • Personnalisation du nom du produit et du numéro de version 5.9.4 Codes langue L'outil de personnalisation SAP BusinessObjects utilise ces codes langue pour représenter les langues prises en charge : 121 Langue Code Anglais EN Tchèque CS Danois DA Néerlandais NL Finnois FI Français FR Allemand DE Hongrois HU Italien IT Japonais JA Coréen KO Norvégien (Bokmål) NB 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Langue Code Polonais PL Portugais PT Roumain RO Russe RU Chinois simplifié zh_CN Slovaque SK Espagnol ES Suédois SV Thaï TH Chinois traditionnel zh_TW turc TR Rubriques associées • 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 • Suppression de packs linguistiques • 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"/> 122 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Tableau 5-17 : ID d'écran Titre de l'écran d'installation "Veuillez sélectionner une langue d'installation" "Installation impossible" ID de l'écran d'installation ID de propriété dans l'écran d'installation Valeurs de propriété SortedAvailableSe tupLanguages Ensemble des codes langue représentant les langues d'installation prises en charge SetupUILanguage Code langue unique représentant la langue d'installation Non applicable Non applicable SelectUILanguage.dia log SharedAlwaysFai lure.dialog • "Choisissez un type d'installation" ChooseInstallType2.dia log InstallType "Vérification des prérequis" CheckPreRequisites.dia log Non applicable Non applicable "Bienvenue dans l'Assistant d'installation..." ShowWelcomeScreen.dia log Non applicable Non applicable "Contrat de licence" ShowLicenseAgreeme nt.dialog Non applicable Non applicable RegisteredUser Votre "Nom d'utilisateur" RegisteredCompany "Nom de l'entreprise" ProductKey Votre "Code clé du produit" "Informations utilisateur" 123 par dé faut (Standard) personna lisé CREnterProductKey.dia log • "Spécifier le dossier de destination" ChooseInstallDir.dia log InstallDir Chemin d'accès au dossier d'installation "Sélection des langues" SelectLanguagePack.dia log SelectedLanguage Packs Tableau des codes langue 2013-09-19 Personnalisation de SAP Crystal Reports 2011 Titre de l'écran d'installation ID de l'écran d'installation ID de propriété dans l'écran d'installation Valeurs de propriété "Sélection des fonctions" SelectFeatures.dialog Non applicable Non applicable "SAP Crystal Reports 2011 a été installé" ShowInstallCom plete.dialog Non applicable Non applicable "SAP Crystal Reports 2011 a été installé" ShowInstallCom plete_PatchUpdate.dia log Non applicable Non applicable "Commencer l'installation" ShowInstallSummary.dia log Non applicable Non applicable "Confirmation de désinstallation" VerifyToRemove.dialog Non applicable Non applicable • 124 0 (Activer le service de mise à jour Web) 1 (Désactiver le service de mise à jour Web) "Option de service de mise à jour Web" ShowPrivacyStateme nt.dialog DisableWebUpdate Service • "SAP Crystal Reports 2011 a été désinstallé" ShowUninstallCom plete.dialog Non applicable Non applicable 2013-09-19 Informations supplémentaires Informations supplémentaires Ressources d'informations Emplacement Informations sur le produit SAP BusinessObjects http://www.sap.com Naviguez vers http://help.sap.com/businessobjects/ et cliquez sur Tous les produits dans le panneau latéral "Présentation de SAP BusinessObjects". SAP Help Portal Vous pouvez accéder à la toute dernière documentation relative aux produits SAP BusinessObjects et à leur déploiement sur le portail SAP Help Portal. Il est également possible de télécharger des versions PDF ou des bibliothèques HTML installables. Certains guides résident sur SAP Service Marketplace et ne sont, par conséquent, pas disponibles sur le portail SAP Help Portal. Le portail d'aide répertorie ces guides et propose un lien vers SAP Service Marketplace. Les clients qui bénéficient d'un contrat de maintenance disposent d'un ID utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez votre support technique. http://service.sap.com/bosap-support > Documentation • • SAP Service Marketplace 125 Guides d'installation : https://service.sap.com/bosap-instguides Notes de version : http://service.sap.com/releasenotes SAP Service Marketplace comprend certains guides d'installation, guides de migration et de mise à niveau, guides de déploiement, notes de version et des documents concernant les plates-formes prises en charge. Les clients qui bénéficient d'un contrat de maintenance disposent d'un ID utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez votre support technique. Si vous êtes redirigé vers SAP Service Marketplace à partir du site SAP Help Portal, utilisez le menu situé dans le panneau de navigation à gauche pour sélectionner la catégorie contenant la documentation que vous souhaitez consulter. 2013-09-19 Informations supplémentaires Ressources d'informations Emplacement https://cw.sdn.sap.com/cw/community/docupedia Docupedia Docupedia fournit des ressources de documentation supplémentaires, un environnement de création collaboratif et un canal de commentaires interactif. Ressources à l'attention des développeurs https://boc.sdn.sap.com/ Articles SAP BusinessObjects sur SAP Community Network https://www.sdn.sap.com/irj/boc/businessobjects-articles https://www.sdn.sap.com/irj/sdn/businessobjects-sdklibrary Ces articles étaient précédemment appelées notes techniques. https://service.sap.com/notes Remarques Forums sur SAP Community Network Ces remarques étaient précédemment appelées des articles de la base de connaissances. https://www.sdn.sap.com/irj/scn/forums http://www.sap.com/services/education Formation Nous pouvons vous fournir un module de formation qui réponde à vos besoins et convienne à votre style d'apprentissage préféré, sous forme de stage traditionnel ou de séminaires plus ciblés. http://service.sap.com/bosap-support Support client en ligne Le site SAP Support Portal présente des informations sur les programmes et services de support technique. Il propose également des liens vers de nombreuses informations techniques ainsi que des téléchargements. Les clients qui bénéficient d'un contrat de maintenance disposent d'un ID utilisateur pour accéder à ce site. Pour obtenir un identifiant, contactez votre support technique. http://www.sap.com/services/bysubject/businessobjectsconsulting Conseil 126 Les consultants peuvent vous accompagner dans votre démarche, depuis la phase initiale d'analyse jusqu'à la phase finale de livraison de votre projet de déploiement. Ils peuvent vous faire bénéficier de leur expertise en matière de bases de données relationnelles et multidimensionnelles, de connectivité, d'outils de conception de base de données et de techno logie d'intégration personnalisée. 2013-09-19 Index P plateforme SAP BusinessObjects Business Intelligence documentation 10 127 2013-09-19 Index 128 2013-09-19 ">

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