设为首页 收藏本站
查看: 1322|回复: 0

[经验分享] 在SharePoint Designer中创建一个BDC实体

[复制链接]

尚未签到

发表于 2017-5-24 11:12:24 | 显示全部楼层 |阅读模式
  业务数据目录--BDC(Business Data Catalog)是MOSS中新加的一个功能。它可以将LOB(Line-of-Business)数据组合到SharePoint的其他基本功能中。比如我们可以利用BDC组合业务数据到列表或企业搜索中。为此,我们必须先构建一个XML文件,用于标识数据存储的位置(MS SQL Server数据库或Web服务)以及数据是什么样子的(比如,数据类型是什么,主键是哪个)。
本文将通过创建一个BDC元数据文件定义一个简单的LOB数据实体。在此之前,需要具备下列的环境:

  • 安装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及其参数:
<LobSystem
Type="Database"
Version="1.0.0.01"
Name="CRM"
xmlns="http://schemas.microsoft.com/office/2006/03/BusinessDataCatalog">
</LobSystem>
  3.定义最上层的安全性相关参数
注意:这是可选的,我们也可以在BDC的管理页面中进行操作。
添加下面的XML到LobSystem元素的末尾(在结束标记</LobSystem>之前)。注意,我们必须更新Principal属性值,以使其指向正确的域名和用户或组名。
<AccessControlList>
<AccessControlEntryPrincipal="yourdomain\you">
<RightBdcRight="Execute"/>
<RightBdcRight="Edit"/>
<RightBdcRight="SetPermissions"/>
<RightBdcRight="SelectableInClients"/>
</AccessControlEntry>
<AccessControlEntryPrincipal="yourdomain\yourBDCusers">
<RightBdcRight="Execute"/>
<RightBdcRight="SelectableInClients"/>
</AccessControlEntry>
</AccessControlList>
  4.定义一个LOB系统的实例
对于数据库来说,一个系统实例定义了BDC中使用的数据库的连接参数。添加下面的XML,作为LobSystem元素的一个子节点(在AccessControlList元素后)。注意,我们必须用正确的服务器名替换server_name。
<LobSystemInstances>
<LobSystemInstanceName="CRMDB">
<Properties>
<PropertyName="AuthenticationMode"Type="System.String">
PassThrough</Property>
<PropertyName="DatabaseAccessProvider"Type="System.String">
SqlServer</Property>
<PropertyName="RdbConnectionDataSource"Type="System.String">
your_server_name</Property>
<PropertyName="RdbConnectionInitialCatalog"Type="System.String">
AdventureWorks</Property>
<PropertyName="RdbConnectionIntegratedSecurity"Type=
"System.String">SSPI</Property>
</Properties>
</LobSystemInstance>
</LobSystemInstances>
  使用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>
    <EntityName="Customer">
    <Properties>
    <!--Propertiesgohere-->
    </Properties>
    <Identifiers>
    <!--Identifiersgohere-->
    </Identifiers>
    <Methods>
    <MethodName="GetCustomers">
    <Properties>
    <!--MethodPropertiesgohere-->
    </Properties>
    <Parameters>
    <!--MethodParametersgohere-->
    </Parameters>
    <MethodInstances>
    <!--MethodInstancesgohere-->
    </MethodInstances>
    </Method>
    </Methods>
    </Entity>
    </Entities>
  • 定义GetCustomers方法中的属性。对于数据库,我们的实体属性告诉BDC查询的内容和如何进行查询。为GetCustomers 方法添加下面的XML到Properties 元素内。注意,在我们的T-SQL语句中有一个WHERE子句,包含了参数minCustomerID 和maxCustomerID 的引用,我们必须提前定义出来。同时,还要注意避免出现大于和小于号。
    这里我们不要按顺序写。先把注意力放到方法属性上,不要管更高一层的实体属性。因为这是我们定义查询的地方,它直接决定了实体其他部分的内容。<PropertyName="RdbCommandText"Type="System.String">
    SELECT
    customerID,
    LastName+','+FirstNameasName,
    Phone,
    EmailAddress
    FROM
    Sales.vIndividualCustomer
    WHERE
    (customerID&gt;@minCustomerIDand
    customerID&lt;@maxCustomerID)
    </Property>
    <PropertyName="RdbCommandType"Type="System.String">Text</Property>
  • 回到实体层次,定义属性和标识。用下面的XML替换Properties和Identifiers占位符元素。<Properties>
    <PropertyName="Title"Type="System.String">Name</Property>
    </Properties>
    <Identifiers>
    <IdentifierName="CustomerID"TypeName="System.Int32"/>
    </Identifiers>
  • 定义方法参数。添加下面的XML到GetCustomers 方法的Parameters 元素中。这里定义了3个参数。头两个是输入参数,通过CustomerID过滤了列表。第三个参数定义了由SQL查询返回的数据。
    所有这3个参数都包括了一个到前面我们创建的标识的引用。这个标识是实体的非常重要的一个部分。MOSS用它来查询一个特定的元素(因此标识被定义在输入参数中)。它同时还用于输出实体的各种附加功能中(比如应用于Business Data Action中)。没有标识,实体就会严重瘫痪。
    返回参数通常比较复杂。它被定义为一个数据的记录集。这样就告诉了MOSS,将会有多个实体被返回。<ParameterDirection="In"Name="@minCustomerID">
    <TypeDescriptorTypeName="System.Int32"Name="customerID"IdentifierName="CustomerID">
    <DefaultValues>
    <DefaultValueMethodInstanceName="CustomerFinderInstance"Type="System.Int32">
    0</DefaultValue>
    <DefaultValueMethodInstanceName=
    "CustomerSpecificFinderInstance"Type="System.Int32">
    0</DefaultValue>
    </DefaultValues>
    </TypeDescriptor>
    </Parameter>
    <ParameterDirection="In"Name="@maxCustomerID">
    <TypeDescriptorTypeName="System.Int32"Name="customerID"IdentifierName="CustomerID">
    <DefaultValues>
    <DefaultValueMethodInstanceName="CustomerFinderInstance"Type=
    "System.Int32">9999999</DefaultValue>
    <DefaultValueMethodInstanceName=
    "CustomerSpecificFinderInstance"Type="System.Int32">
    9999999</DefaultValue>
    </DefaultValues>
    </TypeDescriptor>
    </Parameter>
    <ParameterDirection="Return"Name="Customers">
    <TypeDescriptorTypeName="System.Data.IDataReader,System.Data,Version=2.0.3600.0,
    Culture=neutral,PublicKeyToken=b77a5c561934e089"IsCollection="true"
    Name="CustomerDataReader">
    <TypeDescriptors>
    <TypeDescriptorTypeName="System.Data.IDataRecord,System.Data,
    Version=2.0.3600.0,Culture=neutral,PublicKeyToken=
    b77a5c561934e089"Name="CustomerDataRecord">
    <TypeDescriptors>
    <TypeDescriptorTypeName="System.Int32"IdentifierName=
    "CustomerID"Name="customerID"/>
    <TypeDescriptorTypeName="System.String"Name="Name"/>
    <TypeDescriptorTypeName="System.String"Name="Phone"/>
    <TypeDescriptorTypeName="System.String"Name="EmailAddress">
    <LocalizedDisplayNames>
    <LocalizedDisplayNameLCID="1033">EmailAddress
    </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,所以写的比较简练。 DSC0000.gif <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用户筛选结果。

