给你一个敲门砖之Discoverer.doc

Doc Ref: 深入浅出Oracle EBS 11i十一月 9, 2005深入浅出Oracle EBS 11iE-Business SuiteXX100 应用技术给你一个敲门砖之DiscovererAuthor:黄建华Jianhua.HuangCreation Date:October 16, 2005Last Updated:十一月 9, 2005Document Ref: Version:DRAFT 1ANote: Title, Subject, Last Updated Date, Reference Number, and Version are marked by a Word Bookmark so that they can be easily reproduced in the header and footer of documents. When you change any of these values, be careful not to accidentally delete the bookmark. You can make bookmarks visible by selecting Tools-OptionsView and checking the Bookmarks option in the Show region.Approvals:Note: To add additional approval lines, press Tab from the last cell in the table above. Copy Number_Note: You can delete any elements of this cover page that you do not need for your document. For example, Copy Number is only required if this is a controlled document and you need to track each copy that you distribute.Document ControlChange Record3DateAuthorVersionChange Reference16-Oct-05Jianhua.HuangDraft 1aNo Previous DocumentReviewersNamePositionDistributionCopy No.NameLocation1Library MasterProject Library2Project Manager34Note: The copy numbers referenced above should be written into the Copy Number space on the cover of each distributed copy. If the document is not controlled, you can delete this table, the Note To Holders, and the Copy Number label from the cover page.Note To Holders:If you receive an electronic copy of this document and print it out, please write your name on the equivalent of the cover page, for document control purposes.If you receive a hard copy of this document, please write your name on the front cover, for document control purposes.ContentsDocument Controlii1.Oracle Discoverer11.1.总体说明11.2.Discoverer概念层次11.3.必要设置11.4.先睹为快：一个简单例子. 管理员端配置21.5.先睹为快：一个简单例子. 桌面端做报表141.6.其他设置和功能浏览191.7.Item Class和条件的LOV271.8.Discoverer权限模型301.9.Discoverer发布331.10.其他有用的Topics372.Open and Closed Issues for this Deliverable41Open Issues41Closed Issues41Note: To update the table of contents, put the cursor anywhere in the table and press F9. To change the number of levels displayed, select the menu option InsertIndex and Tables, make sure the Table of Contents tab is active, and change the Number of Levels to a new value.Open and Closed Issues for this Deliverable 41给你一个敲门砖之DiscovererFile Ref: 07617243e9349b6e9be5f8cf20c9d498.pdf (v. DRAFT 1A )Company Confidential - For internal use only1. Oracle DiscovererNote:Note:Note:Note: 以Applmgr登录操作系统cd $APPL_TOP（Windows的变量格式为%APPL_TOP%）md scfmd 1.0.0md forms以Applmgr登录操作系统cd $APPL_TOP（Windows的变量格式为%APPL_TOP%）md scfmd 1.0.0md forms以Applmgr登录操作系统cd $APPL_TOP（Windows的变量格式为%APPL_TOP%）md scfmd 1.0.0md forms以Applmgr登录操作系统Create mockups of the forms using a graphic or design tool. You can use embedded objects as well as screen hardcopies.应用：任意职责：任意1.1. 总体说明Note: For each field, use the center and right tabs to enter additional information about the field.Include in the parenthesized list one or more of the following:OptionalRequiredDefaultDisplay OnlyList of Values (LOV) sourceOracle Discoverer最初是Oracle BIS的前端展现工具，现在越来越多的被用在ERP中。适用范围：对于那些非打印类型的报表或对打印格式要求不高的报表。实施人员：用Discoverer来做报表效率很高，写完SQL报表也就出来了，可以关注核心SQL，不操心布局。最终用户：不但可以将报表直接导出成Excel（进一步分析、作为数据源送给其它系统甚至反灌回ERP等等），而且还可以像在Excel里面一样自己调整报表（增加减少列、添加条件、增加汇总列等等），还可以直接在Discoverer里面做Drill Up/Drill Down分析。1.2. Discoverer概念层次从高到低是：EUL、BA、Folder、Item。EUL：End User Layer，是个容器；存储元数据，相当于数据字典；和DB由SYS拥有数据字典一样，EUL也必须由某个用户（Owner）拥有；不同的是每个数据库用户都可以创建一个EUL，只要数据库权限足够大。BA：Business Area，业务主题；一个EUL下可配置多个BA，比如PO主题、GL主题等。Folder：就是表或者视图，当然也可以是一段SQL，一个BA下可配置多个Folder。Item：就是字段；一个Folder下可配置多个Item。上面这4个在Discoverer Administration里面设置。Discoverer Plus里面做的就是报表，不过不叫Report，而是借用Excel的名字：Workbook，还分Sheet。1.3. 必要设置其实没有必要设置。不用Web Discoverer的话，客户端安装完毕，配好tnsnames就可以用了。不过我们是基于EBS的，所以有些地方略有不同。程序安装Discoverer（4.1.37）目前还不支持Multi-Home安装，所以安装的时候需要在Default Home，其他Home不行。如果先装6i，后装Discoverer，需要备份bin目录下的UIW60.DLL，装完之后把UIW60.DLL拷贝回来；否则Form Builder起不来，需要重新安装或从别人那里拷贝UIW60.DLL。管理员工具和客户端安装分Discoverer Administration和Discoverer Plus。实施人员两个都装，最终用户仅装Discoverer Plus；比较消耗客户端资源。Web版的Discoverer Plus叫Discoverer Viewer，不用装客户端，用IE就可以了，不过比较消耗服务器资源。配置tnsnames按照往常步骤配置tnsnames和hosts。如果是功能顾问，再看一下补充内容：通常从别人那里把tnsnames拷贝过来就可以，不过有时候不行；道理很简单，tnsnames.ora和sqlnet.ora两个加起来才构成SQL*Net协议的基本配置文件，而不同公司的sqlnet.ora可能会不一样；所以把这两个文件全部拷贝过来就99.99%不会有问题了。打个补丁Note:25197前要以application身份登录，需要安装Patch，其实就一个登录验证文件fndpu115.dll，拷贝到DISCVR4目录下；否则报Failed to connect to Database - ORA-01017: invalid username/password:logon denied。1.4. 先睹为快：一个简单例子. 管理员端配置以查看系统PO Document Type为例，先用APPS登录数据库，创建一个View：CREATE OR REPLACE VIEW scf_po_document_types_vv ASSELECT * FROM po_document_types开始N: Discoverer Administration先Cancel。设置登录方式N: Discoverer Administration/Tools/Opion忽略这个警告。出来：选择Connect to both standard and applications。意思是登录的时候可以选择用数据库用户登录或者用EBS用户登录。Gateway User ID和Foundation Name放空。再来登录N: Discoverer Administration/File/Connect最好用system登录，这样可以创建新用户。下面的Oracle Applications User不选。点击Connect之后出来：就是说system这个用户目前自己没有EUL，也没有人授权EUL给它，所以系统提示没法使用Discoverer，除非创建新的EUL。选择“是”。开始创建EULN: 选择“Create an EUL”。创建EUL 01N: 这个画面最关键。首先要选择Create a new user，因为我们通常希望有一个“干净”的用户作为EUL的Owner，不希望用某个应用数据库用户如PO或者APPS，更不希望用System。其次选择New EUL is for used by Oracle Applications users 。然后是输入新用户和密码，假定都是disadmin。Next。创建EUL 02N: 选择包含EBS的用户，当然是APPS了。这个其实可理解为默认的Scheme，这样在创建自定义的Folder时可不需要给表或者视图加apps前缀。输入密码，Next。创建EUL 03N: 这个地方选择新建用户的表空间。11.5.10版之后，Oracle不再为每个应用设立独立的表空间了，数据统一放在APPS_TS_TX_DATA下。简单起见我们也遵循这个标准：Default Tablespace选择APPS_TS_TX_DATA，Temporary Tablespace选择TEMP。实际中最好先新建一个表空间，专门给Discoverer用。Finish，开始创建用户和EUL。创建EUL 04N: 创建完有兴趣的话可以去看看Disadmin这个用户，它下面有很多EUL4开头的对象。确定之后出来：意思是要不要安装一个学习用的演示数据。我们选择“否”。出来：前面是用system登录，这里问要不要换成EUL的Owner也就是刚才新建的disadmin登录。选择“是”系统自动帮我们登录。注意这个disadmin是数据库用户！转折点 1N: 我们不用disadmin这个用户创建BA，我们仅用它来装EUL就行了。这里选择“Cancel”。第一级授权：EUL授权N: Discoverer Administration/Tools/Privileges我们规划一个EBS用户，以后专门用来维护Discoverer，也可以用它来创建Discoverer报表。假定是Huajhua，我们授予它全部权限，就是Privilege里面全部打勾。注意这个Huajhua是Application用户。转折点 2 : 切换用户N: Discoverer Administration/File/Connect用上面的Huajhua登录，并且选择用Application方式：如果前面的补丁没打，则出现如下错误：没错的话，出来职责选择画面：我们选择Purchasing Super User创建BA 01N: Discoverer Administration/File/New正常登录后显示：点击Create a new business areaNext创建BA 02N: 选择数据源DBLink和用户如图，选择APPSNext创建BA 03N: 选择表我们选择上面建的视图：scf_po_document_types_vvNext创建BA 04N: 一些对将要生成的Folder的设置，唯一需要注意的是Default aggregate on一般改为Detail（默认是Sum），理由很简单，我们做的View基本上就是最终要的数据了，不需要在Discoverer中做集合运算了，要做我们在View里面就做掉了。Next创建BA 05N: 起个名字：PO Business AreaFinish系统开始创建BA完成之后，可以查看创建的BA1.5. 先睹为快：一个简单例子. 桌面端做报表开始N: Discoverer Plus同样第一次先Cancel。设置登录方式N: Discoverer Plus/Tools/Opion选择Connect to both standard and applications。意思是登录的时候可以选择用数据库用户登录或者用EBS用户登录。Gateway User ID和Foundation Name放空。再来登录N: Discoverer Plus/File/Connect没错的话，出来职责选择画面：我们选择Purchasing Super User创建Workbook 01N: Discoverer Plus/File/NewDiscoverer支持两种类型的报表：Table和Cosstab以及它们的简单扩展。我们选择Table，Next。创建Workbook 02N: 选择字段，因为只有一个，默认已经选中我们前面建的PO Business Area。我们随便选择几个Item。简单起见，我们直接Finish。创建Workbook 03N: 下面就是结果：至此一个简单的Discoverer报表就出来了。创建Workbook 04N: Discoverer Plus/File/SaveWorkbook可以保存成本地的一个文件，也可以保存到数据库。通常我们选择保存到数据库，这样通过授权之后其他用户就可以打开该报表。保存到本地主要是用来备份和发布。我们先选择My Computer，然后点Save起个名字PO Document Types.DIS。之后我们在通过菜单Save as到Database：为维护方便，我们保持名字和本地的文件名一样，仅仅去掉DIS后缀。接下来就是细节的功能调整了，除了美化之外就是看用户需求了！1.6. 其他设置和功能浏览日常开发创建EUL基本都是做一次，即一个系统通常建一个EUL创建BA通常也是做一次，即一个EUL下建一个BAFolder根据需要做，通常一个报表对应一个FolderWorkbook根据需要做所以Discoverer配置好之后的开发流程：需要调研，创建数据库V，创建Folder，创建Workbook，ShareWorkbook新增一个字段N: Admin/File/Refresh比如客户要求在报表中新增一个字段，而这个字段我们在创建View的时候并没有包含。首先当然是更新数据库脚本，把视图改好；接下来在Discoverer Admin中，选中要改的Folder，通过N: Admin/File/Refresh刷新即可。Plus端重新Connect就可以看到新增的字段了。Sheet菜单N: Plus/Sheet/和Excel一样，一个Workbook可以有多个Sheet，每个Sheet都可以看作是一个报表，我们可以把相关性比较强、类似或者需要做对比的报表放在同一个Workbook里面。通过Sheet菜单，可以New一个Sheet，也可以重新运行向导Edit当前的Sheet，也可以Copy一个Sheet。通过Edit Title菜单，我们可以给生硬的Discoverer报表加一个合适的表头，可以设置格式，还可以插入日期、页数等。默认情况下，报表仅显示100行，和PL/SQL Developer类似，可以选择查看下一批或者全部记录。前者通过报表最后一行的按钮来实现，后者就是通过这里的Retrieve All Rows。另外，Count All Rows就是算出记录数，和Forms上的F12类似。Page ItemN: Plus/View/Page ItemsPage Items相当于Excel中的筛选，当然这里的功能要弱一些。如图，我们把Document Type Code这一列拉到Pate Items区域，就可以过滤了，如选择PO那么下面仅显示PO类型的记录。FormatN: Plus/Formt/可以对Tile、Heading、Data分别设置显示格式如字体字号、对齐、小数位等，全部可以通过菜单Format完成。也可以在列上通过右键来设置。这里还可以设置Sheet的背景图片。特别是可以设置Exception显示格式，如我们假定类型为PO时用红色显示：计算列N: Plus/Tools/Calculations和Reports中的计算列类似，增加一列，值等于某个公式算出来，比如=Item1 + Item2。排序和分组N: Plus/Tools/Sort可以对结果进行排序，可按任何列任意顺序排。在排序的同时还可以指定是否分组、每个分组之间的间隔是多少、用多粗的线条隔开。汇总列N: Plus/Tools/Totals可以对某一列进行求和、计数、求平均等；而且可以分组计算。如下图对Org Id进行计数。百分比列N: Plus/Tools/Percentages可以对某一列进行求百分比，基数可以是某一分组，也可以是全部记录。条件N: Plus/Tools/Parameter和N: Plus/Tools/Conditions都可以为报表的某个字段建立参数。生成Excel等文件N: Plus/File/ExportWorkbook可以导出成很多格式的文件：生成图表N: Plus/Graph/New Graph选一个，Next后有更多的选项。看怎么弄怎么好看了，最终样例如下：Drill in/Drill outN: Discoverer是个BIS前端展现工具，所以支持BIS基本的上钻下钻分析方法。上钻下钻分析的前提是建立数据的层次结构（Hierarchy），比如最容易理解的就是日期：年包含季度，季度包含月份，月份包含日。Discoverer中的Hierarchy在Admin中维护，系统已经有默认的日期层次模型，所以对于日期字段，创建Folder的时候会让我们选择是否使用默认的层次模型，通常就是Yes了，所以观察我们的Folder，每个日期字段都会比我们的视图多4字段，如XXXX Year、XXXXX Quarter、XXXX Month、XXXX Day。假定我们的Workbook中用了一个XXXX Quarter字段：现在可以看到，字段的Heading上有个箭头，表示可以“钻” 了。右键选择Drill：可以看到，可以选择上钻到Year，或者下钻到月等，我们选择Year：就会看到年的数据，注意这里的01-Jan是没有意义的。配合Page Item，还可以有更丰富的分析。HierarchiesN: Admin可以使用默认的日期层次结构：Year/Quarter/Month/DayCrosstabN: Discoverer支持矩阵报表。其他Folder间的连接基于SQL的Folder查看Sheet的最终SQL和执行PlanSchedule一个Discoverer报表删除EUL/BA/Folder1.7. Item Class和条件的LOVAdmin端设置N: Admin/Item Class Tab页/Right Click/New Item Class前面的参数只能自己输入，用户无法选择，也就是没有LOV。这个要通过Item Class来实现。出来：默认，Next：选择LOV数据的来源列，也就是说系统要从这个Folder基于的View中选择该列的Distinct值作为LOV。所以，虽然这里可以选择本Folder的列，如果碰到特别复杂或者需要较长运行时间的View，就要考虑新建一个小View，然后要它来做Folder；这样在这里就可以选择这个“小”Folder的列作为LOV数据的来源列。Next: 这里选择要使用该Item Class的字段，我们仍然选Document Type Code，注意可以选其他的。Next：起个名字后Finish：Plus端设置N: Plus/Tools/Parameter注：首先要通过File菜单重新Connect以获得Admin端的变化。如图简单设置即可。OK后出来条件：1.8. Discoverer权限模型这是Discoverer EUL的权限，和数据库权限以及EBS系统权限是两码事。可以对一个EBS用户授权，也可以对一个职责授权，看实际需要；不过，和Oracle的并发请求一样，实际实施中我们通常也是给职责授权。从高到低是EUL、BA、Workbook。所以简单来说，要让一个最终用户看到我们做的报表，就要牢记在心：这3个东西都要授权。EUL授权N: Admin/Tools/Privileges如果EUL没有授权，用户就选不到我们的EUL，后面的事就免谈。这个很关键，决定了用户的操作权限：是否可以修改报表、是否可以创建BA等等都在这里统一控制。上面的例子我们把EUL的全部授权给HUAJHUA，因为准备用它来开发。这里我们给Purchasing Super User这个职责授予Discoverer Plus的所有权限。BA授权N: Admin/Tools/Security。如果没有授权BA，用户打开报表就会报找不到Item。上面的例子之所以没有问题是因为Huajhua自己创建自己看。BA授权有两种方式：BA到User和Users到BA，结果一样，看哪个操作方便了。这里我们通过BA到Users方式把PO Business Area授权给Purchasing Super User这个职责。所以以后具有这个职责的用户都有了该BA的权限。每个BA都要这样授权。Workbook授权N: Desktop/File/Manage Workbook/Share如果没有授权Workbook（系统里面其实叫共享）用户就看不到报表。同样，上面的例子之所以没有问题是因为Huajhua自己创建自己看。同样有两种方式。这里我们把刚才做的报表授权给Purchasing Super User这个职责。每个报表都要这样授权，就像我们把请求挂到请求组一样。至此，任何用Purchasing Super User这个职责登录的用户都可以运行上面这个报表了。1.9. Discoverer发布就像在测试环境中做好Oracle Forms之后要挂到Production环境一样，Discoverer报表在测试环境做完也要挂到Production环境。Discoverer发布包括2个方面：EUL发布（严格讲是BA发布）和Workbook发布。注意导入导出也要用Application登录方式。EUL发布.导出N: Admin/File/Export （先要选中要发布的BA）在源系统比如测试开发系统中执行导出：统一起见，选择和BA一样的名字作为导出文件的名字。点保存，系统将执行导出：EUL发布.导入N: Admin/File/Import 首先要在目标系统按照前面例子中的步骤先建好EUL，其次要把数据库脚本（主要就是BA中Folder基于的View的脚本）更新到目标系统。然后我们登录到目标系统比如Production环境，然后执行导入：我们点击Add，选择从源系统导出的文件。打开，Next：基本不用改，按默认即可，Next：点击Start，系统开始导入：如果目标系统没有同名BA，一般都没有问题，Finish即可。如果有问题，首先检查视图脚本确实执行了，然后看看现在的EUL里面是不是有同名的BA和Folder。BA导入导出一般适用于上线和新BA。对于增量更新（比如若干时间后在原来的BA中新增一个Folder），则可以采取直接在Production环境中手工创建Folder。如果仅仅是增减字段，也可以通过Refresh Folder的方法来处理。Workbook发布发布就比较简单，从源系统的数据库打开最新的Workbook，一一另存到本地。然后登录目标系统，从本地打开Workbook，一一另存到数据库，再一一Share给需要的职责。如果有问题，请检查上面的权限设置、检查BA是否更新过来了、进一步检查BA是否有问题（比如少字段）、进一步检查Folder基于的View是否正确更新了。Workbook可以通过命令行导出，但我用下来速度很慢，只好一个个手工发布了。1.10. 其他有用的Topics缓存和重新连接Discoverer采用缓存技术，只要登录了，那么其他人在Discoverer中的改动几乎都不会影响当前操作；只有重新连接（File/Connect）了，才能反映出来。多EUL问题和选不到BA或者Workbook一个数据库可以有很多个EUL，这个好理解，因为每个权限足够大的数据库用户都可以拥有一个EUL。然而伴随多个EUL的问题也就来了：EUL授权了、BA授权了，为什么在Plus端做报表选不到BA？或者，3级授权我都做好了，为什么他登录上去看的内容和我不一样，他为什么选不到BA也打不开报表？首先当然要确定一下是否用同一种登录方式（比如都用Application用户）登录，剩下的问题就是多EUL的问题。其实很简单，因为任何一个用户登录Discoverer之后，他只能操作一个EUL的东西。那么如果我们建立了多个EUL（因为测试用或者因为没有沟通好），并且都授权给了某一用户，比如上面的huajhua或者SYSADMIN，那么我用huajhua登录Discoverer之后到底起作用的或者说默认的EUL是哪一个呢？这个就要通过系统选项设定。先登录，然后N: Tools/Option/EUL Tab页（Admin和Plus一样）选择想要的EUL，然后重新Connect。字符集Discover会把NLS语言信息写在dis文件中（可以用二进制编辑软件打开查看），在不同的语言环境间发布报表会出现乱码。如果在注册表中把nls_name设为zhs16gbk，然后再开发report，可以同时满足简体和繁体的要求。Format MaskWorkbook数字用Numeric格式显示有问题，需要改用Customize格式。开始以为是因为字符集为UTF8，其实不是。原因是Admin端的Format Mask默认是错的！N: Admin/选择某个数字类型的Item，右键，属性：可以看到，这里的Format Mask太糟糕了！要改为999999999999999999990D99！不过可惜，客户端的报表不会自动更新成正确的，要么重新创建Workbook，要么删除数字列，保存，重新Connect，增加数字列。Folder间的连接Folder就如表或者视图，它们之间同样可以建立各种连接关系，这个在Admin中定义。Workbook如果使用多个Folder的Item，Discoverer会用我们的定义自动建立关系，如果没有定义连接关系，Discoverer将使用迪卡尔积。最终SQL结果可以通过Plus的菜单View/SQL Inspector查看。然而，通常我们都是一个Folder对应一个数据库View（可能很复杂），一个Workbook对应一个Folder，不希望使用Folder间的连接。原因如下：一对一，这样维护方便，可以放心的修改一个Folder报表的字段都在一个Folder中，如果用户要自己做点小调整也比较方便Discoverer的性能本来就不高，我们希望由我们自己控制连接条件自定义Function注册Function的时候，Function Name需要大写，Packge Name也需要大写，不然它会报Invalid Function。EUL Owner需要的数据库权限上面我们采用System用户创建新用户的办法来创建EUL，这样系统自动给该新用户授予足够的权限。如果要用现有的用户创建EUL，比如让DBA建个用户给我们用，那么需要给用户授予如下权限，不然会报“不能给自己Grant或Revoke权限”：SELECT * FROM dba_sys_privs WHERE grantee = DISADMINDISADMINALTER ANY SNAPSHOTNODISADMINANALYZE ANYNODISADMINCREATE ANY SNAPSHOTNODISADMINCREATE PROCEDURENODISADMINCREATE TABLENODISADMINCREATE TYPENODISADMINCREATE VIEWNODISADMINDROP ANY SNAPSHOTNODISADMINENQUEUE ANY QUEUENODISADMINEXECUTE ANY INDEXTYPENODISADMINEXECUTE ANY LIBRARYNODISADMINEXECUTE ANY OPERATORNODISADMINEXECUTE ANY PROCEDURENODISADMINEXECUTE ANY TYPENODISADMINEXTENDS ANY TYPENODISA