Oracle ADF Task Flow Parametre Geçişi

August 31, 2014 · by altunkan · in Oracle ADF

Merhaba,

Bu yazıda Oracle ADF ile basit bir Bounded Task Flow uygulaması ve Task Flow akışları arasında parametre geçiş yöntemini göstereceğim. Uygulama herhangi bir DML işlemi içermeden sadece veriyi göstermek amaçlı olacaktır.

JDeveloper Versyon: 11.1.2.2.0

1. Aşağıdaki SQL çalıştırılarak uygulamanın tablo yapısı ve verileri hazırlanır.


create table anil.departmanlar (
    departman_id        number primary key,
    departman_adi       varchar2(200),
    acilis_tarihi       date
);

create sequence anil.departmanlar_s start with 1;


create table anil.calisanlar (
    calisan_id          number primary key,
    departman_id        number,
    ad                  varchar2(200),
    sicil_no            varchar2(10),
    soyad               varchar2(200),
    maas                number,
    dogum_tarihi        date,
    ise_giris_Tarihi    date,
    constraint calisanlar_fk
    foreign key (departman_id)
    references departmanlar (departman_id)
);

create sequence anil.calisanlar_s start with 1;

insert into anil.departmanlar values (anil.departmanlar_s.nextval, 'İNSAN KAYNAKLARI', sysdate);
insert into anil.departmanlar values (anil.departmanlar_s.nextval, 'MUHASEBE', sysdate);

insert into anil.calisanlar values(
anil.calisanlar_s.nextval,
(select departman_id from anil.departmanlar where departman_adi = 'İNSAN KAYNAKLARI'),
'ANIL',
'ALTUNKAN',
'1',
10000,
to_Date('30.12.1987', 'dd.mm.rrrr'),
sysdate
);

insert into anil.calisanlar values(
anil.calisanlar_s.nextval,
(select departman_id from anil.departmanlar where departman_adi = 'İNSAN KAYNAKLARI'),
'DUSTIN',
'HOFFMAN',
'2',
15000,
to_Date('01.01.1940', 'dd.mm.rrrr'),
sysdate
);

insert into anil.calisanlar values(
anil.calisanlar_s.nextval,
(select departman_id from anil.departmanlar where departman_adi = 'MUHASEBE'),
'STEVE',
'MCQUEEN',
'2',
13000,
to_Date('01.01.1930', 'dd.mm.rrrr'),
sysdate
);

commit;

create table anil.departmanlar (

departman_id number primary key,

departman_adi varchar2(200),

acilis_tarihi date

);

create sequence anil.departmanlar_s start with 1;

create table anil.calisanlar (

calisan_id number primary key,

departman_id number,

ad varchar2(200),

sicil_no varchar2(10),

soyad varchar2(200),

maas number,

dogum_tarihi date,

ise_giris_Tarihi date,

constraint calisanlar_fk

foreign key (departman_id)

references departmanlar (departman_id)

);

create sequence anil.calisanlar_s start with 1;

insert into anil.departmanlar values (anil.departmanlar_s.nextval, 'İNSAN KAYNAKLARI', sysdate);

insert into anil.departmanlar values (anil.departmanlar_s.nextval, 'MUHASEBE', sysdate);

insert into anil.calisanlar values(

anil.calisanlar_s.nextval,

(select departman_id from anil.departmanlar where departman_adi = 'İNSAN KAYNAKLARI'),

'ANIL',

'ALTUNKAN',

'1',

10000,

to_Date('30.12.1987', 'dd.mm.rrrr'),

sysdate

);

insert into anil.calisanlar values(

anil.calisanlar_s.nextval,

(select departman_id from anil.departmanlar where departman_adi = 'İNSAN KAYNAKLARI'),

'DUSTIN',

'HOFFMAN',

'2',

15000,

to_Date('01.01.1940', 'dd.mm.rrrr'),

sysdate

);

insert into anil.calisanlar values(

anil.calisanlar_s.nextval,

(select departman_id from anil.departmanlar where departman_adi = 'MUHASEBE'),

'STEVE',

'MCQUEEN',

'2',

13000,

to_Date('01.01.1930', 'dd.mm.rrrr'),

sysdate

);

commit;

2. Veritabanı bağlantısı JDeveloper içerisinden oluşturulur. İlk defa bağlantı oluştururken Binding Style olarak ben Oracle Domain tercih ediyorum. Eğer Oracle Domain seçerseniz veritabanındaki NUMBER alanlarınız karşılığı oracle.jbo.domain.Number olur aksi taktide BigDecimal veya Integer olarak oluşurlar.

3. JDeveloper açılır ve New Application seçilir. Applications bölümünden Fusion Web Application (ADF) seçilir.

4. Application Name bölümü BoundedTaskFlowParam olarak değiştirilir. Kalan adımlarda değişiklik yapılmadan son adıma geçilir ve Finish denilir. Rutin bir ADF uygulamasında Model ve View olmak üzere iki adet katman vardır.

5. Kurulumunu yaptığımız veritabanı modelini BC4J objeleri olarak oluşturmak için aşağıdaki adımlar izlenir.

6. ViewController katmanına sağ tıklanır ve New seçilir. Web Tier -> JSF/Facelets bölümünden ADF Task Flow seçilir.