运维网声明 1、欢迎大家加入本站运维交流群:群②:261659950 群⑤:202807635 群⑦870801961 群⑧679858003
2、本站所有主题由该帖子作者发表,该帖子作者与运维网享有帖子相关版权
3、所有作品的著作权均归原作者享有,请您和我们一样尊重他人的著作权等合法权益。如果您对作品感到满意,请购买正版
4、禁止制作、复制、发布和传播具有反动、淫秽、色情、暴力、凶杀等内容的信息,一经发现立即删除。若您因此触犯法律,一切后果自负,我们对此不承担任何责任
5、所有资源均系网友上传或者通过网络收集,我们仅提供一个展示、介绍、观摩学习的平台,我们不对其内容的准确性、可靠性、正当性、安全性、合法性等负责,亦不承担任何法律责任
6、所有作品仅供您个人学习、研究或欣赏,不得用于商业或者其他用途,否则,一切后果均由您自己承担,我们对此不承担任何法律责任
7、如涉及侵犯版权等问题,请您及时通知我们,我们将立即采取措施予以解决
8、联系人Email:admin@iyunv.com 网址:www.yunweiku.com

所有资源均系网友上传或者通过网络收集,我们仅提供一个展示、介绍、观摩学习的平台,我们不对其承担任何法律责任,如涉及侵犯版权等问题,请您及时通知我们,我们将立即处理,联系人Email:kefu@iyunv.com,QQ:1061981298 本贴地址:https://www.yunweiku.com/thread-380442-1-1.html 上篇帖子: [sharepoint]:无法添加选择的web部件,cannot import web part 下篇帖子: SharePoint管理中心通过远程桌面不能访问,本机ie可以解决
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

扫码加入运维网微信交流群X

扫码加入运维网微信交流群

扫描二维码加入运维网微信交流群,最新一手资源尽在官方微信交流群!快快加入我们吧...

扫描微信二维码查看详情

客服E-mail:kefu@iyunv.com 客服QQ:1061981298


QQ群⑦:运维网交流群⑦ QQ群⑧:运维网交流群⑧ k8s群:运维网kubernetes交流群


提醒:禁止发布任何违反国家法律、法规的言论与图片等内容;本站内容均来自个人观点与网络等信息,非本站认同之观点.


本站大部分资源是网友从网上搜集分享而来,其版权均归原作者及其网站所有,我们尊重他人的合法权益,如有内容侵犯您的合法权益,请及时与我们联系进行核实删除!



合作伙伴: 青云cloud

快速回复 返回顶部 返回列表