Personnalisation de SAP Crystal Reports 2011
• Spécifier que les seuls packs linguistiques inclus dans le package d'installation sont l'anglais, le français, l'allemand, l'italien et le chinois.
<oem name="CustomCompanyCrystalReports">
<cloneProduct sourceId="product.crystalreports-4.0-core-32">
<replaceString id="product.cr_name" value="Custom Company Crystal Reports" lang="all"/>
<replaceString id="product.cr_shortname" value="Custom CR" lang="all"/>
<arp duSourceId="product.crystalreports.arp-4.0-core">
<arg id="publisher" value="Custom Company"/>
<arg id="display_name" value="Custom Company Crystal Reports"/>
</arp>
<replaceProperty id="InstallType" defaultValue="custom"/>
<removeDialog id="ChooseInstallType2.dialog"/>
<languageIncludeList value="en;fr;de;it;zh_CN"/>
</cloneProduct>
</oem>
6.5.2 Renommage du produit
Vous pouvez renommer le produit en personnalisant les éléments suivants :
• Le nom de produit et le numéro de version
• L'entrée de "Ajout/Suppression des programmes" de Windows
• L'entrée du menu "Démarrer" pour les raccourcis de fonctionnalités
• Le dossier d'installation par défaut
Les sections qui suivent expliquent ces personnalisations.
6.5.2.1 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.
134 2012-12-05
Personnalisation de SAP Crystal Reports 2011
Tableau 6-1 : Nom du produit et numéro de version
Description de la chaîne
Nom long du produit
Nom court du produit
Version du produit
Version principale du produit
ID de chaîne
product.cr_name
product.cr_shortname
product_cr_version product_cr_majorversion
Valeur par défaut
Crystal Reports
Crystal Reports
2011
2011
Remarque :
Vous devez personnaliser la version du produit et la version principale du produit ensemble. Par exemple, si vous changez la version du produit pour “1.0”, vous devez également personnaliser la version principale du produit en “1”. Dans le cas contraire, le numéro de version dans le menu ne correspondra par au numéro de version dans le produit.
Vous pouvez spécifier un nouveau nom pour chaque langue. Pour obtenir une liste des codes de langue, voir
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é :
135 2012-12-05
Personnalisation de SAP Crystal Reports 2011
136
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 :
2012-12-05
Personnalisation de SAP Crystal Reports 2011
6.5.2.2 Personnalisation des raccourcis du menu Démarrer de Windows
Le menu Démarrer de Windows contient des raccourcis pour des fonctionnalités telles que l'Administrateur de source de données ODBC. Vous pouvez personnaliser le nom, l'emplacement et l'info-bulle de chaque raccourci. Les raccourcis que vous ne personnalisez pas seront regroupés dans l'entrée de menu Démarrer par défaut nommée "Crystal Reports 2011".
Le menu Démarrer par défaut des installations en anglais se présente comme suit :
137
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>
2012-12-05
Personnalisation de SAP Crystal Reports 2011
138
Attribut
duSourceId linkFullPath description
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
• 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
.
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 .
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 :
2012-12-05
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 :
139
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.
2012-12-05
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>
6.5.2.3 Personnalisation de l'utilitaire Ajout/Suppression de programmes de
Windows
Vous pouvez personnaliser le nom d'affichage, l'éditeur et l'icône dans l'utilitaire "Ajout/Suppression de programmes" de Windows. Utilisez l'élément suivant :
<arp duSourceId="product.crystalreports.arp-4.0-core">
<arg id="publisher" value="<publisher name>"/>
<arg id="display_name" value="<product name>" lang="<language list>"/>
<arg id="display_icon" value="<full path to icon>"/>
</arp>
Remarque :
Le nom d'affichage doit être marqué par une balise lang pour spécifier un nom d'affichage différent pour chaque langue. Utilisez un point-virgule pour séparer plusieurs langues utilisant le même nom d'affichage. Les langues non spécifiées utilisent la valeur par défaut.
Pour obtenir une liste des codes de langue, voir
Codes langue
.
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.
140 2012-12-05
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 :
141
6.5.2.4 Personnalisation du dossier d'installation
Vous pouvez personnaliser l'emplacement du dossier d'installation par défaut. Utilisez l'élément 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"/>
2012-12-05