7. Task Flow aşağıdaki özelliklerde oluşturulur.

8. Task Flow açılır ve Component Palette bölümünden bir adet View sürükle bırak yöntemi ile oluşturulur.

9. Yeni bir Task Flow daha oluşturulur ancak bu sefer “Create with Page Fragments” tiki kaldırılır. Bunun amacı ikinci task flow objesini birincinin üzerine pop-up olarak açacak olmamızdır. Pop-up lar için JSF kullanılması gereklidir.

10. ViewCalisanlarBTF Input parametresi aşağıdaki gibi ayarlanır ve task flow objesine de bir adet View Sürükleyip bırakılarak oluşturulur.

11. Tekrar ViewDepartmanBTF task flowuna dönülür ve daha önce oluşturduğumuz view objesine çift tıklanarak bir adet jsff (fragment) aşağıdaki özelliklerde oluşturulur.

12. Oluşturulan ViewDepartmant.jsff sayfacığına Component Palette bölümünden bir adet “Panel Collection” sürüklenip bırakılır. Bu panel tablolar için en kullanışlı paneldir. Ancak içine eklenen tablounun genişliğini alması için tabloya stil verilmesi gereklidir.

13. “Panel Collection” paneline “Data Controls” bölümünde yer alan, uygulama için en başında oluşturduğumuz CalisanlarAM application modülü altındaki “DepartmanlarEOVO1” objesi sürüklenip bırakılarak ADF Read-Only Table olarak aşağıdaki özelliklerde oluşturulur.

14. Tabloya “Context Menu” yani pop up menü yapmak için Context Menu Facet’i altında bir adet Pop-Up, Pop-Up altında bir adet Menu ve Menu altına da bir adet Menu Item aşağıdaki gibi oluşturulur.

15. ViewDepartman.jsff sayfacığında Design bölümünden Bindings bölümüne geçiş yapılır. Be Bindings katmanına bir adet Attribute Binding aşağıdaki özelliklerde oluşturulur.

16. ViewController projesine sağ tıklanır ve yeni bir Java sınıfı oluşturulur. Bu sınıfı ViewBean olarak parametre geçmek için kullanıyor olacağız.


package view.beans.departman.view;

public class ViewDepartmanBTFViewBean {
    private String selectedDepartmanId;

    public void setSelectedDepartmanId(String selectedDepartmanId) {
        this.selectedDepartmanId = selectedDepartmanId;
    }

    public String getSelectedDepartmanId() {
        return selectedDepartmanId;
    }
}

package view.beans.departman.view;

public class ViewDepartmanBTFViewBean {

private String selectedDepartmanId;

public void setSelectedDepartmanId(String selectedDepartmanId) {

this.selectedDepartmanId = selectedDepartmanId;

}

public String getSelectedDepartmanId() {

return selectedDepartmanId;

}

17. Bu oluşturduğumuz JAVA sınıfı ViewDepartmanBTF objesine Managed Bean olarak eklenir.

18. Tekrar ViewDepartman.jsff sayfacığına dönülür ve az önce eklediğimiz Menu Item üzerine bir adet sağ panelde bulunan Set Propert Listener’ı eklenir ve özellikleri aşağıdaki gibi değiştirilir. Bu listener aksyion olduğu anda eklenen binding değerini Java sınıfındaki alana yazar.

19. ViewCalisanlarBTF task flowuna daha önceden eklediğimiz View üzerine iki kere tıklanır ve sayfa oluşturma sihirbazı açılır. Bu noktada dikkat edilmesi gereken husus bu eklenen sayfanın jsff değil jsf olduğudur. Çünkü bu sayfa pop-up olarak açılacaktır.

20. Bu sayfa içerisine de bir adet Panel Collection ve altında CalisanlarEOVO1 objesinden Read-Only Table oluşturulur.

21. CalisanlarEOVO View Object nesnesi açılır. Query bölümünden bir adet Bind Variable aşağıdaki özelliklerde eklenir.

22. Query sorgu bölümü Edit ile açılır ve aşağıdaki gibi güncellenir.

23. ViewCalisanlarBTF task flowu açılır ve Data Controls bölümünde yer alan CalisanlarEOVO1 objesi altındaki ExecuteWithParams task flow üzerine sürükle bırak ile aşağıdaki özelliklerde oluşturulur. Dikkat edilmesi gereken husus pSelectedDepId alanının #{pageFlowScope.selectedDepartmanId} şeklinde değer almasıdır. ExecuteWithParams task flowun default aktivitesi olarak değiştirilir.

24. ViewDepartmanBTF task flowu açılır ve ViewCalisanlarBTF’u bu task flow içine sürüklenip bırakılır. Behaviour bölümünden özellikleri aşağıdaki gibi güncellenir. Önemli hususlardan biri Child Task Flow’a gidecek parametrenin #{viewScope.ViewDepartmanBTFViewBean.selectedDepartmanId} şeklinde düzeltilmesidir.

25. ViewDepartman.jsff sayfasına eklediğimiz tablonun pop-up menu itemının özellikleri aşağıdaki gibi güncellenir. Bu sayede açılan sayfa pop-up olarak aşağıdaki özelliklerde açılacaktır. Action bölümü ise Task Flowdaki çağrıdır.