Upgrading Implementations with Advanced Customizations
If you have implemented advanced overrides in the Stationery design, such as overrides to .xsl
or.fti
files, or overrides to files in the Formats
folder, ensure you save a copy of the following items to a secure location before uninstalling a previous version of ePublisher and installing a new version:
Overrides currently used in the Stationery design project
A copy of the original files from which the overrides were created
If you want to continue to use your advanced customizations with the new version of ePublisher, first uninstall your previous ePublisher version and then install a new ePublisher version. Then identify and include your overrides in the new versions of the ePublisher files as appropriate by performing a three-way merge of the following items:
A copy of the existing override file used in the Stationery design project, located in the
StationeryName\Formats\
OutputFormat folder, where
StationeryName is the name the Stationery designer specified for the Stationery, and
OutputFormat is the type of output format the Stationery Designer specified for a target in the Stationery.
A copy of the original file from which the override was created, available in the
StationeryName\Formats\
OutputFormat.base
folder, where
StationeryName is the name the Stationery designer specified for the Stationery, and
OutputFormat is the type of output format the Stationery Designer specified for a target in the Stationery.
A copy of the new file from the new version of ePublisher
Performing a three-way merge allows you to identify the code you changed when you created the override, and also allows you to quickly and easily create the override again in the new ePublisher files. You may find tools such as Araxis Merge Pro, available at
http://www.araxis.com/merge, or KDiff3, available at
http://kdiff3.sourceforge.net, helpful as you compare and merge override files.
After you perform your three-way merge and update the files you want to override in the new version of ePublisher with the overrides you specified in the previous version, test your overrides by generating output using the new version of ePublisher Designer and the Stationery design project to confirm your output generates appropriately. After you verify the output generated correctly using your advanced customizations, you can create new Stationery using the Stationery design project and then deploy the updated Stationery that includes your advanced customizations to writers to use to generate output.
Last modified date: 02/27/2024