完成时间: 15 分钟
目的: Microsoft SharePoint Server 中的业务数据目录功能公开业务线应用程序中的数据并将其合并到门户中。 若要将此数据合并到门户网站中,必须生成Microsoft Office SharePoint Server 可以使用的应用程序定义文件。
业务数据目录定义编辑器工具可用于Microsoft Office SharePoint Server 2007 SDK,可用于创建业务数据目录的应用程序定义文件。 此工具自动生成定义文件的 XML 文件,因此无需在 XML 编辑器中手动创建该文件。
要创建的 Microsoft Office SharePoint Server 应用程序的目的是:
使用基于员工名称的业务数据列表 Web 部件查询MS_SAMPLE_EMPLOYEE接口表中的员工。
通过 Microsoft Office SharePoint Server 在 MS_SAMPLE_EMPLOYEE 界面表上执行全文搜索。
对于上述每个要求,必须在业务数据目录定义编辑器工具中完成一组任务。 本主题提供有关如何执行这些任务的说明。
先决条件
您必须在 Microsoft Office SharePoint Server 2007 SDK 中安装业务数据目录定义编辑器。
如步骤 1 中所述发布 WCF 服务 :使用 Oracle 电子商务适配器创建和发布 WCF 服务。
连接到 WCF LOB 服务和创建实体
必须连接到 WCF 服务才能为服务提取 Web 服务说明语言(WSDL)。 从 WSDL 中,业务数据目录定义编辑器提取方法。 这些方法可用于创建实体。 在本教程中,将创建一个实体。
连接到 WCF 服务并创建实体
启动业务数据目录定义编辑器。 在“ 开始 ”菜单上,单击 Microsoft业务数据目录定义编辑器。
在工具栏上,单击“ 添加 LOB 系统”。
在“添加 LOB 系统”窗口中,单击“ 连接到 Webservice”。
在 URL 框中,键入 WCF 服务的 URL。 对于本教程,URL 将为:
https://<COMPUTER_NAME>:<PORT_NUMBER>/MS_SAMPLE_EMPLOYEE/InterfaceTables_FND_APPS_MS_SAMPLE_EMPLOYEE.svc
测试 WCF 服务是否成功发布时,URL 可用,如 步骤 1 中所述:使用 Oracle 电子商务适配器创建和发布 WCF 服务。
单击连接。
若要查看在 WCF 适配器服务开发向导中选择的作,请单击“ 添加 Web 方法 ”选项卡。你将看到以下方法: 选择。
将 Select 方法拖到设计图面。 将方法拖动到设计图面时,将创建一个实体,并且该方法将成为该实体的一部分。
单击 “确定” 。
在 “输入 LOB 系统名称”对话框中,在 “LOB 系统名称”框中键入名称。 对于此示例,请将其调用 MS_SAMPLE_EMPLOYEE,然后单击“ 确定”。
在业务数据目录定义编辑器中,新创建的实体列为 Entity0。 将实体重命名为 Employee。 执行以下步骤来重命名实体:
展开 MS_SAMPLE_EMPLOYEE 节点,然后展开 “实体” 节点。
选择 Entity0 节点。
在“属性”窗格中,在“名称”框中键入“员工”。
指定用户名和密码标头用于这些方法
在 Oracle E-Business Suite 的 MS_SAMPLE_EMPLOYEE 接口表上为 Select 操作创建 WCF 服务时,您在 步骤 1:使用 Oracle 电子商务适配器创建和发布 WCF 服务中作为终结点行为配置的一部分指定了用户名和密码标头。 必须为 Select 方法属性指定相同的值。
指定 Select 方法的用户名和密码标头
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
单击“选择”节点,然后在“属性”窗格中,单击“属性”框旁边的省略号(...)按钮。
在 PropertyView 集合编辑器窗口中,单击“添加”,然后在“属性”窗格中,键入“名称”框的 HttpHeaderUserName。 在 PropertyValue 框中输入 MyUserHeader。 选择System.String为“类型”框中的值。
在 PropertyView 集合编辑器窗口中,单击“添加”,然后在“属性”窗格中,键入“名称”框的 HttpHeaderPassword。 同样,在 PropertyValue 框中键入 MyPasswordHeader。 选择System.String为“类型”框中的值。
单击 “确定” 。
方案 1:通过业务数据列表 Web 部件查询员工
若要创建一个应用程序定义文件,该文件可用于从业务数据列表 Web 部件中搜索员工,并基于员工名称,必须执行以下一组任务。
在 Select 方法中,创建筛选器并将其映射到 FILTER 参数。
为 Select 方法创建 Finder 方法实例。 Finder 方法基于筛选器检索记录列表。
创建筛选器并将其映射到 FILTER 参数
创建筛选器。
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
展开 Select 方法,右键单击 “筛选器”,然后单击“ 添加筛选器”。
在“属性”窗格中,对于 FilterType 属性,选择“ 等于”。
在“属性”窗格中,在“名称”框中键入 EmployeeName。
将筛选器映射到 Select 方法中的 FILTER 参数。
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
展开 Select 方法,然后展开 “参数” 节点。
展开 FILTER 节点,然后单击第二个 FILTER 节点。
在“属性”窗格中,从 FilterDescriptor 列表中选择 EmployeeName。
为 Select 方法创建 Finder 方法实例
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
展开 “选择 ”节点,右键单击“ 实例”,然后单击“ 添加方法实例”。
在“创建方法实例”窗口中,单击“方法实例类型的查找器”。 选择返回Return TypeDescriptor。
单击 “确定” 。
在“属性”窗格中,在“名称”框中键入Finder_Instance。
方案 2:在 Microsoft Office SharePoint Server 中对 MS_SAMPLE_EMPLOYEE 接口表进行 Full-Text 搜索
若要创建可用于从 Microsoft Office SharePoint Server 对 MS_SAMPLE_EMPLOYEE 接口表执行全文搜索的应用程序定义文件,必须执行以下一组任务。
在 Select 方法中,创建标识符,并将其映射到 FILTER 参数和存储员工名称的返回值。
为 Select 创建特定查找器方法实例。 Specific Finder 方法将基于标识符(即员工名称)查找特定记录。
创建 ID 枚举器方法实例。
创建标识符,并将其映射到 FILTER 参数和员工名称返回值
为 Employee 实体创建标识符。
在“元数据对象”窗格中,展开 “员工 ”节点。
右键单击 “标识符” 节点,然后选择“ 添加标识符”。
在“属性”窗格中,在“名称”框中键入 EmployeeName。
选择System.String为“类型”框中的值。
将标识符映射到 Select 方法的 FILTER 参数。
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
展开 Select 方法,然后展开 “参数” 节点。
展开 FILTER 参数,然后单击第二个 FILTER 节点。
在“属性”窗格中,从“标识符”列表中选择 EmployeeName[Employee]。
将标识符映射到员工名称返回值。
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
展开 Select 方法,然后展开 “参数” 节点。
展开 “返回 ”节点,然后展开第二个 “返回 ”节点,再展开 “项 ”节点,然后单击“ 名称 ”节点。
在“属性”窗格中,从“标识符”列表中选择 EmployeeName[Employee]。
为 Select 方法创建特定的 Finder 方法实例
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
展开 “选择 ”节点,右键单击 “实例”,然后选择“ 添加方法实例 ”以打开“创建方法实例”窗口。
在“创建方法实例”窗口中,为方法实例类型选择“特定查找器”。 选择返回Return TypeDescriptor。
单击 “确定” 。
在“属性”窗格中,键入SpeciFinder_Instance到名称框中。
为 Select 方法创建 ID 枚举器方法实例
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
展开 “选择 ”节点,右键单击 “实例”,然后选择“ 添加方法实例 ”以打开“创建方法实例”窗口。
在“创建方法实例”窗口中,为方法实例类型选择 ID 枚举器。 选择返回Return TypeDescriptor。
单击 “确定” 。
在“属性”窗格中,在名称框中键入IDEnumerator_Instance。
设置方法实例的默认参数
Select 方法要求指定列名。 因此,需要为前面创建的 Finder、Specific Finder 和 Id 枚举器方法实例指定 COLUMN_NAMES 参数的默认值。 此外,还应为 ID 枚举器方法实例的 FILTER 参数指定默认值。
设置方法实例的默认参数
在“元数据对象”窗格中,展开 “员工 ”节点,然后展开 “方法” 节点。
展开 “选择 ”节点,然后展开 “参数” 节点。
展开 COLUMN_NAMES 节点,然后选择 COLUMN_NAMES 参数。
在“属性”窗格中,针对 DefaultValues 框单击省略号按钮(...)。
在 DefaultValueView 集合编辑器对话框中,单击“添加”,然后在属性窗格中,单击 SelectMethodInstance 列表中的Finder_Instance。
在值框中键入
*
。同样,重复步骤 5 和 6,为 SpecificFinder_Instance 和 IDEnumerator_Instance 方法实例添加默认值。
在 “DefaultValueView 集合编辑器 ”对话框中,单击“ 确定”。
接下来,为 IDEnumerator_Instance 方法实例添加 FILTER 参数的默认值。 展开 FILTER 节点,然后选择 FILTER 参数。
在“属性”窗格中,针对 DefaultValues 框单击省略号按钮(...)。
在 DefaultValueView 集合编辑器对话框中,单击“添加”,然后在属性窗格中,单击 SelectMethodInstance 列表中的IDEnumerator_Instance。
在“值”框中键入
%
。在 “DefaultValueView 集合编辑器 ”对话框中,单击“ 确定”。
设置单一 Sign-On 以连接到 Oracle 电子商务套件
完成本主题中的所有过程后,将创建一个可导入 SharePoint 应用程序的应用程序定义文件。 在应用程序中,调用方法从 Oracle E-Business Suite 检索相关数据。 若要启用此功能,必须在 Oracle E-Business Suite 中的用户与 SharePoint 应用程序中的用户之间创建映射。 导入应用程序定义文件后,将在 SharePoint 管理中心控制台中创建此映射。
但是,若要创建映射,必须在业务数据目录定义编辑器中设置属性 SecondarySsoApplicationId 。
设置 SecondarySsoApplicationId 属性
在“元数据对象”窗格中,展开 MS_SAMPLE_EMPLOYEE 节点,然后展开 “实例” 节点。
单击MS_SAMPLE_EMPLOYEE_Instance,然后在“属性”窗格中,单击“属性”框旁边的省略号(...)按钮。
在 PropertyView 集合编辑器对话框中,单击“添加”,然后在“属性”窗格中,键入 Name 框的 SecondarySsoApplicationId。 同样,在 PropertyValue 框中键入 OracleSSO。 选择System.String为“类型”框中的值。
单击 “确定” 。
将应用程序定义导出到文件
现已创建包含 Oracle E-Business Suite 实例元数据的应用程序定义。 必须将此定义导出到 XML 文件,该文件可以导入到 office SharePoint Server Microsoft。
将应用程序定义导出到文件
在“元数据对象”窗格中,右键单击 MS_SAMPLE_EMPLOYEE 节点,然后单击“ 导出”。
将文件另存为 Employee.xml。
后续步骤
现在必须创建一个 SharePoint 应用程序,以便从 Oracle 电子商务套件检索数据。 有关说明,请参阅 步骤 3:创建 SharePoint 应用程序以从 Oracle 电子商务套件检索数据。