博客园_Sunmoonfire's artistic matrix

SharePoint 2010 SP1

2011-06-29T10:25:00Z

SharePoint 2010 SP1发布了。

下载地址：
Microsoft Office SharePoint Server 2010 Service Pack 1 (SP1)

Microsoft SharePoint Foundation 2010 Service Pack 1 (SP1)

有关更多更新的细节可以参考下面这本白皮书。

Service Pack 1 (SP1) for Microsoft SharePoint Foundation 2010 and Microsoft SharePoint Server 2010 (white paper) 。也可以直接点此下载该白皮书。

更新的文件和版本参考如下的知识库文章。

Technical details about the SharePoint 2010 and Office Server 2010 SP1 releases

SharePoint爱好者们赶快下载吧。

本文链接

SharePoint 2010的网站主题

2011-02-12T08:48:00Z

从SharePoint 2003开始，主题就作为一种自定义SharePoint外观的重要选项。SharePoint 2003和2007中的包括一系列开箱即用的主题，可以被网站所有者通过SharePoint UI应用到SharePoint网站。网页设计师和开发人员可以创建包含自定义图片及CSS文件的自定义主题。
定制SharePoint 2007主题的一个问题是，网页设计师或开发人员需要创建自定义的CSS，图片和相关的主题注册文件才能实现主题的自定义。而且需要将其部署到SharePoint Web前端服务器的本地文件系统上。这样无疑就提高了主题定制的门槛，因为需要一定的技术知识和对物理服务器的访问权限，所以非技术人员和最终用户很难对SharePoint网站视觉设计进行灵活的修改。

SharePoint 2010也支持主题，但其工作机制已发生很大变化。Miicrosoft对整个主题框架进行大调整的目的之一就是，希望非技术用户能够方便的进行站的视觉设计，并能够通过SharePoint用户界面对主题进行定制。

使用主题

全新的主题编辑器可以在"网站设置"下"外观"里的"网站主题"下找到，页面上提供了一个列表框，可以选择某个主题。这和SharePoint 2007里的页面一样，可以看到很多熟悉的主题名称，尽管主题本身已经发生了很大的变化。

现在，我们可以通过SharePoint用户界面选择一个主题，然后定制其字体和颜色。SharePoint 2010主题的一大优点就是更加标准化：

4种控制背景和文字的颜色（深色1[Dark1]，浅色1[Light1]，深色2[Dark2]，浅色2[Light2]），作为该主题的核心色调。这些颜色将作为该主题样式的主旋律，并最大程度的影响网站的整体外观。
6种强调色(accent)可以使您设计的风格更加成熟，允许我们最大程度的控制激活或悬停超链接的颜色，边框的颜色，特定内容的文字颜色（如系统菜单，组标题，标题区等）。
两种字体用于标题和内容元素。
两种颜色用于超链接<hyperlinks>（正常[normal]的和访问过后的[followed]）

除了直接提供给用户选择的颜色外，主题生成器会为每种颜色自动生成5种附加色（通过亮变化和暗变化）。每一种变化所使用的标签为（以强调文字颜色 1 [Accent 1]为例）：

强调文字颜色 1 （用户选定的颜色）
强调文字颜色 1 – 最亮 [Accent 1 - Lightest]
强调文字颜色 1 – 偏亮 [Accent 1 - Lighter]
强调文字颜色 1 – 中等 [Accent 1 - Medium]
强调文字颜色 1 – 偏暗 [Accent 1 - Darker]
强调文字颜色 1 – 最暗 [Accent 1 - Darkest]

色彩和色调变化是网页设计师进行视觉设计时的常用技法，常用于边框效果，渐变等。在本文的后面部分，我将演示这些色彩是如何通过CSS文件的方式来引用的。

剖析一个主题

SharePoint 2007里的主题是一个由CSS，图片，主题信息文件组成的集合，存放在相对于SharePoint的根目录的下。在SharePoint 2010里，你仍然可以找到2007的主题，历史的原因，仍放在相同的相对目录14\Template\Themes下。

然而，真正的SharePoint 2010主题实际上存放在相对于SharePoint根目录的14\Template\Global\Lists\Themes下。格式也已经发生了很大的变化。主题现在使用Office Open XML的格式进行了打包，变成一个.THMX文件。

THMX文件是一个包含了主题样式XML定义和图片资源的zip文件。一个主题文件内部结构的完整描述已经超出了本文的范围，你可以参考MSDN上的文章来“创建Office Open XML格式的文档主题”。

主题也可以通过"网站设置"下"库"下面的"主题"来查看，这种方式打开的是主题库。

主题如何用于页面呈现

SharePoint 2010关联到CSS的方式与SharePoint 2007大致相同，都是采用了在母版页<HEAD>部分添加控件的方式。

<SharePoint:CssLink runat="server" Version="4"/>
<SharePoint:CssRegistration Name="/Style Library/Custom.css" After="true" runat="server" EnableCssTheming="true"/>
<SharePoint:Theme runat="server"/>

虽然我们一直以来都习惯通过标准的HTML<link>属性来在母版页中包含CSS样式表，但是CssLink，CssRegistration和Theme控件可以提供特殊的功能，因此这种方式在2010中继续作为一种在我们的设计中插入样式表关联的推荐方式。这里给出每个控件的简要介绍：

<SharePoint:CssLink>控件负责插入SharePoint默认的核心样式表和任何通过CssRegistration控件注册的自定义样式表。
<SharePoint:CssRegistration>控件允许注册任何自定义的CSS样式。实际插入到页面中的<link>是通过CssLink控件完成的。
<SharePoint:Theme>控件会检查是否有主题被应用到当前站点，并负责关联到主题的样式表。
注：由于历史的原因，本控件似乎仍然包含在SharePoint 2010母板页中。对于SharePoint 2010主题，该控件似乎不再是必需的。

还是上面的例子，让我们来看看在没有应用主题时页面输出的<link>：

<link rel="stylesheet" type="text/css" href="/_layouts/2052/styles/Themable/search.css?rev=13MPCAdDiTOjeBSP8ulMLA%3D%3D"/>
<link rel="stylesheet" type="text/css" href="/_layouts/2052/styles/Themable/wiki.css?rev=YwZnjCtjmh%2B5m0%2BZ4o%2Fw%2Fw%3D%3D"/>
<link rel="stylesheet" type="text/css" href="/_layouts/2052/styles/Themable/corev4.css?rev=hMUVPfEXdjj0KHpLKexFuA%3D%3D"/>
<link rel="stylesheet" type="text/css" href="/Style%20Library/Custom.css"/>

在上面的例子中，我们可以看到通过CssLink控件插入了数个SharePoint自带的样式表。同时还可以看到，我自定义的CSS也已经输出在最后一行，直接关联到样式库中存储的原始CSS文件。

在应用了一个现成的主题后，我们可以看到，SharePoint修改了输出到页面的样式表关联。

<link rel="stylesheet" type="text/css" href="/_catalogs/theme/Themed/67B9FADD/search-BBB12040.css?ctag=6"/>
<link rel="stylesheet" type="text/css" href="/_catalogs/theme/Themed/67B9FADD/wiki-8D6982C.css?ctag=6"/>
<link rel="stylesheet" type="text/css" href="/_catalogs/theme/Themed/67B9FADD/corev4-24A0E46F.css?ctag=6"/>
<link rel="stylesheet" type="text/css" href="/_catalogs/theme/Themed/67B9FADD/Custom-37A53504.css?ctag=6"/>

在SharePoint 2007里，应用主题后会在页面的输出中插入一个额外的样式表关联。该主题中包含的样式将会通过CSS的层叠行为覆盖任何核心样式或自定义样式。

在SharePoint 2010中的行为已经发生了改变。当一个主题应用时，SharePoint会实时的自动生成该主题的CSS和图片，并将它们存储在应用该主题的站点的_themes文件夹下。

如果我们用SharePoint Designer打开该网站，可以看到SharePoint创建的这个文件夹，其中包含了生成的主题文件。文件夹名称是一个唯一的数字标识符，该数字是在应用一个新的主题时生成的。

要注意的很重要的一点是，SharePoint已经用主题化后的变体替代了所有原来的CSS关联。在SharePoint 2010里，当生成一个主题时，SharePoint利用嵌入在原先样式表中的指令来生成替换后的样式表。这种自动生成和替换只有在满足以下两个条件的情况下才会触发：

自带的样式表是*主题化(themable)*的。这些样式表实际上可以很容易的通过引用它们的虚目录区分出来，因为它们位于_layouts/2052/styles/themeable目录中。
用于我们的自定义样式表的CSSRegistration控件需要具有 EnableCssTheming=”true” 这一属性。

如果我们没有启用CSS主题化，那么SharePoint会把我的自定义样式表输出在页面最后一行，并且仍旧直接关联到样式库中原来的CSS文件。

<link rel="stylesheet" type="text/css" href="/_catalogs/theme/Themed/67B9FADD/search-BBB12040.css?ctag=6"/>
<link rel="stylesheet" type="text/css" href="/_catalogs/theme/Themed/67B9FADD/wiki-8D6982C.css?ctag=6"/>
<link rel="stylesheet" type="text/css" href="/_catalogs/theme/Themed/67B9FADD/corev4-24A0E46F.css?ctag=6"/>
<link rel="stylesheet" type="text/css" href="/Style%20Library/Custom.css"/>

注意：并有没有硬性的规定说自定义样式表必须支持主题，只是在SharePoint 2007基础上多了一种选择。在SharePoint 2010里，你完全可以根据所要达到的效果选择合适的方式将自定义样式表关联到母版页，并且取消用户应用主题的能力。这种情况往往会在发布网站上碰到，往往是这类网站共同的做法。网站管理员不希望用户覆盖默认的样式。

在自定义样式表中支持主题

