MS CRM 2011 创建基于Fetch的报表 进阶版

原创地址：http://www.cnblogs.com/jfzhu/archive/2012/10/07/2713507.html

转载请注明出处

（一） 在之前的文章中，我介绍了如何创建基于Fetch的报表，并使用数据预筛选功能。在这篇文章中，我们使用一个比较复杂的FetchXML来完成一个更有实际意义的报表。

在这个报表中，显示相关客户，客户的订单，以及订单的产品信息。报表使用了三个inner join，account inner join order inner join orderdetail inner join product。

（1） 利用CRM的高级查找创建FetchXML

下载Fetch XML：

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="true"> 
  <entity name="account"> 
    <attribute name="name" /> 
    <attribute name="primarycontactid" /> 
    <attribute name="telephone1" /> 
    <attribute name="accountid" /> 
    <order attribute="name" descending="false" /> 
    <filter type="and"> 
      <condition attribute="statuscode" operator="eq" value="1" /> 
    </filter> 
    <link-entity name="salesorder" from="customerid" to="accountid" alias="aa"> 
      <filter type="and"> 
        <condition attribute="statecode" operator="ne" value="2" /> 
      </filter> 
      <link-entity name="salesorderdetail" from="salesorderid" to="salesorderid" alias="ab"> 
        <link-entity name="product" from="productid" to="productid" alias="ac"></link-entity> 
      </link-entity> 
    </link-entity> 
  </entity> 
</fetch>

（2） 我们将它拷贝到报表中数据集的Query，并进行一些修改（添加我们需要的attribute）

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="true"> 
  <entity name="account"> 
    <attribute name="name" /> 
    <attribute name="accountid" /> 
    <order attribute="name" descending="false" /> 
    <filter type="and"> 
      <condition attribute="statuscode" operator="eq" value="1" /> 
    </filter> 
    <link-entity name="salesorder" from="customerid" to="accountid" alias="aa"> 
      <attribute name="ordernumber" /> 
      <attribute name="name" /> 
      <attribute name="totalamount" /> 
      <filter type="and"> 
        <condition attribute="statecode" operator="ne" value="2" /> 
      </filter> 
      <link-entity name="salesorderdetail" from="salesorderid" to="salesorderid" alias="ab"> 
        <attribute name="quantity" /> 
        <attribute name="priceperunit" /> 
        <attribute name="baseamount" /> 
        <link-entity name="product" from="productid" to="productid" alias="ac"> 
          <attribute name="name" /> 
        </link-entity>        
      </link-entity> 
    </link-entity> 
  </entity> 
</fetch>

（3） 按照之前的文章介绍，使用数据预筛选功能。

添加一个CRM_FilteredAccount参数，使用以下的Query:

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="false"><entity name="account"><all-attributes /></entity></fetch>

（4） 修改数据集Query的Fetch XML:

对这一行修改：  <entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount">

修改结果为：

<fetch version="1.0" output-format="xml-platform" mapping="logical" distinct="true"> 
  <entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount"> 
    <attribute name="name" /> 
    <attribute name="accountid" /> 
    <order attribute="name" descending="false" /> 
    <filter type="and"> 
      <condition attribute="statuscode" operator="eq" value="1" /> 
    </filter> 
    <link-entity name="salesorder" from="customerid" to="accountid" alias="aa"> 
      <attribute name="ordernumber" /> 
      <attribute name="name" /> 
      <attribute name="totalamount" /> 
      <filter type="and"> 
        <condition attribute="statecode" operator="ne" value="2" /> 
      </filter> 
      <link-entity name="salesorderdetail" from="salesorderid" to="salesorderid" alias="ab"> 
        <attribute name="quantity" /> 
        <attribute name="priceperunit" /> 
        <attribute name="baseamount" /> 
        <link-entity name="product" from="productid" to="productid" alias="ac"> 
          <attribute name="name" /> 
        </link-entity>        
      </link-entity> 
    </link-entity> 
  </entity> 
</fetch>

（5） 在设计面板中添加Table：

（6） 到这一步报表就完成了。将报表上传到CRM中看一下结果：

（二） 使用FetchXML实现inner join

在上面的实例中，已经看到如何使用 link-entity 来实现 inner join。link-entity 有一个属性 -- link-type，它的默认值为inner，你可以不指定该属性值，也可以指定其为inner。

<fetch distinct="false" no-lock="false" mapping="logical"> 
  <entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount"> 
    <attribute name="name" alias="name" /> 
    <attribute name="accountid" /> 
    <link-entity name="contact" to="accountid" from="parentcustomerid" alias="contact1"> 
      <attribute name="fullname" alias="contact1_fullname" /> 
      <attribute name="contactid" /> 
    </link-entity> 
  </entity> 
