博客园_老猴的快乐

SharePoint 2010问题集锦 (2011.2)

2011-02-23T07:46:00Z

问：	如何修改SharePoint默认的任务通知邮件的格式？
答：	SharePoint的通知邮件(Alert)模板存储在配置数据库里，所有的通知模板的定义位于Local_Drive\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\Template\XML\Alerttemplates.xml文件中。而AlertTemplates.xml文件中的资源变量，如：$Resources:Alerts_anything_filter_shortname，保存在Local_Drive\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\Resources\core.(Language).resx。通过core.(Language).resx文件，我们可以修改通知邮件的标题，但要修改邮件的内容体，我们需要修改Local_Drive\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\(LCID)\Workflow\下的.Action文件。
问：	SharePoint 2010与Office 2010安装在一台服务器上，当用Office打开SharePoint文档库中的文档时，遇到“Word在试图打开文件时遇到错误，请尝试下列方法：检查文档或驱动器的文件权限，确保有足够的内存和磁盘空间，用文本恢复转换器打开文件…”。该如何解决？
答：	如果遇到这类错误（如下图），请按如下方法解决：关闭Office保护视图：打开Word, PowerPoint或Excel，点击Office Backspace -> 选项-> 信任中心-> 信任中心设置 -> 受保护视图 -> 取消所有的受保护视图选项。（注：如果要使用Office OneNote 2010，请确保激活Windows Server 2008 R2的“桌面体验”。

本文链接

SharePoint 2010问题集锦 (2011.1)

2011-02-18T07:34:00Z

问：	如何用代码判断SharePoint 当前显示的语言类型？
答：	SharePoint通过安装语言包可以显示不同的语言。如果浏览器默认的语言是简体中文则显示简体中文界面，如果是英文则显示英文界面。当然，用户也可以手工选择要显示的语言。可以通过如下代码来判断用户当前选择的语言类型： System.Globalization.CultureInfo.CurrentUICulture;
问：	SharePoint用户偶尔会要求再次输入用户名和密码，错误提示：“Error: An existing connection was forcibly closed by the remote host”，日志文件提示：“Unknown SQL Exception 10054 occurred. Additional error information from SQL Server is included below. A transport-level error has occurred when sending the request to the server. (provider: TCP Provider, error: 0 - An existing connection was forcibly closed by the remote host.)“。该如何解决：
答：	这个问题的产生与传输层有关系。建议： 1. 首先升级网卡驱动； 2. 禁用SharePoint Server和SQL Server上的TCP Chimney Offload：Netsh int ip set chimney DISABLED 3. 禁用相关服务器上的Lookbackcheck：注册表->HKLM\System\CurrentControlSet\Control\Lsa,->创建DWORD类型的DisableLoopbackCheck=1,->重启服务器；
问：	如何创建能够继承站点左面导航(Left Navigation)的Web Part页面？
答：	步骤如下： 1. 创建一个Web Part页面，这时的页面默认只继承了顶部导航(Top Navigation)； 2. 打开SharePoint Designer，打开并编辑上一步创建好的页面；最好把原始页面备份一下； 3. 选择“高级模式”，切换到“代码”模式； 4. 搜索“Body s4-leftpanel”，找到后把下面的内容注释掉： <%-- <style type="text/css"> body s4-leftpanel { display:none; } .s4-ca { margin-left:0px; } </style> --%> 5. 搜索“PlaceHolderNavSpacer”，把如下内容也注释掉： <%-- <asp:Content ContentPlaceHolderId="PlaceHolderNavSpacer" runat="server"></asp:Content> <asp:Content ContentPlaceHolderId="PlaceHolderLeftNavBar" runat="server"></asp:Content> --%> 6. 保存一下，就会看到左边导航出现了！
问：	SharePoint与AD-RMS的关系
答：	当用户向一个启用AD-RMS保护的文档库上传文档时，如果这个文档预先已经启用了IRM或者其它保护措施，SharePoint并不会截除加密，而只是把它存放在内容数据库，但这会导致这个文档无法被搜索和索引到；相反，如果这个文档没有启用IRM，那么文档只是在被用户下载时才会附加文档库的RMS信息，这样的文档可以被搜索和索引。
问：	如何使用FAST for SharePoint对非SharePoint站点建立索引？
答：	· Exchange - http://technet.microsoft.com/en-us/library/ff473167.aspx · Lotus - http://technet.microsoft.com/en-us/library/ff715346.aspx · Documentum - http://technet.microsoft.com/en-us/library/ff756030.aspx
问：	SharePoint是否可以安装到只读Read-Only域控制器？
答：	不可以。http://support.microsoft.com/kb/970612 如果安装到只读域控制器上，People Picker就无法解析用户。
问：	如何调整FAST能够检索的文档的最大大小？
答：	默认大小：16MB（16384KB）。可以通过PowerShell进行更改。比如：更改为20MB。 Set-FASTSearchMetadataManagedProperty -Name body -MaxIndexSize 20480

本文链接

Excel REST使用方法

2010-12-08T03:05:00Z

REST 语法：http://server/_vti_bin/ExcelRest.aspx/Shared%20Documents/File.xlsx/Model/

资源名称	访问内容…
/Model	The workbook (the binary or the available feeds)
/Model/Ranges	List of named ranges in a workbook (some of them)
/Model/Ranges('RangeName')?$format=html	Specific range.
/Model/Charts	List of charts
/Model/Charts('ChartName')?$format=image	Specific Chart
/Model/Tables	List of tables (Lists)
/Model/Tables('TableName')?$format=html	Specific table
/Model/PivotTables	List of PivotTables
/Model/PivotTables('PivotName')?$format=html	Specific PivotTable
Model/Ranges('('Sheet1!A1\|D4'')?$format=html	Normal Range
Model/Charts('ChartName')?$format=image&Ranges('FiscalYear')=2008&Ranges('Sheet1!A1')=0.50	Insert Values

本文链接

微软企业生产力大学培训课程_8月

2010-08-09T03:52:00Z

