【转】Form_Form Builder国际化多语言开发(案例)

一、摘要

Oracle EBS系统是一个多语言的系统,能够实现不同语言环境登录显示不同的语言信息,系统中多语言涉及到两个主要的方面:

  1. 界面的多语言
    任何给用户看到的地方,都需要实现多语言来满足不同国家和地区的使用。界面的多语言使得不同的语言环境看到不同语言的界面

  2. 基础数据的多语言
    很多用户看到的数据都是通过基础设置而来的,因此不但需要实现界面的多语言,还需要实现基础数据也多语言化。数据的多语言使得不同的语言环境看到不同语言的数据

二、功能预览

  1. 当以英文环境登录系统时
    (1).界面多语言:可以查询出如上图的数据,我们注意看 User Form Name 和 Description 两个列。
    (2).数据多语言:可以看到其中的数据都是英文定义的,如第一行叫FNDADDSQ的Form,User Form Name 为Register Sequence

在这里插入图片描述

  1. 当以中文环境登录系统时
    (1).界面多语言:可以查询出如上图的数据,我们注意看 用户表单名和说明两个列。
    (2).数据多语言:可以看到其中的数据都是中文定义的,如第一行叫FNDADDSQ的表单,用户表单名为:注册序列
    在这里插入图片描述

三、数据分类

  1. 定义
    要弄清楚数据多语言转换,需要先将数据进行分类,由于要实现多语言转换的对象是:数据。
    这就意味着可能多语言的量会比较大,就拿上面我们定义表单的例子来说,里面包括了字段:表单、应用、用户表单名和说明总共4个字段,哪些字段需要实现多语言转换,即哪些数据需要不同的环境下看到不同语言的表现?
    因此数据会分为3类:
    (1). 用户编码/代码基础数据类:为了知道多语言之后,我们所说的是同一个东西,我们需要一个用户能够识别的代码,不管它在什么语言环境下,都是一样的。如:表单FNDADDSQ
    (2). 非多语言类:这类信息不要求不同的语言环境下显示不同的信息
    (3). 多语言类:这类信息要求不同的语言环境显示不同的信息,如上面的应用、用户表单名和说明,这就是我们需要多语言转换的地方

  2. 实现步骤
    (1). 开发一个具备数据多语言转换定义的界面,如上面的表单定义窗口
    (2). 进入多语言数据界面,录入多语言数据
    (3). 进入不同的语言环境,显示不同的语言数据

  3. 多语言转换定义的界面
    如何去开发一个具备多语言转换定义的界面我们后面在描述,我们先来看看如何使用一个多语言转换定义的界面。
    当录入一条数据的时候,通过工具栏中的一个小地球仪的图标来定义多语言信息,当表单中实现了数据多语言功能后,光标进入相应的数据块,小地球仪就会亮起,否则失效
    在这里插入图片描述
    点击小地球仪,会弹出数据多语言转换窗口,如下图,注意看转换窗口的行和列:
    (1). 行(Row):Oracle EBS系统安装了多少个语言,这个转换窗口就会显示出多少行,如我的环境安装了中文和英文,所以有两行
    (2). 列(Column):这个例子中有两列,分别是用户表单名和说明,这个说明开发表单时候设置的有哪些列是可以进行多语言转换的,因此理论上面可以有无限个列

  4. 多语言显示
    如定义FNDADDSQ表单的时候,点击小地球仪之后显示如下的多语言转换界面:
    (1). 第一行是英文对应的用户表单名和说明
    (2). 第二行是中文对应的用户表单名和说明
    在这里插入图片描述

四、多语言转换表

Oracle Erp中如果需要实现数据多语言的转换功能,对应的后台表结构的设计有一定的规则 ,包括的数据库对象:两张基表加一张视图

  1. 多语言表的实现
    (1). 基本信息表:存储基本信息的基础记录,包括信息的主键
    (2). 多语言表:命名以 _TL结尾,存储基础记录对应的多语言信息,包括主键、需要多语言转换的列和语言代码列LANGUAGE
    (3). 多语言视图:命名以 _VL结尾,根据语音环境取出基于语言的信息,包括主键和语言信息

  2. 多语言表结构逻辑关系
    在这里插入图片描述
    所以根据上面数据库对象的命名 规则,只要在Oracle EBS的数据库系统中看到_TL, _VL对象出现的时候,它肯定是实现了多语言数据转换功能。
    多语言视图同时连接基本信息表和多语言表,并限制多语言表中的语言字段等于环境变量中取得的语言代码,从而达到多语言视图取出的数据是当前语言环境下的信息。

五、多语言转换示例

  1. 表单基本信息表
SQL> desc fnd_form;
Name               Type         Nullable Default Comments
—————— ———— ——– ——- ——–
APPLICATION_ID     NUMBER                                
FORM_ID            NUMBER                                
FORM_NAME          VARCHAR2(30)                          
LAST_UPDATE_DATE   DATE                                  
LAST_UPDATED_BY    NUMBER(15)                            
CREATION_DATE      DATE                                  
CREATED_BY         NUMBER(15)                            
LAST_UPDATE_LOGIN  NUMBER(15)                            
AUDIT_ENABLED_FLAG VARCHAR2(1)
  1. 表单多语言转换表,包括多语言的两列:user_form_name, description
