创建一个简单的BDC实体
来源:互联网 发布:js的不等于符号 编辑:程序博客网 时间:2024/05/25 23:58
- 安装Microsoft SQL Server 2005并部署了AdventureWorks数据库
- 拷 贝BDC架构文件, Bdcmetadata.xsd和Bdcmetadataresource.xsd, 到Visual Studio 2005的Schema库中。将上面的两个文件从program files/Microsoft Office Servers/12.0/Bin/ 拷到 program files/Microsoft Visual Studio 8/Xml/Schemas/。
下面开始构建BDC元数据文件来定义一个简单的LOB数据实体:
1. 首先,创建一个空的XML文件 打开Visual Studio 2005,创建一个 XML文件。右击文档,选属性。在架构(Schemas)属性框上,点省略号,把Bdcmetadata.xsd 架构文件附加到该文档上。
2.定义一个 LobSystem添加下面的XML来定义最上层的LobSystem及其参数:
3.定义最上层的安全性相关参数注意:这是可选的,我们也可以在BDC的管理页面中进行操作。添加下面的XML到LobSystem元素的末尾(在结束标记</LobSystem>之前)。注意,我们必须更新Principal属性值,以使其指向正确的域名和用户或组名。
4.定义一个LOB系统的实例对于数据库来说,一个系统实例定义了BDC中使用的数据库的连接参数。添加下面的XML,作为LobSystem元素的一个子节点(在AccessControlList元素后)。注意,我们必须用正确的服务器名替换server_name。
使用pass-through方式作验证的缺点是操作系统只暴露用户名和密码。因此,如果一个公司使用双因素验证(即用户需要提供用户名,密码以外的其它特定的私有信息),我们就不能使用pass-through方式了。如 果不用考虑上面这些缺点,那么pass-through方式是我们在测试环境下的一个不错的选择。如果您的公司使用双因子验证,并且您还需要连BDC到一 个SQL Server数据库,那么您可以使用SSO(Single Sign Sn),对此,这里就不做更深的介绍了。5.定义一个实体---Customer一个实体包括一个标题(定义在元素属性中),一个唯一标识(等同于主键),和一些方法(用于定义实体中的字段,并告诉BDC如何将实体数据从LOB系统中取出来)。下面的步骤定义了一个名为Customer的实体。
- 在 LobSystemInstances 元素后面为该实体添加XML核心代码。这里包括我们用来定义实体标题的占位符元素,统一标识和一个返回所有Customer的方法。注意:一个方法包含一个Properties元素用于定义数据库查询(或Web服务方法),一个Properties 元素定义从查询返回的数据,和一个MethodInstances 元素,标识MOSS中的特定功能。 <Entities> <Entity Name="Customer"> <Properties> <!--Properties go here--> </Properties> <Identifiers> <!--Identifiers go here--> </Identifiers> <Methods> <Method Name ="GetCustomers"> <Properties> <!--Method Properties go here--> </Properties> <Parameters> <!--Method Parameters go here--> </Parameters> <MethodInstances> <!--Method Instances go here--> </MethodInstances> </Method> </Methods> </Entity></Entities>
- 定 义GetCustomers方法中的属性。对于数据库,我们的实体属性告诉BDC查询的内容和如何进行查询。为GetCustomers 方法添加下面的XML到Properties 元素内。注意,在我们的T-SQL语句中有一个WHERE子句,包含了参数minCustomerID 和maxCustomerID 的引用,我们必须提前定义出来。同时,还要注意避免出现大于和小于号。这里我们不要按顺序写。先把注意力放到方法属性上,不要管更高一层的实体属性。因为这是我们定义查询的地方,它直接决定了实体其他部分的内容。 <Property Name="RdbCommandText" Type="System.String"> SELECT customerID, LastName + ', ' + FirstName as Name, Phone, EmailAddress FROM Sales.vIndividualCustomer WHERE (customerID > @minCustomerID and customerID < @maxCustomerID)</Property><Property Name="RdbCommandType" Type="System.String">Text</Property>
- 回到实体层次,定义属性和标识。用下面的XML替换Properties和Identifiers占位符元素。 <Properties> <Property Name="Title" Type="System.String">Name</Property></Properties><Identifiers> <Identifier Name="CustomerID" TypeName="System.Int32"/></Identifiers>
- 定义方法参数。添加下面的XML到GetCustomers 方法的Parameters 元素中。这里定义了3个参数。头两个是输入参数,通过CustomerID过滤了列表。第三个参数定义了由SQL查询返回的数据。所 有这3个参数都包括了一个到前面我们创建的标识的引用。这个标识是实体的非常重要的一个部分。MOSS用它来查询一个特定的元素(因此标识被定义在输入参 数中)。它同时还用于输出实体的各种附加功能中(比如应用于Business Data Action中)。没有标识,实体就会严重瘫痪。返回参数通常比较复杂。它被定义为一个数据的记录集。这样就告诉了MOSS,将会有多个实体被返回。 <Parameter Direction="In" Name="@minCustomerID"> <TypeDescriptor TypeName="System.Int32" Name="customerID" IdentifierName="CustomerID"> <DefaultValues> <DefaultValue MethodInstanceName="CustomerFinderInstance" Type="System.Int32"> 0</DefaultValue> <DefaultValue MethodInstanceName= "CustomerSpecificFinderInstance" Type="System.Int32"> 0</DefaultValue> </DefaultValues> </TypeDescriptor></Parameter><Parameter Direction="In" Name="@maxCustomerID"> <TypeDescriptor TypeName="System.Int32" Name="customerID" IdentifierName="CustomerID"> <DefaultValues> <DefaultValue MethodInstanceName="CustomerFinderInstance" Type= "System.Int32">9999999</DefaultValue> <DefaultValue MethodInstanceName= "CustomerSpecificFinderInstance" Type="System.Int32"> 9999999</DefaultValue> </DefaultValues> </TypeDescriptor></Parameter><Parameter Direction="Return" Name="Customers"> <TypeDescriptor TypeName="System.Data.IDataReader, System.Data, Version=2.0.3600.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" IsCollection="true" Name="CustomerDataReader"> <TypeDescriptors> <TypeDescriptor TypeName="System.Data.IDataRecord, System.Data, Version=2.0.3600.0, Culture=neutral, PublicKeyToken= b77a5c561934e089" Name="CustomerDataRecord"> <TypeDescriptors> <TypeDescriptor TypeName="System.Int32" IdentifierName= "CustomerID" Name="customerID" /> <TypeDescriptor TypeName="System.String" Name="Name" /> <TypeDescriptor TypeName="System.String" Name="Phone" /> <TypeDescriptor TypeName="System.String" Name="EmailAddress" > <LocalizedDisplayNames> <LocalizedDisplayName LCID="1033">Email Address </LocalizedDisplayName> </LocalizedDisplayNames> </TypeDescriptor> </TypeDescriptors> </TypeDescriptor> </TypeDescriptors> </TypeDescriptor></Parameter>
- 定 义方法的实例。添加下面的XML到MethodInstances 元素中。MOSS通过Finder 方法获取所有实体的已知实例。而且,MOSS通过finder方法来支持Business Data List WebPart。MOSS通过特定的Finder方法来获取查询特定方法实例的类型。搜索,业务数据操作,筛选,几乎所有其他的BDC功能都会用到该方 法。一个方法通常只支持0或1个方法的实例。在本例中,我们只有一个方法,可以返回所有的customers或单个customer。当您定义您 的实体时,您会发现或许使用两个方法会更容易些,一个GetCustomers 方法和一个GetSingleCustomer 方法。我们在这里只是为了简化XML,所以写的比较简练。 <MethodInstance Name="CustomerFinderInstance" Type="Finder" ReturnParameterName="Customers" ReturnTypeDescriptorName="CustomerDataReader" /><MethodInstance Name="CustomerSpecificFinderInstance" Type="SpecificFinder" ReturnParameterName="Customers" ReturnTypeDescriptorName="CustomerDataReader"/>
- 保存文件。
6.将完成的元数据文件上传到SSP(Shared Service Provider)
打开管理中心,点左侧导航栏中的共享服务(通常名为SharedServices1)。在BDC一节中,点导入应用程序定义。点浏览,找到刚刚创建的元数据文件,双击。其他的应用程序定义项都用默认值就好,点导入。
7. 使用业务数据列表部件来显示Customer数据
在一个我们创建好的站点里,在页面中添加一个业务数据列表部件。 打开属性面板,在“类型”中输入Customer然后回车。MOSS会分析该属性,并得到Customer(CRMDB) 实体。 点确定,该实体就会显示在WebPart中了。 MOSS 中的BDC功能允许我们将处于门户以外的LOB数据包括进来,用于列表和企业搜索。BDC需要一个XML元数据文件用于定义到外部数据源的连接参数、各种 查询(或Web服务方法调用),以及用于查询或方法调用的所有的输入输出参数。定义一个元数据文件,关键是理解其结构。理解BDC的关键就是理解实体。实 体包括:属性,允许BDC开发人员在实体层次定义特定的元数据,比如默认的显示元素(Title)。标识,LOB字段的集合,唯一标识该实体。方法, 包括T-SQL或Web服务方法,用于获取实体数据。实体可以包括多个方法,可以随意包含参数和筛选,可供BDC用户筛选结果。
总结:笔者在做该实验的时候也出现了细微的错误,主要是BDC元数据XML格式的错误,这一点望大家小心留意。原文参考:http://www.officeba.com.cn/article/htmldata/detail/2007/9/27/1378.html
- 创建一个简单的BDC实体
- Sharepoint 创建BDC实体
- Sharepoint 创建BDC实体
- 一个简单的bdc program
- MSDN Visual系列:在MOSS中创建一个BDC实体
- 在SharePoint Designer中创建一个BDC实体
- 简单的BDC例子
- 创建session做BDC
- BDC-->创建会计凭证
- 利用java的反射创建一个联合实体类
- ACIS 创建只有一个点的实体(BODY)
- 一个用泛型简单实现的数据库查询实体方法
- 创建一个简单的相册
- 创建一个简单的计算器
- 创建一个简单的触发器
- 创建一个简单的地图
- 创建一个简单的泛型类
- 创建一个简单的项目
- BOOL 和 bool 的区别
- JDOM使用详解及实例
- AIDE 介绍
- 计算机的分类
- 如何在Cuyahoga中新增一个简单的功能模块
- 创建一个简单的BDC实体
- struts2 common error
- 如何在Cuyahoga中添加公告模块
- 疯狂的程序员64
- 怎样做一个优秀的(懒惰的)系统管理员
- 最爆笑的人名
- 【Z一贴】纯C环境下能否在struct里实现函数
- Cuyahoga's DatabaseDiagram and ClassDiagram
- 2008经典语录