INSTALLATION  INSTRUCTIONS  
Insum    
EBS  Objects  for  APEX    
 
 
 
 
Author:   Sylvain  Martel  
Creation  Date:   July  2,  2014  
Last  Updated:   September  19,  2016    
Document  Ref:   Insum  EBS  APEX  Integration    
Version:   1.2.2  
 
Installation  Instructions   Doc  Ref:    Insum  EBS  APEX  Integration    
September  19,  2016  

Document  Control  
 

Change  Record  
3  

Date   Author   Version   Change  Reference  

       
3-­Jul-­14   Sylvain  Martel   1.0   No  Previous  Document  
1-­Dec-­14   Sylvain  Martel   1.1   Naming  standardization  
Multi-­org  support  
19-­Jan-­15   Sylvain  Martel   1.2   JSP  and  Profile  Option  precisions  
23-­Feb-­15   Sylvain  Martel   1.2.1   Added  SQL  script  files  for  components.  
19-­Sep-­16   Sylvain  Martel   1.2.2   Standardization  of  PL/SQL  code  

EBS Objects for APEX Document Control ii

File Ref: Insum - EBS Objects for APEX - Installation Instructions.docx (v. 1.2.2 )
Installation  Instructions   Doc  Ref:    Insum  EBS  APEX  Integration    
September  19,  2016  

Contents  

Document  Control .................................................................................................................... ii  

Installation  Instructions  for  EBS  Objects  for  APEX ............................................................. 1  
Description ......................................................................................................................... 1  
Pre-­Installation  Steps ....................................................................................................... 1  
Installation  Steps .............................................................................................................. 1  
 
 

EBS Objects for APEX Document Control iii

File Ref: Insum - EBS Objects for APEX - Installation Instructions.docx (v. 1.2.2 )
Installation  Instructions   Doc  Ref:    Insum  EBS  APEX  Integration    
September  19,  2016  

Installation  Instructions  for  EBS  Objects  for  APEX  

 
 

Description  

This  document  describes  the  required  authentication  scheme  configuration  for  any  APEX  page  or  
application  to  be  called  from  an  Oracle  E-­Business  Suite  (EBS)  function.    This  authentication  scheme  will  
provide  the  following:  
•   Create  a  custom  authentication  for  calls  made  by  an  EBS  function    
•   Provide  a  seamless  login  integration  between  EBS  and  APEX  allowing  EBS  users  to  access  
APEX  applications  /  pages  without  the  need  to  reenter  credentials    

The  connection  between  EBS  and  APEX  differs  depending  of  the  EBS  version.    This  document  assumes  
the  instance  is  part  of  the  R12  family  (R12.0.4  to  R12.1.3).      

 
    Note:  The  PL/SQL  package  and  views  have  not  been  tested  on  EBS  R12.2.x  
 
 
 

Pre-­Installation  Steps  
 
Requirements  

q   Provide  UNIX  applmgr  credentials  

q   Provide  database  user  APPS  credentials  
q   Provide  EBS  user  SYSADMIN  credentials  
q   Provide  FTP  client  software  access  
 
 
 

Installation  Steps  
 
Installation  Summary  

q   Compile  common  EBS-­APEX  procedures  and  functions  

q   Compile  LauchAPEX  jsp  file  
 
 
   

EBS Objects for APEX Installation Instructions for EBS Objects for APEX 1 of 3
File Ref: Insum - EBS Objects for APEX - Installation Instructions.docx (v. 1.2.2 )
Installation  Instructions   Doc  Ref:    Insum  EBS  APEX  Integration    
September  19,  2016  

Create  common  EBS-­APEX  objects  in  APPS  schema  (APPS  user)  

Connect  to  the  database  as  user  APPS  and  execute  SQL  script  XXAPEX_APPS_install.sql.  
q   Log  on  UNIX  using  applmgr  user  
q   sqlplus apps/****
q   @ XXAPEX_APPS_install.sql
 
 
Create  synonym  for  the  APPS  objects  
Connect  to  the  database  as  user  XX  (or  your  custom  DB  user)  and  execute  SQL  script  
XXAPEX_XX_install.sql.  
q   Log  on  UNIX  using  applmgr  user  
q   sqlplus xx/****
q   @ XXAPEX_XX_install.sql
 

Compile  LauchAPEX  jsp  file  

In  R12,  calling  an  APEX  page  is  achieved  by  passing  parameters  to  a  JSP  file  and  creates  a  URL  string  
called  by  that  process.    In  order  to  provide  this  functionality,  a  custom  jsp  needs  to  be  created  in  the  
$OA_HTML  directory  on  the  server.      
q   Using  Filezilla  (or  any  other  FTP  client  software),  transfer  file  LaunchApex.jsp  to  directory  
$OA_HTML  (text  format)  
q   Log  on  UNIX  using  applmgr  user  and  execute  the  following  commands:  
cd $OA_HTML
export PATH=$PATH:$FND_TOP/patch/115/bin
ojspCompile.pl --compile -s 'LaunchApex.jsp' --retry
 
 
   

EBS Objects for APEX Installation Instructions for EBS Objects for APEX 2 of 3
File Ref: Insum - EBS Objects for APEX - Installation Instructions.docx (v. 1.2.2 )
Installation  Instructions   Doc  Ref:    Insum  EBS  APEX  Integration    
September  19,  2016  

Create  APEX  URL  Profile  Option  

Log  in  Oracle  E-­Business  Suite  as  the  system  administrator  (SYSADMIN)  and  create  a  profile  option  to  
record  the  URL  to  call  to  access  the  APEX  engine.  
q   Login  into  E-­Business  suite  and  select  System  Administrator  responsibility  
q   Follow  navigation  menu  Define  Profile  Option  

Field   Value  
  X  

Name   XXAPEX_APEX_URL  
Application   [Custom  Application]  
User  Profile  Name   APEX:  APEX  URL  
Description   URL  to  Access  APEX  using  custom  JSP  -­  Insum  
Dates  en  vigueur    
Début   [Today’s  Date]  
Fin   (NULL)  

Niveau   Visible   Modifiable  

  X   X  

Site   √   √  
Application      
Responsability      
User      
User  Access      
 

Assign  APEX  URL  Profile  Option  Value  

Log  in  Oracle  E-­Business  Suite  as  the  system  administrator  (SYSADMIN)  and  assign  a  value  at  the  site  
level  to  profile  option  APEX:  APEX  URL.  
q   Login  into  E-­Business  suite  and  select  System  Administrator  responsibility  
q   Follow  navigation  menu  Profile  >  System  

Profil  Option  Name   Site   Application   Responsibility   User  

APEX:  APEX  URL   http://hostname:port/        
 
 
Note:  Make  sure  the  URL  value  ends  with  a  forward  slash  (/)  
 
 
 
 
 
End  of  the  document.  
 

EBS Objects for APEX Installation Instructions for EBS Objects for APEX 3 of 3
File Ref: Insum - EBS Objects for APEX - Installation Instructions.docx (v. 1.2.2 )