为PowerApps和Flow，Power BI开发自定义连接器

作者：陈希章发表于 2017年12月20日

前言

我在之前用了几篇文章来介绍新一代微软商业应用平台三剑客（PowerApps，Microsoft Flow，Power BI），相信对于大家会有一种跃跃欲试的冲动，他们看起来真的不难，因为他们的定位是要给业务部门的用户直接使用的。那么现在问题就来了

他们为什么能这么灵活和强大？
如果这些活儿都是业务部门用户自己去做了，那么IT部门人员，开发人员该干嘛呢？

好问题啊！但是这两个问题其实是相关的，而且第二个问题的答案就是第一个问题所描述的结果。因为可以将IT专业人员（IT Pro）和开发人员（Developer）从日常的轻量级业务应用的工作中解放出来，所以，他们可以去做一些更加擅长的技术、通用性的业务支撑组件的开发。

我们再来看一张已经多次展示过的图片

在应用的基础架构这部分，Common Data Service我此前已经介绍过了，Gateways也已经在 PowerApps进阶篇中讲解过。Pro dev extensibility 在目前这个系列中我不准备展开。那么就余下了Connectors（连接器了）。当然，实际上我们早就使用过了连接器，例如在Microsoft Flow中内置了将近200个连接器，如下

但是，如果我们需要的某个功能，上面的连接器并没有提供，而你有正好有一定的开发能力，那么本文将很适合你。我们将以一个实例介绍如何自定义连接器。从某种意义上说，PowerApps和Flow是共用连接器的，而Power BI的连接器则更特殊一点。本文的内容将包括

编写一个Web API服务（适合于PowerApps和Flow）
在Flow中创建自定义连接器
在Flow中使用自定义连接器
在PowerApps中使用自定义连接器
Power BI自定义连接器的开发思路

编写一个Web API服务

可以这么说，绝大部分的连接器，都是一个Web API服务。我们将一些业务逻辑封装在服务器端(或者准确地说是云端)，然后有选择性地暴露出来一些接口，供PowerApps和Flow在需要的时候调用。所以，在开始自定义连接器之前，你需要做的就是编写一个Web API服务。你可以用任何熟悉的语言和平台完成这个工作，但我已经完成了一个使用C#编写的，基于dotnet core框架的Web API服务的例子，因为本文的重点不是将具体如何创建Web API服务以及部署，所以我用另外一篇文章专门讲解了这个过程，请参考

使用 dotnet core 和 Azure PaaS服务进行devOps开发 (Web API 实例)

该项目的代码，可以通过 https://github.com/chenxizhang/dotnetcoreapisample 下载到。

但是，在PowerApps或Flow中定义自定义连接器的时候，如果有一个服务描述文档，则会大大简化操作。所以，我们需要在上面这个成果的基础上添加一个功能，让它能自动生成一个服务描述文档。微软官方的建议是用swagger的规范。关于swagger，如果有兴趣，可以参考他们的官网：https://swagger.io/specification/

在上述项目中添加swagger的支持，请参考下面的步骤

使用该命令导入一个包 dotnet add package Swashbuckle.AspNetCore，然后进行还原 dotnet restore
在Startup.cs文件中，添加两个命名空间的引用 using Swashbuckle.AspNetCore和 using Swashbuckle.AspNetCore.Swagger

在ConfigureServices方法的底部增加如下代码

services.AddSwaggerGen(_=>{
    _.SwaggerDoc("v1",new Info(){
        Version ="1.0",
        Title ="dotnet core api sample",
        Contact = new Contact(){Name="Ares Chen",Email ="ares@xizhang.com"},
        Description ="dotnet core api sample using swagger"
    });
});

在Configure方法的底部增加如下代码

app.UseSwagger();
app.UseSwaggerUI(_=>_.SwaggerEndpoint("/swagger/v1/swagger.json","v1"));

完成上面的工作后，请按照使用 dotnet core 和 Azure PaaS服务进行devOps开发 (Web API 实例) 提到的步骤那样，将代码提交到Azure的Git存储库，然后在浏览器中访问 https://dotnetcoreapisample.azurewebsites.net/swagger/v1/swagger.json ,正常情况下你会看到如下的结果输出。