Microsoft SharePoint 2010, Project Server 2010, Exchange 2010, OCS 2010, Office 2010, Visio 2010, SQL 2008系列培训课程。

微软生产力大学：http://msbpiou.e-service.net.cn/pages/default.aspx

本文链接

招聘：赴微软工作SharePoint技术专家(V-，北京)

2010-07-13T10:09:00Z

致：园子里研究SharePoint技术的各位兄弟姐妹：

如果你具有以下特质，并且希望能够在微软公司工作（V-身份），请迅速与我取得联系（wang.zhiyong@gmail.com）。

沟通良好，有团队合作精神；
熟悉SharePoint2007/2010产品的安装、部署和使用；
熟悉SQL Server；
有两年以上.NET开发经验，熟练使用Visual Studio和C#语言；
至少2年以上SharePoint开发经验；

本文链接

SharePoint 2010: 如何使用Word Automation Services开发应用

2010-06-25T07:28:00Z

内容

使用Word Automation Services更改文档格式
一个使用Word Automation Services的场景
Word Automation Services工作原理
构建Word Automation Services应用
监控文档转换状态
辨别转换失败的文档
转换完成后删除源文件
与Open XML SDK进行集成
总结
其它资源

源代码下载

使用Word Automation Services更改文档格式

当我们使用Open XML SDK 2.0 for Microsoft Office时，有些任务是比较困难的。比如：重新编排页码，将文档转换为诸如PDF等的其它格式，或者更新文档目录表、字段，以及文档中的其它动态内容。而SharePoint 2010提供的Word Automation Services新功能就是用来解决这些问题的。

Word Automation Services是一个共享服务，它无需人员参与，可以在服务器端执行文档格式转换以及其它重要功能。其最初设计理念是在服务器端以可靠和可预测的方式处理多个文档。

我们可以使用Word Automation Services将Open XML WordprocessingML格式转换成其它格式。比如：可以将多个文档转换成PDF格式然后发送到打印机的打印池，或者通过邮件将PDF文档发送给客户，也可以将其它格式的文档（如：HTML，Word 97-2003二进制格式）转换成Open XML work-processing文档。

除了进行文档格式转换，Word Automation Services还提供了其它一些重要功能。比如：更新文档中的字段，将altChunk内容转换成使用正常格式的段落。如果我们使用Open XML SDK执行这些工作是非常困难的，但是Word Automation Services做这些工作就非常容易。以前，我们使用Word Automation Services为客户端执行这些工作，但这是有问题的。Word客户端更适合进行交互式文档编写，而不是用来在服务器端进行多文档处理的。如果在Word中执行这些任务，Word往往会显示错误提示框，而且如果服务器自动操作Word客户端，又没有用户响应对话框，这样线程就无法停止。这是一个与Word自动化相关的问题，有一篇KB专门介绍，Considerations for Server-side Automation of Office。

一个使用Word Automation Services的场景

下面这个场景展示了如何使用Word Automation Services在服务器端自动处理文档。

某位专家遵循一定的规范创建了一些Word模板，她或许会使用内容控制为这些模板提供一些使用指导，这为在文档生成过程中确定数据应该出现在文档模板的哪些位置提供了良好的用户体验和可靠的编程方法。通常，这些文档模板保存在SharePoint文档库里。
运行在服务器端的程序把文档模板和数据结合在一起，形成Open XML WordprocessingML (DOCX)文档。最好的方法是使用Open XML SDK 2.0 for Microsoft Office编写这个程序，因为这个SDK专门用来在服务器端生成文档。这些文档存放在SharePoint文档库里。
文档自动生成后，可能需要被打印，然后转换为WordprocessingML、PDF、XPS或MHTML格式再通过邮件发送给一系列用户。
作为转换工作的一部分，我们可以使用Word Automation Services更新文档中的字段，比如：文档目录表。

一起使用Open XML SDK 2.0 for Microsoft Office以及Word Automation Services可以创建丰富的、端到端解决方案，而无须自动化Word客户端应用。

Word Automation Services的一个突出优点是可以进行扩展升级，而Word客户端应用无法做到这点，我们可以配置Word Automation Services使用多个处理器，如果需要，还可以配置为负载均衡。

另外一个突出优点是，Word Automation Services在文档布局（包括分页排版）方面保持了与Word客户端近乎完全一致的体验。无论文档是在服务器端处理的，还是在客户端处理的，其布局都是完全一致的。

支持的源文档格式

Open XML File Format documents (.docx, .docm, .dotx, .dotm)
Word 97-2003 documents (.doc, .dot)
Rich Text Format files (.rtf)
Single File Web Pages (.mht, .mhtml)
Word 2003 XML Documents (.xml)
Word XML Document (.xml)

支持的目标文档格式

Portable Document Format (.pdf)
Open XML Paper Specification (.xps)

Word Automation Services的其它功能

除了加载文档并将文档保存为其它格式外， Word Automation Services还具有其它一些功能。

我们可以使用Word Automation Services更新文档目录、table of authorities以及索引字段，这在生成文档时非常重要。如果文档在生成后，其目录表未能正确更新，那么确定文档的分页将是非常困难的工作，而Word Automation Services可以非常容易地处理这个工作。

Open XML word-processing文档包含各式各样的字段类型，使用这些字段类型我们可以为文档动态添加内容。我们可以使用Word Automation Services重新计算所有的字段。比如：为文档添加一个插入当前日期的字段类型。这样当所有字段被更新时，其关联的内容也随之被更新，这样文档就可以在字段所在位置显示当前日期。

使用内容控制的一个最有效途径是将内容绑定到一个自定义XML元素。关于如何进行绑定，请参考Building Document Generation Systems from Templates with Word 2010 and Word 2007，以及其它一些资源。通过替换自定义XML元素可以将绑定内容控件的内容进行更新，而无须更改文档主体。文档主体包含了所有绑定内容控件的缓存值，如果只是替换自定义XML元素，文档主体中的缓存值是不会被更新的。如果用户只是用Word客户端应用查看就不会有这个问题，但是，如果要更深地处理WordprocessingML markup，我们就必须更新文档主体中的缓存值。而Word Automation Services正好可以做这项工作。

