ORACLE ERP CUSTOM WEB SERVİCE OLUŞTURMAK

March 8, 2013 · by altunkan · in E-Business Suite

Oracle eBusiness Suite kullanılan kurumsal firmaların en önemli ihtiyaçlarından biri ERP sistemlerini diğer kullandıkları sistemlerle entegre edebilmektir. Günümüz teknoloji dünyasında entegre sistemleri oluşturabilmek için iki sistem(veritabanı) arasında DBLINK kullanılmalı veya Web Service kullanılmalıdır. Bu yazımda Oracle ERP için PL/SQL kullanarak JDeveloper üzerinde Web Service oluşturmayı inceleyeceğim.

İşlemleri kabaca 6 adımda toplarsak;

oc4jadmin için Parola Değiştirmek
Doğru OPMN Portunu Bulmak
JDeveloper üzerinden Uygulama Sunucusu Bağlantısı Kurmak
Web Service için PL/SQL Fonksiyonu oluşturmak
JDeveloper içinde Web Service Yaratmak ve Uygulama Sunucusuna Yerleştirmek
Web Service Testi

1.oc4jadmin için Parola Değiştirmek

Web Service ile geliştirme yapılabilmesi için JDevleoper üzerinden Application Server bağlantısı kurulmalıdır. Application Server bağlantısı için tanımlı gelen kullanıcı oc4jadmin’dir.

Kurulum sırasında oc4jadmin parolası genellikle standart olarak bırakıldığı için, parolanın manuel müdahale ile değiştirilmesi gerekmektedir. Bu işlem Uygulama Sunucusu içinde oacore altında bulunan system-jazn-data.xml dosyası içinde ilgili bölüm güncellenerek yapılmaktadır. system-jazn-data.xml dosyasını hatalı olarak kaydedilirse apache server açılmamaktadır. Bu yüzden bu dosyayı değiştirmeden önce mutlaka YEDEĞİNİ alınız. Bunun için izlenmesi gereken adımlar aşağıdaki gibidir;

Uygulama sunucusu içinde ilgili home’un (bu işlem her ortam (instance) için farklı yapılmalıdır) /test2_appl/inst/apps/…/ora/10.1.3/j2ee/oacore/config path’ine gidilir.
Örnek path: /test2_appl/inst/apps/…./ora/10.1.3/j2ee/oacore/config
İlgili path altından system-jazn-data.xml dosyası bulunup, açılır.
Dosyanın aşağıdaki kısmı güncellenir. Bu kısımda bulunan <name> tagi kullanıcı adını belirtirken, <credentials> tagi ise parolayı göstermektedir. Parola değişimi için <credentials> tagleri arasına ! ile başlayan bir parola belirlenir.
Parola değiştirildikten sonra dosya kaydedilir ve standart dosyanın üzerine yazılır.
Bu işlemler yapıldıktan sonra, değişikliğin aktif olabilmesi için apache ve oc4j serverlar kapatılıp açılmalıdır.


<user>    
    <name>oc4jadmin</name>
    <display-name>OC4J Administrator</display-name>
    <description>OC4J Administrator</description>
    <credentials>!parola</credentials>
</user>

<user>

<name>oc4jadmin</name>

<display-name>OC4J Administrator</display-name>

<description>OC4J Administrator</description>

<credentials>!parola</credentials>

</user>

2.Doğru OPMN Portunu Bulmak

Jdeveloper üzerinden Application Server bağlantısı kurabilmek için gereken diğer bilgilerden biri ise OPMN portudur. OPMN port’u opmn.xml dosyası içinde yer alan bir bilgidir. Bu bilgiye ulaşabilmek için aşağıdaki yöntem izlenmelidir.

Uygulama suncusu içinde $ORACLE_CONFIG_HOME environment’ına gidilir. Normalde bu environmentler yol üzerinde 10.1.2’yi kullanırlar ancak bizim bakmamız gereken yol 10.1.3 içindedir.
/test2_appl/inst/apps/…/ora/10.1.3/opmn/conf
Bu yol açıldıktan sonra, içindeki opmn.xml dosyası açılır. Dosya içindeki request port’u bizim kullanacağımız opmn portudur. Eğer port erişime açık değilse açtırılması gerekmektedir. Oracle EBS için opmn request portu genellikle Application web portuna benzerdir.

Örnek: Web Port: 8011 OPMN Port: 6511, Web Port: 8000 OPMN Port 6500


<port local="6111" remote="6211" request="6511">

3.JDeveloper üzerinden Uygulama Sunucusu Bağlantısı Kurmak

1.JDeveloper açıldıktan sonra Connections Navigator tabında, Application Server’a sağ tıklanıp, New Application Server Connection seçilir.

