微软Canvas App实战之使用多值列

青旅半醒 2023-10-03 10:56 3阅读 0赞

> 在使用微软Canvas App进行开发过程中，使用Combo box控件下拉框遇到的一些问题及解决方案。

这个功能和SharePoint中的多值列显然是天生一对，本文将具体介绍一下在多值列使用中的坑。本文共900字，阅读约5分钟

在SharePoint中，最常见的多值列，就是内置的People关联字段了。如下图所示，我们可以新建或者修改一个字段的多值属性为Yes，然后就可以在一行记录中保存多个用户。比如，一个帖子的关注者这样的业务场景，平时使用关系型数据库可以用一个1对多的外键表来保存关注者，而有了这个功能，只需要一张表就好了。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70][]

当然，这种“易用”的功能显然是一把双刃剑。在带来了使用便捷优势的同时，也带来了开发上的麻烦。毕竟这是公然违反数据库一范式的——虽然其内部还是2张表，但是经过微软的包装了。

下面，我们从最基本的界面操作开始。我们CanvasApp里拖拽一个Form表单，并添加带有这样多值列的字段。然后尝试做一些查询观察一下就会发现，下拉框中的对象结构大体上是这样规格的Record：

[{
    	"Claims": "i:0#.f|membership|mail@xxx.com",
    	"Department": "xxx",
    	"DisplayName": "User1",
    	"Email": "mail@xxx.com",
    	"JobTitle": null,
    	"Picture": "......"
    },第2份，第3份.......第N份]

那么，是不是将DefaultSelectedItems的值设置为这样的Records就可以了提交保存进多值列了呢？

### 并不是！ ###

控件中的选项需要的Record格式实际上应该为：

{
    	'@odata.type': "#Microsoft.Azure.Connectors.SharePoint.SPListExpandedUser",
    	'Claims': "i:0#.f|membership|mail@xxx.com",
    	'Value': "User1"
    }

这是我们需要注意到的问题。

当你辛辛苦苦的构造出了一个这样结构的集合，会发现仍然不能提交。如下图，Combo box里是一群无法使用的Object。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70 1][]

正确的姿势应该是这样的。注意两者的区别在于数据类型本质上的不同

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70 2][]

这里以SharePoint为例，其他数据源就不一一介绍了，自行查找类型 @odata.type 标识符吧！这个可以通过开启Monitor观察网络请求的方式获得。

在CanvasApp中，我们往往也会遇到和微软的其他生态组件搭配使用的情况。那么，上面这个多值列的数据，如果出现在了其他地方又该怎么写呢？下面我们以Power Automate（原名Microsoft Flow）为例介绍下。

假设我们有一个创建或者更新List Item的任务，该List中含有多值列。那么我们会面临一个类似于这样的多值输入区：

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70 3][]

图中紫色所表示的就是我们需要使用的“伪字段名”了。当我们希望做输入的时候，他是一个数组类型，图上的Claims就是属性名，可以通过切换视图模式查看道一个合理的输入结构应该下图是这样的。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70 4][]

我们可以通过数组型变量来取代上图所写的常量值来实现我们的开发目标。

后记：多值列原本不是Canvas App的一部分，但是因为是微软生态中的一环，很容易搭配使用。而且这种两个产品相交的功能，往往是文档缺失的重灾区。比如上面提到的类型名，就没有发现可以查阅的文档资料，而需要用网络请求自行观察得知。

下一篇打算介绍一些如何对多值列进行数据导入工作。敬请期待。

**传送门：**

[微软Canvas App实战踩坑指南6：使用多值列][Canvas App_6]

[TiDB源码学习笔记：制定计划][TiDB]

[TiKV源码略读-Config][TiKV_-Config]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70]: https://img-blog.csdnimg.cn/20210714101926530.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/2021071410202155.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20210714102048669.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20210714102125240.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw==,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw_size_16_color_FFFFFF_t_70 4]: https://img-blog.csdnimg.cn/20210714102147714.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0NCR0NhbXB1cw==,size_16,color_FFFFFF,t_70
[Canvas App_6]: https://zhuanlan.zhihu.com/p/333522911
[TiDB]: https://zhuanlan.zhihu.com/p/334986433
[TiKV_-Config]: https://zhuanlan.zhihu.com/p/322400326