[]
        
(Showing Draft Content)

连接网络型JSON时使用上下文信息

1. 概述

1.1 功能概述

Wyn支持连接网络型JSON时使用上下文信息,对接入的数据进行加工和处理,最终通过仪表板或报表实现数据的可视化展示。

1.2 应用场景

当您需要通过用户信息上下文(用户信息上下文和组织信息上下文)动态过滤网络型JSON数据,并将其数据接入 Wyn,借助 Wyn 强大的可视化图表与报表功能进行数据展示时,本文将为您详细介绍从用户信息上下文动态过滤网络型JSON数据到数据接入 Wyn 的具体操作流程,为您提供全面且实用的参考。

此时用户上下文信息相当于一个特殊的参数,无需输入,直接从用户属性获取。支持使用上下文的位置与使用参数的位置相同,包含以下几项:

  • URL 中,即基准地址或端点地址中使用。

  • 在请求头中,全局请求头和端点地址请求头中均支持。

  • 在有效载荷中。

用户信息上下文的使用方式为@{用户上下文名称}”如“@{DBName}

组织信息上下文的使用方式为#{组织上下文名称}”如“#{DBName}

type=info

提示

直接引用参数时,仅能使用单值的上下文。如需使用多值的上下文,则必须通过添加参数传递,具体参考下文操作步骤-多值上下文。

2. 操作步骤

2.1 前提条件

使用用户上下文信息动态过滤网络型 JSON 数据前,需满足以下条件:

  1. 接口准备:提前准备好支持用户上下文配置的网络型 JSON 数据源。。

2.2 操作步骤-单值上下文

示例一:GET请求

  1. 在端点地址中使用用户信息上下文过滤数据。

    image

  2. 预览数据时,完成过滤,当前用户的 idPro 属性值为1。

    image2021-11-1_18-4-37.png

示例二:POST请求

  1. 在有效载荷中使用用户信息上下文。

    image

  2. 预览数据后,过滤成功,当前用户的 shirt\_size 属性值为 M。

    image2021-11-1_17-47-30.png

2.3 操作步骤-多值上下文

使用多值上下文时,必须通过数据源中的参数传递,具体用法如下。

  1. 在 JSON 数据源中定义一个参数,并开启多值,默认值使用上下文。然后在 API 地址中引用参数,如下图所示。

    image

    其中 user-name 是一个扩展属性生成的用户信息上下文,当前用户的该属性值为 Ervin Howell Leanne Graham

    image2021-11-9_14-26-53.png

  2. 预览端点效果如下,使用当前用户的上下文进行了数据过滤。

    image2021-11-9_14-27-50.png

    type=info

    提示

    单值的上下文也可以通过参数调用,只需在添加参数时不开启多值属性即可。

    image