在SharePoint 2007中，核心和自定义样式表不需要考虑任何与主题相关的事情。 SharePoint使用CSS的层叠能力使用主题中的CSS直接覆盖关联到母板页的核心和默认的自定义样式。

在SharePoint 2010中此行为发生了变化。现在核心样式表和任何我们开发的自定义样式表都需要包含一些标记，以便支持主题。学习如何操作的最简单的方式就是打开现有的样式表，看看他们是如何做到这一点的：

.ms-menutoolbar td a{
/* [ReplaceColor(themeColor:"Hyperlink")] */ color:#0072bc;
font-size:9pt;
font-family:宋体;
text-decoration:none;
}

在上面的例子中，我们看到，为了支持主题，样式表中的CSS的注释插入了一些特定的指令。通过这些特殊指令，SharePoint就可以用主题中定义的命名样式覆盖默认的样式。

下面是另外的一些例子，也是从默认样式中找到的，可以帮助我们编写自己的样式表来支持主题：

[ReplaceColor(themeColor:"Light1")]
 [ReplaceColor(themeColor:"Accent3-Darker")] 
 [ReplaceColor(themeColor:"Light2-Lightest")]
 [RecolorImage(themeColor:"Light2",includeRectangle:{x:0,y:610,width:1,height:42})]

请注意，SharePoint现在可以在生成主题过程中自动重新着色图片(RecolorImage) - 给力啊！

将SharePoint 2007的主题升级到SharePoint 2010

到目前为止，我还没有看到任何有关升级SharePoint 2007主题的文章。再加上SharePoint 2010的主题支持，升级SharePoint 2007主题实际上就是把旧的完全换掉：

可以用Office PowerPoint 2010创建自定义主题，并部署到网站的主题库中。 Todd Baginski 写过一篇如何创建SharePoint 2010自定义主题的文章。如果你的自定义主题是只限于基本的文字和颜色属性的话，通过这种方式实现起来会很方便。但如果你自定义的主题中包含了一些高级的CSS技巧，那么仍需手工编写代码。
创建一个自定义母版页，直接在母版页中注册您的自定义CSS

有些人可能会抱怨说，微软似乎背离了CSS继承的Web标准的本意。但是，网站所有者、管理员和开发人员毕竟会从这种标准的提升中获得便利。

参考资料

How Themes work in SharePoint 2010

本文链接

SharePoint 2010整合Silverlight 4应用 - 任务管理

2011-01-22T15:24:00Z

SharePoint 2010可以与Silverlight实现紧密集成。不管是在浏览器中运行的Silverlight程序还是单独的一个Silverlight程序，都能与SharePoint 2010实现很好的整合。本文中我们将实现一个Silverlight和SharePoint高度整合的例子，通过SharePoint 2010客户端对象模型访问SharePoint任务列表。同时，我们还将学习如何通过SharePoint自带的Silverlight Web部件来宿主Silverlight应用。下图是根据我个人的理解绘制的Silverlight和SharePoint 2010应用整合示意图。

从上图我们可以看到，我们分别有SharePoint客户端对象模型（OM）和SharePoint Web服务两种API供 Silverlight应用程序调用。事实上客户端对象模型和服务这两条途径，不仅仅能用在Silverlight中，还可以用于其它的客户端应用程序中。

在开始编写应用程序之前，我们首先了解一下Silverlight和SharePoint之间不同类型的集成模型。我们可以简单的通过HTML以IFrame的方式显示Silverlight应用程序，也可以将Silverlight应用程序宿主在Web部件中，还可以调用SharePoint对象模型或服务。这些方式彼此之间并没有硬性的分类界限。只是人为的通过使用规模所做的一个区分。分类如下：

1. 无接触：通过无接触方式，可以直接把现有的Silverlight应用集成到SharePoint。目的只是在SharePoint中进行显示。直接使用iframe即可。

2.低接触：低接触的应用与SharePoint间的互动多了一点。但也仅仅是通过SharePoint 开箱即用的Silverlight Web部件对Silverlight应用进行装载而已。这个应用程序本身是一个独立的应用程序，它可能会调用一些除SharePoint API以外的其他服务。

之前我的一篇博文中，曾讨论过一个典型的低接触的例子。是关于SharePoint2010整合Silverlight 4应用——Bing地图控件

3.高接触：高接触整合是指利用到SharePoint客户端对象模型或Web服务来读写SharePoint Server信息的应用整合。应用程序本身可以是一个WPF应用程序，或者是像Silverlight这样的客户端应用程序，或者是ASP.NET 、JavaScript应用程序。下图为一个Silverlight客户端应用程序的高接触整合。

接下来，我们要实现一个Silverlight与SharePoint高接触的应用，通过Silverlight调用客户端对象模型。会对使用客户端对象模型的三种场景都进行描述：

1. 在浏览器中运行的Silverlight应用程序

2. 在浏览器外运行的（Out of Browser,简称OOB）Silverlight应用程序

3. 作为Silverlight XAP文件宿主在SharePoint Web部件中的Silverlight应用程序

首先，我们需要创建一个Silverlight应用程序，打开Visual Studio 2010>“新建” >“项目” 。选择Silverlight项目模板，并选择.NET Framework 4.0。将该项目命名为“SilverlightSPIntegration”。

点击“确定”按钮后，会弹一个窗口要求自动创建一个Web应用程序，Silverlight应用程序将自动宿主在该Web应用程序中。

下一步我们要做的就是编写Silverlight程序来调用客户端对象模型的API 。右击Silverlight解决方案，选择“添加引用”

这里我们需要添加“Microsoft.SharePoint.Client.Silverlight.dll”和“Microsoft.SharePoint.Client.Silverlight.Runtime.dll”这两个dll。他们位于"C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS\ClientBin"文件夹下。

引用添加完成后，整个Silverlight应用程序的文件夹结构如下：

接下来，我们要对Silverlight的XAML进行设计，实现SharePoint网站中的某些功能。如上所述，在本例中，我们会从SharePoint内置的任务列表中读取一些数据。因此，我们不妨先参考一下SharePoint默认的界面。打开SharePoint网站，从快速启动区中找到“任务”列表并点击它。

这是默认的SharePoint任务列表。当然你也可以使用任意的列表，甚至是自定义列表。只需要根据实际的设计修改对应的用户界面和代码即可。现在，为该任务列表输入一些虚拟的数据。

下面是我为的任务列表添加的一些虚拟数据。

至此，我们完成了SharePoint部分的工作。接下来我们要创建一个自定义的UI，用Silverlight来显示这些数据。界面比较简陋，只是为了说明两者是如何实现整合的。

返回Visual Studio，在Silverlight解决方案中，设计一些简单的XAML界面。

为了快速设置样式，我用Expression Blend对界面做了一点美化工作。

保存该Expression Blend项目，并在Visual Studio中从我们的Silverlight应用程序中打开。它会要求重新加载应用程序，因为内容在当前环境外被修改了。

以下是Silverlight用户界面的XAML代码

<!--
    <Setter Property="MinWidth" Value="150" />
    <Setter Property="MaxWidth" Value="150" />
    <Setter Property="HorizontalAlignment" Value="Left" />
-->
<!--
    <Setter Property="HorizontalAlignment" Value="Right" />
    <Setter Property="Foreground" Value="Orange" />
-->

现在，我们完成了界面设计。可以按“F5”运行一下，看看用户界面的样子。

上图就是我们设计的Silverlight应用程序。它托管在ASP.NET Web应用程序里。现在就可以使用 SharePoint 客户端对象模型来从SharePoint服务器中读取任务列表数据了。

因为我们要通过类来读取列表的信息，所以首先要创建一个任务类型的类，作为任务的容器。下面是任务类代码。

public class Tasks
{
        public string Title { get; set; }
        public string DueDate { get; set; }
        public string Status { get; set; }
        public string Priority { get; set; }
        public double PercentComplete { get; set; }
}

打开MainPage.XAML.CS文件，添加如下的命名空间

using Microsoft.SharePoint.Client;

添加好命名空间后就可以调用对象模型API了。

下面的示例代码可以从特定的SharePoint站点中获取某列表实例。

void MainPage_Loaded(object sender, RoutedEventArgs e)
        {
            using (ClientContext SharePointContext = new ClientContext(this.SPWebSiteURL))
            {
                this.query = new CamlQuery();
                SharePointContext.Load(SharePointContext.Web);
                this.task = SharePointContext.Web.Lists.GetByTitle("Tasks");
                this.strQuery = @" ";
                query.ViewXml = this.strQuery;
                this.taskLists = this.task.GetItems(this.query);
                SharePointContext.Load(this.taskLists);
                SharePointContext.ExecuteQueryAsync(this.OnSiteLoadSuccess, this.OnSiteLoadFailure);
            }
        }

SharePointContext.ExecuteQueryAsync方法的执行是异步的。该方法使用两个回调函数分别处理成功和失败的返回结果。

如上面的代码所示，如果我们的程序成功执行，它会调用OnSiteLoadSuccess，否则调用 OnSiteLoadFailure。下面是这两个函数实现代码。

private void OnSiteLoadSuccess(object sender, ClientRequestSucceededEventArgs e)
{
    foreach (ListItem item in this.taskLists)
    {
       Tasks objTask = new Tasks();
       objTask.Title = item["Title"].ToString();
       objTask.DueDate = item["DueDate"].ToString();
       objTask.Status = item["Status"].ToString();
       objTask.Priority = item["Priority"].ToString();
       double fraction = Convert.ToDouble(item["PercentComplete"]);
       objTask.PercentComplete = fraction * 100;
       this.SharePointTasks.Add(objTask);
    }
   AddTaskList( this.SharePointTasks);
}

private void OnSiteLoadFailure(object sender, ClientRequestFailedEventArgs e)
{
    MessageBox.Show(e.Message +  e.StackTrace);
}

