!"#"$%&'(()
April 2014 BI Publisher !!!"#$%&'())*"&+%
CONVERTING CM WORD LETTER TEMPLATES TO BI TEMPLATES Older versions of CM used Word for “Letter T emplates”, where CM14 now uses BI for Letter Templates. The process to re-­‐create these is fairly simple, requiring you to save the Word Letter Templates from your old version of CM to a standalone Word document and then copy/pasting and formatting using the BI RTF tool. In brief, the method of re-­‐creating these is as simple as saving the old Word Template as a document on your computer, replacing all the CM links in the old template with links using the BI tool and saving as an RTF file and then uploading to the BI server. CM WORD TEMPLATES 1. Open your old version of CM and from the Define, Letter Templates, click the EDIT for each Letter Template, then “Modify Letter Template”—which will open the document in Word. 2. Click Save AS and save the document to your local drive. These tech tips are offered free of charge in the spirit of sharing knowledge with others. They do not include technical support, should you have a problem with them. We are always interested in how they can be improved, please do not hesitate to email us your comments. These tips have been thoroughly tested by our consultants in a variety of environments. Please read these tech tips thoroughly and be sure that you understand them before trying to use them. We can not be responsible for issues that develop because of the configuration of your hardware, technical environment or application of the tech memos. If you are not sure, then we urge you to contact Oracle technical support or your local support consultant for assistance. *'&+%,-.
*&/+,#/
!"#$%&'%(#)
!"#$%&'"%()*#+#'"
!"#$%&'"%(!,(-!!.
!"#$%&'"%(/0*1"%21(.%*%3'$'*1
CONVERTING CM WORD LETTER TEMPLATES TO BI TEMPLATES 3. Repeat this for all Letter Templates you need to re-­‐create. 4. Exit out of your old version of CM BI TEMPLATES 1. Making a copy of the Data Model for Letters: a. Open the BI Web Tool and navigate in the Catalog to the “Tempates” folder. b. There should be a CmLettersDataModel saved there, click Edit c. Click the XML link and then select “Export XML”. This will let you save the data model format to your local drive to be used by the Word RTF tool. You will use this XML for all your letter templates, so you’ll only do this once. Page 2
CONVERTING CM WORD LETTER TEMPLATES TO BI TEMPLATES d. Sign out of the BI Web Tool for now. 2. Modify the Word Letter Template to BI specifications a. Open the first Word template you saved. b. Click SAVE AS, and select RTF format (do NOT save as a Word DOC, DOCX format) c. Click on Bi Publisher tab, Load Data, Sample XML. Browse to the XML file you saved (CmLettersDataModel.xml) and load. d. Next, highlight all fields in old template where fields were referenced one by one. Delete old reference, then click the BI Publisher tab, Insert, Field and select the field from the list. Note: if the reference is in a header/footer, you will need to insert in BI code using the format: <?FIELD_NAME?> Page 3
CONVERTING CM WORD LETTER TEMPLATES TO BI TEMPLATES e. Once you have replaced all field inserts Save the RTF Note: you MUST save as RTF. Saving as a DOC or DOCX will not be accepted by the BI server. f. Repeat these steps for all your letter templates 3. Uploading Templates to the BI server a. Next, open BI Web Tool and navigate in the Catalog to the “Templates” folder b. On the SampleCmLetterTemplate layout select the Copy and then Paste to create a copy. Page 4
CONVERTING CM WORD LETTER TEMPLATES TO BI TEMPLATES c. On the Copy, select Rename and change the name of the template to your old template name d. Edit this new entry and click the Add New Layout Page 5
CONVERTING CM WORD LETTER TEMPLATES TO BI TEMPLATES e. Select Upload RTF option, browse to your new template. i. Layout Name—you can type in a name here ii. Template File—select the RTF you saved locally (this will not accept DOC and DOCX format) iii. Type—select RTF iv. Locale—select English v. Click Upload f. Click on View a List and make sure that your new RTF file is set to be the “Default Layout” (note you may see the TestLetterTemplate there as well—you can either leave there or delete it—as long as your template is the default it doesn’t matter.) g. Repeat these steps for all your letter templates. 4. FINISHED! (Just go to CM14 and test them) Page 6
CONVERTING CM WORD LETTER TEMPLATES TO BI TEMPLATES NOTES AND CONSIDERATIONS 1. Global vs. Project Specific Templates a. The Letter Templates folder in BI is by default the “Global” list of templates, and will be available in all projects. b. If you have Project-­‐specific templates, you will need to create additional folders in the BI server Catalog for each project and add the templates there rather than in the root of the Templates folder. c. Additionally, you will need to go into CMAdministration Server Configuration section and create an entry in the Project Reports, Forms and Letter Templates for each project that has their own custom templates and point the Templates to your Project folder. i. Key Note: where the old application displayed BOTH group and project templates, this will ONLY show the templates in the “Project” reference, so you’ll need to copy into this Project folder project-­‐specific templates AND any “global” templates. Page 7
CONVERTING CM WORD LETTER TEMPLATES TO BI TEMPLATES d. If you are going to use ONLY a global list, just put all templates in the root Templates folder. Page 8