14.01.2013 Views

Oracle JHeadstart Developer's Guide - Downloads - Oracle

Oracle JHeadstart Developer's Guide - Downloads - Oracle

Oracle JHeadstart Developer's Guide - Downloads - Oracle

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

13.3.6. Troubleshooting<br />

• ADF BC Migration: Each extracted XML file is processed by a number of ADF<br />

BC migrators (each target ADF BC element has its own migrator), that together<br />

create an XML structure that is the input for the actual creation (composition) of<br />

ADF BC components. This XML structure is written to the file system, in the Java<br />

source root directory, in a file named _migratedAdfbc.xml<br />

• ADF BC Composition: Based on the migrated ADF BC XML structure of each<br />

form, the entity objects, entity associations, view objects and view links, and the<br />

application modules are created.<br />

• <strong>JHeadstart</strong> Migration: Each extracted XML file is then processed by a number of<br />

<strong>JHeadstart</strong> migrators (each target <strong>JHeadstart</strong> Application Definition element has<br />

its own migrator), that together create an XML structure that is the input for the<br />

actual creation (composition) of the <strong>JHeadstart</strong> Application Definition file. This<br />

XML structure is written to the file system, in the Java source root directory, in a<br />

file named _migratedJhs.xml<br />

• <strong>JHeadstart</strong> Composition: Based on the migrated <strong>JHeadstart</strong> XML structure of<br />

each form, the <strong>JHeadstart</strong> Application Definition file is created, and stored in the<br />

properties directory of the ViewController project.<br />

If the ADF2Generator run was successful, you can safely delete the intermediate results<br />

of the Forms2AdDF Generator, being the extracted and migrated XML files in the Java<br />

source root directory. However, if processing failed with an error, these XML files can<br />

be used for troubleshooting as explained in the next section.<br />

When the <strong>JHeadstart</strong> Forms2ADF Generator fails with an error, the first thing to do is to<br />

assess which form module is causing the error. This information can easily be obtained<br />

from the log window in JDeveloper, which prints an informational message for each<br />

processing phase, for each module, as show in the screen shot below.<br />

<strong>JHeadstart</strong> Developer’s <strong>Guide</strong> Forms2ADF Generator 13 - 11

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!