接下来，我们需要创建一个委托来更新UI。使用Dispatcher.BeginInvoke ，以避免跨线程调用的异常。

private void AddTaskList()
{
    this.Dispatcher.BeginInvoke(new UpdateSilverLightUI(this.AddItemsToLists), this.SharePointTasks);
}
private void AddItemsToLists(List tasks)
{
    foreach (Tasks t in tasks)
    {
        TaskList.Items.Add(t.Title);
    }
}

现在，所有的任务已被添加到Silverlight的Task List中，然后我们要处理的ListBox的SelectionChanged事件，并在不同的文本框中显示相应的值。

private void TaskList_SelectionChanged(object sender, SelectionChangedEventArgs e)
{
    var v = this.SharePointTasks.FirstOrDefault(item => item.Title.Equals(TaskList.SelectedItem.ToString()));
    if (v != null)
    {
        txtTitle.Text = v.Title;
        txtDueDate.Text = v.DueDate;
        txtPriority.Text = v.Priority;
        txtStatus.Text = v.Status;
        txtPercentage.Value = v.PercentComplete;
    }
}

OK，到这里所有的代码编写部分就完成了。但如果你现在尝试运行该应用程序，会得到一个跨域访问异常。因为SharePoint网站宿主在IIS中，而正在运行的应用程序却是在VS里。为了解决这个问题，你必须把clientAccessPolicy.xml文件放到SharePoint站点的根目录。
按F5运行该应用程序。没错，所显示的Silverlight风格的任务列表和前面我们创建的SharePoint列表完全一致。可以点击List中的一个任务来显示详细信息。

至此，我们完成了一个在单独的网站中运行的Silverlight应用，并与SharePoint集成。你可以把这个应用宿主在任何ASP.NET Web应用程序中。

接下来，让我们把这个Silverlight应用程序变得更有趣些，使其可以在浏览器外运行。事实上仅仅是通过VS2010自带的配置工具做一个小小的修改就OK了。

在解决方案管理器中右键点击Silverlight应用程序 >“属性”，然后勾选“允许在浏览器外运行应用程序” 复选框，如下图所示。

点击“浏览器外设置...”可以做更细的配置。您可以修改窗口的高度，宽度和标题等。

完成浏览器外设置后，再运行该应用程序，你会发现它现在和Windows应用程序运行效果很相似.

我们已经实现了在浏览器中和在浏览器外的Silverlight应用与SharePoint 集成。

如何将Silverlight应用作为一个SharePoint Web部件宿主在SharePoint中呢。其实和在一般网站中一样，SharePoint也是通过Silverlight的XAP文件实现宿主的，之前我已经在上次讲地图控件的时候提到过。

首先，我们在与上面的例子相同的解决方案下，新建一个SharePoint 2010项目。选择“ 空白SharePoint项目 ”模板。

为项目命名，然后单击“ 确定 ”。接下来将显示如下的部署向导。

要求输入作为调试的SharePoint网站的位置和部署类型。你可以使用默认的选择。点击“ 确定 ”，完成对SharePoint项目的创建。

现在，我们需要添加一个SharePoint项——模块。模块包含一个待部署的文件，本身需要包含在一个SharePoint项目中。要添加一个模块，可以在SharePoint项目上右击，并点击添加新项。

在SharePoint 2010分类下，选择“模块”，为其命名，点击“ 添加 ”。然后右击该模块，点击“ 属性 ”。

在属性窗口的“ 项目输出引用 ”选择器中，做如下图的设置。

请注意，你需要选择部署类型为“ElementFile”，项目名称应该是Silverlight解决方案的名称。点击确定。这是SharePoint模块的“Element.XML”文件中，会添加到Silverlight的xap文件的路径。通过这种方式可以把Silverlight应用添加到SharePoint网站中，使其成为SharePoint的一部分。

完成我们的SharePoint项目后，就可以编译部署了。右键单击SharePoint项目，选择部署。这样就完成了部署操作。

接下来，我们将其宿主到SharePoint网站的Silverlight Web部件。

Silverlight Web部件和其他Web部件的使用一样。首先你需要打开SharePoint页面的编辑模式，转到插入，选择Web部件。选择“ 媒体与内容 ”类别，选择SharePoint 自带的Silverlight Web部件。点击添加。

你会看到一个Ajax弹出对话框，要求输入Silverlight 应用程序包（XAP ）文件的URL。这里填写上面我们在SharePoint模块的Element. XML文件中指定的URL。

点击确定。运行成功的话，Silverlight Web部件的显示如下图所示。

如果没有写对URL，保存后会看到如下的错误信息。提示你可能提供的XAP文件路径有错误，请重新配置。

这时，你必须首先确保你提供的XAP文件路径是有效的。如果路径有效，再检查一下相应的功能是否已经被激活（可以从网站操作>网站设置中找到管理功能的链接）。

如果愿意，我们可以把SharePoint的任务列表和 Silverlight WebPart放在一个页面上。

这样当我们在任务列表中添加一项新的任务后，新任务同时会反映在我们的Silverlight任务控件中。

如果不想这么麻烦的部署一个XAP文件，也可以简单的把XAP上传到一个文档库中。然后在Web部件中直接指定其在文档库中的路径即可。

当然，你还可以创建一个SharePoint 2010项目，包含一个自定义Web部件宿主Silverlight应用，然后再部署该Web部件。

希望对你有帮助！

参考资料

Silverlight Task Control For SharePoint 2010 - Example of Hight Touch Integration

Microsoft Silverlight 4 Tools for Visual Studio 2010

本文链接

在SharePoint中实现图形可视化

2010-12-22T02:17:00Z

本文介绍了在Codeplex上看到的SPGraphviz项目。http://spgraphviz.codeplex.com。利用SPGraphviz，你可以创建自己的图表，架构图，关系图等，并且无需编程或使用任何外部应用程序即可显示在Sharepoint中。你可以用它来显示一个组织结构，门户网站的层次结构，文件的版本历史记录的图形化表示，或项目整体框架等（可以说其应用场景唯一受限与你的想象力）。这里是一些你可以创建（摘自graphviz图库）的图形的例子：

背景介绍

SPGraphviz是基于开源的图表绘制库Graphviz，这个库是很久以前由AT&T公司的一批专家实现的。它本身是一个C语言的库，SPGraphviz使用David Brown的managed wrapper（有些小的修改）对其进行了包装，从而实现本地调用。图表本身是定义在一个普通的txt文件中的，使用DOT语言来进行描述。这是一种特定的DSL语言，用于定义图表结构（节点，关系，标题）和布局（颜色，大小，方向等）。 DOT是一门相当丰富的语言，但对于简单的解决方案，你不必深入了解。例如，对于下面这样的图表：

这个例子显示了如何使用SPGraphviz来显示门户的层次。我们有根站点，下面有子站点（或子站点集），比如部门下有3个部门的网站，IT部，HR部，销售部。还有一个个人网站的子网站集，根据需要用户可以创建自己的站点（类似MySites）。这个图表可以用下面的DOT的定义来创建：

digraph example {
        size="6,6";
        node [color=lightblue2, style=filled];
        "Start page" -> "Departments";
        "Start page" -> "News";
        "Start page" -> "Personal sites";
        "Departments" -> "IT";
        "Departments" -> "HR";
        "Departments" -> "Sales";
        "Personal sites" -> "Alexey Sadomov";
        "Personal sites" -> "...";
}

这里我们定义了一个有向图(diagraph)（diagraph example{}），然后在它里面，我们指定了节点以及节点之间的关系：

"Start page" –> "Departments";

此外，我们指定一些布局设置：图像大小（size="6,6"）和节点的颜色以及填充样式（node[color= lightblue2，style=filled]）。我觉得这个例子很容易理解，你可以拿来入门，从而开始SPGraphviz的体验之旅。

部署

那么，如何在Sharepoint 中使用SPGraphviz呢？它包含了一个Web部件——SPGraphvizWebPart，可以基于文本文件中的DOT定义渲染一个图形。首先，你需要在服务器上安装SPGraphviz。SPGraphviz也是通过WSP包的方式发布的。详细步骤你可以参考http://spgraphviz.codeplex.com/documentation中的部署文档，这里列出其中的重要步骤：

1.下载并在Web服务器上安装GraphViz库（选择Download>Windows>Stable and developement Windows Install packages）。在安装过程中，请确保您选中向导第一步中的"Everyone"
2.下载SPGraphviz的最新版本。目前，该版本中包含了常规的WSP包。
3.在你的SharePoint服务器上安装SPGraphvizWebPart.wsp。以下是安装步骤：

stsadm -o addsolution -filename SPGraphvizWebPart.wsp
stsadm -o deploysolution -local -allowgac -allcontenturls -name SPGraphvizWebPart.wsp
stsadm -o activatefeature -name SPGraphvizWebPart -url http://example.com

注意：为了使用SPGraphviz，你需要在所有的Web前端服务器上安装Graphviz库。安装完所有必需的组件后，你就可以使用DOT语言来定义你要显示的图形了，定义好后用SPGraphvizWebPart即可将其发布到网页中。

用例

接下来让我们看一个例子，所使用DOT定义还是上面写的那一个。为了要在SharePoint中显示该图，你需要将这个DOT定义文本文件上传到网站集上的某个文档库中。然后，打开一个Web部件页，在页面上添加SPGraphvizWebPart（它应该位于Web部件列表中的Graphviz分组下）。最后一步，你需要修改该Web部件的属性（点击修改共享Web部件），并指定所要显示的DOT文件的URL，直接填写该文件的绝对路径（在Web部件属性编辑器的“自定义设置”组下），单击“应用”（这里有些DOT定义文件位置上的限制。默认情况下，你只能使用与安装SPGraphvizWebPart相同的主机来存放DOT定义文件。http://spgraphviz.codeplex.com/documentation说明文档中，有如何使用外部的主机存储DOT定义的更多内容）。之后，你就可以看到一个基于该DOT定义的图形显示：

