Oracle Application Form

MỤC LỤC MỤC LỤC................................................................................................................1 Kiến trúc ứng dụng .................................................................................................4 Tổng quan về kiến trúc ứng dụng. .................................................................................. 4 Mô hình phát triển và triển khai Oracle Application. ..................................................... 7

Các chuẩn cho việc Customize ứng dụng .............................................................8 Tổng quan về việc customize Oracle Applications......................................................... 8 Customization theo cách mở rộng. ................................................................................. 9 Customize theo cách mở rộng ......................................................................................... 9 Customize bằng cách chỉnh sửa .................................................................................... 11 Customize cơ sở dữ liệu Oracle Applications............................................................... 12 Nâng cấp và chỉnh sửa Oracle Applications ................................................................. 12 Tích hợp Custom Objects và Schemas ......................................................................... 12 Nâng cấp các form được customize lên Release 11i .................................................... 12

Tổng quan về Coding Standard trong ứng dụng ...............................................13 Theo dõi các thay đổi về dữ liệu với Record History ( WHO ) .................................... 13 Các ràng buộc khai báo ( declarative constraint ) : ....................................................... 15 View : ............................................................................................................................ 16 Sequence : ..................................................................................................................... 16 API đăng kí bảng : ........................................................................................................ 16 Tổng quan về việc sử dụng PL/SQL trong các ứng dụng : ........................................... 17 Thuật ngữ : .................................................................................................................... 17 Các chuẩn chung trong lập trình PL/SQL : ................................................................... 18 Định dạng mã PL/SQL : ............................................................................................... 19 Xử lý lỗi : ...................................................................................................................... 20 Một vài hướng dẫn khi coding SQL : ........................................................................... 21 Các trigger trong form : ................................................................................................ 22 Những sự thay thế cho các built-in trong Oracle Forms ............................................... 22 Lập trình các handler cho item, event và table : ........................................................... 23 Lập trình các handler cho item : ................................................................................... 24 Lập trình các handler cho event : .................................................................................. 25 Lập trình các handler cho table : ................................................................................... 25

Form TEMPLATE ................................................................................................40 Giới thiệu về form TEMPLATE : ................................................................................. 40 Các thư viện trong form TEMPLATE .......................................................................... 40 Các trigger trong form TEMPLATE............................................................................. 42

Thiết lập các thuộc tính của các đối tượng chứa(ContainerObject) ................49 Các đối tượng chứa : ..................................................................................................... 49 Module : ........................................................................................................................ 49 Window :....................................................................................................................... 49 Canvas : ......................................................................................................................... 51 1

Block : ........................................................................................................................... 51 Region : ......................................................................................................................... 54

Thiết lập các thuộc tính của các đối tượng Widget ...........................................55 Text Item : ..................................................................................................................... 55 Display Item : ................................................................................................................ 56 Poplist : ......................................................................................................................... 56 Option Group : .............................................................................................................. 56 Check Box :................................................................................................................... 56 Button ( Nút ) : .............................................................................................................. 56 List of Values ( LOV ) .................................................................................................. 57 Thiết lập các thuộc tính cho item : ................................................................................ 57 Một số lưu ý : ................................................................................................................ 60

Điều khiển hoạt động của Window, Block, và Region .......................................61 Điều khiển hoạt động của Window ............................................................................... 61 Lập trình cho các Tabbed Regions................................................................................ 69 Hành động của tabbed region : ..................................................................................... 70 3 mức khó trong lập trình : ........................................................................................... 70

Cho phép hoạt động truy vấn ..............................................................................73 Query Find : .................................................................................................................. 73 Triển khai Row-LOV .................................................................................................... 73 Triển khai Find Window ............................................................................................... 74

