понедельник, 21 января 2013 г.

Запуск канкарента с отчетом из OAF

На той странице где вы хотите вызвать отчет, и где вы знаете параметры этого отчета "рисуете" кнопку или ссылку(более предпочтительно т.к. можно указать чтоб открылась в новом окне, очень актуально для отчетов). В качестве target у кнопки или ссылки указываете на свою собственную пустую страницу, сделать ее можно за 1 минуту.
На этой странице ничего нет кроме контроллера с методом processRequest приблизительно такого содержания (внимание - в 12-й версии addLayout требует 6 параметров, а не 5, как в 11 версии) :

public void processRequest(OAPageContext pageContext, OAWebBean webBean)
  {
    super.processRequest(pageContext, webBean);
     

       OAApplicationModule am = pageContext.getApplicationModule(webBean);
        int xxRequestId = 0;
        // Считываем входные параметры
        String xxp_kvpid = pageContext.getParameter("p_kvpid");
        String xxp_loanId = (String)pageContext.getParameter("p_loanId");
      
        // Заполняем, вычисляем параметры необходимые для запуска конкарента
        String xxp_type = null;
        String applnName = "PER";
        String cpName = null;
        String LayName = null;
        String cpDesc = null;
        Vector cpArgs = null;
        String xxDate = null;
        String xxp_number = null;
        String xxp_summa = null;
        String xxp_code = null;
        String xxp_date = null;
        
       if (xxp_kvpid != null)
      {  xxp_date = (String)pageContext.getParameter("p_date"); 
       
        java.util.Date d1 =(java.util.Date) pageContext.getOANLSServices().stringToDate(xxp_date,"dd-MMM-yyyy");
         xxDate  =  new SimpleDateFormat("yyyy/MM/dd").format(d1);  
        
      
         xxp_number = pageContext.getParameter("p_number");
         xxp_summa = pageContext.getParameter("p_summa");
         xxp_code = pageContext.getParameter("p_code");
         xxp_type = "G"; 
        if  ("P".equals(xxp_code.substring(0,1)) ) { xxp_type = "P";}
      }
        // Запускаем конкарент
        try
        {
            OADBTransaction tx = am.getOADBTransaction();
            java.sql.Connection pConncection = tx.getJdbcConnection();
            ConcurrentRequest cr = new ConcurrentRequest(pConncection);
           
            if (xxp_kvpid != null)
           { 
             cpName = "XXKVP_KO1";  // Краткое название конкарента
             LayName = "XXKVP_KO1"; // код шаблона XML
             if ("G".equals(xxp_type))
             {  cpName = "XXKVP_KO2";
               LayName = "XXKVP_KO2";
             }
             // Заполняем параметры конкарента
             cpArgs = new Vector(6);
             cpArgs.addElement(xxDate);
             cpArgs.addElement(xxp_kvpid);
             cpArgs.addElement(xxp_type);
             cpArgs.addElement(xxp_number);
             cpArgs.addElement(xxp_summa);
             cpArgs.addElement(xxp_code);
           }
           else
           {  cpName = "XXKVP_DOG_LOAN"; // Краткое название конкарента
              LayName = "XXKVP_DOG_LOAN"; // код шаблона XML
              // Заполняем параметры конкарента
              cpArgs = new Vector(1);
              cpArgs.addElement(xxp_loanId);
           }
            try
            {
            // Добавление шаблона (для отчетов XML Publisher)
            cr.addLayout("PER",LayName,"ru","RU","PDF"); 
            }
            catch(Exception e)
            {throw new OAException("addLayout -" + e.getMessage(), (byte)0);
            }
            // Непосредственно запуск конкарента
            xxRequestId = cr.submitRequest(applnName, cpName, cpDesc, null, false, cpArgs);
            
          
            tx.commit();
            // xxRequestId - id конкарента
        }
        catch(RequestSubmissionException e)
        {
            throw new OAException("RequestSubmissionException " + e.getMessage(), (byte)0);
        }
        // Ждем завершения конкарента через пакет fnd_concurrent.wait_for_request
        OAException oaexception = null;
        String Stmt = "declare var_wait boolean; var_phase  varchar2(80); var_status  varchar2(80); var_dev_phase varchar2(80);  var_dev_status varchar2(80); var_message varchar2(80); begin var_wait := fnd_concurrent.wait_for_request( request_id  => " + xxRequestId + ",interval => 5 ,max_wait => 0,phase => var_phase,status => var_status,dev_phase => var_dev_phase,dev_status => var_dev_status,message => var_message ); end;";
        OAApplicationModule MyApplicationModule = pageContext.getRootApplicationModule();
        OADBTransaction oadbtransaction = MyApplicationModule.getOADBTransaction();
        OracleCallableStatement MyOraCallableStmt;
        try
        {
            MyOraCallableStmt = (OracleCallableStatement)oadbtransaction.createCallableStatement(Stmt, 1);
            MyOraCallableStmt.execute();
        }
        catch(Exception exception1)
        {
            oaexception = OAException.wrapperException(exception1);
            throw OAException.wrapperException(exception1);
        }
        try
        {
            MyOraCallableStmt.close();
        }
        catch(Exception exception)
        {
            throw OAException.wrapperException(exception);
        }
       // Дождались окончания конкарента и переходим на страницу отображения результатов конкарента с передачей параметра какой конкарент нужно отобразить
       pageContext.forwardImmediately("OA.jsp?_rc=FNDCPREQUESTVIEWPAGE&_ri=0&OUTPUT=Y&REQUESTID=" + xxRequestId, null, (byte)0, null, null, false, "N");
  } 
 