Bağlantı İsmi

2.Connection Name kısmına Bağlantı adı yazılır. Connection Type ise Oracle Application Server 10g 10.1.3 seçilir. Versyon patchlerine göre buradaki bağlantı tipi değişebilir.
3.Username kısmına oc4jadmin, Password kısmına ise yukarıdaki adımlarda belirtilen parola yazılır.

Bağlantı Bilgileri

4.Host Name kısmına bağlanmak istediğimiz makinenin ip adresi yazılır. Connect To Single Instance olarak seçilir. OC4J Instance Name için oacore yazılır. OPMN Port’u ise daha önceden belirlediğiniz Request portudur.

oc4jadmin parolası

Test

5.Son adımda bağlantı test edilir.

Test

4.Web Service için PL/SQL Fonksiyonu oluşturmak

Web Service ile veri yayınlamak için JDeveloper’a table type döndüren bir pl/sql fonksiyonu yazılmalıdır. Fonksyion parametrik yapılarak da Web Service için çağrıda bulunan istemciden parametre alınabilir. İlgili parametre PL/SQL kodunun içersinde kullanıma açıktır.

Fonksyion ile tablo tipinde veri döndürmek için önce CUSTOM bir OBJECT yaratılır. Daha sonra bu object’den bir collection yaratılır. Sonraki aşamada ise bu collection bir cursor ile doldurulur. Bunun için aşağıdaki yöntem uygulanmalıdır.

1.CUSTOM bir OBJECT yaratılır.


CREATE OR REPLACE TYPE APPS.XXBLG_PERSON_TYPE AS OBJECT
(
    PERSON_ID       NUMBER,
    FIRST_NAME      VARCHAR2(150),
    LAST_NAME       VARCHAR2(150)
);

CREATE OR REPLACE TYPE APPS.XXBLG_PERSON_TYPE AS OBJECT

(

PERSON_ID NUMBER,

FIRST_NAME VARCHAR2(150),

LAST_NAME VARCHAR2(150)

);

2.Bu OBJECT’den yeni CUSTOM bir table type (collection) yaratılır.


CREATE OR REPLACE TYPE APPS.XXBLG_PERSON_TABLE_TYPE AS TABLE OF XXBLG_PERSON_TYPE;

CREATE OR REPLACE TYPE APPS.XXBLG_PERSON_TABLE_TYPE AS TABLE OF XXBLG_PERSON_TYPE;

3.Bu Collection’ı dolduran bir fonksiyon yazılır.


CREATE OR REPLACE PACKAGE APPS.XXBLG_WS_PKG AS
FUNCTION XXBLG_GET_PERSONS RETURN XXBLG_PERSON_TABLE_TYPE;
END XXBLG_WS_PKG;

CREATE OR REPLACE PACKAGE APPS.XXBLG_WS_PKG AS

FUNCTION XXBLG_GET_PERSONS RETURN XXBLG_PERSON_TABLE_TYPE;

END XXBLG_WS_PKG;


CREATE OR REPLACE PACKAGE BODY APPS.XXBLG_WS_PKG AS

    FUNCTION XXBLG_GET_PERSONS RETURN XXBLG_PERSON_TABLE_TYPE IS

        L_RECORDS XXBLG_PERSON_TABLE_TYPE := XXBLG_PERSON_TABLE_TYPE();

        CURSOR CSR IS

            SELECT PAP.PERSON_ID, PAP.FIRST_NAME, PAP.LAST_NAME 
            FROM PER_ALL_PEOPLE_F PAP
            WHERE SYSDATE BETWEEN PAP.EFFECTIVE_START_DATE AND PAP.EFFECTIVE_END_DATE;

    BEGIN

        FOR SEL IN CSR
        LOOP

            L_RECORDS.EXTEND;
            L_RECORDS(L_RECORDS.COUNT) := (XXBLG_PERSON_TYPE(SEL.PERSON_ID, SEL.FIRST_NAME, SEL.LAST_NAME));

        END LOOP;

        RETURN L_RECORDS; 

    END XXBLG_GET_PERSONS;

END XXBLG_WS_PKG;

CREATE OR REPLACE PACKAGE BODY APPS.XXBLG_WS_PKG AS

FUNCTION XXBLG_GET_PERSONS RETURN XXBLG_PERSON_TABLE_TYPE IS

L_RECORDS XXBLG_PERSON_TABLE_TYPE := XXBLG_PERSON_TABLE_TYPE();

CURSOR CSR IS

SELECT PAP.PERSON_ID, PAP.FIRST_NAME, PAP.LAST_NAME

FROM PER_ALL_PEOPLE_F PAP