更换以altChunk元素表示的格式内容，是将HTML内容导入到WordprocessingML文档的好办法。Building Document Generation Systems from Templates with Word 2010 and Word 2007探讨了如何更换格式内容，使用方法，并且提供了其它开始资源。但是，这需要一直到你打开和保存包含altChunk元素的文档时才可以。这个文档包含HTML，而没有常规的的WordprocessingML markup，比如：段落，runs 以及文本。现在我们可以使用Word Automation Services导入HTML（或其它格式的可更换内容），然后将它们转换为WordprocessingML markup，这样WordprocessingML段落就有了styles。

也可以把以往的Word版本格式进行转换。比如，要构建的企业级应用有几千个用户，而他们当中就有一些人在Word 2007或Word 2003编辑Open XML文档，这时候，我们就可以将Open XML文档转换成与Word 2007或Word 2003兼容的格式。

Word Automation Services的不足

Word Automation Service缺少打印功能，但是，我们可以直接将WordprocessingML文档转换为PDF或XPS格式然后再打印。

有人可能会问，是否可以不采购和安装SharePoint Server 2010就可以使用Word Automation Services呢？答案是：Word Automation Services依赖于SharePoint 2010的其它功能，它只是SharePoint 2010的一个功能，我们购买并且安装SharePoint Server 2010才可以使用它。SharePoint 2010的标准版和企业版都包含Word Automation Services。

Word Automation Services工作原理

默认情况下，Word Automation Services随SharePoint Server 2010一起安装并且运行。如果在服务器场中使用SharePoint 2010，必须专门启用Word Automation Services。

要使用Word Automation Services，可以使用其编程接口启动转换工作（conversion job），对于每项转换工作需要指定要转换的文件、文件夹或者文档库。转换工作启动时，根据用户的配置信息，Word Automation Services在每台服务器上启动指定数量的转换线程。可以指定转换工作的执行频率，还可以指定每个转换线程执行的转换的数量。另外，还可以Word Automation Services可以使用的最大内存的百分比。

可以配置Word Automation Services，以保证其不过分使用SharePoint服务器的资源，你可以根据对SharePoint服务器的使用期望来决定该如何配置Word Automation Services。如果只是用Word Automation Services执行文档转换，你可以考虑让Word Automation Services占用大部分的processor time。当然，如果要执行的是低优先级的后台转换，你需要相应进行配置。

重要提示

建议worker process占用的处理器的数量绝对不要超过服务器减一。比如：对于4核服务器i，转换线程最多不能超过3个。
如果是在服务器场中，worker process占用的处理器数量不超过服务器场中有最少处理器那台服务器的处理器减一。
建议每分钟每个worker process最多处理90个文档转换。

编写代码除了可以启动转换实例外，还可以监控转换过程，这样当较大的转换工作完成时就可以同志用户或者发出提示。

Word Automation Services还可以进行4个方面的转换配置。

限制支持的文档格式的数量。
设置转换线程重启时可以转换的文档的数量。这非常有价值，因为无效文档会导致Word Automation Services消耗过多的内存资源。
设置Word Automation Services尝试转换文档的次数。默认情况下，这个值为2，也就是说，如果Word Automation Services转换某个文档失败，它只会再尝试一次(在当时那个conversion job中)。
设置转换线程开始后多久才开始监控。这非常有价值，因为Word Automation Services可以监控转换以确保每个转换进程没有停滞。

配置Word Automation Services

无论是否安装服务器场，默认情况下，Word Automation Services都随SharePoint Server 2010安装并运行。但开发人员可能需要更改其配置以获取更好的开发体验。默认情况下，转换线程每15分钟执行一次，如果是为了测试代码，更改为每分钟允许一次更好。另外，在测试过程中让Word Automation Services使用更多的资源是更好的主意。

调整转换线程每分钟执行一次

打开SharePoint 2010 Central Administration。
在SharePoint 2010 Central Administration首页，点击Manage Service Applications。
在Service Applications管理页，服务是按字母排序的。点击Word Automation Services。如果Word Automation Services是手动安装的，可能名称会有所不同。
在Word Automation Services管理页，相应配置即可。
点击OK。

构建Word Automation Services应用

Because Word Automation Services is a service of SharePoint Server 2010, you can only use it in an application that runs directly on a SharePoint Server. You must build the application as a farm solution. You cannot use Word Automation Services from a sandboxed solution.

A convenient way to use Word Automation Services is to write a web service that you can use from client applications.

However, the easiest way to show how to write code that uses Word Automation Services is to build a console application. You must build and run the console application on the SharePoint Server, not on a client computer. The code to start and monitor conversion jobs is identical to the code that you would write for a Web Part, a workflow, or an event handler. Showing how to use Word Automation Services from a console application enables us to discuss the API without adding the complexities of a Web Part, an event handler, or a workflow.

重要提示:

Note that the following sample applications call Sleep so that the examples query for status every five seconds. This would not be the best approach when you write code that you intend to deploy on production servers. Instead, you want to write a workflow with delay activity.

To build the application

Start Microsoft Visual Studio 2010.
On the File menu, point to New, and then click Project.
In the New Project dialog box, in the Recent Template pane, expand Visual C#, and then click Windows.
To the right side of the Recent Template pane, click Console Application.
By default, Visual Studio creates a project that targets .NET Framework 4.0. However, you must target .NET Framework 3.5. From the list at the upper part of the File Open dialog box, select .NET Framework 3.5.
In the Name box, type the name that you want to use for your project, such as FirstWordAutomationServicesApplication.
In the Location box, type the location where you want to place the project.
Figure 1. Creating a solution in the New Project dialog box
Click OK to create the solution.
By default, Visual Studio 2010 creates projects that target x86 CPUs, but to build SharePoint Server applications, you must target any CPU.
If you are building a Microsoft Visual C# application, in Solution Explorer window, right-click the project, and then click Properties.
In the project properties window, click Build.
Point to the Platform Target list, and select Any CPU.
Figure 2. Target Any CPU when building a C# console application
If you are building a Microsoft Visual Basic .NET Framework application, in the project properties window, click Compile.