以上我描述了非编程的方式在SharePoint中添加图形的步骤。同时，SPGraphviz也为开发人员提供了巨大的机遇。图形的定义是基于文本的形式，这意味着，开发人员可以实现自定义代码，在一些数据的基础上自动创建这样的DOT定义，再设置SPGraphvizWebPart来显示这个定义。例如，可以使用下面的例子，以可视化的方式显示门户的层次：

class Program
{
    static void Main(string[] args)
    {
        if (args.Length != 1)
        {
            Console.WriteLine("Usage: GraphBuilder.exe [url]<SITE_COLLECTION_URL />");
            return;
        }

        Console.WriteLine("digraph sites {");
        Console.WriteLine("node [color=lightblue2, style=filled];");

        using (var site = new SPSite(args[0]))
        {
            using (var web = site.OpenWeb())
            {
                foreach (SPWeb subWeb in web.Webs)
                {
                    iterateSubWebs(subWeb, web.Title);
                }
            }
        }
        Console.WriteLine("}");
    }

    private static void iterateSubWebs(SPWeb web, string parentNode)
    {
        Console.WriteLine("\"{0}\" -> \"{1}\";", parentNode, web.Title);

        foreach (SPWeb subWeb in web.Webs)
        {
            iterateSubWebs(subWeb, web.Title);
        }
    }
}

代码很简单——通过递归遍历所有的网站，并把结果对应的节点添加到DOT定义中。为了获得图形化显示，你需要运行该程序并将输出重定向到一个文件中：

GraphBuilder.exe http://example.com > graph.txt

下面是在我的环境下得到的图形：

如上所述，通过SPGraphviz我们可以实现很多有趣的应用。希望通过本文，可以使你的SharePoint站点更加丰富多彩，使你的客户更满意。也希望你能和我一起分享更多更好的关于SPGraphviz使用方面的想法。

下载链接

你可以从Codeproject (源代码) 或http://spgraphviz.codeplex.com下载到SPGraphviz的最新版本。

参考资料

SPGraphviz:Graph Visualization in SharePoint

作者的blog http://sadomovalex.blogspot.com

更多关于使用SPGraphvizWebPart的例子, 请参考http://spgraphviz.codeplex.com/documentation

DOT 语言参考资料： http://www.graphviz.org/pdf/dotguide.pdf

Graphviz：

本文链接

SharePoint：扩展DVWP - 赠送部分：当“找不到匹配项”时修复Insert表单操作

2010-12-20T17:08:00Z

Richard问了一个很棒的问题：“你是否在设置insert链接的时候遇到过无匹配项( no matching items )的模版？”

是的, 我在使用DVWP时遇到过相同的问题。当列表为空时调用特定的模版，这绝对是个bug。

解决的方法是在SPD的设计视图中，勾选“显示示例数据（Show sample data）” ，来告诉 SPD 模拟有数据的情况。这样至少可以允许我们处理该链接了。在实际情况下页面进行渲染时，还需要进行一点稍复杂的处理。看来我需要为这个系列写一个增篇了。 ;)

I’ll do that.

现在我们就开始。

拨开外壳

打开 edit 和insert 模版非常容易，只需要勾选一些选框就行。然而， SharePoint Designer (SPD) 使底层的XSL发生了重大变化：添加了变量和参数，修改一些已有变量的值，添加新的模版和条件格式，等等。

变量

dvt_1_automode 是一个变量，它告诉 DVWP 是否要绘制 edit 和/或delete 链接。 0 = 否; 1 = 是。打开 edit 和/或 delete 会将其设置为1。

如果edit template 被打开，一个新的参数会创建出来：dvt_1_form_editkey。如果 insert 模版被打开，会创建 dvt_1_form_insertmode 。这两个参数会在点击相应的edit或insert 链接时通过 ParameterBindings 传递给该页面。

<xsl:variable name="dvt_1_automode">0</xsl:variable>

…变成…

<xsl:param name="dvt_1_form_editkey" />
<xsl:param name="dvt_1_form_insertmode" />
<xsl:variable name="dvt_1_automode">1</xsl:variable>

在主模版dvt_1里，, 当 dvt_RowCount = 0，或者 RowLimit = 0时，IsEmpty 变量都被修改为 true 。

<xsl:variable name="IsEmpty" select="$dvt_RowCount = 0" />

…变成…

<xsl:variable name="IsEmpty" select="$dvt_RowCount = 0 or $RowLimit = 0" />

设计

首先要通过SPD进行的一个设计上的修改是：通过清空th标记的nowrap属性来允许列头折行。

<th  nowrap="nowrap">Location</th>
<th  nowrap="nowrap">Group</th>

…变成…

<th  nowrap="">Location</th>
<th  nowrap="">Group</th>

接下来的一个设计上的变更是设置一个条件，通过检验该条件来确定哪个模板会被调用。如果我们不是在插入模式中，它会调用dvt_1.body，传递给它一些行用于显示。然后是dvt_1.rowinsert，传递dvt_1_form_insertmode，决定是渲染插入数据的表单还是只是输出一个插入链接。

然后它会传递ShowNavigation 和ShowFormActions 参数给dvt_1.commandfooter 模版，从而添加 X – Y 分页链接到页脚部分。

<xsl:with-param name="ShowNavigation"> 
     <xsl:if test="not($dvt_1_form_insertmode = '1')">1</xsl:if> 
 </xsl:with-param> 
 <xsl:with-param name="ShowFormActions"> 
    <xsl:if test="($dvt_1_automode = '0' and $dvt_1_form_insertmode)">1</xsl:if> 
 </xsl:with-param>

因此，这两个参数也被添加到了dvt_1.commandfooter模板，并且添加了相关的一些元素，用来在需要时显示他们。

新的模版

在默认的DVWP中， dvt_1.body 模版会遍历所有返回回来的行，为每一行都调用一次dvt_1.rowview 模版。

在更新后的版本中，它仍然会遍历所有的行，但是会检查每一行的dvt_1_form_editkey 是否与该行的ID相匹配。如果是，dvt_1.rowedit 模版会被调用，并传递该行的位置。对与剩下的所有行，会调用 dvt_1.rowview 。

<xsl:call-template name="dvt_1.rowview" />

…变为…

<xsl:choose> 
     <xsl:when test="$dvt_1_form_editkey = ddwrt:EscapeDelims(string(@ID))"> 
        <xsl:call-template name="dvt_1.rowedit"> 
             <xsl:with-param name="Pos" select="concat('_', position())" /> 
         </xsl:call-template> 
     </xsl:when> 
     <xsl:otherwise> 
         <xsl:call-template name="dvt_1.rowview" /> 
     </xsl:otherwise> 
 </xsl:choose>

当然，edit 模版(dvt_1.rowedit) 也要被添加到页面中。（有关使用edit模版的更多信息，请参考扩展DVWP的第26部分：修改edit模版）因此insert 模版大致如下所示：

…becomes…

<xsl:template name="dvt_1.rowinsert">
    <xsl:param name="IsInsertMode" />
    <xsl:variable name="Pos">_new</xsl:variable>
    <tr>
        <xsl:choose>
            <xsl:when test="$IsInsertMode = '1'">
                <xsl:if test="$dvt_1_automode = '1'" ddwrt:cf_ignore="1">
                    <td  width="1%" nowrap="nowrap">
                        <xsl:call-template name="dvt_1.automode">
                            <xsl:with-param name="KeyField">ID</xsl:with-param>
                            <xsl:with-param name="KeyValue" select="ddwrt:EscapeDelims(string(@ID))" />
                            <xsl:with-param name="Mode">insert</xsl:with-param>
                        </xsl:call-template>
                    </td>
                </xsl:if>
                <td >
                    <SharePoint:FormField runat="server" id="ff1{$Pos}" ControlMode="New" FieldName="YourField" {code} />
                    <SharePoint:FieldDescription runat="server" id="ff1description{$Pos}" FieldName="YourField" ControlMode="Edit" />
                </td>
                <td >
                    //The next column
                </td>
                .
                .
                .
            </xsl:when>
            <xsl:otherwise>
                <td  colspan="99">
                    <a href="javascript: {ddwrt:GenFireServerEvent('__cancel;dvt_1_form_insertmode={1}')}">insert</a>
                </td>
            </xsl:otherwise>
        </xsl:choose>
    </tr>
</xsl:template>

注意其中的第6行， IsInsertMode 变量决定了数据控件是否渲染，或者只是输出insert 行。

进一步的修改

在 SPD里，当我们首次把DVWP添加到页面上时，会有一个链接可以让我们设置没有匹配项时所显示的文字。

Now, how do we display the insert link?

Option 1. Since the empty template is being called, we could simply add the insert link to that template as well. In an STP discussion with Richard, Matt Bramer suggested adding the link below the dvt_ViewEmptyText.

SPD 会链接到数据视图属性对话框

当然我们也可以直接打开数据视图属性对话框，之前我们也曾用它来修改直接编辑选项。其中有一项可以设置当没有找到匹配的数据时所显示的文字，这里直接输入一些类似“该视图中没有项目”的文字即可。

当通过SPD的链接打开该对话框时，会自动选中选择框并填充一些默认的文字

但，这也正是会出现问题的地方。

当SPD 添加上面的文本后，它会跳过输出insert链接的 insert 模版。

噢。Insert链接没了！

重返核心

因此，让我们分析一下究竟是什么原因导致的这个问题，并试图对其进行修复。

首先，SPD并没有创建其他的变量，当dvt_RowCount = 0时 dvt_IsEmpty 被设为true。接下来在dvt_1模版的主table外包装了一层xsl:choose块。