Lập trình các hành động cho item .......................................................................78 Mối quan hệ giữa các Item............................................................................................ 78 Item phụ thuộc có điều kiện .......................................................................................... 81 Các item đa phụ thuộc................................................................................................... 82 2 Master Item và 1 Dependent Item .............................................................................. 83 Kiểu phụ thuộc Cascading ............................................................................................ 85 Các item loại trừ lẫn nhau (Mutually Exclusive Items) ................................................ 86 Các item đồng hành với nhau (Mutually Inclusive Items) ............................................ 88 Mutually Inclusive Item liên hệ với Dependent Item ................................................... 89 Các item bắt buộc điều kiện (Conditionally Mandatory Items) .................................... 91 Các mặc định (Defaults) ............................................................................................... 93 Kiểm tra tính toàn vẹn (Integrity Checking) ................................................................. 94 Đối tượng Calendar ....................................................................................................... 97 Các lựa chọn cấp cao của Calendar .............................................................................. 98

Điều khiển Toolbar và Default Menu ...............................................................100 Pulldown Menu và Toolbar ........................................................................................ 100 Các lựa chọn có trên thanh công cụ ( toolbar ) : ......................................................... 101 Các mục chỉ có trong Menu ........................................................................................ 102 Điều khiển menu động ................................................................................................ 103 Tạo các biểu tượng trên toolbar cho các form bạn customize .................................... 104 Các menu đặc biệt ....................................................................................................... 105 Customize các Right–Mouse Menu (Popup Menus) .................................................. 105

Message Dictionary .............................................................................................108 Tổng quan về Message Dictionary ............................................................................. 108 Các điểm đặc trưng của Message Dictionary ............................................................ 108

2

Các bước cần tiến hành khi xác định Message Dictionary ......................................... 109 Thiết lập Message Dictionary ..................................................................................... 109 Phương pháp đối với Database Server–side Messaging. ............................................ 110

USER PROFILE .................................................................................................112 Các mức của User Profile: .......................................................................................... 112 Định nghĩa mới các tùy chọn của user profile ............................................................ 113 Thiết lập giá trị tùy chọn user profile.......................................................................... 113 Thiết lập user profile riêng của bạn ............................................................................ 113 Xác định trước tùy chọn user profile .......................................................................... 113 Profile Window ........................................................................................................... 114

FOLDER ..............................................................................................................116 Tổng quan về Folder. .................................................................................................. 116 Lập trình với Folder trên form ứng dụng. ................................................................... 116

3

Kiến trúc ứng dụng Tổng quan về kiến trúc ứng dụng. Kiến trúc ứng dụng của hệ thống Oracle Application theo mô hình tập trung 3 lớp, đó là các lớp Desktop Client, Middle Tier (Form Server) và Data Base Server. Mọi thao tác ở Client đều thực hiện dựa trên hệ thống Java nhúng. Dữ liệu nhập liệu được truyền về Application Server, việc xử lí các chức năng được thực hiện ở Application Server. Việc thao tác xử lí dữ liệu thực hiện ở Database Server. Kiến trúc tổng thể được mô tả như hình vẽ dưới đây:



Desktop Client : • Giao diện đồ họa, sử dụng trên các Web browser chuẩn có hỗ trợ Java nhúng chạy Jinitiator. • Oracle JInitiator là phiên bản Oracle của JavaSoft‟s Java Plug-In, cho phép xử lý JVM tại Web client thay vì dựa vào JVM default của browser.

4

•



Có thể tương thích với mọi PC,network computer hoặc trên bất cứ giao diện nào có Java.

Middle Tier (Form Server): • Xử lý các đáp ứng logic của Form. • Là nơi lưu giữ các dữ liệu cache cục bộ. • Trung gian giữa hai tầng.

5



Database Server: • Sử dụng các lời hàm từ xa (RPC) để giao tiếp với DB khi cần thiết (có thể thực hiện nhiều DB action cùng một lúc – các câu lệnh SQL). • Xử lý thao tác dữ liệu trên ứng dụng. • Lưu các thủ tục trên DB nên giao tiếp giữa các stored procedure và DB xảy ra trong bộ nhớ chứ không phải trên mạng. • Tương thích với DB từ 8i trở lên.