__________________________________________________________
 
Чтобы другим не наступать на грабли и не гадать как этот javascript 
прилаживать к OAF, роя интернет. Выкладываю что у меня получилось. 
Получилось у меня и через кнопку и по линку.
Через кнопку, получилось используя javascript. Вот пример кода:
public void processFormRequest(OAPageContext pageContext, OAWebBean webBean)
    {
      super.processFormRequest(pageContext, webBean);
        if (pageContext.getParameter("bPrint") != null)
          {
             String lookupType = pageContext.getParameter("LookupType");
             StringBuffer l_buffer = new StringBuffer();
             StringBuffer l_buffer1 = new StringBuffer();
             l_buffer.append("javascript:var mywin = openWindow(top, '");
             l_buffer1.append("/xxlookup/oracle/apps/fnd/lookups/webui/xxConcurent");
             l_buffer1.append("&retainAM=Y");
             l_buffer1.append("&LookupType="+lookupType);
             String url = "/OA_HTML/OA.jsp?page="+l_buffer1.toString();
             OAUrl popupUrl = new OAUrl(url, OAWebBeanConstants.ADD_BREAD_CRUMB_SAVE );
             String strUrl = popupUrl.createURL(pageContext);
             l_buffer.append(strUrl.toString());
             l_buffer.append("', 'ReportWindow', {width:800, height:600},false,'dialog',null);");
             pageContext.putJavaScriptFunction("RepLookup",l_buffer.toString());
          }
    }   


Где xxConcurent - это страничка (создавал в JDevelopere, как New -> OACompanets -> Page)
LookupType - это параметр который забираю с текущей странички

Для линка просто сам формирую дестинэйшин:
public void processRequest(OAPageContext pageContext, OAWebBean webBean)
    {
        super.processRequest(pageContext, webBean);    
        OALinkBean linkBean = (OALinkBean) webBean.findIndexedChildRecursive("lPrint");//first get the LinkBean
        linkBean.setAttributeValue(linkBean.DESTINATION_ATTR, "OA.jsp?page=/xxlookup/oracle/apps/fnd/lookups/webui/xxConcurent&retainAM=Y&LookupType="+ (String)pageContext.getParameter("LookupType"));
    }


Ну и в свойствах у Линка стоит Target Frame = _blank

Надеюсь кому-нибудь будет полезным.  

четверг, 27 декабря 2012 г.

Объект DIRECTORY в ORACLE

