通过逻辑应用使用自定义连接器
备注
本主题是有关在 Azure 逻辑应用、Power Automate 和 Power Apps 中创建与使用自定义连接器的系列教程的一部分。 请务必阅读自定义连接器概述来了解流程。
在本主题中,您将构建一个基本逻辑应用,该应用使用您在以前的主题中创建的自定义连接器。 逻辑应用在项目被添加到 SharePoint 列表中时触发,然后逻辑应用使用自定义连接器调用认知服务文本分析 API。 连接器返回列表项中文本的情绪分数(0 到 1),然后逻辑应用将分数写回到列表中。 下图显示了完成的逻辑应用:
先决条件
拥有构建逻辑应用的基本经验。 有关详细信息,请参阅构建您的第一个逻辑应用工作流。
您在以下主题之一中创建的自定义连接器:
如果您的自定义连接器通过使用本地数据网关访问本地资源,您需要设置网关安装,以允许访问相应的预生成连接器出站 IP 地址。 同一区域中的所有逻辑应用使用相同的 IP 地址范围。 有关详细信息,请参阅为 Azure 逻辑应用安装本地数据网关 - 检查或调整通信设置。
创建 SharePoint 列表
首先,您在 SharePoint Online 中创建一个简单的三列列表;此列表存储逻辑应用用于情绪分析的电影评价数据。 有关 SharePoint 列表的详细信息,请参阅 SharePoint 文档中的列表简介。
在 SharePoint Online 站点中,选择新建,然后选择列表。
输入名称“电影评论”,然后选择创建。
将创建列表,其中包含默认标题字段。
选择 ,然后选择单行文本。
输入名称“评论”,然后选择保存。
对列表中的其他列重复执行步骤 3. 和 4. 将另一列添加到列表:使用数据类型数字和名称“分数”。
创建逻辑应用
现在您已经有可以使用的列表了,您将在 Azure 门户中创建逻辑应用。
使用您的 Azure 帐户凭据登录 Azure 门户。
在 Azure 主菜单中,选择新建 > 企业集成 > 逻辑应用。
在创建逻辑应用下,提供有关您的逻辑应用的详细信息,如下所示。 完成之后,选择固定到仪表板 > 创建。
设置 值 描述 客户 SentimentAnalysis 您的逻辑应用的名称 预订 <your-Azure-subscription-name> 您的 Azure 订阅的名称 资源组 My-First-LA-RG 用于组织相关资源的 Azure 资源组的名称 地点 美国东部 2 存储您的逻辑应用信息的区域 注意:您的逻辑应用和自定义连接器必须存在于同一区域。
Log Analytics 关闭 将诊断日志记录保持关闭设置。 在 Azure 部署您的应用后,逻辑应用设计器将打开并显示带有介绍视频和常用触发器的页面。 在模板下,选择空白逻辑应用。
添加触发器和自定义连接器
创建逻辑应用后,添加将项添加到 SharePoint 列表时触发的触发器。 然后,基于所添加的项添加要执行的操作。
在逻辑应用设计器中,搜索或选择 SharePoint,然后选择触发器 SharePoint - 创建项时。
如果提示,请使用您的 SharePoint 凭据登录。
输入 SharePoint 触发器的值。
参数 值 站点地址 <your-SharePoint-site-address> 列表名称 电影评价 时间间隔 10 频率 第二 选择新建步骤,然后选择添加操作。
搜索已创建的 SentimentDemo 自定义连接器,然后选择与该连接器相关联的操作。
操作的名称和说明来自您在创建连接器时提供的信息。
输入连接的名称和 API 密钥。
参数 值 连接名称 一个名称,例如 SentimentDemoConnection。 API 键 文本分析 API 的 API 密钥。 要了解详细信息,请转到获取 API 密钥。 为所有字段输入值。
参数 值 语言 en ID 1 文本 SharePoint 评价字段(来自动态内容对话框) ID 是必需的,因为连接器可以处理多个文档;在我们的示例中,一次发送一个文档。 在生产逻辑应用中,语言和 ID 值可能来自列表或其他数据源。
选择新建步骤,然后选择添加操作。
添加操作 SharePoint - 更新项,并为所有字段输入值。
参数 值 站点地址 <your-SharePoint-site-address> 列表名称 电影评价 ID SharePoint ID 字段 职务 SharePoint 标题字段 查看 SharePoint 评价字段 分数 自定义连接器分数字段 为分数字段添加动态内容时,可以看到逻辑应用添加了一个每项容器,因为它已识别到自定义连接器接受了多个文档。 您的连接器一次只能发送一个,但是逻辑应用与连接器的功能匹配,这很酷。
完成的逻辑应用现在应如下图所示:
在逻辑应用设计器的顶部,选择运行。
测试逻辑应用
现在逻辑应用已完成,可以通过将评价添加到 SharePoint 列表并查看逻辑应用的响应方式,对逻辑应用进行测试。
在 SharePoint Online 列表中,选择快速编辑。
向列表中添加两个评价(一个负面和一个正面),然后选择完成。
参数 建议值 标题(正面) 我最喜爱的电影 评价(正面) 漫长的一天后,我欣赏了这部新电影 标题(负面) 其他一些电影 评价(负面) 我几十年来看过的最糟糕的电影 返回 Azure 门户,选择概览查看此逻辑应用的运行历史记录。 此时应看到两次运行—针对添加到列表中的每段评论各运行了一次。 若要在使用此逻辑应用完成操作后保存 Azure 资源,请选择禁用。
返回到 SharePoint 列表页,刷新浏览器查看逻辑应用所添加的分数。
您已全部完成! 这是一个简单的逻辑应用,但可以通过自定义连接器调用认知服务,从而实现强大的功能。
后续步骤
在组织中共享连接器和/或认证连接器,使组织外部的人员也可以使用它:
提供反馈
我们非常感谢大家提出有关连接器平台问题或新功能想法的反馈。 要提供反馈,请转到提交问题或获取连接器帮助,然后选择反馈类型。