<table border="0" width="100%" cellpadding="2" cellspacing="0">
.
.
.

…变为…

<xsl:variable name="dvt_IsEmpty" select="$dvt_RowCount = 0" />
    <xsl:choose>
        <xsl:when test="$dvt_IsEmpty">
            <xsl:call-template name="dvt_1.empty" />
        </xsl:when>
        <xsl:otherwise>
            <table border="0" width="100%" cellpadding="2" cellspacing="0">
            .
            .
            .

换句话说，如果列表为空，主table就不会渲染；直接进入dvt_1.empty 模版，它如下所示：

<xsl:template name="dvt_1.empty">
   <xsl:variable name="dvt_ViewEmptyText">There are no items to show in this view.</xsl:variable>
   <table border="0" width="100%">
      <tr>
         <td >
            <xsl:value-of select="$dvt_ViewEmptyText" />
         </td>
      </tr>
   </table>
</xsl:template>

其中 insert 模版和所有其他的东西一样都被跳过了。这的确不是我们所期望的。

修复它

这就是 SharePoint。里面有不止一种解决问题的方式。

有一点是肯定的，那就是我们必须在列表为空的情况下进入insert模式，使得SharePoint渲染出insert表单来。当点击insert链接时， dvt_1_form_insertmode 被设为1，我们可以以此进行判断。

<xsl:when test="$dvt_IsEmpty">

…改为…

<xsl:when test="$dvt_IsEmpty and not($dvt_1_form_insertmode = '1')">

现在，我们该如何显示insert 链接呢?

选择 1. 因为 empty 模版被调用，我们可以简单的把insert 链接同时添加到该模版中。在与Richard的 STP discussion 中， Matt Bramer 建议将该链接添加到dvt_ViewEmptyText下面。

<xsl:template name="dvt_1.empty">
   <xsl:variable name="dvt_ViewEmptyText">There are no items to show in this view.</xsl:variable>
   <table border="0" width="100%">
      <tr>
         <td >
            <xsl:value-of select="$dvt_ViewEmptyText" />
         </td>
      </tr>
      <tr>
         <td >
            <a href="javascript: {ddwrt:GenFireServerEvent('__cancel;dvt_1_form_insertmode={1}')}">insert</a>
         </td>
      </tr>
   </table>
</xsl:template>

选择 1: 在空列表信息下添加insert 链接

选择 2. 与其放在单独一行里，倒不如直接跟在dvt_ViewEmptyText后面。

<xsl:template name="dvt_1.empty">
   <xsl:variable name="dvt_ViewEmptyText">There are no items to show in this view.</xsl:variable>
   <table border="0" width="100%">
      <tr>
         <td ><xsl:value-of select="$dvt_ViewEmptyText" /> Be the first to <a href="javascript: {ddwrt:GenFireServerEvent('__cancel;dvt_1_form_insertmode={1}')}">insert a list item</a>.
         </td>
      </tr>
   </table>
</xsl:template>

选项 2: 把insert 链接放在空列表信息后

选项 3. 另一种使得insert 模版被调用的方法是将其从xsl:choose 块中移出来，使其必然运行。

<xsl:choose>
    <xsl:when test="$dvt_IsEmpty and not($dvt_1_form_insertmode = '1')">
        <xsl:call-template name="dvt_1.empty" />
    </xsl:when>
    <xsl:otherwise><table border="0" width="100%" cellpadding="2" cellspacing="0">
        <tr valign="top">
            <xsl:if test="$dvt_1_automode = '1'" ddwrt:cf_ignore="1">
                <th  width="1%" nowrap=""></th>
            </xsl:if>
            <th  nowrap="">Your Field</th>
            .
            .
        </tr>
        <xsl:if test="not($dvt_1_form_insertmode = '1')"><xsl:call-template name="dvt_1.body">
            <xsl:with-param name="Rows" select="$Rows"/>
            <xsl:with-param name="FirstRow" select="1" />
            <xsl:with-param name="LastRow" select="$LastRow - $FirstRow + 1" />
        </xsl:call-template></xsl:if>
        <xsl:call-template name="dvt_1.rowinsert">
            <xsl:with-param name="IsInsertMode">
                <xsl:if test="$dvt_1_form_insertmode = '1'">1</xsl:if>
            </xsl:with-param>
        </xsl:call-template>
    </table>
    <xsl:call-template name="dvt_1.commandfooter">
            .
            .
    </xsl:call-template></xsl:otherwise>
</xsl:choose>

…变成…

<xsl:choose>
    <xsl:when test="$dvt_IsEmpty and not($dvt_1_form_insertmode = '1')">
        <xsl:call-template name="dvt_1.empty" />
    </xsl:when>
    <xsl:otherwise><table border="0" width="100%" cellpadding="2" cellspacing="0">
        <tr valign="top">
            <xsl:if test="$dvt_1_automode = '1'" ddwrt:cf_ignore="1">
                <th  width="1%" nowrap=""></th>
            </xsl:if>
            <th  nowrap="">Your Field</th>
            .
            .
        </tr>
        <xsl:if test="not($dvt_1_form_insertmode = '1')"><xsl:call-template name="dvt_1.body">
            <xsl:with-param name="Rows" select="$Rows"/>
            <xsl:with-param name="FirstRow" select="1" />
            <xsl:with-param name="LastRow" select="$LastRow - $FirstRow + 1" />
        </xsl:call-template></xsl:if>
    </table>
    <xsl:call-template name="dvt_1.commandfooter">
            .
            .
    </xsl:call-template></xsl:otherwise>
</xsl:choose>
<table border="0" width="100%" cellpadding="2" cellspacing="0">
    <xsl:call-template name="dvt_1.rowinsert">
        <xsl:with-param name="IsInsertMode">
            <xsl:if test="$dvt_1_form_insertmode = '1'">1</xsl:if>
        </xsl:with-param>
    </xsl:call-template>
</table>

注意其中第一段代码中的第 19-23行被移到了xsl:otherwise 块的外面（对应到第二段代码中的第26-30 行）。但它们还是被包裹到table标记中，因为这些标记是包含在xsl:otherwise 中的， dvt_1.rowinsert 模版中并没有这些标记。

选项 3: 把模版调用移到xsl:otherwise 块外面

选项 4. 就个人而言，我喜欢显示列标题，即使该列表是空的。因此，与上面几个选项类似，我们也可以把标题行从xsl:choose 中分离出来，这样他们就会出现在每一个场景中。（我喜欢第2种方案，所以下面的代码假设你是在empty模版中处理insert 链接的输出。）

<xsl:choose>
    <xsl:when test="$dvt_IsEmpty and not($dvt_1_form_insertmode = '1')">
        <xsl:call-template name="dvt_1.empty" />
    </xsl:when>
    <xsl:otherwise><table border="0" width="100%" cellpadding="2" cellspacing="0">
        <tr valign="top">
            <xsl:if test="$dvt_1_automode = '1'" ddwrt:cf_ignore="1">
                <th  width="1%" nowrap=""></th>
            </xsl:if>
            <th  nowrap="">Your Field</th>
            .
            .
        </tr>
        <xsl:if test="not($dvt_1_form_insertmode = '1')"><xsl:call-template name="dvt_1.body">
            <xsl:with-param name="Rows" select="$Rows"/>
            <xsl:with-param name="FirstRow" select="1" />
            <xsl:with-param name="LastRow" select="$LastRow - $FirstRow + 1" />
        </xsl:call-template></xsl:if>
        <xsl:call-template name="dvt_1.rowinsert">
            <xsl:with-param name="IsInsertMode">
                <xsl:if test="$dvt_1_form_insertmode = '1'">1</xsl:if>
            </xsl:with-param>
        </xsl:call-template>
    </table>
    <xsl:call-template name="dvt_1.commandfooter">
            .
            .
    </xsl:call-template></xsl:otherwise>
</xsl:choose>

…改为…

<table border="0" width="100%" cellpadding="2" cellspacing="0">
    <tr valign="top">
        <xsl:if test="$dvt_1_automode = '1'" ddwrt:cf_ignore="1">
            <th  width="1%" nowrap=""></th>
        </xsl:if>
        <th  nowrap="">Your Field</th>
        .
        .
    </tr>
    <xsl:choose>
        <xsl:when test="$dvt_IsEmpty and not($dvt_1_form_insertmode = '1')">
            <xsl:call-template name="dvt_1.empty" />
        </xsl:when>
        <xsl:otherwise>
            <xsl:if test="not($dvt_1_form_insertmode = '1')"><xsl:call-template name="dvt_1.body">
                <xsl:with-param name="Rows" select="$Rows"/>
                <xsl:with-param name="FirstRow" select="1" />
                <xsl:with-param name="LastRow" select="$LastRow - $FirstRow + 1" />
        </xsl:call-template></xsl:if>
        <xsl:call-template name="dvt_1.rowinsert">
            <xsl:with-param name="IsInsertMode">
                <xsl:if test="$dvt_1_form_insertmode = '1'">1</xsl:if>
            </xsl:with-param>
        </xsl:call-template>
        <xsl:call-template name="dvt_1.commandfooter">
                .
                .
        </xsl:call-template></xsl:otherwise>
    </xsl:choose>
</table>

注意，table标记并没有包含所有xsl:choose中的内容。所以我们需要快速的串一遍整个模版的调用过程，以保证其运转过程和我们预想的一致。

dvt_1.empty 并没有在 table 里，但现在却包进来了。所以要移除其table 标记，以使得其中的tr落入主table中。

<xsl:template name="dvt_1.empty">
    <xsl:variable name="dvt_ViewEmptyText">There are no items to show in this view.</xsl:variable>
    <table border="0" width="100%">
        <tr>
            <td ><xsl:value-of select="$dvt_ViewEmptyText" /> Be the first to <a href="javascript: {ddwrt:GenFireServerEvent('__cancel;dvt_1_form_insertmode={1}')}">insert a list item</a>.            </td>
        </tr>
    </table>