Объект базы данных DIRECTORY - это ссылка на каталог сервера, на котором работает инстанс Oracle. Он нужен для пакета UTL_FILE, работы утилит impdp/expdp, при использовании полей типа BFILE в таблицах, а также при создании внешних таблиц (external tables).
Вот что можно делать с объектом DIRECTORY:


Пара замечаний:
  • При создании директории ORACLE не проверяет её наличие и доступность, поэтому о создании каталога на диске и предоставлении прав на него пользователю-владельцу инстанса надо позаботиться заранее. Если этого не сделать, то при попытке обращения получим ошибку.
  • При удалении директории всё её содержимое остаётся в файловой системе.
  • Надо с осторожностью раздавать пользователям привилегию CREATE ANY DIRECTORY, так как у них появится возможность изменять любые файлы ОС, к которым есть доступ у пользователя-владельца инстанса

Регистрация приложения OEBS

Источники:

http://onlineappsdba.blogspot.com/2007/10/creating-custom-application-in-oracle.html
http://apps-oracle.ru/registration_application/
http://www.appshosting.com/pub_doc/custom_top.html

Кратко

  1. Создать структуру каталогов
  2. Изменить файл (по умолчанию defaults.env) настроек переменных окружения для сервера форм. Его имя хранится в переменной окружения envFile в файле appsweb.cfg, имя и путь к которому в свою очередь хранятся в переменной окружения  FORMS_WEB_CONFIG_FILE, добавив строку с установкой значения переменной окружения <префикс приложения (ЗАГЛАВНЫМИ)>_TOP. Тем самым будет определён каталог, в котором сервер Oracle Forms сможет найти файлы приложения
  3. В файл $APPL_TOP/custom<имя инстанса>.env следует добавить инициализацию тех же переменных с последующим их экспортом (это необходимо для выполнения системных процедур и вызова параллельных запросов) и проверить наличие вызова это файла из $APPL_TOP/APPS<имя инстанса>.env. При наличии в составе приложения исполняемых операционной системой программ также следует добавлять <префикс приложения (ЗАГЛАВНЫМИ)>_TOP/bin к переменной окружения PATH (если используется)
  4. Остановить менеджер параллельных программ (concurrent manager)
    $ADMIN_SCRIPTS_HOME/adcmctl.sh stop apps/apps
  5. Выполнить файл, замещающий APPLSYS.env
    . / $APPL_TOP/APPS<имя инстанса>.env
  6. Перезапустить concurrent manager
    $ADMIN_SCRIPTS_HOME/adcmctl.sh start apps/apps
  7. Войдите в систему с полномочиями Разработчик приложений (Application Developer) и зарегистрируйте приложение
  8. Войдите в систему с полномочиями System Administrator и добавьте приложение в группу данных (раздел меню «Security : ORACLE», пункт «Группа данных»)

Подробнее

Custom Applications are required if you are creating new forms, reports, etc.   
This allows you to segregate your custom written files from the standard seeded functionality that
Oracle Applications provide.     
Customizations can therefore be preserved when applying patches or upgrades to your environment. 
1)  Make the directory structure for your custom application files.
               cd $APPL_TOP
               mkdir fz
               mkdir fz/11.5.0
               mkdir fz/11.5.0/admin
               mkdir fz/11.5.0/admin/sql
               mkdir fz/11.5.0/admin/odf
               mkdir fz/11.5.0/sql
               mkdir fz/11.5.0/bin
               mkdir fz/11.5.0/reports
               mkdir fz/11.5.0/reports/US
               mkdir fz/11.5.0/forms
               mkdir fz/11.5.0/forms/US 
               mkdir fz/11.5.0/$APPLLIB
               mkdir fz/11.5.0/$APPLOUT
               mkdir fz/11.5.0/$APPLLOG 
2)  Add the custom module into the environment
Apply ADX.E.1 and add the entry to topfile.txt as a standard product top entry .   
Customised environment variables can be added to AutoConfig by using the filename specificed by s_custom_file, 
which is then called from the APPSORA.env file. 
If using Forms Listener Servlet, you may also need to add $CUSTOM_TOP to formsservlet.ini in
$APACHE_TOP/Jserv/etc 
3)  Create new tablespace for database objects
     create tablespace FZ datafile '/u01/oracle/visdata/fz.dbf' size 10M default storage(initial 10k next 10k)
