ORACLE标准附件开发总结

1、ORACLE标准附件开发总结Author:张宏哲Creation Date:Jun 25, 2015Last Updated:Jun 25, 2015Version:1.0 Document ControlChange Record3DateAuthorVersionChange ReferenceJun 25, 2015张宏哲1.0No Previous DocumentContentsDocument Controlii标准附件添加1标准附件功能1定义附件2客户化标准附件开发6附件复制功能实现6Open and Closed Issues for this Deliverable8Open

2、 Issues8Closed Issues8Document Control 3上海汉得信息技术有限公司Oracle Mobile配置手册Company Confidential - For internal use onlyOpen and Closed Issues for this Deliverable 9上海汉得信息技术有限公司Company Confidential - For internal use only标准附件添加标准附件功能Oracle为form提供了附件上传下载功能，通过点击功能栏中的附件按钮来调用。点击后弹出附件功能，用户可以在这里添加数据类型为长文本、短文本和文件

3、附件等，其中短文本为varchar2类型数据库字段，长文本为clob类型数据库字段，附件为用户上传的本地文件。如果我们需要为指定的form中的记录添加附件，只需要在应用开发员-附件中完成一定的配置工作即可。定义附件单据类别 单据类别是对附件的一个分类，界面如下。单据类别只是相当于人工的将附件分组，在将附件添加到记录中时，必须选择分组，而只有在存在多个Form针对同一记录存在附件时，可以用来进行权限控制。类别：输入任意一个名字即可默认数据类型：选择应用这个Category最常用的类型，比如文件有效日期：默认，不填即可应用产品：一般选择客户化应用分配：按钮 这里仅用于查看文档实体 文档实体即用于关

4、联附件的表在界面上添加的附件最后会挂在指定的文档实体中，一个文档实体可以由多个表单或功能来使用，多个位置公用一套附件记录。表：用于记录的表，用表名即可文档实体：用表名即可实体名称：附件界面显示的名称，应取有意义的名字提示：与实体名称相同即可应用：一般选择客户化应用附件功能 用于定义一处可以调用附件的表单功能。类型：附件定义在功能或表单上名称：功能或表单的名称用户名：选择功能或表单后会带出会话上下文字段：一般不需定义类别：指定该附加功能可以选择的类别类别：选择该附加功能，在用户上传附件时可以选择的之前定义的单据类别，如果多出用到同一文档实体，则可以用该类别来做权限控制。块：用于在上述表单或功能的

5、指定块上添加附件功能，当光标停留在指定block时，才能选择进入附件功能。块名：form中的block的名称方法：有仅查询和允许更改可选，用于控制该处block的权限安全等级：进一步限制安全性，可根据需要填写，也可不填。实体：实体：选择之前定义的文档实体显示方法：“基础实体选择主要实体，引用实体选择相关实体”这里参照销售订单标准功能选择的是主要实体。包括在指示符中：勾选视图含指示符：不勾选权限：这里可以控制附件是否可以增删改查查询、插入、更新、删除：可以选择始终、从不、条件为真、条件为假再根据下面的控制字段来控制当前附件的可用操作。字段：使用block.item运算符：根据需要填写值1：运算判

6、断值值2：使用between类操作符时使用这里有一个可能是BUG的情况，保存时会报出“只有一个块实体可以有插入、更新或删除权限”，但这并不是配置出错的原因，可以更改查询插入更新删除对应的下拉框，保存，再更改回需要的值，再保存，多次尝试后的某次中就可以保存上了。关键字：关联唯一记录的关联字段。关键字1：使用block.item关键字n：同上客户化标准附件开发附件复制功能实现在客户化开发时，可能会遇到这样的需求：在客户化表上要求可以添加附件，并且在某次数据操作时，调用API生成标准表数据，并将客户化表上的附件也生成在标准表上。这时我们可以将客户化表上的附件复制到新生成的标准功能数据中。以预评审订单

7、（客户化数据）生成标准采购订单为例，开发分以下步骤：1. 在客户化界面添加附件功能，定义方法如上。2. 上传附件后可以在fnd_attached_docs_form_vl表中查询到附件存储信息：3. fnd_attached_docs_form_vl表中的datatype_id用来区分附件类型，当附件为短文本（datatype_id = 1）时，需要从fnd_documents_short_text表中，根据media_id来获取短文本内容short_text。当附件为长文本（datatype_id = 2）时，需要从fnd_documents_long_text表中根据media_id来获取

8、长文本内容long_text。4. 调用fnd_attached_documents_pkg.insert_row，其中大部分参数为fnd_attached_docs_form_vl表中的内容，需要注意的参数为： a) x_rowid：返回值，须用变量接收。b) x_attached_document_id：传入值fnd_attached_documents_s.nextval。c) x_document_id：传空。d) x_entity_name传入销售订单对应的文档实体名称：'OE_ORDER_HEADERS'。e) x_column1：传空。f) x_pk1_value

9、：传入需要复制到的目标销售订单关键字。即oe_order_headers_all中的header_id（如需复制到其他位置，则关键字等字段根据目标文档实体来变化）。g) x_request_id：传空。h) x_program_application_id：传空。i) x_program_id：传空。j) x_program_update_date：传空。k) x_security_id：传空。l) x_storage_type：传空。m) x_media_id：需要用变量接收。5. 根据客户化表对应的datatype_id、函数返回的x_media_id和之前获取的长文本/短文本内容，重新生成长文本和短文本内容。经过以上步骤之后，就可以将客户化界面的附件内容，复制到标准的采购订单的指定订单上了。附件为上述示例的完整版。附件内容服务器存储相关存储方式及下载标准功能的附件信息存在表FND_ATTACHED_DOCS_FORM_VL中，通过其中的MEDIA_ID可以在FND_LOBS表中对应FILD_ID找到文件，用函数fnd_gfm.construct_download_url(fnd_web_config.gfm_agent, p_file_id)来获取下载地址。Open and Closed Is