tài liệu training

Tài liệu Training

Admin Provisioning

Công ty cổ phần công nghệ tài chính viễn thông FTL

Agenda

Demo framework Giới thiệu bộ tài liệu Giới thiệu framework Mô tả framework Nội dung Kết luận


Mục tiêu bộ tài liệu

Bộ tài liệu này cung cấp các nội dung cơ bản xoay quanh hệ thống ADMIN PROVISIONING của công ty FTL.

Bộ tài liệu này là tài liệu dùng để đào tạo các thành viên mới làm quen với framework ADMIN PROVISIONING. Đồng thời là tài liệu để các thành viên đã làm việc với framework tổng hợp lại kiến thức và tham khảo khi cần thiết


Bộ tài liệu bao gồm

FTL-TRAINING Tài liệu Admin Provisioning.doc – Trình bày các vấn đề cụ thể của framework: cơ sở, thành phần, sự hoạt động, hướng dẫn, triển khai…

FTL-TRAINING Slide đào tạo Admin Provisioning.ppt – Là tài liệu sử dụng để trình bày và là tài liệu cho cái nhìn tổng quan về framework.

Video hướng dẫn.


Giới thiệu framework

Framework Admin Provisioning là 1 framework dùng để xây dựng hệ thống quản trị và xử lý dữ liệu thông qua giao diện Applet.

Hỗ trợ gen form tự động. Hỗ trợ đa ngôn ngữ.


Mô tả framework

Framework bao gồm 2 phần chính: Applet & Servlet.

Applet chứa các file xử lý bên phía client. Servlet chứa các file xử lý bên server. Thông tin được đóng gói theo chuẩn DDTP (FTL)

và được truyền nhận qua giao thức HTTP. Chủ yếu sử dụng các hàm:

public String getString(String string) { return null;} public void setString(String string, String string1) { } public Vector getVector(String string) { return null;} public void setVector(String string, Vector vector) { }


Giới thiệu chức năng hệ thống:

Quản trị NSD, nhóm NSD. Đặt lịch truy cập cho từng NSD, nhóm NSD. Truất quyền truy cập của IP nào đó. Quản lí các chức năng. Phân quyền từng chức

năng có quyền tác động như thế nào. Ghi log các tác động, log các phiên giao dịch, log

các thay đổi CSDL. Đa giao diện, đa ngôn ngữ.


Các bước để dựng môi trường lập trình

Download project template về. Trỏ lại JDK của project lên 1.6.xx Config lại Connection, ResourceDir của project

trong file admin_server_config.dic.


Các bước xây dựng 1 module mới

Tối thiểu một module bắt buộc phải có 3 file .dic (file giao diện, file định nghĩa từ điển, file bean xử lý dữ liệu). Ngoài ra còn có thể thêm 2 file java để xử lý những “vấn đề” phức tạp mà trong những file .dic không thể thực hiện được.

Quy tắc đặt tên các file: Form + <tên module> (VD : FormAdmApp.dic, FormAdmApp.java). <tên module> + Bean (VD : AdmAppBean.dic, AdmAppBean.java). Form + <tên module> + <ngôn ngữ> (VD : FormAdmAppVN.dic

hoặc FormAdmAppEN.dic).



Qui tắc đặt tên package: com.ftl.template Vị trí các file:

\resource\com\ftl\template\form\FormAdmApp.dic \resource\com\ftl\template\form\FormAdmAppEN.dic \resource\com\ftl\template\form\FormAdmAppVN.dic \resource\com\ftl\template\bean\AdmAppBean.dic com.ftl.template.form.FormAdmApp.java com.ftl.template.bean.AdmAppBean.java

File FormAdmApp.java là file Extends JXFrame để có khả năng đọc file FormAdmApp.dic.

File AdmAppBean.java là file Extends AppDBProcessorBase



Để gọi hàm checkAccount( ) trên file AdmAppBean.java:

DDTP request = new DDTP(); request.setString("SUBSCRIBER",strSubsId); DDTP response =

getChannel().processRequest(“com.ftl.template.bean.AdmAppBean”,"checkAccount",request);


FormStructure

FormStructure (http://kb.ftl.vn/ftllib/FormStructure.txt) là file định nghĩa các node giao diện, các validation.

SingleList, MultipleList , Value Xuất phát từ node gốc “Root”. Có các node quan trọng:

Field: Khai báo các field, sẽ được lưu giá trị trong formData. Có validation.

Control: Khai báo các control, ko lưu giá trị. Layout: Để qui định giao diện của module.


FormStructure

Các field, control gồm các đối tượng giao diện: Text,Combo….

Validation hỗ trợ một số validation cơ bản: mandatory, compare, format, regex… và cho phép viết script.

Layout mô tả cách sắp xếp các đối tượng giao diện hiển thị lên form.

Mặc định framework sử dụng GridbagLayout. Kèm theo là các thuộc tính x,y,w,h,wx,wy….


BeanStructure

Class AppDBProcessorBase đọc các file bean dic để thực hiện các hàm bên server.

BeanStructure (http://kb.ftl.vn/ftllib/BeanStructure.txt) là file định nghĩa các node bean.Root

SingleListComboData

MultipleList Data=>QueryData

Query=>QueryInsert=>InsertList Update=>UpdateList Delete=>DeleteList Fetch=>FetchList


BeanStructure

STT Node Mô tả Lưu ý

1 ComboData Khai báo query dữ liệu của các combo Có cache cho các ComboData bằng cách định nghĩa CacheKey

2 Query Node query dữ liệu. Dữ liệu trả về là một Vector hai chiều

3 Insert Node insert dữ liệu.

4 Update Node update dữ liệu

5 Delete Xóa dữ liệu

6 Fetch Trả về một dòng dữ liệu


Form generation

Framework hỗ trợ một công cụ: generate form theo đúng định nghĩa từ database với các nút chức năng cơ bản: Thêm, sửa, xóa,sao chép.

Sử dụng gói thư viện ftl_form_generator_1_0.jar để gen ra các form, bean danh mục.

Sau khi sử dụng gói thư viện trên ta có 2 thư mục: form, bean bao gồm các file dic định nghĩa các form danh mục và 1 file PermisionData.sql để gán quyền cho các form.


Form generation

Sau khi gen form cần làm các việc sau: Cần phải chỉnh lại giao diện cho hợp lí hơn. Chỉnh sửa các file từ điển. Định dạng lại ngày tháng, trường ID… Định nghĩa lại các

Combo như các trường trạng thái. Chỉnh lại kích thước các cột của bảng. Chuyển thành ExternalList với các Combo có nhiều dự

liệu. Do đặc thù của một số chức năng danh mục có thể phức

tạp, tùy theo từng trường hợp phải viết riêng cho phù hợp. Những form có liên kết đến những bảng chứa nhiều dữ liệu

thì khi tạo gen form không chọn gen các bảng liên kết đến.

tài liệu training

Documents