</xsl:template>

…变成…

<xsl:template name="dvt_1.empty">
    <xsl:variable name="dvt_ViewEmptyText">There are no items to show in this view.</xsl:variable>
    <tr>
        <td  colspan="99"><xsl:value-of select="$dvt_ViewEmptyText" /> Be the first to <a href="javascript: {ddwrt:GenFireServerEvent('__cancel;dvt_1_form_insertmode={1}')}">insert a list item</a>.        </td>
    </tr>
</xsl:template>

我们需要添加 colspan="99" 到 td 上，以确保其横跨整个由列头创建的table。

dvt_1.commandfooter 同样也是在table外，但现在被包进来了。所以也要做同样的修改。

<xsl:template name="dvt_1.commandfooter">
    <xsl:param name="FirstRow" />
    <xsl:param name="LastRow" />
    .
    .
    <table cellspacing="0" cellpadding="4" border="0" width="100%">
        <tr>
            <xsl:if test="$ShowFormActions = '1'">
                <xsl:call-template name="dvt_1.formactions" />
            </xsl:if>
            .
            .        </tr>
    </table>
</xsl:template>

…改为…

<xsl:template name="dvt_1.commandfooter">
    <xsl:param name="FirstRow" />
    <xsl:param name="LastRow" />
    .
    .
    <tr>
        <xsl:if test="$ShowFormActions = '1'">
            <xsl:call-template name="dvt_1.formactions" />
        </xsl:if>
        .
        .    </tr>
</xsl:template>

选项 4: 包含列头（也是用的选项2的方法输出的insert链接）

至此，我们通过少许更改，修正了SharePoint默认的功能，使得在空列表的情况下可以显示插入链接。

参考资料

SharePoint：Extending the DVWP - Bonus:Fixing the Insert Form Action When "No Mathcing Items"

本文链接

TechED 2010中国上的SharePoint讲师团

2010-11-26T08:12:00Z

从http://teched2010.registermsg.com/content/speaker.aspx上找出来的。所有SharePoint方向的讲师。方便SharePoint爱好者们选课和参与讨论。

郭晓颖

于2007年加入微软中国研发集团服务器与开发工具事业部，担任开发工具部门项目经理一职。现主要从事于Visual Studio对SharePoint的工具支持。在过去的四年中，晓颖曾参与了多个项目的研发工作： • 2007年，晓颖致力于Silverlight 2运行时（即Core CLR）的开发，并参与了Visual Studio 2008中C++类设计器的研发工作。 • 2008年，晓颖致力于.NET框架4.0中CLR Interop的增强，为开发人员提供更多有用的工具和API，从而提高开发人员在处理非托管及托管代码互通性时的效率。 • 从2009年起，晓颖参与了WCF RIA Services 1.0工具支持，以及Visual Studio 2010中和数据有关的开发工具的设计研发，如数据源窗口相关的功能等。 • 从2010年起，晓颖开始为下一个版本的Visual Studio设计提供SharePoint开发相关的工具，努力为SharePoint开发人员提供更好的开发体验。

马健

天翼博雅科技发展有限公司解决方案研发部经理，微软（中国）有限公司特邀解决方案顾问，微软全球最有价值专家（MVP），微软（中国）特约资深产品开发和技术架构培训师。参与多次 Microsoft POC 计划，并主持开发微软工作流、OBA、BPOS 等解决方案，具有丰富的技术架构和技术验证经验。目前负责 Microsoft SharePoint 产品和 Microsoft EPM 解决方案全国客户培训工作和推广计划。

马靖

以微软ASP.NET技术为基础，擅长SharePoint开发以及扩展开发，研究SharePoint本身在各个领域中的应用和解决方案，并进行不断的实践。对于SharePoint和微软各个技术的结合很感兴趣。希望能结交更多的朋友，对于SharePoint不了解的朋友可以尽情的向我发问，我将尽力为您介绍、解决问题。

韩梅

微软最有价值产品专家（MVP）,从2000年开始从事微软产品的课程培训工作，并同时负责为多家知名企业提供相应的技术培训和技术支持，曾协助微软完成新一代商业软件平台发布会和明智IT等重要活动。现负责微软CIE(客户体验之旅)的培训工作，同时为微软重要客户和全国市场提供UC和 SharePoint培训服务、解决方案和技术支持。

侯钟雷

清华大学计算机系研究生毕业,曾获得全国大学生电脑大赛一等奖。长期从事微软相关技术的研究,熟悉.net技术和相关服务器产品，主要的技术方向是协作软件,内容管理,企业信息门户等。曾参与过多个基于微软产品的项目开发工作。精通微软SharePoint，RMS，Infopath,，CRM等软件的应用和开发,尤其擅长Office System解决方案，是微软Office专家俱乐部成员，微软资深讲师。

纪宁

东方瑞通(北京)咨询服务有限公司讲师，微软认证讲师（软件开发方向），熟悉Windows Server、SharePoint Server、OCS以及Visual Studio系列产品，了解基于C#和C++的开发技术。

靳涛

本科现任神州数码（中国）有限公司信息化管理部开发经理，专注于微软相关技术在大型企业中的应用。热衷于.NET平台开发，sharepoint，dynamic crm等在企业内部应用中的解决方案。

涂曙光

拥有超过7年的 SharePoint 平台设计、开发与管理经验。在加入 HP 公司之前，他在微软公司以 SharePoint 产品技术专家的身份工作了5年。涂曙光拥有所有 SharePoint 相关的 MCP 认证证书，并曾经编撰或翻译过3本
SharePoint 技术书籍。

王兴明

连续7年获得Visual C#技术方向MVP称号，曾获得微软认证系统开发工程师（MCAD、MCSD）,微软认证讲师（MCT），2004年获得微软金牌认证讲师（开发类）。他作为资深.NET系统架构师，对WCF分布式应用、Web应用、Biztalk、SharePoint等微软平台技术有深刻的见解和广泛的大型企业级应用经验。

如有遗漏，欢迎补充！

本文链接

一步一步开发属于自己的SharePoint 2010工作流

2010-11-22T11:38:00Z

从Sharepoint 2007开始，工作流作为一个真正的强有力的工具内置在SharePoint中。你可以通过设计工作流，从而在网站或应用程序中添加自定义逻辑，而且不需要编写任何代码！通过工作流实现业务流程自动化所需的各种功能，从发送通知到创建任务这么简单的事都可以通过工作流完成。还有的很多可能性，许多的功能有待挖掘，可以说只是受限于你的想象力。

本文将讨论如何能够非常容易地开发属于自己的SharePoint 2010的工作流，甚至不需要你必须懂开发，这里不会要你写任何自定义的代码，您要做的只是点点鼠标。首先我们需要一个切入点，以此触发一个工作流的启动，作为例子，我们使用当某人添加项目到列表中作为触发的条件。在我们的解决方案中，我们将开发一个工作流，该工作流基于列表中某一栏的值的选择状态，当为选中状态时，将触发工作流发送一封email，同时更新该列表项的状态。通过这个例子，我想应该能够涵盖工作流的绝大部分重要概念，如步骤，条件和操作等。

让我们开始吧！

首先创建一个列表，这是列表的结构。

解释一下每一列都是干什么用的。

标题，将来就是所发送的邮件的主题
User Email - 用户电子邮件，收件人的邮件地址
Message To user – 电子邮件中的具体信息
Status - 状态，当前列表项的状态（可选择项包括已开始 - Started, 已发送电子邮件 - Email Sent, 进行中 - Processing, 已解决 - Resolved）
Send Email - 发送电子邮件，标记是否要给收件人发送电子邮件。

创建好列表后，启动Sharepoint Designer来开始创建我们的工作流。首先点击列表和库（Lists and Libraries）。

选择我们的列表，找到工作流部分，点击新建（New)。

向导会提示你填写工作流的名称和描述

点击确定后就进入工作流设计器界面了。

此时，如果你留意功能区，就会看到有一个条件按钮和一个操作按钮，还有一些其他的元素，这些都是设计工作流所用的核心元素。详细查看其中的项，有助于我们了解当前可以做的所有事情。

工作流操作项

工作流条件项

在第1步里，我们选择“发送电子邮件(Email users)” 操作（这意味着，当工作流启动时，它会发送电子邮件给您所选择的特定用户）

现在，定义一下电子邮件的信息。

在“收件人（To）”的位置上，选择用户。在这里，我们选择存放在列表项中的的电子邮件地址。

我们选择之前在列表中创建的“用户电子邮件（User Email）”栏。

在抄送（CC)的位置，我们将添加创建当前项目的用户（User who created current item）。

对于标题，我们会从列表的“标题（Title）”栏中取值。

而对于内容部分，我们将从列表中的“发给用户的信息（Message to user）”栏，以及“修改者（Modified by）”栏进行取值。

恭喜！至此你已经完成了你的第一个操作。现在让我们添加一个执行该操作的条件。

点击我们创建好的第一个操作的顶部。

新增一个一般条件，“如果任何值等于值（If any value equals value）”，意思是，如果当前项中某一列的值等于你所定义的值时，将触发一个操作。

这样，该条件就显示在你的第一个操作的顶部。

根据你的情况修改其中的值，因为这里我们需要当“发送电子邮件（Send Email）”字段的值为“是”时引发一个动作，所以这么定义：

你可能已经注意到了，前面创建的第一个操作并没有包在IF块中，所以我们需要向上移动一下它，可以通过右侧的下拉箭头，然后从中选择上移操作（Move Action Up）。

这样就把它放在IF块里面了。

