通过逻辑应用使用自定义连接器

备注

本主题是有关在 Azure 逻辑应用、Power Automate 和 Power Apps 中创建与使用自定义连接器的系列教程的一部分。 请务必阅读自定义连接器概述来了解流程。

在本主题中,您将构建一个基本逻辑应用,该应用使用您在以前的主题中创建的自定义连接器。 逻辑应用在项目被添加到 SharePoint 列表中时触发,然后逻辑应用使用自定义连接器调用认知服务文本分析 API。 连接器返回列表项中文本的情绪分数(0 到 1),然后逻辑应用将分数写回到列表中。 下图显示了完成的逻辑应用:

完成的情绪分析逻辑应用

先决条件

创建 SharePoint 列表

首先,您在 SharePoint Online 中创建一个简单的三列列表;此列表存储逻辑应用用于情绪分析的电影评价数据。 有关 SharePoint 列表的详细信息,请参阅 SharePoint 文档中的列表简介

  1. 在 SharePoint Online 站点中,选择新建,然后选择列表

    创建新 SharePoint 列表

  2. 输入名称“电影评论”,然后选择创建

    指定新列表的名称

    将创建列表,其中包含默认标题字段。

    “项目申请”列表

  3. 选择 “新建项”图标,然后选择单行文本

    添加单行文本字段

  4. 输入名称“评论”,然后选择保存

  5. 对列表中的其他列重复执行步骤 3.4. 将另一列添加到列表:使用数据类型数字和名称“分数”。

创建逻辑应用

现在您已经有可以使用的列表了,您将在 Azure 门户中创建逻辑应用。

  1. 使用您的 Azure 帐户凭据登录 Azure 门户

  2. 在 Azure 主菜单中,选择新建 > 企业集成 > 逻辑应用

    创建逻辑应用

  3. 创建逻辑应用下,提供有关您的逻辑应用的详细信息,如下所示。 完成之后,选择固定到仪表板 > 创建

    提供逻辑应用详细信息

    设置 描述
    客户 SentimentAnalysis 您的逻辑应用的名称
    预订 <your-Azure-subscription-name> 您的 Azure 订阅的名称
    资源组 My-First-LA-RG 用于组织相关资源的 Azure 资源组的名称
    地点 美国东部 2 存储您的逻辑应用信息的区域

    注意:您的逻辑应用和自定义连接器必须存在于同一区域。

    Log Analytics 关闭​ 将诊断日志记录保持关闭设置。
  4. 在 Azure 部署您的应用后,逻辑应用设计器将打开并显示带有介绍视频和常用触发器的页面。 在模板下,选择空白逻辑应用

    选择空白逻辑应用模板

添加触发器和自定义连接器

创建逻辑应用后,添加将项添加到 SharePoint 列表时触发的触发器。 然后,基于所添加的项添加要执行的操作。

  1. 在逻辑应用设计器中,搜索或选择 SharePoint,然后选择触发器 SharePoint - 创建项时

    SharePoint 创建项目触发器

  2. 如果提示,请使用您的 SharePoint 凭据登录。

  3. 输入 SharePoint 触发器的值。

    SharePoint 创建项目触发器参数

    参数
    站点地址 <your-SharePoint-site-address>
    列表名称 电影评价
    时间间隔 10
    频率 第二
  4. 选择新建步骤,然后选择添加操作

  5. 搜索已创建的 SentimentDemo 自定义连接器,然后选择与该连接器相关联的操作。

    选择 SentimentDemo 操作

    操作的名称和说明来自您在创建连接器时提供的信息。

  6. 输入连接的名称和 API 密钥。

    连接名称和 API 密钥

    参数
    连接名称 一个名称,例如 SentimentDemoConnection。
    API 键 文本分析 API 的 API 密钥。 要了解详细信息,请转到获取 API 密钥
  7. 为所有字段输入值。

    连接器参数

    参数
    语言 en
    ID 1
    文本 SharePoint 评价字段(来自动态内容对话框)

    ID 是必需的,因为连接器可以处理多个文档;在我们的示例中,一次发送一个文档。 在生产逻辑应用中,语言ID 值可能来自列表或其他数据源。

  8. 选择新建步骤,然后选择添加操作

  9. 添加操作 SharePoint - 更新项,并为所有字段输入值。

    “更新列表项”操作

    参数
    站点地址 <your-SharePoint-site-address>
    列表名称 电影评价
    ID SharePoint ID 字段
    职务 SharePoint 标题字段
    查看 SharePoint 评价字段
    分数 自定义连接器分数字段

    分数字段添加动态内容时,可以看到逻辑应用添加了一个每项容器,因为它已识别到自定义连接器接受了多个文档。 您的连接器一次只能发送一个,但是逻辑应用与连接器的功能匹配,这很酷。

    应用到每项

    完成的逻辑应用现在应如下图所示:

    完成的情绪分析逻辑应用

  10. 在逻辑应用设计器的顶部,选择运行

测试逻辑应用

现在逻辑应用已完成,可以通过将评价添加到 SharePoint 列表并查看逻辑应用的响应方式,对逻辑应用进行测试。

  1. 在 SharePoint Online 列表中,选择快速编辑

    SharePoint 列表快速编辑

  2. 向列表中添加两个评价(一个负面和一个正面),然后选择完成

    快速编辑完成

    参数 建议值
    标题(正面) 我最喜爱的电影
    评价(正面) 漫长的一天后,我欣赏了这部新电影
    标题(负面) 其他一些电影
    评价(负面) 我几十年来看过的最糟糕的电影
  3. 返回 Azure 门户,选择概览查看此逻辑应用的运行历史记录。 此时应看到两次运行—针对添加到列表中的每段评论各运行了一次。 若要在使用此逻辑应用完成操作后保存 Azure 资源,请选择禁用

    运行历史记录

  4. 返回到 SharePoint 列表页,刷新浏览器查看逻辑应用所添加的分数。

    从逻辑应用添加的分数

您已全部完成! 这是一个简单的逻辑应用,但可以通过自定义连接器调用认知服务,从而实现强大的功能。

后续步骤

在组织中共享连接器和/或认证连接器,使组织外部的人员也可以使用它:

提供反馈

我们非常感谢大家提出有关连接器平台问题或新功能想法的反馈。 要提供反馈,请转到提交问题或获取连接器帮助,然后选择反馈类型。