Oracle数据库2日学习之APEX开发指导.docx

Oracle APEX 开发指导北极熊 2015年16周Oracle APEX 开发指导Oracle 官方文档翻译 1 / 2Oracle APEX 开发指导绪言11Oracle Application Express安装综述21.1安装过程概述21.2从之前的Oracle Application Express版本升级21.3关于运行环境21.4关于选择Web监听器31.4.1关于 Oracle Application Express Listener和Oracle HTTP Server with mod_plsql31.4.2About the Embedded PL/SQL Gateway41.4.3Selecting a Web Listener in an Oracle RAC Environment41.5可用的安装场景41.5.1Downloading from OTN and Configuring the Oracle Application Express Listener：51.5.2Downloading from OTN and Configuring the Embedded PL/SQL Gateway51.5.3Downloading from OTN and Configuring Oracle HTTP Server62Oracle Application Express安装要求62.1Oracle Database 要求62.2Browser 要求62.3Web Listener 要求62.4Disk Space 要求62.5Oracle XML DB 要求62.6PL/SQL Web Toolkit6IIOracle APEX 开发指导绪言这篇指南描述如何建立一个开发环境,或访问托管演示环境。然后带您通过建立一个初始应用程序，修改，并预览1 介绍Oracle Application Express这一节描述Oracle Application Express，它的体系结构和使用的产品环境。也介绍了论述Oracle Application Express的概念和术语。1.1 安装过程概述Oracle Application Express是Oracle数据库看的快速Web应用开发工具。仅需要Web浏览器和 少量的程序开发经验，你能够快速安全的开发个人应用。大量的内建用户特性如：user interface themes, navigational controls, form handlers, and flexible reports，Oracle Application Express加速应用开发过程。1.2 了解Oracle Application Express体系结构Oracle Application Express安装在Oracle数据库中由数据表和PL/SQL代码组成。无论你是运行Oracle Application Express开发环境或是构建一个应用，处理都是相同的。浏览器发送URL请求翻译成相应的Oracle Application Express PL/SQL调用。在数据库处理了PL/SQL后，结果作为HTML返回给浏览器。这个循环发生在每次请求或提交页面时。应用的会话状态由Oracle Application Express 内部的数据库表管理。 它不使用转有数据库连接，替代的是，每个请求使用分离的数据库会话消耗最小的CPU资源。了解Web Listener选项为了运行，Oracle Application Express必须访问Oracle Application Express Listener, Oracle HTTP Server and mod_plsql,或the embedded PL/SQL gateway。关于Oracle HTTP Server (Apache)和Oracle Application Express ListenerOracle HTTP Server使用mod_plsql插件和Oracle数据库内部的Oracle Application Express引擎通讯。Oracle Application Express Listener 直接和Oracle Application Express引擎通讯。Oracle HTTP Server和Oracle Application Express Listener功能都是作为web server与数据库中的Oracle Application Express对象通讯时的中介。具体的来说，它们映射浏览器请求到数据库的存储过程调用通过Oracle Net Services连接。下面的图表体现了使用Oracle HTTP Server and mod_plsql时Oracle Application Express的体系结构。这个三层体系结构包含下列组件his three-tier architecture has the following components: A web browser Oracle HTTP Server (Apache) with mod_plsql or Oracle Application Express Listener An Oracle database containing Oracle Application Express使用Oracle HTTP Server (Apache) with mod_plsql或Oracle Application Express Listener优势包括： 从数据库中分离中间层 适应Oracle Real Application Clusters (Oracle RAC) 环境； 在Oracle Database 11g Release 1之前必须使用Oracle Application Express Listener或Oracle HTTP Server (Apache) with mod_plsqlEmbedded PL/SQL GatewayThe embedded PL/SQL gateway安装在Oracle数据库内，它提供了建立动态应用必须的Oracle数据库和Web服务器架构。The embedded PL/SQL gateway运行于数据库内的Oracle XMLDB Protocol Server包含了mod_plsql的核心特性。下面的图表说明了使用embedded PL/SQL gateway时Oracle Application Express的体系结构。这个两层的体系结构包含下列组件: A web browser An Oracle database containing the embedded PL/SQL gateway and Oracle Application Expressembedded PL/SQL gateway的优势: 简单的配置 包含在数据库内 不用分离的服务器安装关于Application Express EngineApplication Express engine实施和处理页面，它执行下列任务 Session state management Authentication services Authorization services Page flow control Validations processing1.3 关于Oracle Application Express EnvironmentOracle Application Express能够使单个Oracle数据库成为共享工作组数据库服务。多个用户能够使用Web浏览器访问它而不需要安装附加的软件。1.3.1 关于工作空间开发的应用在工作空间区域被调用。工作空间是一个虚拟私有的数据库，多个用户能够在同一Oracle Application Express安装内部工作，并保留他们的对象、数据和applications private。在典型的开发环境，你可以建立给所有开发者单个开发空间共享使用。然而，你也能建立专有的工作空间为特定的应用或对象。建立专有的工作空间限制仅有那些与工作空间关联的用户能够访问工作空间对象。下面图形展示了用户和开发者，工作空间和数据库schemas之间的关系。当建立工作空间时，将其与一个新的或已存在的schema关联。schema一个逻辑容器，它存放数据库对象，如：表，视图和存储过程。一个schema可以关联一个或多个工作空间。1.4 关于Oracle Application Express User Roles当在一个大型组织设置Application Express用户时，分别特定的角色和权限给指定的用户。Oracle Application Express包含以下内置角色： End users：应用用户，不具备任何访问开发和管理的能力； Developers：建立和编辑应用，改变数据库对象。开发者能拥有他们自己的工作空间或共享工作空间； Workspace administrators：是能够执行管理任务的开发者，如：管理用户账号，监视工作空间活动和查询日志文件； instance administrators：超级用户，管理整个实例。下面图形展示了多个用户和多种角色访问Oracle Application Express开发环境，Oracle Application Express管理服务和发布应用在这个指南中，你必须拥有3个角色： Instance Administrator, Workspace Administrator, and Developer。下面的图形展示了单个用户下的Oracle Application Express instance.1.5 构建应用概述在构建你的应用程序中，打开一个新的窗口，为虚构的AnyCo公司建立一个简单的人力资源应用。这个应用程序管理部门和员工信息，信息存储在建立的部门和员工表中。这个辅导显示了如何建立应用，改变并预览它。 2 访问Oracle Application Express开发环境这一节指南说明访问Oracle Application Express开发环境的步骤，使你和开发者能够开始使用Oracle Application Express构建应用程序。2.1 开始之前根据Oracle Application Express安装指南的描述安装Oracle Application Express。阅读Introducing Oracle Application Express确认你的web浏览器支持JavaScript和HTML 4.0 and Cascading Style Sheet (CSS) 1.0 standards。必须使用下列浏览器： Microsoft Internet Explorer 7.0 or later version Mozilla Firefox 14 or later version Google Chrome 21 or later version Apple Safari 5.0 or later version启用Web浏览器cookies确认你想使用的开发环境：Oracle提供一个托管演示环境当你试验Oracle Application Express时。使用演示环境能够最快速的访问开发环境。你从Oracle Application Express 站点请求一个工作空间并提供一些基本的用户信息。在你提交请求后，你将收到包含你登录验证的email。这种方式不用安装任何软件。装配你自己本地的Oracle Application Express。安装Oracle Application Express的步骤见Setting Up Your Own Local Environment2.2 访问托管演示环境在不安装本地产品情况下，使用托管演示环境并登录到工作空间。访问托管演示环境（过程很简单，不翻译了）1. 登录浏览器2. Click Sign Up.3. Click Get Started.4. On Welcome, review the information and click Next.5. Identify the administrator for the service. Enter a first name, last name, and valid email address and click Next.6. The system generates an email with your login credentials and sends it to the email address you enter.7. For Workspace, enter a workspace name.8. Workspace names must be unique. Requesting a duplicate name might delay your request. In general, enter a name that is significant to you. For example, enter your own name, your company name, or the name of the project or department to which your applications pertain.9. To use the same name for your workspace and your schema (defined in the next step) use alphabetic characters when naming your workspace. Schema names are restricted to alphabetic characters.10. Specify a schema. Options include:11. New Schema to Create - Enter a name containing only alphabetic characters.12. Initial Space Allocation - Select at least 10 MB to accommodate the space needed for creating the objects required for this guide.13. Click Next.14. A survey appears. Answer the survey questions and click Next. Indicate why you are requesting this service and click Next. A license agreement appears. Review the agreement, select I accept the terms, and click Next. Click Submit Request.An initial email containing a link is sent to you. Click the link within the email to complete the workspace provisioning process. This step verifies that your email address is valid before approving a workspace. After that, an email with your login credentials is sent to you. Use those credentials to log in to the hosted demo environment and begin using Oracle Application Express.2.2.1 登录到托管演示环境（不翻译，同上）sing the login credentials you received in an email, log in to your dedicated workspace on the hosted demo environment.To log in to the hosted demo environment: In a web browser, go to: On the Login page, enter your login credentials. Click Login.The Workspace home page appears. You may be prompted to change your password. If not, you can change it manually by clicking the Change Password link on the right side of the Workspace home page. Then, enter the information requested on the page that appears.2.3 安装本地环境相对于使用托管演示环境，你也能在本地安装Oracle Application Express。如果你使用本地安装，你必须安装你的开发环境，你必须执行下面步骤：安装Oracle Application Express看：“Oracle Application Express Installation Guide”登录Application Express Administration Services看：Logging In To Administration Services建立工作空间看：Creating a Workspace(可选)建立开发者或管理员权限的附加用户看：Creating Additional User Accounts注：这个指导说明提供简单的方式开始使用Oracle Application Express。然而，如果你想安装自己开发环境开发真实应用，回顾Oracle Application Express Administration Guide中的“Oracle Application Express Hosted Instance Administration。2.3.1 登录到管理服务对于配置本地开发环境，你必须登录到Oracle Application Express Administration Services。这个一个独立的应用用于管理整个Oracle Application Express instance。登录Oracle Application Express Administration Services:在浏览器中进入Oracle Application Express Administration Services 应用，它的位置取决于你的安装。Oracle Application Express以如下方法之一安装： 如果使用Oracle Application Express Listener安装，则：http:/hostname:port/apex/apex_adminhostname：安装Oracle Application Express Listener的系统名称port：分配给Oracle Application Express Listener的端口号。默认安装时为8080。更多信息看Oracle Application Listener Installation and Developer Guide.apex： Oracle Application Express Listener配置的服务名。参照文档： Oracle Application Express Listener documentation如果使用embedded PL/SQL gateway安装：http:/hostname:port/apex/apex_adminhostname：安装Oracle XML DB Protocol Server的系统名称port： Oracle XML DB Protocol Server分配的端口号。默认安装时为8080。apex：在配置文件中定义的database access descriptor (DAD) 。如用户从一个之前版本升级或是自定义配置，这个值可能是htmlb或其它。如果使用Oracle HTTP Server (Apache) with mod_plsql安装：http:/hostname:port/pls/apex/apex_adminhostname：安装Oracle HTTP Server的系统名称port：Oracle HTTP Server分配的端口号。默认安装为7777。你可以从下来文件之一找到这些信息ORACLE_BASEORACLE_HOMEinstallportlist.iniORACLE_BASEORACLE_HTTPSERVER_HOMEApacheApacheconfhttpd.conf需要了解，如果你改变了端口号它不会更新到portlist.ini文件。pls：指示使用mod_plsql cartridge。apex：在mod_plsql配置文件中的database access descriptor (DAD) 定义。如用户从一个之前版本升级或是自定义配置，这个值可能是htmlb或其它。在登录页面：Username：安装Oracle Application Express时的用户名Password：安装Oracle Application Express时指定的密码点击登录到Administration.Oracle Application Express Administration Services appears。2.3.2 建立工作空间从管理服务中建立工作空间。工作空间是Oracle内部的一个Oracle Application Express开发环境的共享工作区域，有着唯一的ID和名称。所有用户在工作空间内能够访问所有的应用和脚本。 登录到Oracle Application Express Administration Services.实例管理主页显示如下：点击Manage Workspaces在工作空间区域，点击建立工作空间显示建立工作空间向导输入工作空间属性：Workspace Name：输入唯一的空间名。这个指南使用2DayPlus作为空间名。通常工作空间名是对于自己有意义的，例如自己的名字，公司名字或是应用所属的部门或项目名。如果你想使用工作空间和schema一样的名字，那么仅能包含字母， Schema名被限制只能使用字母。Workspace ID：使用空白的工作空间ID将系统自动生成一个新的功过空间ID，工作空间ID必须是正整数且大于100000。Workspace Description：数据工作空间描述点击下一步输入schema属性：Re-use existing schema：选择No，如果建立第一个工作空间。 schema是数据库对象的逻辑容器。在这一步中你为后面的练习添加的数据库对象建立容器。Schema Name：输入schema 名。这个指南使用TWODAYPLUS。schema 名必须使用字母。Schema Password：输入大小写敏感的密码。Space Quota (MB)：为这个指南选择至少10 MB空间点击下一步输入管理员属性Administrator Username：同意默认的ADMIN，或是输入其它Oracle Application Express使用的用户名。Administrator Password：输入大小写敏感的密码。输入剩下的内容：包括一个有效的电子邮件地址并点击下一步。访问Oracle Application Express的登录验证将发送给你这里输入的电子邮件地址。如果你对Oracle Application Express进行了电子邮件的设置 点击下一步。校对你的选择并点击建立工作空间Create Workspace.点击执行。2.3.3 登录到你的本地实例要登录到本地Oracle Application Express，你必须了解这些信息：访问Oracle Application Express的URL你开发应用使用的Workspace名Oracle Application Express内工作空间配置的用户名Oracle Application Express内工作空间设置的用户密码如果你安装配置你的开发环境，你将有你的认证信息。其它联系账号创建者提供这些信息登录Oracle Application Express:在Web浏览器中，进入到Oracle Application Express登录页面，它的位置取决于你的安装。Oracle Application Express以如下方法之一安装：如果安装使用embedded PL/SQL gateway或 Oracle Application Express Listener:http:/hostname:port/apex如果安装使用Oracle HTTP Server (Apache) with mod_plsql:http:/hostname:port/pls/apex在登录页面输入你的认证信息2.4 建立附加的用户账号点击“管理工作空间”点击“管理开发者和用户”点击“建立用户”输入用户属性： 用户名：最长100字符，不包括空格，特殊字符仅允许和. 电子邮件地址： First Name Last Name 描述 默认日期格式输入账号权限 Workspace：从列表中选择工作空间 Default Schemas：指定data browsing, application creation, and SQL script execution的默认schema。当工作空间有多余一个schema可用时，这个schema是默认的，这个设置不是因为安全，仅是用户参照。 User is a workspace administrator：指定用户拥有工作空间管理员权限。管理员能够访问所有组件，能够管理用户账号，组和开发服务。如果实例管理员关闭，组件将不可用。 User is a developer：指定用户开发者权限。开发者必须访问Application Builder, SQL Workshop, or both。如果实例管理员关闭，组件将不可用。 Application Builder Access：决定开发者是否能访问Application Builder SQL Workshop Access：决定开发者是否能访问SQL Workshop Team Development Access ：决定开发者是否能访问Team Development Set Account Availability：选择锁定阻止账号使用，解锁与允许账号使用。输入密码： Password：密码大小写敏感 Confirm Password：再次输入密码 Require Change of Password On First Use：选择No允许用户使用相同密码，选择Yes用户在第一次登录时必须修改密码。3 开始使用Oracle Application Express本节介绍Oracle Application Express用户接口，同时也展示了如何安装示例对象。3.1 关于工作空间主页当你登录了Oracle Application Express后工作空间主页显示如下： Application Builder：使用Application Builder组装一个HTML界面(或应用程序)的数据库对象,如表和程序。SQL Workshop：使用SQL Workshop访问管理数据库对象Team Development：使用Team Development to track new features, nonfeature to-do tasks, bugs, and milestones. Users can also provide real-time feedback which then can be categorized into features, to-do tasks, or bugs.Administration： 链接到Workspace Administration page.3.2 什么是Application Builder使用Oracle Application Express的Application Builder组件构建应用，通过向导或是直接输入的方式，你能组装一个HTML界面(或应用程序)的数据库对象,如表和程序。每个应用程序是链接页面的集合使用标签、按钮、或超文本链接。一个页面是一个应用程序的基本构建块。页面也包含用户界面元素,比如标签列表按钮,项目,和区域。看到每个页面的定义属于你的应用程序中,您使用页面定义页面。页面定义包含3个主要区域： Page Rendering：列出了页面呈现时执行的用户界面和逻辑，页面处理从数据库中生成一个页面 Page Processing： 列出了逻辑控制 (例如： computations and processes) ，当页面处理时进行评估和控制。 Shared Components：列出当前页面组件，那些能被应用中其它页面参照的页面。3.3 安装示例对象在Oracle Application Express中，用户登录到工作空间，你能够认为每个工作空间作为一个共享区域来分离的的对象，数据和应用到一个虚拟的私有数据库。在指南中执行任何任务之前，你必须建立相应的示例对象。这些示例对象安装在2个schema中：Human Resources (HR)：HR schema包含员工和 他们工作的设备。每个员工有一个标识号，电子邮件地址，工作标识代码，薪水和管理者。员工分配到一个部门，并且每个部门完全的地址位置关联，包括街道名，邮政编码，城市，州或省，和国家编码Order Entry (OE)OE schema：公司产品目录和销售记录，包括产品标识号，产品名，关联产品分类，产品描述，重量组（为运输目的），保修期，供应商，可用状态和最低价格。3.3.1 下载OEHR示例对象从OTN上下载OEHR示例对象/technetwork/testcontent/oehr-sample-objects-131098.zip3.3.2 导入示例对象1. 导入示例对象登录到Oracle Application Express在工作空间主页，点击Application Builder点击import指定文件如下：For Specify File, specify the following:Import file：oehr_sample_objects_installer.sql文件File Type 选择Database Application, Page, or Component Export.File Character Set 选择正确的字符集点击下一步安装导入文件如下：在Database Application Wizard显示页面Parsing Schema：选择你配置开发环境时的schemaBuild Status：选择运行并构建应用Install As Application：选择自动分配应用ID点击安装应用在安装应用后，必须安装支持对象为安装支持对象，选择Yes点击下一步校对你的选择后，点击安装在完成安装后，点击Home breadcrumb link at the top of the page.The Application Builder home page appears.2. 检查工作空间的存储空间如果安装时遇到问题，检查你工作空间的可用存储空间。3. 删除OEHR示例对象应用删除OEHR示例对象应用并卸载支持对象，完全移除所有相关对象和示例数据。登录Oracle Application Express在工作空间主页点击Application Builder点击OEHR示例对象图标在任务列表中，点击删除应用在删除页面选择Remove Application Definition and Deinstall Supporting Objects.点击卸载3.3.3 查看数据库对象在Oracle Application Express主页，点击SQL Workshop点击对象浏览，对象浏览窗口有2个窗格：Object Selection pane显示在对象浏览器页面左侧，根据选择类型列出了当前schema内数据库对象Detail pane：显示在对象浏览器页面右侧，显示选择对象的详细信息。下表显示了类型为表，并选中OEHR_EMPLOYEES对象的情况。4 构建你的应用在这个辅导中，你为一个虚构的AnyCo公司建立一个Human Resources 。这一节显示你如何构建应用，改变应用并预览应用，在整个开发过程的不同阶段。4.1 关于构建你的应用指导这个指南开发一个虚构的AnyCo公司的人力资源应用，这个应用能够查看和改变存储在OEHR_DEPARTMENTS和OEHR_EMPLOYEES表中员工信息。在构建这个应用过程中你将执行下列任务： Creating the Initial Application: 建立一个应用包括一个主页和几个基本的开发报表； Modifying the Departments Report: 扩展这个报表从其它表拉入数据； Using an Interactive Report: 运行并使用交换式报表； Adding an Employees Report and Form: 构建基于OEHR_EMPLOYEES 表的员工表单和报表 Editing the Employees Report: 添加计算域到员工报表； Adding a Link on the Home Page to the Employees Report: 在Home页添加一个链接； Adding a Department Column to the Employees Report: 修改员工报表使用户能够选择一个部门； Linking a Column Value to Another Page: 在部门报表添加一个链接使用户能够导航到员工报表； Adding a List of Values to the Employees Report: 添加一个报表区域显示部门详细信息； Adding Your Company Name: 添加公司名称显示到所有页面； Switching Themes to Change the User Interface:切换应用主题。4.2 建立初始应用这个练习使用建立应用向导建立两个页面和指定的基本应用功能。这一节建立页面包括：Home：应用运行时显示的第一个页面，包含一个指向部门报表的链接；Department：这个页面显示一个交互式的所有部门报表。有两种类型的报表interactive and classic，在建立应用，转换表单和建立报表区域是默认是交互式。当你想用户自定义排序，过滤器和编辑等功能是使用交互模式。如果限制这些功能选择传统模式。1. 登录到APEXhttp:/localhost:8088/apex2. 在工作空间主页，点击应用程序构建器-点击创建3. 在创建应用程序向导中选择数据库，点击下一步填写各选项Application 使用默认ID。系统为你创建工作空间提供了一个唯一ID；Name 输入名称Schema 选择包含这个练习对象的schema；Create Options 选择包含主页Select Include Home Page；User Interface 使用默认，桌面点击下一步：可以看到主页显示在顶层区域，你能够在添加页面区域为应用添加新的页面，此处为OEHR_DEPARTMENTS添加一个报表页面，在添加页面这节内指定下列选项：选择页面类型 选择报表选择从属页面 选择HOME(1)这个配置决定应用的层次页面源- 使用默认, 表表名- 选择OEHR_DEPARTMENTS.列表显示了应用关联schema的所有表实现- 选择默认，交互式点击添加页面，建立页面章节的页面列表反映了应用程序页面的层次。下一步改变默认页面名称OEHR_DEPARTMENTS到Departments点击链接OEHR_DEPARTMENTS，显示新的页面定义窗口在页面定义中，改变页面名称为Departments，点击应用在创建应用页面，点击下一步定义一些应用级设置对于共享组件，选择默认，NO，点击下一步在属性页面，做如下设置认证Scheme 使用默认，Application Express.Application Express是默认的Authentication Scheme。这个认证选项使你能控制用户访问到这个应用，使用Application Express 或其它类型认证Tabs - Select No Tabs.语言- 使用默认，English (en).表单用户语言偏向 使用默认，应用程序主语言日期格式- 点击箭头选择 12-JAN-04.日期时间格式- 点击箭头选择12-JAN-2004 1430.时间戳格式-点击箭头选择12-JAN-2004 1430.时间戳时区格式-点击箭头选择12-JAN-2004 1430.点击下一步显示所有可选主题选择一个主题Blue Builder (Theme 2)，点击下一步校验信息点击创建应用，完成创建。完成后应用显示如下应用建立完毕，下一步预览应用看应用如何呈现给最终用户4.2.1 预览应用运行应用以预览它。运行应用将呈现的版本既是最终用户所能看到的。对你创建的页面你能通过运行页面或整个应用查看它。当你运行页面或应用时，Application Express引擎动态的呈现到可见的HTML页面，基于存储在数据库中的数据。对于运行应用，点击图标运行应用对于运行指定页面，点击图标运行页面1. 在应用程序主页，点击运行应用2. 运行应用首先提示输入用户名和密码，接下来，输入你的工作空间的用户名和密码点击登录主页显示如下：因为你配置的层次结构，主页上有一个到部门报表的链接。这个主页的底部有开发工具栏，因为是在开发环境中运行的应用。这个开发工具栏提供了快速编辑当前页面的，创建页面，区域或页面控制，查看会话状态或进入和退出调试模式。3. 点击部门链接，页面显示如下：4.3 修改部门报表当你运行创建应用向导时，这个向导基于你做出的选择建立表单和报表。在后台，Application Express写一个查询从数据库中提取相应的数据。在这个练习中，你修改部门报表查询包含的信息，从OEHR_EMPLOYEES 表中选择员工号，管理者名字和位置添加到部门报表，管理者名字列替换管理者ID列，并且位置列替换位置ID列。修改部门报表：1. 在开发工具栏，点击编辑页面2页面2定义显示2. 在页面显示中，定位到区域3. 展开区域，定位到部门4. 右键点击部门选择编辑。注：也可以使用双击区域定义显示5. 滚动到源位置，替换源默认脚本如下：SELECT d.DEPARTMENT_ID, d.DEPARTMENT_NAME, (select count(*)from oehr_employees where department_id = d.department_id)