SharePoint 2013 app ---Provider Hosted app实战

本文介绍SharePoint 2013 Provider Hosted app。

首先来回顾一些啊SharePoint 2013 Provider Hosted app的特点（在前面三篇介绍app的文章中我们也有提到一些，但没针对Provider Hosted app作过总结）：

可以运行在SharePoint farm之外的server上 可以使用server端代码(注意不是SharePoint server API)使用Client Object Model 或Rest API访问SharePoint 的资源使用OAuth 协议取得SharePoint授权可以使用非微软的技术平台来Host(当然本例使用Asp.net来host)

该app主要用途是SharePoint 与其他系统集成,因为该类型的App记可以访问SharePoint资源也可以访问宿主系统本身的资源。

闲话不说，说怎么做：

1. 创建一个证书备用 http://msdn.microsoft.com/en-us/library/fp179901.aspx#Cert2

2. 配置Provider Host app 信任关系 http://msdn.microsoft.com/en-us/library/fp179901.aspx#Configure2， 注意记住 issuerId，在第三步需要用到

3. 启用SharePoint 使用OAuth 时可以通过 Http请求 http://msdn.microsoft.com/en-us/library/fp179901.aspx#Https2

4. 创建Provider Host app http://msdn.microsoft.com/en-us/library/fp179901.aspx#Createapp2

5. 在SharePoint provider hosted app 中使用Client Ojbect Model 访问SharePoint 资源（本例功能为在页面上打印出SharePoint Documents文档库中的文件相对路径），将Default.aspx.cs修改为：

using System;using System.Collections.Generic;using System.Linq;using System.Web;using System.Web.UI;using System.Web.UI.WebControls;using SP=Microsoft.SharePoint.Client;using Microsoft.SharePoint.Linq;namespace SharePointApp9Web.Pages{    public partial class Default : System.Web.UI.Page    {        protected void Page_Load(object sender, EventArgs e)        {            // The following code gets the client context and Title property by using TokenHelper.            // To access other properties, you may need to request permissions on the host web.            Uri hostWeb = new Uri(Request.QueryString["SPHostUrl"]);            // Here only take CamlQuery for example for the client object basic operations            // for more examples, please check http://msdn.microsoft.com/en-us/library/fp179912.aspx            // and http://code.msdn.microsoft.com/SharePoint-2013-Perform-eba8df54           // using (var clientContext = TokenHelper.GetS2SClientContextWithWindowsIdentity(hostWeb, Request.LogonUserIdentity))        // 该处 如果使用TokenHelper.GetS2SClientContextWithWindowsIdentity 来取得clientContext，下面的代码就查不出文档记录了，笔者也不         // 知道是为啥，按道理讲是不应该的，可能是微软的bug吧，           // 所以最后笔者使用 new SP.ClientContext(hostWeb.AbsoluteUri)来初始化客户端模型的上下文：            using (var clientContext = new SP.ClientContext(hostWeb.AbsoluteUri))            {                Microsoft.SharePoint.Client.List spList = clientContext.Web.Lists.GetByTitle("Documents");                clientContext.Load(spList);                clientContext.ExecuteQuery();                if (spList != null && spList.ItemCount > 0)                {                    Microsoft.SharePoint.Client.CamlQuery camlQuery = new SP.CamlQuery();                    camlQuery.ViewXml =                       @"<View>                              <Query>                                <Where><Neq><FieldRef Name='Title' /><Value Type='Text'>a</Value></Neq></Where><OrderBy><FieldRef Name='Created' Ascending='FALSE' /></OrderBy>                             </Query>                              <ViewFields><FieldRef Name='FileLeafRef' /><FieldRef Name='Title' /><FieldRef Name='Modified' /><FieldRef Name='Author' /><FieldRef Name='FileRef' /><FieldRef Name='FileSizeDisplay' /><FieldRef Name='Created' /><FieldRef Name='Editor' /></ViewFields>                       </View>";                    SP.ListItemCollection listItems = spList.GetItems(camlQuery);                    clientContext.Load(listItems);                    clientContext.ExecuteQuery();                    foreach (SP.ListItem item in listItems)                    {                        Response.Write(item["FileRef"] + "<br>");                    }                }                           }        }    }}

运行该app(直接点击VS2012上的Start按钮),当出现下列页面时点击Trust It:

但程序可能会报拒绝访问(access denied)的错误,原因是在AppManifest.xml没有申明该App需要访问那些SharePoint资源。但app尝试读取文档库 Documents.

解决方法为：

双击AppManifest.xml单击Permission 选项卡Scope 选择List, Permission 选择Read

注意：这里Scope和permission都有很多选项可以选，开发者可以根据app的资源访问需求来选择

重新运行该app,就可以打印出文档库里面的文件相对路径了