WHERE SYSDATE BETWEEN PAP.EFFECTIVE_START_DATE AND PAP.EFFECTIVE_END_DATE;

BEGIN

FOR SEL IN CSR

LOOP

L_RECORDS.EXTEND;

L_RECORDS(L_RECORDS.COUNT) := (XXBLG_PERSON_TYPE(SEL.PERSON_ID, SEL.FIRST_NAME, SEL.LAST_NAME));

END LOOP;

RETURN L_RECORDS;

END XXBLG_GET_PERSONS;

END XXBLG_WS_PKG;

5.JDeveloper içinde Web Service Yaratmak ve Uygulama Sunucusuna Yerleştirmek

İlgili Oracle EBS versyonuna ait Oracle Application Framework (OAF) patch’i indirilip veritabanı bağlantısı yapıldıktan sonra,
1.Applications’a sağ tıklayıp New Application’dan yeni bir çalışma alanı oluşturulur.
2.Olşturulan Application’a sağ tıklayıp New Project seçilerek yeni proje oluşturulur.
3.Projeye sağ tıklanıp New seçilir. Açılan ekranda Business Tier -> Web Services -> PL/SQL Web Service seçilir.

4.Açılan pencerede J2EE 1.4 (JAX-RPC) Web Service seçilir.
5.İkinci adımda eğer daha önceden oluşturulduysa Databse Connection seçilir. Yoksa New’a tıklanarak yeni bir Veritabanı bağlantısı oluşturulabilir. Databse Connection seçildikten sonra yukarıdaki adımlarda yarattığımız Web Service paketi bulunur. Web Service Name alanına Web Service için bir isim belirlenir ve Next’e tıklanır. Bu aşamada JDeveloper Paketin içindeki fonksiyonları aramaya başlayacaktır. Bulunduğunuz Network ve Sistem durumuna göre bu işlem zaman alabilir. En alt kısımda entegre olacağınız sisteme göre desteklencek soap versyonları seçilir.

6.2. Adımda herhangi birşey değiştirilmeden Next seçilir.
7.Açılan ekrandan ilgili Web Service Veritabanı fonksiyonu seçilir.

8.Kalan adımlarda herhangi birşey değiştirilmeden devam edilir.
9.Son aşamada ise birşey değiştirmeden Next ve Finish Denilir.
10.JDeveloper Web Service ile ilgili dosyaları ve classları kendisi oluşturduktan sonra, Proje -> Resources altında bulunan .deploy dosyasına sağ tıklanıp Properties açılır. WEB-INF/classes -> Filters tabında bulunan, PL/SQL’den dönen table type işaretlenir.

11.Web Service’i EBS üzerinden yayınlayabilmek için, daha önce oluşturulan Application Server Bağlantısı kullanılmalıdır. Deployment işlemi için .deploy dosyasına sağ tıklanıp Deploy To -> ApplicationServerConnection seçilmelidir.

12.Web Service başarılı bir şekilde depoy edildikten sonra linki bulmak için wsdl uzantılı xml dosyası açılır. XML içinde aşağıdaki location tagi içinde link bulunabilir. Ancak link local linktir, ip adresininin değiştirilmesi gerekmektedir. Bu noktada iki adet link bulunabilir.


<service name="BilgiWebServiceTest8011">
        <port name="BilgiWebServiceTest8011Soap12HttpPort" binding="tns:BilgiWebServiceTest8011Soap12Http">
        <soap12:address location="http://10.5.2.104:8888/BilgiWebService-WebService-context-root/BilgiWebServiceTest8011Soap12HttpPort"/>
        </port>
        <port name="BilgiWebServiceTest8011SoapHttpPort" binding="tns:BilgiWebServiceTest8011SoapHttp">
        <soap:address location="http://10.5.2.104:8888/BilgiWebService-WebService-context-root/BilgiWebServiceTest8011SoapHttpPort"/>
        </port>
</service>

<soap12:address location="http://10.5.2.104:8888/BilgiWebService-WebService-context-root/BilgiWebServiceTest8011Soap12HttpPort"/>

</port>

<soap:address location="http://10.5.2.104:8888/BilgiWebService-WebService-context-root/BilgiWebServiceTest8011SoapHttpPort"/>

</port>

</service>

13.Üstteki linkten açılan sayfada Service Description’a tıklayarak, entegrasyon için gönderilmesi gereken WSDL linkine ulaşılır.

Tags: jdeveloper, oracle, pl/sql, web service

ORACLE ERP CUSTOM WEB SERVİCE OLUŞTURMAK

One Response

Leave a Reply Click here to cancel reply.

Visitors

Subscribe to Blog via Email