6

Mô hình phát triển và triển khai Oracle Application.

Hiện tại tại trung tâm sử dụng môi trường Window để thiết kế giao diện, dịch Form bằng Form Server trên hệ điều hành Linux. Quá trình phát triển form bao gồm ba bước chính là: • Build • Generate • Run/Test Build Form : Access to Libraries and Referenced Forms Thiết lập FORMS60_PATH. Referenced Objects and the ORACLE_APPLICATIONS V ariable Generating Your Form : (dịch Form trên Forms Server) Moving the File fmb Dịch file : f60gen module=demo.fmb userid=apps/apps Running Your Form for Testing : test trên môi trường Web chứ không phải trên Form developer Sau khi hoàn thành các bước trên chuyển đến Deployment : Nếu đang phát triển và triển khai trên cùng một platform thì chỉ cần copy file .fmx đến đích còn không phải dịch file trên platform đích.

7

Các chuẩn cho việc Customize ứng dụng Để có thể phát triển ứng dụng trên sản phẩm Oracle Applications bạn phải sử dụng Oracle Application Object Library cùng với các công cụ khác như Form và Report. Các chủ đề chính : 

Tổng quan về việc customize Oracle Applications



Customize theo cách mở rộng



Customize theo cách chỉnh sửa



Customize cơ sở dữ liệu Oracle Applications



Nâng cấp và chỉnh sửa Oracle Applications



Nâng cấp Custom Forms lên Release 11i



Upgrade Utility và Standards Compliance Checker: flint60

Tổng quan về việc customize Oracle Applications Các công việc sau bạn có thể làm để phát triển trên ứng dụng : 

Thay đổi các Form trên ứng dụng : – Giao diện (appearance) – Mã kiểm tra (validation logic) – Hành động (behavior)



Thay đổi Report hay chương trình : – Giao diện (appearance) – Mã (logic)



Thay đổi cơ sở dữ liệu của ứng dụng : – Thêm vào các read–only schema – Thêm mã vào các database trigger



Biên dịch lại toàn bộ ứng dụng.

8

Customization theo cách mở rộng. Phát triển các thành phần mới cũng như ứng dụng mới trên nền có sẵn sử dụng Oracle Application Object Library. Điều này có thể đơn giản bằng cách copy một thành phần có sẵn tới một thư mục khác và tiến hành sửa đổi nó. 

Customization theo cách chỉnh sửa Cách này gọi là thay đổi ngay tại chỗ. Tuy nhiên theo khuyến cáo ta nên tránh cách làm này vì có thể gặp sự cố khi nâng cấp hoặc khi sửa đổi.



Các thành phần (Component) Component có thể là module code (như form, report hoặc SQL script) hay các đối tượng Oracle Application Object Library (như menus, responsibilities, messages) hay kể cả đối tượng CSDL(tables, views, packages, or functions). Một ứng dụng phát triển phải được đăng ký với Oracle Application Object Library và phải có thư mục riêng cùng với component của nó.



Các đối tượng cơ sở dữ liệu Một table, index, view, sequence, database trigger, package, grant, hoặc synonym.



Application Short Name Là tên tham chiếu của ứng dụng không có dấu cách.



Application Basepath Là tên của một biến môi trường được chuyển thành top directory của cây thư mục của ứng dụng. Oracle Application Object Library sẽ tìm các đường dẫn tới các thư mục ở mức dưới để thực hiện các file chạy trong ứng dụng kể cả form file.



Cấu trúc thư mục của Application Là sự sắp sếp thứ tự các thư mục trong ứng dụng. Thủ mục của Oracle Applications được tạo ra khi cài đặt ứng dụng hay khi nâng cấp ứng dụng. Với các ứng dụng tự tạo bạn phải tạo riêng các thư mục cho nó.



Các file môi trường (Environment Files) của ứng dụng Xác định biến môi trường khi cài đặt ứng dụng. Biến môi trường bao gồm .env và adovars.env (đối với UNIX platforms).