接下来，我们还需要在发送完电子邮件后更新域“Status”的状态为“Email Sent”。为了实现这一功能，我们需要通过功能区的操作按钮添加另外一个操作，“设置当前项目中的域（Set Feild in Current Item）”。在此前，确保您已经点击了第一个操作的下方，以保证新的操作将来放在那里。

设置字段和值的属性。

对于ELSE块，从功能区中选择“Else-If分支”

重复上一步骤，但这次是设置“Status”为“Processing”

这样全部工作就完成了！保存并发布您的工作流。

接下来等待一下，系统对工作流进行验证。

但是我们还没有设置工作流启动的条件。可以通过点击工作流，选择我们的工作流对象，然后在摘要视图中配置工作流的启动选项。

现在，剩下的工作就是测试了。新建一个列表项来触发前面设计的条件。

然后等待结果

OK了！很容易吧，无代码！

参考资料

Step by Step Guide in Developing your own Workflow in Sharepoint 2010

本文链接

SharePoint 2010之Visio Services入门1－2－3

2010-11-21T09:43:00Z

问题

你一定已经听说过SharePoint 2010中新增加的 Visio Services 了吧，通过它用户可以在浏览器中直接查看Visio文档。现在，就让我们开始体验一下吧！

解决方案

对用户来说在浏览器中显示Visio文件实际上很简单。但除非内已经完成了下面的步骤，否则相关的使用项并不是很显而易见的。

一个大的前提条件，就是你必须同时具有SharePoint 2010企业版和Visio 2010，才能继续下面的步骤。

步骤 1 - 启用 Visio Services

打开 --> 网站操作（Site Actions） -->网站设置（Site Settings）.

然后点击 "管理网站功能（Manage site features）".

如果你的SharePoint Server企业版网站功能（SharePoint Server Enterprise Site features）没有激活，则点击“激活（Activate）”按钮。

Here is what it should look like:

步骤 2 - 配置文档库

现在，导航到一个准备供用户存放发布的Visio文档的文档库，来设置其在浏览器中查看的选项。进到文档库设置页面，并点击高级设置（Advanced Settings）。

设置 “在浏览器中打开文档（Opening Documents in the Browser）”项为“在浏览器中打开（Open in the browser）”。

步骤 3 - 发布一个 Visio 2010 文档

创建好我们的 Visio 文档后，选择文件（File）菜单下的另存为（Save As）。

在文件名（File name）文本框中，粘贴我们的文档库所在的网站的URL地址。

导航到该库（双击）。

给我们的文件起一个名字。

关键点: 在保存类型（Save as type）下拉框中选择Web绘图（Web Drawing）。然后按回车或点击保存（Save）。

下面是在我的浏览器中查看 Visio 文件的效果。

简单吧！1－2－3！

参考资料

3 Easy Steps to Visio Services in SharePoint 2010

本文链接

SharePoint：扩展DVWP - 第35部分：把所有的内容串起来

2010-11-20T17:32:00Z

“真正”的标题为：我如何创建一个SharePoint 列表来替换一个原先每月在15个经理手里转一圈的Excel电子表格，通过为每一个经理创建一个Web部件页来显示一个有关雇员信息的经过过滤后的可编辑的表格，易于阅读和修改。其中会用到Tab页，网站栏，级联下拉框，DVWP，EasyTabs,表单操作工作流，PreSaveAction()，SPServices/jQuery，XSL以及CSS的知识。

终于，我们进行到扩展DVWP系列的第35部分。在过去的18周内，我们分析了工具本身，技术，进行了各种尝试，修复遇到的错误，实际上是针对同一个解决方案，最终是为了解决如下的一个简单问题：

问题: “我有一个需要每个月都重新创建一次并发给15个经理的Excel 文档。每个经理都负责15个文档中之一，但是我要把所有的电子表格都发给每一个经理，并希望他们更新其中正确的部分。我也要很小心，只能在特定的字段处填写数据，并且要注意不要把之前设定好的公式给盖掉。
有没有办法通过SharePoint改善这一切？”

我们的解决方案满足具备下列需求：

• 避免通过email的方式将文件传来传去
• 可以使每一名经理方便的对他们自己那一部分的数据进行查看和修改
• 为高层管理者提供一个试图可以查看所有区域的所有雇员
• 对当前数据的修改要进行审计，支持历史记录报告。
• 使常规的修改尽可能容易
• 使非常规的修改尽可能变得直观
• 给经理提供多样化的雇员视图，根据雇员类别进行聚合
• 提供小计和总计功能

最终的效果类似下面这样：

完整指南

那个看起来很像Excel电子表格的WebPart是数据视图Web部件（DVWP），通过它我们可以在页面中显示某个区域的所有雇员，并可以直接在页面中进行编辑。因此，我们将从DVWP着手，将其扩展以满足我们的需求。
有关该项目的所有内容都包含在其自己的子网站中，所以主页和快速启动区域都是与雇员(Full-Time Employee,简称FTE)项目相关的。所以新建页面时最容易的方法是直接创建一个和默认主页相同功能的页面（因此也包含快速启动），通过SPD可以直接基于现有的页面进行创建。

右击 default.aspx ，在上下文菜单中点击 New from Existing Page

我们并不需要这上面的这些webpart，但可以很方便的基于此页进行修改：

我们的新创建的web部件页是基于该站点的default.aspx页

假设我们将来会用到共享文档这个库，比如放一些希望共享的文档……没关系，让我们新建一个别的文档库来存放我们新创建的页面，这里将新建一个名为Locations的文档库。

• 在 Web Site 选项卡下，在窗口中右击打开上下文菜单。

在窗口中右，选择 New -> SharePoint Content…

• 选择 Document Libraries 下的Document Library，并为新库起一个名字

选择Document Libraries 下的Document Library，并填写一个名称

• 在你新建的文档所在选项卡下，点Save，将其保存到新建的库。

将新建的页保存到新建的文档库，这里我起名为 LocationsMaster.

现在，有了一个可以开始操作的页面了。在本例中，我们不需要右侧的web部件区域。与其直接删除该区域，不如删除包裹右侧区域和之间空格的外层TD。

很简单，如上图中的步骤1-2-3…噢，还有4

在拆分视图中，点击设计视图中的图片WebPart。将会在代码视图中选中整个webpart的HTML/XSL内容，同时还将在标记面包屑导航条上高亮该ImageWebPart。
如果我们点击标记条中的 WebPartZone#Right，整个web部件区域的 HTML/XSL 会被选中——包括其中的webpart——也会被选中，但不包括其外层的ID。
该标记左侧紧挨着的就是TD，点击该标记会选中整个TD。
同时，我们还想删除前面的一个TD，所以按住 Shift 键，并点击上面第244 行中TD标记的左侧（你的行号可能不同）来选中它。

这是再通过 Delete 键将所有这些都删掉。

在设计视图中，我们看到右边这块还是有一大片空白。

删掉右侧的Web部件区域后留下一大片空白。我们将会把它给填上。

为了将左侧区域拉伸到右侧：

点击左侧区域红的某个webpart，然后
在标记面包屑导航条中点击最近的td，以便
在代码视图中定位到该td标记的顶部，这里你会
注意到宽度被设置为70%.
修改为 100% 后将收回我们的失地。同时…
我们发现在这下面还有一个td，所以
删除它，这样我们的DVWP就可以填满整个区域了

对于 Announcements 和Calendar，我们不需要删除WebPart区域，只删webpart。所以，对与每一个webpart：

在设计视图中点击该 webpart，
鼠标悬停在标记面包屑导航条中高亮显示的标记上，
点击下箭头打开上下文菜单，然后
选择 Remove Tag

现在我们就可以添加DVWP。

添加DVWP

现在我们有了一个页面，可以作为我们DVWP的外壳。现在就开始创建我们的DVWP。

点击WebPart区域中的链接，以便在SPD中将其高亮选中。

根据链接的指示去操作

这样就可以使该WebPart区域进入可以插入WebPart的状态，以便接受DVWP。

点击 Insert -> SharePoint Controls -> Data View

SPD 继续提示我们进行接下来的步骤。

在 Data Source Library 选项卡下，点击包含你所要数据的列表旁的下拉框。然后，点击 Show Data.

• SPD 将切换到 Data Source Details 选项卡，在这里我们可以选择要包含的字段。

注意: SPD 将会根据我们在数据源详细信息面板中点选的顺序把选中的字段以从左到右的顺序铺在DVWP中。按住Ctrl键再点击可以选中多个栏，同时决定将来显示的顺序。
• 当我们有了想要的字段，就可以点击 Insert Selected Fields as…

……然后选择 Multiple Item View。

DVWP初始载入的状态

格式化DVWP

现在，页面上已经有了DVWP，接下来就可以开始对其进行自定义了，首先是通过配置界面进行修改，这样就可以最大限度的减少XSL的修改。
对于我的项目有一点很明确的需求就是使用多个DVWP来管理数据，而不是一块一块的每次看10项。

格式化数据视图属性：分页

红框框住的链接将打开数据视图属性（Data View Properties）对话框的分页（Paging）选项卡。

你也可以通过菜单将其打开： Data View -> Paging…

默认情况下，分页设置为10项。我们将选择 Display all items。

在这个窗口中，我顺便修改一些其他的设置。

格式化数据视图属性：列标题排序

允许用户在页面中进行排序是一个很好的体验，所以我们从 General 选项卡下将该项设置启用。

默认设置是没有工具栏。我们将“对列标题启用排序和筛选” （Enable sorting and filtering on column headers）。

格式化数据视图属性：编辑

我们允许用户可以在DVWP上进行插入，编辑和删除操作，所以让我们在“编辑”(Editing)选项卡下将其开启。

所有的操作链接默认都是关闭的。我们把3个都勾选上。

开始的几个DVWP扩展: 直接编辑，不分页，和列标题排序/筛选。

