Windows 商店应用中使用 Office 365 API Tools

本篇我们介绍一个API 工具,用于在 Windows Store App 中使用 Office 365 API。

首先来说一下本文的背景:

使用 SharePoint 做过开发的同学们应该都知道,SharePoint 有一套客户端对象模型(Client Object Model)用于读取和操作列表和文档库的数据。这个模型支持的应用程序类型包括ASP.NET、WPF、Silverlight和WP等,但是 Windows Store App 不在支持行列中(这一点我一直不太理解)。。。这样的话,我们就没办法在 Store App 中直接使用这个模型了,那如果我们的 Store App 想利用 SharePoint 作为服务端,应该怎么办呢?

这也是最初接触 Store App 和 SharePoint 的时候困扰我的东西。当时是在给微软中国做一个应用,需求是将 Office 365 与 Store App 相结合,在 Store App 中实现对 Office 365 数据的读取和操作,将多种数据和文件集成到一起,形成一个一站式个人工作平台,进而展示 Office 365 在工作中的作用,作为微软 Office 365 宣传的 Demo 使用。需求其实挺简单,但是最常用的对象模型不被支持,这就没这么简单了。值得庆幸的是我们还有另外一套神器:SharePoint REST API (REST API reference and samples)。

SharePoint为我们提供了一套标准的 REST API,利用它我们可以通过网络请求的方式来读取和更新数据。读取数据还算简单,只需要拼接 API 地址和解析 json / XML 数据就可以了。但是操作数据就比较麻烦了,拼接需要 POST 的内容是一件说起来很容易,但很繁琐的工作。而且更让人头疼的是 SharePoint Online 的认证方式。(关于 REST API 的使用,我会在随后的文章中介绍,这里只是让大家感受一下使用的感受。)所以相对以对象模型,我们需要做的工作也多了不少。这就是本文的前提背景,找一个工具来把我们从繁琐的工作中解脱出来。它就是 Microsoft Office 365 API Tools for Visual Studio 2013

下载地址:https://visualstudiogallery.msdn.microsoft.com/a15b85e6-69a7-4fdf-adda-a38066bb5155 。只支持 Visual Studio 2013。来看看安装程序的信息:

安装过程很简单,这里就不介绍了。利用这个工具,就可以实现数据的操作,包括了邮件、联系人、日历、文件等。

下面我们来看看详细的使用过程:

1. 在工程中添加工具中的服务 

解决方案名上点右键,选择 “添加” -> "连接的服务",出现下面界面

点击“注册应用”,登录自己的 Office 365 账号,就会出现与 Office 365 站点关联的信息

选择一项服务,点击右侧的“权限...”对该服务的权限进行配置,配置后点击“确定”,就可以完成对这一项服务的引用了。这个过程中工具对将你添加的服务注册到 Microsoft Azure Active Directory 中。这里的配置会在应用进行登录认证的时候提示给用户,类似于微博 API 认证过程。

2. 在代码中整合 Office 365 API

代码中 Office 365 API 的整个分为三个步骤:

(1). Creating the Office 365 discovery client

我们的程序会调用不同的Endpoints来展现不同内容,例如用户邮件、日历、OneDrive 或联系人等。程序需要调用 Office 365 Discovery Service 来获得这些 EndPoints 的地址。

详细描述可以参照:http://msdn.microsoft.com/en-us/office/office365/howto/discover-service-endpoints 和 http://msdn.microsoft.com/en-us/office/office365/api/discovery-service-rest-operations 。

(2). Getting an access token for Office 365

在授权使用 Discovery Service 时,我们的代码可以使用从Azure AD 中返回的 token,这个 token 用于下一步访问数据之用。

(3). Creating the client object to access the Office 365 services

在获得了 Office 365 数据取得的权限后,我们就可以创建客户端对象来取得我们需要的数据了。

不同类型的数据需要创建不用的客户端对象,例如日历、联系人、邮件,需要创建 Outlook Services client object。文件 和 网站,需要创建 SharePoint client object。用户信息 需要创建 Azure AD client object。

我们看一段简单的代码来验证一下这个过程:

public async Task<List<IContact>> GetContactsAsync()
{

    // Make sure we have a reference to the Exchange client
    var exchangeClient = await AuthenticationHelper.EnsureOutlookClientCreatedAsync();

    // Query contacts
    var contactsResults = await exchangeClient.Me.Contacts.OrderBy(c => c.DisplayName).ExecuteAsync();

    // Return the first page of contacts. 
    return contactsResults.CurrentPage.ToList();

}
public static async Task<OutlookServicesClient> EnsureOutlookClientCreatedAsync()
{
    try
    {
        AuthenticationContext = new AuthenticationContext(CommonAuthority);

        if (AuthenticationContext.TokenCache.ReadItems().Count() > 0)
        {
            // Bind the AuthenticationContext to the authority that sourced the token in the cache 
            // this is needed for the cache to work when asking for a token from that authority 
            // (the common endpoint never triggers cache hits) 
            string cachedAuthority = AuthenticationContext.TokenCache.ReadItems().First().Authority;
            AuthenticationContext = new AuthenticationContext(cachedAuthority);

        }

        // Create a DiscoveryClient using the discovery endpoint Uri.  
        DiscoveryClient discovery = new DiscoveryClient(DiscoveryServiceEndpointUri,
            async () => await AcquireTokenAsync(AuthenticationContext, DiscoveryResourceId));

        // Now get the capability that you are interested in.
        CapabilityDiscoveryResult result = await discovery.DiscoverCapabilityAsync("Mail");

        var client = new OutlookServicesClient(
            result.ServiceEndpointUri,
            async () => await AcquireTokenAsync(AuthenticationContext, result.ServiceResourceId));

        return client;
    }
    // The following is a list of all exceptions you should consider handling in your app.
    // In the case of this sample, the exceptions are handled by returning null upstream. 
    catch (DiscoveryFailedException dfe)
    {
        MessageDialogHelper.DisplayException(dfe as Exception);

        // Discovery failed.
        AuthenticationContext.TokenCache.Clear();
        return null;
    }
    catch (MissingConfigurationValueException mcve)
    {
        MessageDialogHelper.DisplayException(mcve);

        // Connected services not added correctly, or permissions not set correctly.
        AuthenticationContext.TokenCache.Clear();
        return null;
    }
    catch (AuthenticationFailedException afe)
    {
        MessageDialogHelper.DisplayException(afe);

        // Failed to authenticate the user
        AuthenticationContext.TokenCache.Clear();
        return null;

    }
    catch (ArgumentException ae)
    {
        MessageDialogHelper.DisplayException(ae as Exception);
        // Argument exception
        AuthenticationContext.TokenCache.Clear();
        return null;
    }
}

这里我们获得了 Outlook Service 的 Client,并且获得了 token,然后利用这个 Client 来取得 Outlook 的联系人信息。

这里是一个完整的使用了 Office 365 API Tools 的 Windows Store App Demo:https://github.com/OfficeDev/Office-365-APIs-Starter-Project-for-Windows,供大家参考。

好了,到这里我们就把 Office 365 API Tools 介绍完了,希望对大家开发 Store App 有所帮助。下一篇我们将对前面提到的 SharePoint 2013 REST API 做出详细介绍,谢谢! 

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏逍遥剑客的游戏开发

.Net用的SQLite

15430
来自专栏林德熙的博客

wpf 单例

本文告诉大家如何做一个 wpf 单例程序。单例就是用户只能运行这个程序一次,也就是内存只有存在这个程序一个。

10920
来自专栏张善友的专栏

开发人员应该知道Windows 7的十大技巧

最近我在笔记本上安装了64位的Windows 7,今天逛的时候看到Scott Hanselman’s 写的一篇文章Top 10 Tips Working Dev...

18950
来自专栏张善友的专栏

使用 NuGet 管理项目库

共享和重用代码是一个很大的挑战。 不相信? 请随便走进一间中型或大型工作室,问问他们有多少日志记录库。 访问多家公司后,您将发现他们拥有比例非常高的内部日志记录...

195100
来自专栏逸鹏说道

Birdge.NET:将C#代码转换为JavaScript

Birdge.NET 是一个可以将C#代码转换为JavaScript的开源编译器,由 Object.NET于2015年5月推出。它允许开发者使用C#编写平台独立...

31140
来自专栏程序员与猫

ASP.NET Core 介绍和项目解读

标签: ASP.NETCore 1. 前言 作为一个.NET Web开发者,我最伤心的时候就是项目开发部署时面对Windows Server上贫瘠的解决方案...

27460
来自专栏.NET开发者社区

(码友推荐)2018-07-10 .NET及相关开发资讯速递

2.第三节:SignalR之PersistentConnection模型详解(步骤、用法、分组、跨域)

12920
来自专栏张善友的专栏

Microsoft Sync Framework 1.0 RTM发布了

Microsoft Sync Framework 是一个功能完善的同步平台,实现了应用程序、服务和设备的协作和脱机访问。它提供了一些可支持在脱机状态下漫游、共享...

21260
来自专栏张善友的专栏

性能优化工具 MVC Mini Profiler

MVC MiniProfiler是Stack Overflow团队设计的一款对ASP.NET MVC、WebForm 以及WCF 的性能分析的小程序。可以对一个...

22880
来自专栏乐沙弥的世界

查看及管理Oracle patch

    Oracle patch也即是Oracle补丁。Oracle补丁又包含好几个种类,小的补丁简直是难以数计,难免让人眼花缭乱。尽管如此,Oracle pa...

12710

扫码关注云+社区

领取腾讯云代金券