SQL> desc fnd_form_tl;
Name              Type          Nullable Default Comments
—————– ————- ——– ——- ——–
APPLICATION_ID    NUMBER                                 
FORM_ID           NUMBER                                 
LANGUAGE          VARCHAR2(30)                           
USER_FORM_NAME    VARCHAR2(80)                           
CREATED_BY        NUMBER(15)                             
CREATION_DATE     DATE                                   
LAST_UPDATED_BY   NUMBER(15)                             
LAST_UPDATE_DATE  DATE                                   
LAST_UPDATE_LOGIN NUMBER(15)    Y                        
DESCRIPTION       VARCHAR2(240) Y                        
SOURCE_LANG       VARCHAR2(4)
  1. 表单多语言视图
SQL> desc fnd_form_vl;
Name               Type          Nullable Default Comments
—————— ————- ——– ——- ——–
ROW_ID             ROWID         Y                        
APPLICATION_ID     NUMBER                                 
FORM_ID            NUMBER                                 
FORM_NAME          VARCHAR2(30)                           
LAST_UPDATE_DATE   DATE                                   
LAST_UPDATED_BY    NUMBER(15)                             
CREATION_DATE      DATE                                   
CREATED_BY         NUMBER(15)                             
LAST_UPDATE_LOGIN  NUMBER(15)                             
AUDIT_ENABLED_FLAG VARCHAR2(1)                            
USER_FORM_NAME     VARCHAR2(80)                           
DESCRIPTION        VARCHAR2(240) Y
  1. 表单多语言视图声明定义
SELECT b.ROWID row_id,
       b.application_id,
       b.form_id,
       b.form_name,
       b.last_update_date,
       b.last_updated_by,
       b.creation_date,
       b.created_by,
       b.last_update_login,
       b.audit_enabled_flag,
       t.user_form_name,
       t.description
  FROM fnd_form_tl t, fnd_form b
WHERE b.application_id = t.application_id
   AND b.form_id = t.form_id
   AND t.LANGUAGE = userenv(‘LANG’); 

六、Form触发器

  1. 在需要使用多语言项所在的BLOCK内增加触发器:PRE-BLOCK
    触发器中添加如下的代码启用Translation按钮:
    app_special.enable(‘TRANSLATE’);

  2. 在需要进行多语言转换的所在的BLOCK内增加触发器:TRANSLATIONS
    加入如下PROCEDURE进行多语言字段的初始

FND_MULTILINGUAL.EDIT(‘FND_FORM’,
                     ‘FORM_ID, APPLICATION_ID’,
                     ‘USER_FORM_NAME, DESCRIPTION’,
                     ‘*FND:ML_USER_FORM_NAME, *FND:ML_DESCRIPTION’);
  1. 参数描述
    (1).FND_FORM:
    多语言数据块的名称
    (2).FORM_ID,APPLICATION_ID:
    多语言表的主键列,多个列用逗号(,)隔开
    (3).USER_FORM_NAME,DESCRIPTION:
    需要进行多语言转换的列
    (4).*FND:ML_USER_FORM_NAME, *FND:ML_DESCRIPTION:
    多语言转换窗口中每列对应的标题(如下图),为了实现它也多语言,因此这里是消息字典,*FND是消息字典对应的应用,ML_USER_FORM_NAME是消息的名称

  2. 而外增加如下触发器及代码
    4.1 Form Level
    (1).POST-FORMS-COMMIT
    fnd_multilingual.save;
    4.2 Block Level
    (1).POST-INSERT
    fnd_multilingual.key;
    (2).WHEN-CLEAR-BLOCK
    fnd_multilingual.free_block;
    (3).WHEN-REMOVE-RECORD
    fnd_multilingual.free_record;

七、Table Handler

当定义一条多语言的数据时,同时会往基本信息表和多语言表插入数据。

往基本信息插入一条数据,多语言表插入多条数据,系统安装了多少种语言环境,就会插入多少条。

因此对于多语言转换的插入语句的写法有一点特别的地方,为了处理的方便,一般都将增删改的操作写到数据库的存储过程中。

  1. 插入 - Insert
    在Form块的on-insert触发器中,要同时往基本信息表和多语言表(_TL)插入数据,因此insert的存储过程中需要根据Oracle EBS系统安装的语言来决定往多语言表中插入多少条记录。通过FND_LANGUAGES表来判断。
伪代码:
INSERT INTO FND_FORM;
INSERT INTO FND_FORM_TL
SELECT
FROM FND_LANGUAGES
WHERE 
INSTALLED_FLAG in (‘I’, ‘B’)
  1. 更新 - Update
    更新的时候需要同时更新基本信息表和多语言表;在on-lock触发器中,需要同时对基本信息表和多语言表锁定。
伪代码:
UPDATE FND_FORM
UPDATE FND_FORM_TL
WHERE userenv(‘LANG’) in (LANGUAGE, SOURCE_LANG)
  1. 删除 - Delete
    删除的时候也需要同时删除基本信息和多语言信息。
伪代码:
DELETE FND_FORM
DELETE FND_FORM_TL

代码请查看数据库包fnd_form_pkg

猜你喜欢

转载自blog.csdn.net/qingshimoon4/article/details/118094943