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

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

前言

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

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

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

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

为PowerApps和Flow开发自定义连接器 - 图1

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

为PowerApps和Flow开发自定义连接器 - 图2

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

  1. 编写一个Web API服务(适合于PowerApps和Flow)
  2. 在Flow中创建自定义连接器
  3. 在Flow中使用自定义连接器
  4. 在PowerApps中使用自定义连接器
  5. 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开发自定义连接器 - 图3

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

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

  1. 使用该命令导入一个包 dotnet add package Swashbuckle.AspNetCore,然后进行还原 dotnet restore
  2. 在Startup.cs文件中,添加两个命名空间的引用 using Swashbuckle.AspNetCoreusing Swashbuckle.AspNetCore.Swagger
  3. 在ConfigureServices方法的底部增加如下代码
    1. services.AddSwaggerGen(_=>{
    2. _.SwaggerDoc("v1",new Info(){
    3. Version ="1.0",
    4. Title ="dotnet core api sample",
    5. Contact = new Contact(){Name="Ares Chen",Email ="ares@xizhang.com"},
    6. Description ="dotnet core api sample using swagger"
    7. });
    8. });
  4. 在Configure方法的底部增加如下代码
    1. app.UseSwagger();
    2. 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 ,正常情况下你会看到如下的结果输出。

你的实际部署地址可能跟我不一样,因为Azure不允许同名地址。如果你不想自己去部署,你可以直接用我的这个地址查看输出结果,并且将其用在后续的自定义连接器中。

为PowerApps和Flow开发自定义连接器 - 图4

这是一个JSON的文档。如果你用格式化工具来查看,它可能是这样的:

为PowerApps和Flow开发自定义连接器 - 图5

查看它并不是重点,你现在需要做的是将点击右键,然后另存到本地(swagger.json),一会儿我们就会用到这个文件来自定义连接器。

在Flow中创建自定义连接器

准备好了上面这个Web API服务的话,接下来就可以在Flow中来自定义连接器了。

为PowerApps和Flow开发自定义连接器 - 图6

在接下来的界面中选择导入现有OpenAPI文件来定义连接器

为PowerApps和Flow开发自定义连接器 - 图7

接下来定义标题,并且找到此前保存在本地的swagger.json文件

为PowerApps和Flow开发自定义连接器 - 图8

点击“继续”,设置一些基本信息

为PowerApps和Flow开发自定义连接器 - 图9

点击“继续”,在安全设置这里暂时先选择 “无身份验证”

为PowerApps和Flow开发自定义连接器 - 图10

请注意,真正使用的连接器,是需要做身份验证的。建议在这个基础上,大家做一些针对性的实践。

点击“继续”,此时Flow会读取swagger文件中的定义信息,列出所有的操作

为PowerApps和Flow开发自定义连接器 - 图11

你会发现我们有五个操作,对应了创建订单,修改订单,查询订单(列表以及单个订单的详情),删除订单。目前来说在这些操作上面有一个感叹号的提示,因为有部分信息还需要你做定义:摘要和说明。请补充完整即可。

为PowerApps和Flow开发自定义连接器 - 图12

如果你确认没有问题了,请点击“创建连接器”来完成操作。

为PowerApps和Flow开发自定义连接器 - 图13

然后点击加号,可以基于这个连接器(connector)创建一个用于当前环境的连接(connection)。

为PowerApps和Flow开发自定义连接器 - 图14

在Flow中使用自定义连接器

接下来我们“从空白创建”来体验上面这个自定义连接器的使用。为了便于测试,我选择用“手工触发流”。如果你对这个方面不熟悉,请参考 这篇文章

为PowerApps和Flow开发自定义连接器 - 图15

在添加操作的时候,搜索Orderservice,你能看到有五个操作,下面我们添加CreateOrder,输入一些基本信息

为PowerApps和Flow开发自定义连接器 - 图16

当然为了让测试更加直观,我继续添加了一个获取订单列表的操作,然后将获取到的结果发送到一个服务器地址。

为PowerApps和Flow开发自定义连接器 - 图17

点击“创建流”,然后点击“立即运行”按钮

为PowerApps和Flow开发自定义连接器 - 图18

点击“继续”

为PowerApps和Flow开发自定义连接器 - 图19

点击“运行流”,很快你就能看到下面的结果

为PowerApps和Flow开发自定义连接器 - 图20

而且在我的服务器也很快收到了数据

为PowerApps和Flow开发自定义连接器 - 图21

在PowerApps中使用自定义连接器

同样的事情,在PowerApps上面也是类似的。所以,你在PowerApps中也立即可以看到之前定义好的这个OrderService的连接。

为PowerApps和Flow开发自定义连接器 - 图22

在创建应用的时候,可以很自然地选择到这个数据连接

为PowerApps和Flow开发自定义连接器 - 图23

建立连接后,在数据控件上面可以通过下面的方式调用方法。例如下面这个操作,是读取订单列表。

为PowerApps和Flow开发自定义连接器 - 图24

如果要创建一个订单,可以参考下面的做法。

为PowerApps和Flow开发自定义连接器 - 图25

Power BI自定义连接器的开发思路

看完上面的介绍,大家对于创建Web API服务,并且将其用于PowerApps和Flow的过程有了感性的认识。我们可能还会很自然地联想到,这个服务和连接器能否也用于三剑客中的另外一个组件——PowerBI,用于数据获取呢?

答案是:目前还不行。Power BI目前支持的自定义连接器的方式,目前是在Preview的阶段,其实现方式是比较特殊的,有兴趣的朋友可以参考下面这篇文章:

Data Connector SDK Developer Preview

结语

新一代的商业应用平台,它的强大依赖于强大的底层设计和灵活的应用架构。作为PowerApps和Flow的基础,连接器是一个核心的基础组件。微软提供的组件化架构,让开发人员可以使用自己习惯的方式开发Web API,并将其无缝地整合到业务应用的开发中去。