我花了一小会儿才在SPD中加载出数据，因为我有486 条记录。当然我不希望我的用户必须一次加载这么多的数据，所以让我们添加一些筛选和分组条件。

格式化数据视图属性：筛选

筛选DVWP 可以使我们根据Location把列表数据分成几块。

像分页（Paging）一样，你也可以通过菜单打开筛选条件对话框： Data View -> Filter…

格式化数据视图属性：排序和分组

我们希望对现有数据进行排序和分组。

默认情况下是按创建时间（Created）升序排列的。我们改成按 Group 进行分组，同时按 Worker进行排序，均为升序。

格式化数据视图属性：编辑列…（Edit Columns…）

现在我们会根据Location 进行筛选并根据 Group进行分组，所以不再需要显示这两列。

通过高亮选中列并点击<< Remove移除 Location 和 Group 列。

格式化数据视图布局：WebPart标题，列标题，和显示格式

在开始扩展我们的解决方案前，还有其他一些小的微调工作。

标题

由于我们打算将相同的一个WebPart用于多个区域，所以需要方便的对WebPart的标题进行修改。

这个WebPart默认的标题是所显示的列表的名称。我们将把它修改成Operations 以便反映出我们设置的筛选项。

列标题

现在我已经有了一个载入数据的部件，HR部门决定把列标题修改成他们自己的术语：他们希望看到"Job Title" 而不是 "Position," "Employee" 而不是 "Worker," "Shift"而不是"Work Shift," "Effective"而不是 "EffDate."
每个列标题都包含在一个名为dvt.headerfield的模版中，传一个显示名称。

在设计视图中点击列标题，以便在代码视图中高亮对应的模版调用。

在该模版（template）中， fieldtitle 和 displayname这两项是修改标题行文本时必须要改的。 (见第 245-6行)：

<xsl:call-template name="dvt.headerfield" ddwrt:atomic="1" xmlns:ddwrt="http://schemas.microsoft.com/WebParts/v2/DataView/runtime">
    <xsl:with-param name="fieldname">@Positions</xsl:with-param>
    <xsl:with-param name="fieldtitle">Job Title</xsl:with-param>
    <xsl:with-param name="displayname">Job Title</xsl:with-param>
    <xsl:with-param name="sortable">1</xsl:with-param>
    <xsl:with-param name="fieldtype">x:string</xsl:with-param>
</xsl:call-template>

修改列标题后

显示格式

Effective Date 的时间部分实际上没有什么意义；可以看到在这里总是显示12:00 AM。让我们通过修改数据格式来将其隐藏。

日期格式默认是显示时间的。我们取消选中 Show Time 复选框以将其改成只显示日期。我们还可以修改日期的显示格式。

扩展DVWP

至此，我们已经完成了格式化的工作，现在可以开始扩展DVWP了。
首先要做的是重新排列栏，把edit 和delete 链接放在页面右侧。我们必须在默认值模版，编辑模版，以及插入模版上都操作一遍。

接下来，我们把所有的表单操作链接放在一行中，并把其中的几个变成按钮的形式。

根据我们的需要对外观进行修改后，我们将打开这些操作链接，研究一下它们的工作原理，添加一个PreSaveAction()，挂接一个工作流，重新排列执行顺序，并修复其中的错误。

然后，我们将传递一些工作流变量给该工作流，通过变量传递一些信息，并添加更多信息，添加更多的变量用于jQuery和PreSaveAction()，以便进行表单验证，或者进行审计记录的写入。

为了使用户输入数据或者修改数据变得更容易，我们创建了一些网站栏，加载上数据，并在网站栏间创建关系列表（并通过两种方式中的一种来填充数据）。接着我们就可以把这些网站栏和关系列表加工成级联下拉框（分别实现了两级和三级联动）。

有时，我们会填充大量的数据，所以设置一些默认值将对我们非常有利。比如，在我们的关系列表中，Title基本上是多余的。它只是为了告诉我们两个存在关系的栏中是什么内容的数据。我们可以让SharePoint 利用jQuery自动填写该数据。或者我们也可以引发一个工作流来做这件事情。

现在我们的数据流转的很好了，我们可以设置一个审计跟踪功能来捕获对该列表进行的任何修改。

由于我们的编辑模板（edit template）和我们的默认值模板（default template）看起来很类似，所以用户可能会感到迷惑，不清楚自己当前处于什么状态。因此，我们需要修改编辑模板，通过一些简单的图形化元素使该状态变得更加明显些。同时，我们还可以创建另一个版本的编辑模板，来捕获当一个列表项删除时的信息。这个remove模板可以被单独格式化，以便满足我们的需求。我们甚至可以独立于编辑模板，单独修改其表单操作工作流。

为了将大量数据展现给不同的用户时变得更直观，我们需要重用前面创建的WebPart，通过Christophe Humbert的Easy Tabs代码以及内容编辑器（Content Editor Web Part ，简称CEWP ）添加所需数量的DVWP，来对应不同的区块，每一个只需要修改一下筛选和排序条件即可。

在保存该WebPart前，我们还应该对insert模板进行一些修改以填入默认值。但是要注意，我们是在多个DVWP的情况下，所以需要有一些特殊的考量以保证我们的默认值设置到正确的tab页上。

最后，为了使其看起来更棒，我们格式化了一下总计和小计行的外观，并用图标替换了一些表单操作链接。

重用我们的WebPart

我们花了18周才进行到这儿。如果让你没创建一个tab页，或者一个新的Location后将每一步重做一遍显然是一件很恐怖的事情。幸运的是，我们不必这么做。我们只需要导出之前改好的WebPart并重用它即可。

我们将在浏览器中来操作。

点击网站操作（Site Actions ）->编辑页面（Edit Page）。
点击WebPart右上角菜单编辑（edit） -> 导出（Export…）

将它保存到一个容易找到的地方。

然后，当我们要用到它时，我们只要：

点击 Add a Web Part 按钮
点击 Advanced Web Part gallery and options
点击 Browse… 按钮
定位到你的WebPart并点击 Open
点击 Upload 按钮
把该WebPart拖到页面上
为页面中的每一个tab重复该步骤
在每个tab中，为该tab调整筛选，排序和分组
最后，点击 Exit Edit Mode

进球了!

尽管我们已经到了扩展DVWP系列的尾声部分，但实际上还只是触碰了数据视图WebPart整个功能的冰山一角。DVWP更多的功能还有待于大家在将来的工作中继续挖掘。

我很荣幸献上这一系列的内容，同时也很希望能听到您关于DVWP使用方面的奇思妙想。

赠送部分

最近来自社区的朋友问到如何在空白的列表中处理insert表单操作链接遇到的问题。我的解决方案将作为本系列的赠送部分附上。敬请期待！

参考资料

SharePoint:Extending the DVWP - Part 35:Putting it All Together

本文链接

在SharePoint 2010中创建自定义字段类型

2010-11-14T15:15:00Z

网站栏已经为一般用户和开发者提供了非常好的可重用的能力。更进一步，你可以定义一个可重用的栏定义，这将为我们带来更大的灵活性。配合Microsoft SharePoint Foundation 2010，你可以将创建自定义字段类型的门槛降得很低。

下面是创建一个自定义字段类型的总体步骤。你也可以参考这个msdn How to Video 视频。

创建一个自定义字段控件的过程为：

1. 创建一个public 的自定义字段类型的类，并继承自某个内置的字段类型类，比如SPFieldBoolen，SPFieldChoice，或 SPFieldText。
2. 创建两个public的构造器，接收特定的参数，并传递给相同参数的父类的构造器。

3. 创建一个XML文件，作为该字段类型的部署文件。你必须将其部署到一个指定的目录中，并且需要在场级别激活该自定义字段类型。

创建自定义字段类

你必须把自定义字段类定义为public的，并且为其提供两个非默认的构造器。本例同时还展示了如何通过覆写GetValidatedString方法使用正则表达式验证字段的值。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using Microsoft.SharePoint;

namespace WingtipCustomFields {
public class ProductCode : SPFieldText {

public ProductCode(SPFieldCollection fields, string fName) : base(fields, fName) { }
public ProductCode(SPFieldCollection fields, string tName, string dName) : base(fields, tName, dName) { }

public override string DefaultValue {
get { return “P001″; }
}

public override string GetValidatedString(object value) {

if (!value.ToString().StartsWith(“P”))

{ throw new SPFieldValidationException(“Product code must start with ‘P’”); }

if (value.ToString().Length != 4)

{ throw new SPFieldValidationException(“Product code must be 4 chars”); }

// 在写入内容数据库前总是转换成大写的
return value.ToString().ToUpper();
}
}}

创建该字段类型的部署文件

字段类型的部署文件包含了由 Collaborative Application Markup Language (CAML) 定义的自定义字段类型。你必须以这样的格式命名该文件 fieldtypes*.xml 并将其部署到14\TEMPLATE\XML 目录下。下面的例子文件被命名为 fldtypes_WingtipCustomFields.xml。

<FieldTypes>
  <FieldType>
    <Field Name="TypeName">ProductCode</Field>
    <Field Name="ParentType">Text</Field>
    <Field Name="TypeDisplayName">Product Code</Field>
    <Field Name="TypeShortDescription">Wingtip Product Code</Field>
    <Field Name="UserCreatable">TRUE</Field>
    <Field Name="FieldTypeClass">
      WingtipCustomFields.ProductCode,
      $SharePoint.Project.AssemblyFullName$ 
   </Field>
  </FieldType>
</FieldTypes>

注意 -

Microsoft Visual Studio 2010 中的SharePoint部署工具允许你使用 $SharePoint.Project.AssemblyFullName$ 占位符来表示实际的组件名称。当你编译源文件并打包成解决方案包时SharPoint会用实际的组件名称替换该占位符。

参考资料

Custom field type in SharePoint 2010

本文链接