Chapter - 6 : Troubleshooting

This chapter provides troubleshooting tips for issues you might encounter during the Mobile Implementation.

I have installed Documaker Mobile, but cannot access the Mobile options when using the Documaker Add-In for Microsoft Word.

After you have installed Documaker Mobile, you will need to re-export your Workspace Definition. See the topic "GENERATING A WORKSPACE DEFINITION FILE" in the Documaker Studio user guide for details on exporting this file.

Cannot access Mobile options Context Tag or Omit in Documaker Studio either at the resource level, for example, Application Definition, Sections, Forms or the object level, for example Charts, Fields, Text Areas, etc.)

Mobile options requires Documaker Mobile. If you have not purchased and installed Documaker Mobile the required mobile options will be disabled. To purchase Documaker Mobile, visit My Oracle Support website or contact your Oracle Sales representative.

Cannot define a new context tag in a resource, such as a Section or a Field.

Check the user right "Limit to pre-defined context tags". When this option is turned on, the user is limited to selecting pre-defined context tags specified in the Application Definition file.

Is there a way to write snippet contents to the trace file at runtime?

The Debug_Switches INI group contains the option MRO_Debug which when active, includes snippet information in the trace file.

To activate, set both Enable_Debug_Options and MRO_Debug to Yes

For example,

  • Opening C:\FAP\mstrres\enterprise\MROLIB\master_financials.xml * UTLDefWarnNotify * PrtType:MRO: Unable to open file C:\FAP\mstrres\enterprise\MROLIB\master_financials.xml
    Unable to open file C:\FAP\mstrres\enterprise\MROLIB\master_financials.xml
    Opening C:\FAP\mstrres\enterprise\MROLIB\master.xml
  • Opening C:\FAP\mstrres\\enterprise\MROLIB\group_financials.xml * UTLDefWarnNotify * PrtType:MRO: Unable to open file C:\FAP\mstrres\enterprise\MROLIB\group_financials.xml
    Unable to open file C:\FAP\mstrres\enterprise\MROLIB\group_financials.xml
    Opening C:\FAP\mstrres\enterprise\MROLIB\group.xml
  • Form name:FS_COVER
    Opening C:\FAP\mstrresenterprise\MROLIB\form_financials.xml * UTLDefWarnNotify * PrtType:MRO: Unable to open file C:\FAP\mstrres\enterprise\MROLIB\form_financials.xml

Note: Be sure to turn debugging off by setting Enable_Debug_Switches to No once you no longer need to log MRO or other debug information to the trace file.

I am getting results that look fine but a field (or other) value is missing which I expected from the Documaker output.

Generate Mobile output using the Documaker Mobile default snippets, then check for that value in the output. Using the Documaker Mobile default snippets provides a clean way to analyze the output from Documaker.

I would like to omit groups from my mobile output. How can I accomplish this?

To omit groups from mobile output, you would change the master snippet to use documaker.forms instead of documaker.groups

For example,

<?xml version="1.0" encoding="UTF-8" ?>
<DOCSET NAME="documaker.name" DESC="documaker.description">
<RECIPIENT NAME="documaker.recip"/>
<FONTS>
documaker.fonts
</FONTS>
documaker.forms
</DOCSET>