ug_ldk_t_localizingsubsequentversionsofaproduct.html 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104
  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xml:lang="en-us" lang="en-us">
  3. <head xmlns="">
  4. <!--
  5. Licensed Materials - Property of IBM
  6. IBM Cognos Products: DOCS
  7. © Copyright IBM Corp. 2005, 2014
  8. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
  9. -->
  10. <meta name="Copyright" content="© Copyright IBM Corp. 2005, 2014."></meta>
  11. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  12. <meta name="copyright" content="© Copyright IBM Corporation 2014" />
  13. <meta name="DC.Rights.Owner" content="© Copyright IBM Corporation 2014" />
  14. <meta name="security" content="public" />
  15. <meta name="Robots" content="index,follow" />
  16. <meta name="DC.Type" content="task" />
  17. <meta name="DC.Title" content="Customizing Subsequent Versions of a Product" />
  18. <meta name="abstract" content="If a new version or a patch for a IBM Cognos product contains changes to the messages or user interface text, you must customize the resource files again. IBM Cognos User Interface and Error String Customization Toolkit simplifies this task." />
  19. <meta name="Description" content="If a new version or a patch for a IBM Cognos product contains changes to the messages or user interface text, you must customize the resource files again. IBM Cognos User Interface and Error String Customization Toolkit simplifies this task." />
  20. <meta name="DC.subject" content="subsequent, customization projects, subsequent projects, subsequent versions of a product, versions of a product" />
  21. <meta name="keywords" content="subsequent, customization projects, subsequent projects, subsequent versions of a product, versions of a product" />
  22. <meta name="DC.Relation" scheme="URI" content="ug_ldk_c_id__0usingibmcognoslocalizationdevelopmentkit.html#id__0UsingIBMCognosLocalizationDevelopmentKit" />
  23. <meta name="DC.Date" scheme="iso8601" content="2014-08-19" />
  24. <meta name="DC.Format" content="XHTML" />
  25. <meta name="DC.Identifier" content="LocalizingSubsequentVersionsofaProduct" />
  26. <meta name="DC.Language" content="en-us" />
  27. <meta name="IBM.Country" content="ZZ" />
  28. <!-- Licensed Materials - Property of IBM -->
  29. <!-- US Government Users Restricted Rights -->
  30. <!-- Use, duplication or disclosure restricted by -->
  31. <!-- GSA ADP Schedule Contract with IBM Corp. -->
  32. <link rel="stylesheet" type="text/css" href="./common/ibmdita.css" />
  33. <link rel="stylesheet" type="text/css" href="./common/idsvhlp.css" />
  34. <link rel="Start" href="ug_ldk_c_id__0usingibmcognoslocalizationdevelopmentkit.html#id__0UsingIBMCognosLocalizationDevelopmentKit" />
  35. <title>Customizing Subsequent Versions of a Product</title>
  36. <script language="javascript"><!--
  37. function openTopic( openTopicLoc, tour ) { var helpWin = ''; var tempHelpWindowName = ''; var helpWindowName = ''; var winWidth = 680; var winHeight = 500; var charPos = openTopicLoc.indexOf("?", 0); if(tour == "tour") { winWidth = 800; winHeight = 600; } if( charPos > 0 ) tempHelpWindowName = openTopicLoc.substring(0, charPos ) || ''; else tempHelpWindowName = openTopicLoc || ''; if( tempHelpWindowName ) { helpWindowName = tempHelpWindowName.replace(/#/ig, "_"); helpWindowName = helpWindowName.replace(/\./g, "_"); helpWindowName = helpWindowName.replace(/\//g, "_"); } if( helpWindowName ) { helpWin=window.open( openTopicLoc, helpWindowName, "toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,width="+winWidth+",height="+winHeight, true); helpWin.focus(); } }
  38. function doNav() {parent.header.previousNavPage = "ug_ldk_t_configuretheproducttoworkwithlocalizedresourcefiles.html#t_configuretheproducttoworkwithlocalizedresourcefiles";parent.header.nextNavPage = "ug_ldk_c_inputresourcefiles.html#c_inputresourcefiles"; parent.header.updateNav();
  39. if(parent.tabcontent) {document.getElementById("collapsableVbar").className="bux-collapsableContentPane-resize-vbar-right-invisible-false"; document.getElementById("collapsableVbarButton").className="bux-collapsableContentPane-border-openClose-button-left"; document.getElementById("collapsableVbarButton").title="Hide the navigation pane"; }
  40. else {document.getElementById("collapsableVbar").className="bux-collapsableContentPane-resize-vbar-left-invisible-false"; document.getElementById("collapsableVbarButton").className="bux-collapsableContentPane-border-openClose-button-right"; document.getElementById("collapsableVbarButton").title="Show the navigation pane"; } }
  41. function dC() { if(parent.tabcontent){ parent.tab.fHlp('ug_ldk.html'); } else {parent.tab.fHlp('ug_ldk_a.html'); } }
  42. --></script><!--[if IE 6]><style type="text/css">.contentDIV {width:100%;overflow:auto;} .bux-collapsableContentPane-resize-vbar-left-invisible-false {visibility:visible;position:absolute;} .bux-collapsableContentPane-resize-vbar-right-invisible-false {visibility:visible;position:absolute;}</style><![endif]-->
  43. <!--[if gte IE 7]><style type="text/css">.contentDIV {overflow:visible;}</style><![endif]-->
  44. </head>
  45. <body onLoad="doNav();highlight();jumpHL();">
  46. <!--ZOOMSTOP-->
  47. <noscript>To use IBM Cognos product documentation, you must enable JavaScript in your browser.</noscript>
  48. <noscript>Internet Explorer Users: If the Information Bar displays a message informing you that active content has been restricted, click the Information Bar for an option to allow blocked content for the current help session. For more information on changing security settings, search Internet Explorer help for <q>active content advanced options</q>. All other browsers: Please make sure JavaScript is enabled.</noscript>
  49. <!--ZOOMRESTART-->
  50. <div class="bux-collapsableContentPane-resize-vbar-right-invisible-false" id="collapsableVbar" role="region" aria-label="navigation bar container"><div tabindex="0" class="bux-collapsableContentPane-border-openClose-button-left" id="collapsableVbarButton" role="region" aria-label="collapse and expand navigation bar"><a href="JavaScript:dC();"><img style="text-decoration: none" src="common/spacer.gif" height="1px" width="1px" border="0" alt="Open and Close navigation pane" /></a></div></div><div class="contentDIV" role="main">
  51. <a name="t_localizingsubsequentversionsofaproduct"></a><a name="localizingsubsequentversionsofaproduct"></a><h1 class="title topictitle1">Customizing Subsequent Versions of a Product</h1>
  52. <div class="body taskbody"><div class="abstract"> <div class="shortdesc">If a new version or a patch for a IBM® Cognos® product
  53. contains changes to the messages or user interface text, you must
  54. customize the resource files again. IBM Cognos User Interface and Error
  55. String Customization Toolkit simplifies this task. </div>
  56. <p class="p">It
  57. can check whether the new version of files in the source directory
  58. differs from the previous version saved in the reference directory.
  59. It then updates the files in the reference and synchronization directories
  60. by inserting the translate attribute in the string elements that are
  61. new or changed in the files in the synchronization directory. Because
  62. you customize only new and changed strings, the customization cost
  63. is reduced.</p>
  64. </div>
  65. <div class="section prereq"><div class="tasklabel"><h2 class="sectiontitle tasklabel">Before you begin</h2></div>Back up all files in the synchronization and reference directories
  66. before you begin.</div>
  67. <div class="tasklabel"><h2 class="sectiontitle tasklabel">Procedure</h2></div><ol class="ol steps"><li class="li step stepexpand"><span class="ph cmd">Configure Cognos UI
  68. and Error String Customization Toolkit to update the configuration
  69. settings, if required <a class="xref" href="ug_ldk_c_configurelocalizationkit.html#ConfigureLocalizationKit" title="You must configure IBM Cognos User Interface and Error String Customization Toolkit before you start using it.">Configure Cognos UI and Error String Customization Toolkit</a>.</span></li>
  70. <li class="li step stepexpand"><span class="ph cmd">Set up the source directory, and then copy new versions
  71. of the input resource files located in the product installation directory
  72. named msgsdk in the source directory. For more information, see <a class="xref" href="ug_ldk_c_prepareinputresourcefilesforlocalization.html#PrepareInputResourceFilesforLocalization" title="Before you can start customizing text, IBM Cognos User Interface and Error String Customization Toolkit must create and synchronize the directories that it will use for processing.">Prepare the Input Resource Files for Customization</a>.</span> <p class="p">Although you can use the source directory from the previous
  73. customization project, we recommend that you set up a new source directory.</p>
  74. </li>
  75. <li class="li step stepexpand"><span class="ph cmd">Ensure that the files from the previous customization project
  76. are in the synchronization and reference directories. For more information,
  77. see <a class="xref" href="ug_ldk_c_prepareinputresourcefilesforlocalization.html#PrepareInputResourceFilesforLocalization" title="Before you can start customizing text, IBM Cognos User Interface and Error String Customization Toolkit must create and synchronize the directories that it will use for processing.">Prepare the Input Resource Files for Customization</a>.</span></li>
  78. <li class="li step stepexpand"><span class="ph cmd">Prepare the input resource files for customization. For
  79. more information, see <a class="xref" href="ug_ldk_c_prepareinputresourcefilesforlocalization.html#PrepareInputResourceFilesforLocalization" title="Before you can start customizing text, IBM Cognos User Interface and Error String Customization Toolkit must create and synchronize the directories that it will use for processing.">Prepare the Input Resource Files for Customization</a>. </span> <p class="p">Files in the synchronization directory and the reference
  80. directory are automatically updated. If the current version of an
  81. input resource file differs from the previous version, a translate
  82. attribute that has a value of new or changed is inserted into the
  83. appropriate string elements.</p>
  84. </li>
  85. <li class="li step stepexpand"><span class="ph cmd">Customize strings identified by the translate attribute.
  86. For more information, see <a class="xref" href="ug_ldk_c_localizethetext.html#LocalizetheText" title="Customize the messages and user interface text in the files that are located in the synchronization directory.">Customize the Text</a>.</span></li>
  87. <li class="li step stepexpand"><span class="ph cmd">Validate the resource files. For more information, see
  88. <a class="xref" href="ug_ldk_t_validatethelocalizedfiles.html#ValidatetheLocalizedFiles" title="Before you generate the target resource files, it is important to validate the customized files in the synchronization directory.">Validate the Resource Files</a>.</span></li>
  89. <li class="li step stepexpand"><span class="ph cmd">Generate the target resource files. For more information,
  90. see <a class="xref" href="ug_ldk_t_generatethetargetresourcefiles.html#GeneratetheTargetResourceFiles" title="IBM Cognos User Interface and Error String Customization Toolkit generates the target resource files containing the customized text.">Generate the Target Resource Files</a>.</span></li>
  91. <li class="li step stepexpand"><span class="ph cmd">Copy the target resource files to the product installation
  92. directory. For more information, see <a class="xref" href="ug_ldk_t_copythetargetresourcefilestotheproductinstallationdirectory.html#CopytheTargetResourceFilestotheProductInstallationDirectory" title="After the target resource files are generated in the target directory, you must copy them to the product installation directory.">Copy the Target Resource Files to the Product Installation Directory</a>.</span></li>
  93. </ol>
  94. </div>
  95. <div class="related-links">
  96. <div class="familylinks">
  97. <div class="parentlink"><strong>Parent topic:</strong> <a class="link" href="ug_ldk_c_id__0usingibmcognoslocalizationdevelopmentkit.html#id__0UsingIBMCognosLocalizationDevelopmentKit" title="IBM Cognos User Interface and Error String Customization Toolkit keeps track of the customized messages and user interface text in different versions of files used in previous customization projects.">Using Cognos UI and Error String Customization Toolkit</a></div>
  98. </div>
  99. </div>
  100. <style type="text/css">.highlight { background: #DEEEFF; }</style><script src="common/highlight.js"></script><script><!-- highlight(); //--></script>
  101. </div>
  102. </body>
  103. </html>