4)  Create schema
               create user fz identified by fz
                               default tablespace fz
                               temporary tablespace temp
                               quota unlimited on fz
                               quota unlimited on temp;
               grant connect, resource to fz;
5)  Register your Oracle Schema. 
     Login to Applications with System Administrator responsibility
     Navigate to Application-->Register
               Application = FZ Custom
               Short Name  = FZ
               Basepath    = FZ_TOP
               Description = FZ Custom Application
6)  Register Oracle User
     Naviate to Security-->Oracle-->Register
               Database User Name = FZ
               Password           = FZ
               Privilege          = Enabled
               Install Group      = 0
               Description        = FZ Custom Application User
7)  Add Application to a Data Group
     Navigate to Security-->Oracle-->DataGroup
               Data Group  = FZGroup
               Description = FZ Custom Data Group
      Click on "Copy Applications from" and pick Standard data Group, then add the following entry.
               Application = FZ Custom
               Oracle ID   = APPS
               Description = FZ Custom Application
8)  Create custom request group
     This will act as a placeholder for any custom reports we wish to make available for the Custom Responsibility 
      Navigate to Security-->responsbility-->Request
               Group       = FZ Request Group
               Application = FZ Custom
               Code        = FZ
               Description = FZ Custom Requests
       We will not define any requests to add to the group at this stage, but you can add some now if required.
9)  Create custom menu
      This will act as a placeholder for any menu items we wish to make available for the Custom Responsibility. 
      We will create two menus, one for Core Applications and one for Self Service.
       Navigate to Application-->Menu
               Menu           = FZ_CUSTOM_MENU
               User Menu Name = FZ Custom Application
               Menu Type      = <leave blank>
               Description    = FZ Custom Application Menu
               Seq         = 100
               Prompt      = View Requests
               Submenu     = <leave blank>
               Function    = View All Concurrent Requests
               Description = View Requests
               Seq         = 110
               Prompt      = Run Requests
               Submenu     = <leave blank>
               Function    = Requests: Submit
               Description = Submit Requests
               Menu           = FZ_CUSTOM_MENU_SSWA
               User Menu Name = FZ Custom Application SSWA
               Menu Type      = <leave blank>
               Description    = FZ Custom Application Menu for SSWA 
10)  Create new responsibility.   One for Core Applications and One for Self Service (SSWA)
       Navigate to Security-->Responsibility-->Define
               Responsibility Name       = FZ Custom
               Application               = FZ Custom
               Responsibility Key        = FZCUSTOM
               Description               = FZ Custom Responsibility
               Available From            = Oracle Applications
               Data Group Name           = fzGroup
               Data Group Application    = FZ Custom
               Menu                      = FZ Custom Application
               Request Group Name        = FZ Request Group
 
               Responsibility Name       = FZ Custom SSWA
               Application               = FZ Custom
               Responsibility Key        = FZCUSTOMSSWA
               Description               = FZ Custom Responsibility SSWA
               Available From            = Oracle Self Service Web Applications
               Data Group Name           = fzGroup
               Data Group Application    = FZ Custom
               Menu                      = FZ Custom Application SSWA
               Request Group Name        = FZ Request Group
11)  Add responsibility to user
       Navigate to Security-->User-->Define
       Add FZ Custom responsibility to users as required.
12)  Other considerations
       You are now ready to create your database Objects, custom Reports, Forms, Packages, etc
Create the source code files in the FZ_TOP directory appropriate for the type of object.   For example forms
would be located in $FZ_TOP/forms/US or package source code in $FZ_TOP/admin/sql for example.
Database Objects, such as tables, indexes and sequences should be created in the FZ schema, then you need to 
               a) Grant all privilege from each custom data object to the APPS schema.
                               For example :  logged in as FZ user
                                              grant all privileges on myTable to apps;
               b) Create a synonym in APPS for each custom data object
                               For example :  logged in as APPS user
                                              create synonym myTable for fz.myTable;
Other database objects, such as views and packages should be created directly in the APPS schema.