First OAF page deployment - many questions

Question

I am trying deploy my first OAF Page (HelloWorldPG). However, I am getting lost trying to understand the directory
structure. I tried to read through older posts from other users....but parts of their directory structure is different
from mine.
Development Steps:
1) Created new OA component page using the default package "oracle.apps.ak.hello"
The Physical location of the page is C:\JDEV\jdevhome\jdev\myprojects\oracle\apps\ak\hello\webui
I notice that it is also located under C:\JDEV\jdevhome\jdev\myclasses\oracle\apps\ak\hello\webui. why does it get created in both myprojects and myclasses?
2) Created and attached the controller class (HelloWorldMainCO.class) as suggested in the dev guide
Physical location of the class file is C:\JDEV\jdevhome\jdev\myclasses\oracle\apps\ak\hello\webui
3) Build and run the page. Page runs with out any errors
Deployment steps(This is where I feel like I am running in circles...)
1) I manually created a directory structure "/hello/webui" under $JAVA_TOP/oracle/apps/ak since I thought that it should match what I had on my PC. Is this step of creating the directory structure manually even needed?
2) Then I migrated:
a)"HelloWorldPG.xml" into $JAVA_TOP/oracle/apps/ak/hello/webui from C:\JDEV\jdevhome\jdev\myprojects\oracle\apps\ak\hello\webui
as ASCII after ftp'ing into in my UNIX via command prompt
b) "HelloWorldMainCO.class" into $JAVA_TOP/oracle/apps/ak/hello/webui from C:\JDEV\jdevhome\jdev\myclasses\oracle\apps\ak\hello\webui
as Binary after ftp'ing into in my UNIX via command prompt
3) I tried to import the page/region in to the DB using the following command in the command prompt from C:\JDEV\jdevbin\jdev\bin
import C:\JDEV\jdevhome\jdev\myprojects\oracle\apps\ak\hello\webui\HelloWorldPG.xml -username apps -password <password> -rootdir C:\JDEV\jdevhome\jdev\myprojects\ -dbconnection "(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=172.xx.x.xxx)(PORT=1521))(CONNECT_DATA=(SID=<xxxxxx>)))" -rootPackage /oracle/apps/ak/hello
Import seems to have completed successfully without any errors. However, I am not sure if I gave the correct rootpackage or not.
JDR_% tables seem to be updated. I can vouch for only the JDR_PATHS table as only that seems to have the creation date.
PS: In the above import statement, I masked (only for this post) the password, ip address and the SID for security reasons. I am confident that what I used when importing is accurate.
4) At this point should I be able to run procedure shown below?
Begin
jdr_utils.PrintDocument('/oracle/apps/ak/hello/webui/HelloWorldPG');
End;
or should I first create the AOL function/attach it to the menu and then run the above?
I tried running it, with out creating the AOL Function and attaching the menu. It comes back with the message "Error: Could not find document /oracle/apps/ak/hello/webui/HelloWorldPG".
5) Then I created the form function called "TOOLBOX_HELLO" with following:
Type = SSWA jsp function
HTML Call = "OA.jsp?page=/oracle/apps/ak/hello/webui/HelloWorldPG"
Now I don't know which menu to add the AOL Function.
As I mentioned earlier, I tried to read through several other older posts....however, I am getting confused.
There are multiple places in the above steps where I need guidance. Could any one pls. suggest/correct my steps in deployment?
Thanks

Answer 1

Hi there,
1) Created new OA component page using the default package "oracle.apps.ak.hello"
The Physical location of the page is C:\JDEV\jdevhome\jdev\myprojects\oracle\apps\ak\hello\webui
I notice that it is also located under C:\JDEV\jdevhome\jdev\myclasses\oracle\apps\ak\hello\webui. why does it get created in both myprojects and myclasses?
The folder myclasses holds the .class compiled object files you deploy, the myprojects folder holds the .java source files.
2) Created and attached the controller class (HelloWorldMainCO.class) as suggested in the dev guide
Physical location of the class file is C:\JDEV\jdevhome\jdev\myclasses\oracle\apps\ak\hello\webui
3) Build and run the page. Page runs with out any errors
Deployment steps(This is where I feel like I am running in circles...)
1) I manually created a directory structure "/hello/webui" under $JAVA_TOP/oracle/apps/ak since I thought that it should match what I had on my PC. Is this step of creating the directory structure manually even needed?
Yes. This allows your code to be separate from seeded code so it isn't overwritten on patches.
2) Then I migrated:
a)"HelloWorldPG.xml" into $JAVA_TOP/oracle/apps/ak/hello/webui from C:\JDEV\jdevhome\jdev\myprojects\oracle\apps\ak\hello\webui
as ASCII after ftp'ing into in my UNIX via command prompt
b) "HelloWorldMainCO.class" into $JAVA_TOP/oracle/apps/ak/hello/webui from C:\JDEV\jdevhome\jdev\myclasses\oracle\apps\ak\hello\webui
as Binary after ftp'ing into in my UNIX via command prompt
3) I tried to import the page/region in to the DB using the following command in the command prompt from C:\JDEV\jdevbin\jdev\bin
import C:\JDEV\jdevhome\jdev\myprojects\oracle\apps\ak\hello\webui\HelloWorldPG.xml -username apps -password <password> -rootdir C:\JDEV\jdevhome\jdev\myprojects\ -dbconnection "(DESCRIPTION=(ADDRESS=(PROTOCOL=tcp)(HOST=172.xx.x.xxx)(PORT=1521))(CONNECT_DATA=(SID=<xxxxxx>)))" -rootPackage /oracle/apps/ak/hello
Import seems to have completed successfully without any errors. However, I am not sure if I gave the correct rootpackage or not.
JDR_% tables seem to be updated. I can vouch for only the JDR_PATHS table as only that seems to have the creation date.
PS: In the above import statement, I masked (only for this post) the password, ip address and the SID for security reasons. I am confident that what I used when importing is accurate.
4) At this point should I be able to run procedure shown below?
Begin
jdr_utils.PrintDocument('/oracle/apps/ak/hello/webui/HelloWorldPG');
End;
Yes, that will show you that it was loaded into mds. This is only for diagnostic purposes, not always required.
or should I first create the AOL function/attach it to the menu and then run the above?
You can now to do the AOL function.
I tried running it, with out creating the AOL Function and attaching the menu. It comes back with the message "Error: Could not find document /oracle/apps/ak/hello/webui/HelloWorldPG".
5) Then I created the form function called "TOOLBOX_HELLO" with following:
Type = SSWA jsp function
HTML Call = "OA.jsp?page=/oracle/apps/ak/hello/webui/HelloWorldPG"
Now I don't know which menu to add the AOL Function.
As I mentioned earlier, I tried to read through several other older posts....however, I am getting confused.
There are multiple places in the above steps where I need guidance. Could any one pls. suggest/correct my steps in deployment?
You need to bounce the apache server on the middle tier to get it to work.
Hope this helps.
Kristofer