How to install a font using XML Publisher Administrator?

Many of you will have seen the Administrator module on the Template manager in the E Business Suite ... the new properties UI is great and much easier to use but you can now also manage those troublesome MICR, Barcode and other fonts through the manager too.

Thanks to Kevin McDermott from Oracle Support for laying out the following very useful instructions:

XML Publisher 5.6 has a new tab: Administration. This replaces the xdo.cfg configuration file. Now fonts can be uploaded and stored in the database instead of stored on the file system.

Under the Administration tab are sub tabs: Configuration, Font Mappings and Font Files and Currencies.

To install a font requires only a few steps.

1. Log in as XML Publisher Administrator.

2. Navigate to Administration->Font Files->Create Font File.

3. Fields are Font Name and File.
       For Font Name choose any descriptive name.
       File will browse your PC to locate the font file.

4. Navigate to Font Mappings->Create Font Mapping Set.

5. Mapping name is the name you will give to a set of fonts.

6. Mapping code is the internal name you will give to this set.

7. Type: 'PDF Form' for PDF templates. 'FO to PDF' for all other template types.

8. Create Font Mapping (this allows you to add multiple fonts to a set).

9. Font Family is the exact same name you see in Word under Fonts.
If you don't use the same name the font will not be picked up at runtime.

10. Style and weight must also match how you use the font in windows.
Normal and Normal are good defaults.

12. Navigate to Configuration General-> FO Processing->Font Mapping Set.
Can also be done at data def and template level under Edit Configuration.
Hierarchy is Site-> Data Def -> Template.

13. Select your new mapping set.

14. Make sure the font is not referenced under File->Properties->Custom in the RTF template file.

15. Upload a template that uses your special font and test using preview.


Hi, We are on 12.0.6 and I followed your steps to install MICR fonts. I uploaded GnuMICR, but couldnt get it to display in my PDF output. My template is type RTF. Can you please help? Thanks, Suresh

Posted by Suresh on June 12, 2009 at 12:33 AM MDT #

Hi, I've setup my font mappings and the preview of my RTF -> PDF works fine with the fonts. However, I also create an xsl file which I use to preview the document from forms and workflow. What I do is download the RTF to an XSL file using RTFProcessor rtfP = new RTFProcessor(rtfTemplate.getBinaryStream()); rtfP.setOutput(lDirectory); rtfP.process(); And to preview I use the following, where I first fetch the XML output in the CLOB and pass that with the XSL to the processor. oracle.sql.CLOB eventData=statement.getCLOB(1); ByteArrayOutputStream bout = new ByteArrayOutputStream(); fpro.setData(eventData.getCharacterStream()); fpro.setTemplate(lDirectory); fpro.setOutput(bout); fpro.setOutputFormat(FOProcessor.FORMAT_PDF); fpro.process(); byte[] arr = bout.toByteArray(); InputStream [] inStream= new InputStream[1]; inStream[0] = new ByteArrayInputStream(arr); OutputStream fOs = new BufferedOutputStream(response.getOutputStream()); PDFDocMerger pdfMerger = new PDFDocMerger(inStream,response.getOutputStream()); pdfMerger.mergePDFDocs(); Now the problem I encounter is that it only shows the default fonts, not the fonts I've uploaded. Any thoughts/experience on this??

Posted by Pam on July 09, 2009 at 07:04 AM MDT #

Hi, I found the solution. I needed to place the font files somewhere on the server and create an XDO Config file (xdo.cfg) to point to the font files. The font mapping setup is not enough if you are using preview with the FO Processor apparently.

Posted by Pam on July 09, 2009 at 11:35 PM MDT #

How do you define non truetype fonts, like opentype fonts? If you specify Type 1 you cannot select your font file, you must pick one of the values from the predefined list, so how would I link my opentype Font Family to my actual Font File?

Posted by Pam on July 12, 2009 at 08:18 PM MDT #

Pam, Did you ever find a solution to this issue: "How do you define non truetype fonts, like opentype fonts? If you specify Type 1 you cannot select your font file, you must pick one of the values from the predefined list, so how would I link my opentype Font Family to my actual Font File?" I am having the same issue and would like to know if you found a solution to defining non truetype fonts, like opentype fonts? Thanks, Mark

Posted by Mark on November 02, 2009 at 03:13 AM MST #

Hi, We are creating the XML Publisher reports with Arabic Transparent font.It is coming in the xml publisher (win word) but if I selected that arabic transparent font I am not able to select the font,automatically it is changing to Times New Roman font. Can anybody help me to solve this problem? I followd this post but am not able to select the font name from the browse filed it is giving error like "control.ini File not found Please verify the correct file name was given" Sahul

Posted by Sahul Hameed on November 15, 2009 at 09:15 PM MST #

Tim, I am trying to map a MICR font using the same steps listed here, it does not seem to work. I have to place the font in some Unix directory and set the custom property on the template to make it work. the version is 5.6.3 embedded with 11.5.10 1) Is there a set up that is missing 2) Any suggestion for the UNIX directory to upload the font as alternative ? Thanks

Posted by MD on December 29, 2009 at 05:40 AM MST #

Hi, I used BI publisher to Print the Check, But issues is MICR font is not printing Occassionaly. Even in the PDF output MICR Font is not Display.. It happens Occasionally.. We cut 25000 check but only 2 check without MICR font. Any idea why it is happening. Thanks in Advance, Chetan

Posted by Chetan on January 17, 2010 at 12:59 AM MST #

Anybody has any clear idea on how to produce the MICR font on XML Check Writer.I did from XML Publisher Administration and also on the Unix.It did produce the MICR font but not completely. It did not generate the " at the begining and end of the check number, routing number and account number. Any success stories.Please share your ideas. Regards, Ranga..

Posted by Ranga on February 03, 2010 at 06:30 AM MST #

Hi we want to use XML publisher for check printing with MICR font. We created RTF template and output in PDF. When we are opening output in PDF then system is not showing MICR font. I placed the XDO.cfg file under resource directory and also placed locally but no success. We are on linux (Oracle R12.1.1) , can any one suggest if they find any success and what steps they performed. Thanks in advance

Posted by Harish on August 10, 2010 at 02:09 PM MDT #

Hi, Anyone has and answer for: "How do you define non truetype fonts, like opentype fonts? I'm facing the same issue, thank you

Posted by Xavi on September 16, 2010 at 08:51 PM MDT #

How do you setup to be able to use multiple fonts. Such as using a MICR font for checks and also being able to use a barcode font for shipping docs. I see how to create multiple mappings but only one font is defined in the --> Navigate to Configuration General-> FO Processing->Font Mapping Set

Posted by guest on November 10, 2011 at 02:25 AM MST #

Hi All,

I would like to know the process to migrate the font files , font mappings etc from one instance to other.

Can anyone who is aware of migration process , please let me know.


Posted by Lenin on April 16, 2012 at 05:31 AM MDT #

In EBS XML Publisher I do not think there is a supported method other than to do it manually.


Posted by guest on April 20, 2012 at 06:58 AM MDT #

I have a arabic Language which i am not able to see in the application can anyone please suggest...

Posted by Jagadeesh Bellamkonda on January 05, 2015 at 02:01 AM MST #

Post a Comment:
  • HTML Syntax: NOT allowed

Follow bipublisher on Twitter Find Us on Facebook BI Publisher Youtube ChannelDiscussion Forum

Join our BI Publisher community to get the most and keep updated with the latest news, How-to, Solutions! Share your feedback and let us hear your voice @bipublisher on Twitter, on our official Facebook page, and Youtube!


« August 2016