Customize theo cách mở rộng 

Định nghĩa ứng dụng được customize của bạn

9



Tạo cấu trúc thư mục cho ứng dụng được customize



Thêm ứng dụng được customize vào trong file Environment của ứng dụng



Thêm các thành phần mới vào trong ứng dụng được customize của bạn



Lập tài liệu cho các thành phần mới



Lập tài liệu cho các thành phần mới



Với mỗi thành phần mới, lập tài liệu cho ít nhất là các nội dung sau :



Mục đích



Các tham số đầu vào (cho report và program)



Các đầu ra ví dụ (cho report và program)



Xử lý mã



Các đối tượng CSDL được sử dụng và kiểu truy cập (select, update, insert,delete). Nếu các component tự của bạn là sửa từ bản copy của một component trong ứng dụng bạn phải liệt kê chúng trong file applcust.txt ( nằm ở $APPL_TOP/admin directory Oracle Applications sẽ sử dụng file này trong quá trình patch hay upgrade

 Định nghĩa ứng dụng được customize của bạn Sử dụng Applications window để đăng ký custom application (bao gồm name và short name theo tiêu chuẩn đặt tên thông thường)



Tạo cấu trúc thư mục cho ứng dụng được customize Tự tạo cho ứng dụng của bạn một cấu trúc thư mục hợp lý.



Sửa đổi Applications Environment File Sửa đổi file biến môi trường cho hợp lý sau đó khởi động lại Forms Server và Internal Concurrent Manager rồi chạy file biến môi trường để Oracle Application Object Library tìm thấy các component.



Thêm mới các thành phần Mỗi khi tạo một component mới lưu ý là để chúng ở trong thư mục con hợp lý của ứng dụng.



Thêm một form mới Sử dụng file Template khi bắt đầu tạo một form mới để có thể tương thích

10

với ứng dụng hoặc sửa đổi một form đã có sẵn trên ứng dụng rồi đăng ký lại với ứng dụng.

Các bước tiếp theo là : 

Thêm một Report hoặc một Concurrent Program



Thêm một Report Submission Form



Thêm Online Help



Thêm Menus



Thêm Responsibilities



Thêm các thông báo trong Message Dictionary

Customize bằng cách chỉnh sửa Các bước tiến hành để sửa đổi một form có sẵn trong ứng dụng : Với Release 11i, tất cả các form đêu đặt trong thư mục $AU_TOP/forms/. Copy Oracle Applications form để tiến hành sử đổi ( Lưu ý không sửa đổi trực tiếp lên form). Sử dụng Oracle Forms Developer and Oracle Application Object Library :

1. Xác định một file 2. Copy file vào trong custom application và đổi tên file 3. Bảo toàn file nguyên bản 4. Thực hiện các chỉnh sửa 5. Chú thích cho form 6. Dịch form 7. Đăng kí ứng dụng được customize trong applcust.txt 8. Lập tài liệu cho việc customize



Chú thích cho form Để ghi thông tin về ngày và người sửa của form sử dụng PRE–FORM trigger Oracle Forms. FND_STANDARD.FORM_INFO(‟$Revision: $‟, ‟

‟, ‟<Application Shortname>‟, ‟$Date: $‟, ‟$Author: <developer name> $‟);

11

Lưu ý để có thể sử dụng Help oline thì phải giữ nguyên Application short Name . 

Chỉnh sửa một Report đã có sẵn Các bước tiến hành đối với Oracle Reports .rdf file cũng tương tự như dưới đây : 1. Xác định file 2. Thực hiện chỉnh sửa 3. Chú thích cho report 4. Tạo 1 concurrent program sử dụng file của bạn

Customize cơ sở dữ liệu Oracle Applications Nếu thực hiên việc này phải đặc biệt lưu ý không làm ảnh hưởng tới toàn bộ ứng dụng .

Nâng cấp và chỉnh sửa Oracle Applications 

Kiểm tra các chỉnh sửa đối với CSDL



Xác định các chỉnh sửa cũ



Luân chuyển các chỉnh sửa



Chạy lại Grant và Synonym Scripts



Test tất cả các sự sửa đổi

Tích hợp Custom Objects và Schemas Để thực hiện điều này tốt nhất nên hỏi chuyên gia.

Nâng cấp các form được customize lên Release 11i

12

Tổng quan về Coding Standard trong ứng dụng Theo dõi các thay đổi về dữ liệu với Record History ( WHO ) 

Tính năng Record History ( WHO ) cung cấp thông tin về người đã tạo mới hay cập nhật các hàng trong các bảng Oracle Applications. Nếu bạn thêm các cột WHO đặc biệt vào bảng và các mã WHO vào form và stored procedure, người dùng có thể theo dõi được những thay đổi với dữ liệu của họ. Bạn sử dụng các trường ẩn ( hidden field ) trong mỗi block đại diện cho các cột WHO. Gọi FND_STANDARD.SET_WHO trong các trigger PRE-INSERT, PRE-UPDATE để cung cấp giá trị cho các trường này.



Các cột WHO :

13

14

Các ràng buộc khai báo ( declarative constraint ) : 

NOT NULL



DEFAULT



UNIQUE



CHECK



PRIMARY KEY

Tránh tạo các bảng với kiểu dữ liệu : LONG, LONG RAW, RAW. Sử dụng kiểu VARCHAR2(2000) để thay thế. Với các bảng có tên cột trùng với từ khoá, tạo view đến bảng đó với tên cột được thay bằng tên khác không trùng từ khoá. Có thể thực hiện INSERT, UPDATE, DELETE qua view kiểu này được.

15

View : 

Các block phức tạp thì dựa trên các view, các block đơn giản thì dựa trên các table. Bạn cũng nên tạo các LOV dựa trên view.



Cột đầu tiên trong view nên chọn là cột giả (pseudo-column) ROWID (đặt tên là ROW_ID), rồi đến các cột của bảng ( kể cả các cột WHO ).



Đặt thuộc tính Key Mode của block là Non-Updatable để tắt tham chiếu mặc định đến ROWID của Oracle Forms cho các block dựa trên view. Đặt thuộc tính Primary Key của item là True với item là khoá chính của view.



Lập trình các trigger để thực hiện insert, update, delete và lock : khi tạo 1 block dựa trên view, phải lập trình các trigger ON-INSERT, ON-UPDATE, ON-DELETE và ON-LOCK để insert, update, delete và lock bảng gốc thay vì view.



Với view trên 1 bảng, không cần đến các trigger để insert, update, delete hay lock. Đặt Key Mode của block là Unique. Các view trên 1 bảng không cần đến cột ROW_ID.

Sequence : 

Tạo sequence : để cung cấp các giá trị ID không trùng nhau cho 1 cột của 1 bảng.



Không nên giới hạn phạm vi của sequence ( không sử dụng CYCLE hoặc MAXVALUE ).



Sử dụng kiểu dữ liệu Number để lưu các giá trị của sequence.



Không sử dụng bảng FND_UNIQUE_IDENTIFIER_CONTROL

API đăng kí bảng : 

Bạn đăng kí các bảng ứng dụng tự tạo của mình bằng 1 PL/SQL routine trong package AD_DD.



Các bảng ( và mọi cột của nó ) chỉ phải đăng kí khi chúng sử dụng flexfield hoặc Oracle Alert.



Có thể sử dụng AD_DD API để xoá các đăng kí của bảng và cột



Khi thay đổi cấu trúc bảng, đăng kí lại bằng cách xoá đăng kí cũ ( cột trước rồi đến bảng ), sau đó đăng kí lại.



AD_DD API không kiểm tra sự tồn tại của bảng cần đăng kí. Vì vậy, cần biết chắc bảng cần đăng kí có tồn tại và mô tả đúng các định dạng của nó khi sử dụng AD_DD API.



Không cần phải đăng kí cho view.



Các thủ tục trong package AD_DD : procedure register_table (p_appl_short_name in varchar2, p_tab_name in varchar2,

16

p_tab_type in varchar2, p_next_extent in number default 512, p_pct_free in number default 10, p_pct_used in number default 70); procedure register_column (p_appl_short_name in varchar2, p_tab_name in varchar2, p_col_name in varchar2, p_col_seq in number, p_col_type in varchar2, p_col_width in number, p_nullable in varchar2, p_translate in varchar2, p_precision in number default null, p_scale in number default null); procedure delete_table (p_appl_short_name in varchar2, p_tab_name in varchar2); procedure delete_column (p_appl_short_name in varchar2, p_tab_name in varchar2, p_col_name in varchar2);

Ví dụ về sử dụng package AD_DD để đăng kí 1 bảng flexfield và các cột của nó : EXECUTE ad_dd.register_table(‟FND‟, ‟CUST_FLEX_TEST‟, ‟T‟, 8, 10, 90); EXECUTE ad_dd.register_column(‟FND‟, ‟CUST_FLEX_TEST‟, ‟APPLICATION_ID‟, 1, ‟NUMBER‟, 38, ‟N‟, ‟N‟);

Tổng quan về việc sử dụng PL/SQL trong các ứng dụng : 

Bạn có thể sử dụng các thủ tục PL/SQL như một phần của ứng dụng bạn xây dựng nằm trong Oracle Applications. Bằng cách tuân theo các chuẩn lập trình, bạn có thể tạo ra 1 thủ tục PL/SQL tích hợp hoàn toàn với ứng dụng.



Bạn có thể sử dụng PL/SQL viết các đoạn mã mở rộng có tính thủ tục để custom form và report. PL/SQL cũng giúp module hoá form code của bạn, hoặc phát triển các chương trình chạy đồng thời ( concurrent program ).

Thuật ngữ : 

Server-side : chỉ các thủ tục lưu trên cơ sở dữ liệu Oracle .



Client-side : chỉ các thủ tục chạy trong các chương trình là client của CSDL Oracle.

17

Các chuẩn chung trong lập trình PL/SQL : 

Luôn sử dụng package : định nghĩa các thủ tục PL/SQL trong package



Kích thước package : mã nguồn của 1 đơn vị chương trình ( 1 package ) client-side không được vượt quá 10K, và tổng kích thước source code và compiled code phải nhỏ hơn 64K. Nếu 1 đơn vị chương trình quá lớn, có thể chia ra thành các đơn vị con được liên kết với nhau. Server-side package không bị giới hạn về kích thước.



Thêm các thủ tục mới vào các package đã tồn tại : thêm vào cuối của mỗi package. Nếu thêm vào giữa package ( specification hay body ), phải dịch lại các form có tham chiếu đến package, nếu không sẽ bị lỗi.



Sử dụng tên trường trong các client-side package : luôn dùng tên trường đầy đủ ( BLOCK_NAME.FIELD_NAME ) để khoanh vùng tìm kiếm ( chỉ tìm trong block đó ), và tránh trường hợp xung đột khi có 2 trường trùng tên.



Tên trường trong các tham số của thủ tục : không dùng kiểu tham số OUT hoặc IN OUT vì có thể làm thay đổi các giá trị của trường truyền vào khi kết thúc thủ tục. Với danh sách tham số quá dài, sử dụng “ => “ để truyền đúng tham số.



Sử dụng DEFAULT : sử dụng DEFAULT để khởi tạo giá trị mặc định cho tham số thay vì “:=”, để cho giá trị truyền vào có thể ghi đè lên giá trị mặc định. Ngược lại, với hằng, sử dụng “:=” để giá trị không thể bị ghi đè lên.



Sử dụng ID của object : các đoạn code thay đổi nhiều thuộc tính của 1 đối tượng bằng SET_