</fetch>

<fetch distinct="false" no-lock="false" mapping="logical"> 
  <entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount"> 
    <attribute name="name" alias="name" /> 
    <attribute name="accountid" /> 
    <link-entity name="contact" to="accountid" from="parentcustomerid" link-type="inner" alias="contact1"> 
      <attribute name="fullname" alias="contact1_fullname" /> 
      <attribute name="contactid" /> 
    </link-entity> 
  </entity> 
</fetch>

 

（三） 使用FetchXML实现outer join

实现outer join需要指定link-entity 的属性 link-type的值为outer

<fetch distinct="false" no-lock="false" mapping="logical"> 
  <entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount"> 
    <attribute name="name" alias="name" /> 
    <attribute name="accountid" /> 
    <link-entity name="contact" to="accountid" from="parentcustomerid" link-type="outer" alias="contact1"> 
      <attribute name="fullname" alias="contact1_fullname" /> 
      <attribute name="contactid" /> 
    </link-entity> 
  </entity> 
</fetch>

（四） 使用 Order + Count

你可以使用order对fetchxml返回的数据集进行排序，并且可以用count指定返回数据的个数。下面的代码指定按照contact fullname 和 account name 进行排序，并返回最多1条数据。

<fetch distinct="false" no-lock="false" mapping="logical" count="1"> 
  <entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount"> 
    <attribute name="name" alias="name" /> 
    <attribute name="accountid" /> 
    <link-entity name="contact" to="accountid" from="parentcustomerid" link-type="inner" alias="contact1"> 
      <attribute name="fullname" alias="contact1_fullname" /> 
      <attribute name="contactid" /> 
      <order attribute="fullname"/> 
    </link-entity> 
    <order attribute="name"/> 
  </entity> 
</fetch>

（五） 使用 fetchXML来获取 N:N 关系的数据

如果你使用的是Native N:N 关系，CRM 会自动为你的关系创建一个Entity。比如我做的一个项目中，有如下的关系， account 与 aw_aansluitadres 是 1 : N 的关系， aw_aansluitadres 与 aw_deelcontract 是 N : N 的关系， 系统便自动生成一个名为 aw_deelcontract_aansluitadres的entity。

如果你想获得 account inner join aw_aansluitadres inner join aw_deelcontract， 你可以使用下面的fetchXML：

<fetch distinct="false" mapping="logical" > 
  <entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount"> 
    <attribute name="name" alias="name" /> 
    <link-entity name="aw_aansluitadres" from="aw_accountid" to="accountid" alias="aa" > 
      <link-entity name="aw_deelcontract_aansluitadres" from="aw_aansluitadresid" to="aw_aansluitadresid" visible="false" intersect="true"> 
        <link-entity name="aw_deelcontract" from="aw_deelcontractid" to="aw_deelcontractid" alias="ab"> 
          <attribute name="aw_einddatum" alias="ab_aw_einddatum" /> 
          <attribute name="aw_leverancierid" alias="ab_aw_leverancierid" /> 
          <attribute name="aw_jaartalid" alias="ab_aw_jaartalid" /> 
        </link-entity> 
      </link-entity> 
    </link-entity> 
  </entity> 
</fetch>

如果想得到 account outer join aw_aansluitadres outer join aw_deelcontract，我在上面已经解释过了，需要为每个link-entity 的 link-type属性指定值为outer

<fetch distinct="false" mapping="logical" count="1"> 
  <entity name="account" enableprefiltering="1" prefilterparametername="CRM_FilteredAccount"> 
    <attribute name="name" alias="name" /> 
    <link-entity name="aw_aansluitadres" from="aw_accountid" to="accountid" alias="aa" link-type="outer"> 
      <link-entity name="aw_deelcontract_aansluitadres" from="aw_aansluitadresid" to="aw_aansluitadresid" visible="false" link-type="outer"> 
        <link-entity name="aw_deelcontract" from="aw_deelcontractid" to="aw_deelcontractid" alias="ab" link-type="outer"> 
          <attribute name="aw_einddatum" alias="ab_aw_einddatum" /> 
          <attribute name="aw_leverancierid" alias="ab_aw_leverancierid" /> 
          <attribute name="aw_jaartalid" alias="ab_aw_jaartalid" /> 
        </link-entity> 
      </link-entity> 
    </link-entity> 
  </entity> 
</fetch>

总结： fetchXML可以实现inner join，也可以实现outer join，关键在于link-entity的link-type属性，inner为inner join， outer 为 outer join，默认值为 inner。通过对数据使用order 排序，还可以通过设置fetch 的 count属性来指定返回的数据数目。