Figure 3. Compile options for a Visual Basic application

Click Advanced Compile Options.

Figure 4. Advanced Compiler Settings dialog box

Point to the Platform Target list, and then click Any CPU.

To add a reference to the Microsoft.Office.Word.Server assembly, on the Project menu, click Add Reference to open the Add Reference dialog box.

Select the .NET tab, and add the component named Microsoft Office 2010 component.

Figure 5. Adding a reference to Microsoft Office 2010 component

Next, add a reference to the Microsoft.SharePoint assembly.

Figure 6. Adding a reference to Microsoft SharePoint

The following examples provide the complete C# and Visual Basic listings for the simplest Word Automation Services application.

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using Microsoft.SharePoint;

using Microsoft.Office.Word.Server.Conversions;

class Program

{

static void Main(string[] args)

{

string siteUrl = "http://localhost";

// If you manually installed Word automation services, then replace the name

// in the following line with the name that you assigned to the service when

// you installed it.

string wordAutomationServiceName = "Word Automation Services";

using (SPSite spSite = new SPSite(siteUrl))

{

ConversionJob job = new ConversionJob(wordAutomationServiceName);

job.UserToken = spSite.UserToken;

job.Settings.UpdateFields = true;

job.Settings.OutputFormat = SaveFormat.PDF;

job.AddFile(siteUrl + "/Shared%20Documents/Test.docx",

siteUrl + "/Shared%20Documents/Test.pdf");

job.Start();

}

Note:

Replace the URL assigned to siteUrl with the URL to the SharePoint site.

To build and run the example

Add a Word document named Test.docx to the Shared Documents folder in the SharePoint site.
Build and run the example.
After waiting one minute for the conversion process to run, navigate to the Shared Documents folder in the SharePoint site, and refresh the page. The document library now contains a new PDF document, Test.pdf.

监控文档转换状态

In many scenarios, you want to monitor the status of conversions, to inform the user when the conversion process is complete, or to process the converted documents in additional ways. You can use the ConversionJobStatus class to query Word Automation Services about the status of a conversion job. You pass the name of the WordServiceApplicationProxy class as a string (by default, "Word Automation Services"), and the conversion job identifier, which you can get from the ConversionJob object. You can also pass a GUID that specifies a tenant partition. However, if the SharePoint Server farm is not configured for multiple tenants, you can pass null (Nothing in Visual Basic) as the argument for this parameter.

After you instantiate a ConversionJobStatus object, you can access several properties that indicate the status of the conversion job. The following are the three most interesting properties.

ConversionJobStatus Properties

Property	Return Value
Count	Number of documents currently in the conversion job.
Succeeded	Number of documents successfully converted.
Failed	The number of documents that failed conversion.

Whereas the first example specified a single document to convert, the following example converts all documents in a specified document library. You have the option of creating all converted documents in a different document library than the source library, but for simplicity, the following example specifies the same document library for both the input and output document libraries. In addition, the following example specifies that the conversion job should overwrite the output document if it already exists.

Console.WriteLine("Starting conversion job");

ConversionJob job = new ConversionJob(wordAutomationServiceName);

job.UserToken = spSite.UserToken;

job.Settings.UpdateFields = true;

job.Settings.OutputFormat = SaveFormat.PDF;

job.Settings.OutputSaveBehavior = SaveBehavior.AlwaysOverwrite;

SPList listToConvert = spSite.RootWeb.Lists["Shared Documents"];

job.AddLibrary(listToConvert, listToConvert);

job.Start();

Console.WriteLine("Conversion job started");

ConversionJobStatus status = new ConversionJobStatus(wordAutomationServiceName,

job.JobId, null);

Console.WriteLine("Number of documents in conversion job: {0}", status.Count);

while (true)

{

Thread.Sleep(5000);

status = new ConversionJobStatus(wordAutomationServiceName, job.JobId,

null);

if (status.Count == status.Succeeded + status.Failed)

{

Console.WriteLine("Completed, Successful: {0}, Failed: {1}",

status.Succeeded, status.Failed);

break;

}

Console.WriteLine("In progress, Successful: {0}, Failed: {1}",

status.Succeeded, status.Failed);

}

To run this example, add some WordprocessingML documents in the Shared Documents library. When you run this example, you see output similar to this code snippet,

识别转换失败的文档

You may want to determine which documents failed conversion, perhaps to inform the user, or take remedial action such as removing the invalid document from the input document library. You can call the GetItems method, which returns a collection of ConversionItemInfo objects. When you call the GetItems method, you pass a parameter that specifies whether you want to retrieve a collection of failed conversions or successful conversions. The following example shows how to do this.

Console.WriteLine("Starting conversion job");

ConversionJob job = new ConversionJob(wordAutomationServiceName);

job.UserToken = spSite.UserToken;

job.Settings.UpdateFields = true;

job.Settings.OutputFormat = SaveFormat.PDF;

job.Settings.OutputSaveBehavior = SaveBehavior.AlwaysOverwrite;

SPList listToConvert = spSite.RootWeb.Lists["Shared Documents"];

job.AddLibrary(listToConvert, listToConvert);

job.Start();

Console.WriteLine("Conversion job started");

ConversionJobStatus status = new ConversionJobStatus(wordAutomationServiceName,

job.JobId, null);

Console.WriteLine("Number of documents in conversion job: {0}", status.Count);

while (true)

{

Thread.Sleep(5000);

status = new ConversionJobStatus(wordAutomationServiceName, job.JobId, null);

if (status.Count == status.Succeeded + status.Failed)

{

Console.WriteLine("Completed, Successful: {0}, Failed: {1}",

status.Succeeded, status.Failed);

ReadOnlyCollection<ConversionItemInfo> failedItems =

status.GetItems(ItemTypes.Failed);

foreach (var failedItem in failedItems)

Console.WriteLine("Failed item: Name:{0}", failedItem.InputFile);

break;

}

Console.WriteLine("In progress, Successful: {0}, Failed: {1}", status.Succeeded,

status.Failed);

}

To run this example, create an invalid document and upload it to the document library. An easy way to create an invalid document is to rename the WordprocessingML document, appending .zip to the file name. Then delete the main document part (known as document.xml), which is in the Word folder of the package. Rename the document, removing the .zip extension so that it contains the normal .docx extension.

代码输出如下。

Starting conversion job

Conversion job started

Number of documents in conversion job: 5

In progress, Successful: 0, Failed: 0

In progress, Successful: 4, Failed: 0

Completed, Successful: 4, Failed: 1

Failed item: Name:http://intranet.contoso.com/Shared%20Documents/IntentionallyInvalidDocument.docx

另外一种监控转换过程的方法是使用SharePoint List的 Event Handler捕捉转换后的文档添加到文档库时的动作。

转换完成后删除源文件

文档转换完毕后，如果要删除源，可以使用下面的示例代码。

Console.WriteLine("Starting conversion job");

ConversionJob job = new ConversionJob(wordAutomationServiceName);

job.UserToken = spSite.UserToken;

job.Settings.UpdateFields = true;

job.Settings.OutputFormat = SaveFormat.PDF;

job.Settings.OutputSaveBehavior = SaveBehavior.AlwaysOverwrite;

SPFolder folderToConvert = spSite.RootWeb.GetFolder("Shared Documents");

job.AddFolder(folderToConvert, folderToConvert, false);

job.Start();

Console.WriteLine("Conversion job started");

ConversionJobStatus status = new ConversionJobStatus(wordAutomationServiceName,

job.JobId, null);

Console.WriteLine("Number of documents in conversion job: {0}", status.Count);

while (true)

{

Thread.Sleep(5000);

status = new ConversionJobStatus(wordAutomationServiceName, job.JobId, null);

if (status.Count == status.Succeeded + status.Failed)

{

Console.WriteLine("Completed, Successful: {0}, Failed: {1}",

status.Succeeded, status.Failed);

Console.WriteLine("Deleting only items that successfully converted");

ReadOnlyCollection<ConversionItemInfo> convertedItems =

status.GetItems(ItemTypes.Succeeded);

foreach (var convertedItem in convertedItems)

{

Console.WriteLine("Deleting item: Name:{0}", convertedItem.InputFile);

folderToConvert.Files.Delete(convertedItem.InputFile);

}

break;

}

Console.WriteLine("In progress, Successful: {0}, Failed: {1}",

status.Succeeded, status.Failed);

}

Console.WriteLine("Starting conversion job")

Dim job As ConversionJob = New ConversionJob(wordAutomationServiceName)

job.UserToken = spSite.UserToken

job.Settings.UpdateFields = True

job.Settings.OutputFormat = SaveFormat.PDF

job.Settings.OutputSaveBehavior = SaveBehavior.AlwaysOverwrite

Dim folderToConvert As SPFolder = spSite.RootWeb.GetFolder("Shared Documents")

job.AddFolder(folderToConvert, folderToConvert, False)

job.Start()

Console.WriteLine("Conversion job started")

Dim status As ConversionJobStatus = _

New ConversionJobStatus(wordAutomationServiceName, job.JobId, Nothing)

Console.WriteLine("Number of documents in conversion job: {0}", status.Count)

While True

Thread.Sleep(5000)

status = New ConversionJobStatus(wordAutomationServiceName, job.JobId, _

Nothing)

If status.Count = status.Succeeded + status.Failed Then

Console.WriteLine("Completed, Successful: {0}, Failed: {1}", _

status.Succeeded, status.Failed)

Console.WriteLine("Deleting only items that successfully converted")

Dim convertedItems As ReadOnlyCollection(Of ConversionItemInfo) = _

status.GetItems(ItemTypes.Succeeded)

For Each convertedItem In convertedItems

Console.WriteLine("Deleting item: Name:{0}", convertedItem.InputFile)

folderToConvert.Files.Delete(convertedItem.InputFile)

Exit While

End If

Console.WriteLine("In progress, Successful: {0}, Failed: {1}",

status.Succeeded, status.Failed)

End While

与Open XML SDK进行集成

The power of using Word Automation Services becomes clear when you use it in combination with the Welcome to the Open XML SDK 2.0 for Microsoft Office. You can programmatically modify a document in a document library by using the Welcome to the Open XML SDK 2.0 for Microsoft Office, and then use Word Automation Services to perform one of the difficult tasks by using the Open XML SDK. A common need is to programmatically generate a document, and then generate or update the table of contents of the document. Consider the following document, which contains a table of contents.

Figure 7. Document with a table of contents

Let's assume you want to modify this document, adding content that should be included in the table of contents. This next example takes the following steps.

Opens the site and retrieves the Test.docx document by using a Collaborative Application Markup Language (CAML) query.
Opens the document by using the Open XML SDK 2.0, and adds a new paragraph styled as Heading 1 at the beginning of the document.
Starts a conversion job, converting Test.docx to TestWithNewToc.docx. It waits for the conversion to complete, and reports whether it was converted successfully.

Console.WriteLine("Querying for Test.docx");

SPList list = spSite.RootWeb.Lists["Shared Documents"];

SPQuery query = new SPQuery();

query.ViewFields = @"<FieldRef Name='FileLeafRef' />";

query.Query =

@"<Where>

<Eq>

</Eq>

</Where>";

SPListItemCollection collection = list.GetItems(query);

if (collection.Count != 1)

{

Console.WriteLine("Test.docx not found");

Environment.Exit(0);

}

Console.WriteLine("Opening");

SPFile file = collection[0].File;

byte[] byteArray = file.OpenBinary();

using (MemoryStream memStr = new MemoryStream())

{

memStr.Write(byteArray, 0, byteArray.Length);

using (WordprocessingDocument wordDoc =

WordprocessingDocument.Open(memStr, true))

{

Document document = wordDoc.MainDocumentPart.Document;

Paragraph firstParagraph = document.Body.Elements<Paragraph>()

.FirstOrDefault();

if (firstParagraph != null)

{

Paragraph newParagraph = new Paragraph(

new ParagraphProperties(

new ParagraphStyleId() { Val = "Heading1" }),

new Run(

new Text("About the Author")));

Paragraph aboutAuthorParagraph = new Paragraph(

new Run(

new Text("Eric White")));

firstParagraph.Parent.InsertBefore(newParagraph, firstParagraph);

firstParagraph.Parent.InsertBefore(aboutAuthorParagraph,

firstParagraph);

}

Console.WriteLine("Saving");

string linkFileName = file.Item["LinkFilename"] as string;

file.ParentFolder.Files.Add(linkFileName, memStr, true);

}

Console.WriteLine("Starting conversion job");

ConversionJob job = new ConversionJob(wordAutomationServiceName);

job.UserToken = spSite.UserToken;

job.Settings.UpdateFields = true;

job.Settings.OutputFormat = SaveFormat.Document;

job.AddFile(siteUrl + "/Shared%20Documents/Test.docx",

siteUrl + "/Shared%20Documents/TestWithNewToc.docx");

job.Start();

Console.WriteLine("After starting conversion job");

while (true)

{

Thread.Sleep(5000);

Console.WriteLine("Polling...");

ConversionJobStatus status = new ConversionJobStatus(

wordAutomationServiceName, job.JobId, null);

if (status.Count == status.Succeeded + status.Failed)

{

Console.WriteLine("Completed, Successful: {0}, Failed: {1}",

status.Succeeded, status.Failed);

break;

}

运行代码后生成的新文档如下图。

图 8. 更新后的文档目录

总结

尽管Open XML SDK 2.0是非常强大的开发服务器端文档生成和处理系统的工具，但其在文档操作的其它方面功能有限，比如：进行文档格式转换，或者更新文档目录、字段等等。Word Automation Services弥补了其不足，并且提供了高可用性的解决方案。结合Open XML SDK 2.0使用Word Automation Services能够解决单独使用Open XML SDK 2.0时无法解决的很多难题。

其它资源

本文链接

SharePoint 2010: 对于开发人员

2010-06-24T08:41:00Z

对开发人员的价值

SharePoint 2010为开发人员提供的好处是什么？

开发人员可以使用 SharePoint 2010 开发平台为企业和互联网构建商业协作应用，并且使用熟悉的工具和一套丰富的可互操作的预置功能。使用Visual Studio 2010 和新的 SharePoint Designer 2010 开发人员可以极大地提高工作效率。SharePoint 2010可以安装在 Microsoft Windows 7 或 Windows Vista 上进行开发。使用 SharePoint 2010，软件开发人员可以获得丰富的资源，包括 SDK 文档和产品功能，如开发人员仪表板页面。

SharePoint 2010还包括一系列用于构建应用的可扩展框架功能和工具，包括： Microsoft Silverlight Web Parts和Client APIs, LINQ to SharePoint, Business Connectivity Services (BCS), Sandboxed Solutions, 以及全新的SharePoint List data relationships。使用BCS，开发人员可以非常容易地将LOB业务数据集成到SharePoint和Office客户端解决方案，并且提供读写功能。

开发人员还可以构建沙盒解决方案，沙盒解决方案可以进行on-premise部署或者在线部署，其内置受限访问的API接口和资源管理。沙盒解决方案可以部署到corporate intranet或者共享托管环境中，如SharePoint Online。

开发

使用什么工具开发SharePoint应用或者自定义其外观？

可以使用Visual Studio 2010和SharePoint Designer 2010。SharePoint Designer免费下载使用。

开发人员可以构建什么样的 SharePoint作品？

例如：

web part, visual web part, sandboxed web part, workflow model, workflow action, event receiver, external content type, site definition, list definition, module, service application, image, timer job, custom css, custom master page, field control, custom action, custom ribbon, Silverlight application, web services, application pages, localized resources

开发人员可以创建哪些能够被非开发人员开发的解决方案复用的组件？

没有开发背景的人员通过SharePoint Designer或者SharePoint HTML UI构建复合解决方案。开发人员可以构建下面的这些组件，然后这些组件可以被一般用户在SharePoint复合解决方案中使用。

Web Parts – 开发人员可以使用 Visual Studio 2010构建Web Part，然后一般用户可以在SharePoint Designer或HTML UI中使用这些Web Part。Web Parts包含开发人员编写的自定义代码，并且显示在SharePoint 的web part 库里。
Workflow Actions – 开发人员可以在Visual Studio 2010中构建工作流Actions (或 steps) ，然后在SharePoint Designer中使用，以设计工作流模型。工作流actions包含开发人员编写的代码，显示在SharePoint Designer的流程设计面板中。
External Content Types – 开发人员可以使用Visual Studio 2010构建外部内容类型，其中包含访问某些外部系统数据的自定义代码。这些外部内容类型显示SharePoint的business data catalog中，并且可以用来创建外部数据列表，SharePoint可以搜索这些外部数据列表， Office客户端应用也可以访问这些外部数据列表。

沙盒解决方案为什么对开发人员有益？

自定义代码解决方案是开发业务解决方案时最有效的选择，但往往需要服务器管理员将代码部署到服务器。在一个托管着成千上万人员的大型服务器场中，部署自定义代码就变成一个非常敏感的事情，因为设计糟糕的代码会影响更多的人。

SharePoint 2010通过沙盒解决方案来解决这个问题。沙盒解决方案包含自定义代码，可以由服务器管理员或站点管理员进行部署。这就免去了企业的IT人员为一小部分用户专门评估、部署和维护自定义代码的麻烦。

开发人员创建的沙盒解决方案受限访问SharePoint对象模型。比如：站点集所有者部署的沙盒解决方案无法和托管Web应用程序以及SharePoint服务器场进行交互，只可以和当前站点集里的站点进行交互。

当站点集所有者部署自定义代码而无需IT人员的参与时， SharePoint服务器场和服务器管理员就需要控制一定的边界和自定义代码的工作范围。SharePoint 2010提供了对沙盒解决方案的监控和管理功能，能够确保SharePoint服务器场不会因为质量较差的代码而受影响。管理员可以设计CPU利用率、内存使用以及数据库查询时间的阈值，如果当沙盒解决方案超过这些阈值时，SharePoint 2010会自动将其停用。

沙盒解决方案减轻了IT Pro的工作压力，因为它可以让站点集管理员部署自定义代码而无需管理员的介入。但站点管理员可以确保SharePoint服务器场不被质量差的自定义解决方案搞垮。

是否支持第三方插件？

支持。SharePoint可以运行很多第三方插件，包括additions, extensions, 以及第三方应用等。微软有一个庞大的合作伙伴社区，有规模较小的软件开发商，也有较大的独立软件开发商。

是否支持为第三方模块、扩展、插件的在线交易站点？

可以通过CodePlex (www.codeplex.com)获取到很多第三方插件。当前，微软不提供此类支持或者销售第三方插件。

开发人员是否可以在Windows 7或Vista上进行SharePoint 2010开发？

SharePoint 2010开发环境有了极大改进，除了非常丰富的开发工具集，开发SharePoint应用程序也不必须在运行Windows Server 2008服务器操作系统的机器上，现在我们可以直接在运行Windows 7或Windows Vista Service Pack 1的本地开发工作站上开发，开发好的解决方案可以从工作站部署到服务器上进行集成、测试，并发布为生产环境。

需要注意的是， SharePoint 2010只有64位系统，所以不管是客户端还是服务器端都必须是64位操作系统。

SharePoint Designer 设计工作流有哪些改进的地方？

SharePoint Designer 2010的工作流设计体验有了很大变化，业务分析师可以将它作为工作流开发的第一个工具。SharePoint Designer 2010的工作流设计器能够将一系列的步骤、条件和动作整合在一起形成顺序工作流，还可以创建诸如循环和分支等的复杂工作流，也可以把默认的动作和自定义动作装配在一起，不需要编写任何代码就可以开发工作流。

构建工作流的用户界面提供了组件模型页面，用户在设计工作流的同时还可以修改列表或者内容类型。

工作流可以导出到Visio，然后再次导入到SharePoint Designer。开发人员可以使用Visual Studio 2010构建自定义流程步骤，然后在SharePoint Designer中使用。除此之外，开发人员也可以完全在Visual Studio中构建工作流。

SharePoint 2010使用哪个版本的.NET Framework？

SharePoint 2010必须使用.NET Framework 3.5，当然，也可以在同一台机器上安装.NET 4.0，但SharePoint 2010只会使用.NET 3.5。

这意味着SharePoint 2010使用的是Windows Workflow Foundation 3.5。我们可以在SharePoint 2010下面的这些地方使用.NET 4.0：

Silverlight或.NET 4.0的客户端对象模型代码
发起SharePoint ASMX web services调用的.NET 4.0代码
SharePoint 2010 BCS调用的Web Service中的代码

SharePoint 2010之所以使用.NET 3.5，是因为有2个项目未能及时完成。SharePoint团队会专注于.NET Framework，但现在还没有发布任何关于未来支持.Net 4.0的时间计划。

互操作性

SharePoint的互访问性如何？

互访问性是确保企业内部的系统能够彼此进行集成并且共享内容和数据的关键。SharePoint 2010提供了丰富的、容易扩展的标准集合，使用这些标准， SharePoint可以非常方便地与其它系统进行互操作。

包括：

REST (Representational State Transfer)
Web Services
WSRP 1.1 (Web Services for Remote Portlets)

SharePoint 2010是否支持REST？

SharePoint 2010提供了使用标准的REST接口查询列表数据的功能，SharePoint REST通过OData服务提供（原项目名称 "Astoria"）。REST提供了与Web紧密集成的灵活的数据服务，只需要将URI指向数据的某些部分，即可以用简单容易的方式来操作这些数据，如JSON和XML。以REST方式发布到Web的资源能够让代理通过URI地址，以常用的GET, POST或DELETE方法和数据进行交互。

SharePoint 2010是否支持Web Services？

SharePoint 2010提供了丰富的XML Web Services集，用于与SharePoint查询、交互和管理。下面列举的只是SharePoint Web Service的一部分。

Administration
Alerts
Authentication
Data retrieval
Permissions
Sites
Search
People & Profiles
Workflow

SharePoint 2010是否支持WSRP？

SharePoint 2010默认提供一个WSRP v1.1 consumer web part，能够将WSRP provided content展示到SharePoint Web界面。

支持的标准

SharePoint 2010支持什么样的标准？

SharePoint 2010支持非常广泛的标准，如：

.NET Web Part Framework, DOM 1.0 , DOD 5015, FrontPage RPC, HTML, HTTP, HTTPS, MathML, ODBC , ODF (IS26300) , Open XML (IS29500) , OpenSearch, OpenType , PDF 1.7 ,PDF/A ,RTF,RSS, ATOM, SMTP, SOAP, SVG, REST, UDDI, Unicode, URI/URN, W3C XML Schema, WCAG 2.0, WebDAV, WSDL, WSRP 1.0, XHTML, XML, XML Web Services, XML Dsig, XPATH, XPS, XSLT。

本文链接

SharePoint 2010: 使用SharePoint的Theming引擎

2010-06-23T09:51:00Z

SharePoint 2010提供了一个全新的Theming引擎，可以很方便地进行界面风格的定制。

Theming引擎能做什么？

SharePoint 2010 Theming引擎的工作对象是CSS文件，可以提供如下功能：

替换颜色，如背景色和文本色
替换字体
为图片设定颜色（使用3种方法：淡化，调和以及填充）

使用浏览器，我们可以选择SharePoint开箱即用的站点风格（Theme），或者通过选择12种颜色和2种字体创建新的站点风格。这些颜色和字体的值都保存在一个THMX文件中。因为Office应用也使用THMX文件，所以我们可以使用PowerPoint创建一个风格，然后将风格保存为THMX文件，最后在SharePoint中使用这个THMX文件。THMX文件保存在站点的Theme库里，我们可以用SharePoint Designer添加风格，也可以通过浏览"站点设置"-〉"Theme库"的方式添加风格。12种风格颜色以下面的标识符进行标识：

Dark1，Dark2
Light1，Light2
Accent1，Accent2，Accent3，Accent4，Accent5，Accent6
Hyperlink
FollowedHyperlink

Theming引擎能够使用这些颜色，并且为每种颜色另外产出5种变体：Lightest，Lighter，Medium，Darker以及Darkest。我们可以Color-Permutation的格式，如Light2-Darkest，的方式使用这些变体。

语法

Theming引擎通过读取CSS文件中的备注信息进行工作。要风格化一个格式，我们首先定义一个默认选项，然后把风格标识直接放在格式之前即可。比如，要把一个background-color元素风格化为Light2-Darkest，我们的CSS文件定义应该类似：

/* [ReplaceColor(themeColor:"Light2-Darkest")] */ background-color:#707070;

使用默认风格时，背景色是#707070，当使用新的风格时，背景色将变为Light2-Darkest。关于如何使用其它的颜色标识，请参考本文档结尾部分，或者SharePoint默认CSS文件corev4.css。

安装文件

我们需要执行下面的步骤才能够对Master Page启用Theme功能：

把CSS文件放到Theme引擎可以看到的地方
在Master Page中注册CSS文件

文件位置

只有CSS文件放在正确的路径下，Theme引擎才可以使用它。我们可以使用RootSite/Style Library/~language/Themable文件夹。该文件夹只有当激活SharePoint Server Publishing功能时才会存在。如果我们所工作的根站点下没有这个文件夹，我们只需手工创建这个文件夹即可。Themable文件夹下面的所有内容都会被Theming引擎看到，包括子文件夹里面的内容。可以使用SharePoint Designer或者在浏览器中再次创建这个文件夹。Language文件夹是可选的，只有当你希望不同的语言对应不同的CSS文件时才需要。对于英语，文件夹的名称是en-us，对于简体中文，文件夹名称是zh-cn。

图片文件无需放在特定的文件夹下，不过我们建议放在RootSite/Style Library/Images里。

注册文件

我们需要把风格化的CSS文件注册到Master Page，而不仅仅是把CSS文件链起来，这样，当应用新的Theme时Master Page才可以找到正确的CSS文件。我们只需要把下面的内容加到Master Page的Header部分即可。

<SharePoint:CssRegistration name="<% $SPUrl:~sitecollection/Style Library/~language/ Themable /myStyleSheet.css %>" After="corev4.css" runat="server"/>

After参数确保我们自定义的CSS文件在应用corev4.css之后才会被应用。需要注意的是：<%$SPUrl>是无法被SharePoint Foundation识别的，所以在SPF中，我们需要使用硬编码的URL地址。这样做的遗憾是无法为不同的语言设置不同的CSS文件，因为我们无法使用~Language参数。

演示

现在我们来做个示例。为了更好的理解颜色面板，我把下面的颜色变体表加入到了v4.master，同时导入一个示例图片，并对其设置颜色。

接下来，打开浏览器选择一个新的站点风格，Papyrus和Segoe Script字体，然后应用自定义的CSS文件，就看到下面的效果。

示例代码

上图中第二个Logo的CSS代码如下：

/* [ReplaceFont(themeFont: "MinorFont")] */ font-family:Verdana;
/* [ReplaceColor(themeColor:"Dark2-Darker")] */ color:black;
/* [RecolorImage(themeColor:"Dark2-Lightest",method:"Tinting")] */ background:url("/Style Library/images/spdicon1.png") no-repeat;

呵呵，挺酷吧！如果使用的得当，SharePoint Theming引擎可以大大地帮助我们进行界面外观的定制。

本文链接

SharePoint 2010: Claims-based Authentication

2010-06-22T04:42:00Z

基于声明的身份授权模型

SharePoint Server 2010引入了一个全新的、强大的，并且非常灵活的授权模型，可以和企业的任何身份体系相集成，包括：AD，基于LDAP的目录服务，特定应用程序的身份体系，以及新的以用户为中心的身份模型，如LiveID。该模型使用基于声明的授权模式和新产品——Geneva。基于声明的授权模型围绕身份理念构建，并且使用WS-Federation, WS-Trust，以及诸如Security Assertion Markup Language (SAML)等协议构建。

身份是用户信息的集合，包括：名称、邮箱地址、部门等等。事实上，Geneva等同于3套相关的技术：Active Directory Federation Services (以前称为Geneva Server），Windows Cardspace™ (以前称为Cardspace Geneva), 以及Windows Identity Foundation (以前称为Geneva Framework)。

为什么使用这个新的系统？

身份是驱动应用各个关键部分的核心，比如：用户是谁（authentication)，用户拥有什么样的权限(authorization)，以及应用如何与用户进行交互(personalization)等等。当今所有的应用都有身份体系，但都运行在各自的身份体系下。通常，要集成这些应用非常非常困难。

基于声明的身份授权体系为应用提供了一种从组织内、其他组织以及Internet，获取用户身份信息的常规方法。

身份信息包含在security token内（简单来讲，就是Token）。Token包含一个或者多个用户声明。我们可以把基于声明的授权体系理解为用户元数据，而这些数据贯穿于用户访问Session的整个过程。

基于声明的授权体系为SharePoint 2010提供了无限的可能性。我们可以在一个Web应用中灵活地使用多个用户授权体系，然后根据他们的Token提供的身份信息提供更加个性化的访问体验。

本文链接

SharePoint 2010: 学习资源

2010-06-21T11:51:00Z

SharePoint 2010 RTM已经正式发布，大家可以去下载试用版，并领略SharePoint 2010给我们带来的新体验和新价值！

本文链接