Power Apps 中的 JSON 函数

生成表、记录或值的 JSON 文本字符串。

描述

JSON 函数以文本形式返回数据结构的 JavaScript 对象表示法 (JSON) 表示形式,从而适合在网络上存储或传输。 ECMA-404IETF RFC 8259 介绍了此格式,其已被 JavaScript 和其他编程语言广泛使用。

画布应用支持此表列出的数据类型,并提供有关其文本表示的详细信息:

数据类型 描述 结果示例
布尔值 truefalse true
颜色 包含颜色的 8 位十六进制表示形式的字符串。 此表示形式采用格式 #rrggbbaa,其中 rr 是红色分量,gg 是绿色,bb 是蓝色,aa 是 Alpha 通道。 对于 Alpha 通道,00 是完全透明,ff 是完全不透明。 您可以将此字符串传递到 ColorValue 函数。 "#102030ff"
货币 为用户语言使用适当的小数点分隔符的数字。 如果需要,将使用科学计数法。 1.345
日期 包含 ISO 8601 yyyy-mm-dd 格式的日期的字符串。 "2019-03-31"
日期时间 包含 ISO 8601 日期/时间的字符串。 以 UTC 表示的日期/时间值,如结尾的“Z”所示。 "2019-03-31T22:32:06.822Z"
GUID 包含 GUID 值的字符串。 字母为小写。 "751b58ac-380e-4a04-a925-9f375995cc40"
图像、媒体 如果指定了 IncludeBinaryData,媒体文件将以字符串编码。 使用 http: 或 https: URL 架构的 Web 引用不会被修改。 对内存中二进制数据的引用以 "data:mimetype;base64,..." 格式编码。 内存中数据包括用户使用 相机控件捕获的图像,以及具有 appres: 和 blob: URL 架构的任何其他引用。 "data:image/jpeg;base64,/9j/4AA..."
编号 为用户语言使用适当的小数点分隔符的数字。 如果需要,将使用科学计数法。 1.345
选项集  选择项的数字值,不是用于显示的标签。 使用数字值是因为它与语言无关。 1001
时间 包含 ISO 8601 hh:mm:ss.fff 格式的字符串。 "23:12:49.000"
记录 字段及其值的逗号分隔列表,放在 {} 之间。 此表示法类似于画布应用中的记录,但名称始终在双引号之间。 此格式不支持基于多对一关系的记录。 { "First Name": "Fred", "Age": 21 }
Table 记录的逗号分隔列表,放在 [] 之间。 此格式不支持基于一对多关系的表。 [ { "First Name": "Fred", "Age": 21 }, { "First Name": "Jean", "Age": 20 } ]
双选项  双选项的布尔值(truefalse),不是用于显示的标签。 使用布尔值是因为它与语言无关。 false
超链接、文本 双引号之间的字符串。 此函数用反斜杠转义嵌入的双引号,将换行符替换为“\n”,并进行其他标准 JavaScript 替换。 "This is a string."

指定可选的 Format 参数来控制结果的可读程度,以及不支持的数据类型和二进制数据类型的处理方式。 默认情况下,输出尽可能紧凑,没有不必要的空格或换行符,并且不允许不支持的数据类型和二进制数据。 如果您指定了 & 运算符,可以组合多种格式。

JSONFormat 枚举 描述
紧凑 默认。 输出尽可能紧凑,不增加空格或换行符。
IndentFour 为了提高可读性,输出为每个列和嵌套级别包含一个换行符,并为每个缩进级别使用四个空格。
IncludeBinaryData 结果包含图像、视频和音频剪辑列。 此格式会大大增加结果的大小并降低应用的性能。
IgnoreBinaryData 结果不包含图像、视频或音频剪辑列。 如果您既未指定 IncludeBinaryData 也未指定 IgnoreBinaryData,此函数将在遇到二进制数据时产生错误。
IgnoreUnsupportedTypes 允许使用不受支持的数据类型,但结果不会包含这些数据类型。 默认情况下,不受支持的数据类型会产生错误。

使用 ShowColumnsDropColumns 函数可控制结果包含哪些数据并删除不支持的数据类型。

由于 JSON 可能既占用内存又需要大量计算,因此只能在行为函数中使用此函数。 您可以将结果从 JSON 捕获到变量,然后将其用于数据流。

如果列同时有显示名称和逻辑名称,结果将包含逻辑名称。 显示名称反映应用用户的语言,因此不适合将数据传输到通用服务。

语法

JSON( DataStructure [, Format ] )

  • DataStructure – 必需。 要转换为 JSON 的数据结构。 支持表、记录和基元值,任意嵌套。
  • Format - 可选。 JSONFormat 枚举值。 默认值为 Compact,不添加换行符或空格,阻止二进制数据和不支持的列。

示例

分层数据

  1. 插入 Button 控件,并将其 OnSelect 属性设置为以下公式。

    ClearCollect( CityPopulations,
        { City: "London",    Country: "United Kingdom", Population: 8615000 },
        { City: "Berlin",    Country: "Germany",        Population: 3562000 },
        { City: "Madrid",    Country: "Spain",          Population: 3165000 },
        { City: "Hamburg",   Country: "Germany",        Population: 1760000 },
        { City: "Barcelona", Country: "Spain",          Population: 1602000 },
        { City: "Munich",    Country: "Germany",        Population: 1494000 }
    );
    ClearCollect( CitiesByCountry, GroupBy( CityPopulations, "Country", "Cities" ) )
    
  2. 按住 Alt 键,并选择此按钮。

    CitiesByCountry 集合已使用此数据结构创建,您可以通过在 文件 菜单上选择 集合,然后选择集合的名称来显示该集合。

    CitiesByCountry 集合。

    您还可以通过选择 文件 > 设置 > 即将推出的功能 > 启用公式栏结果视图,在公式栏中选择集合的名称,然后选择公式栏下集合名称旁边的向下箭头,来显示此集合。

    公式栏结果视图中的集合。

  3. 插入另一个按钮,并将其 OnSelect 属性设置为以下公式:

    Set( CitiesByCountryJSON, JSON( CitiesByCountry ) )
    

    此公式将全局变量 CitiesByCountryJSON 设置为 CitiesByCountry 的 JSON 表示形式。

  4. 按住 Alt 键,并选择此按钮。

  5. 插入 标签控件,然后将 文本 属性设置为此变量。

    CitiesByCountryJSON
    

    标签将显示此结果,所有结果都在一行中,没有空格,适合跨网络传输:

    [{"Cities":[{"City":"London","Population":8615000}],"Country":"United Kingdom"},{"Cities":[{"City":"Berlin","Population":3562000},{"City":"Hamburg","Population":1760000},{"City":"Munich","Population":1494000}],"Country":"Germany"},{"Cities":[{"City":"Madrid","Population":3165000},{"City":"Barcelona","Population":1602000}],"Country":"Spain"}]
    
  6. 更改第二个按钮的公式,使输出更具可读性。

    Set( CitiesByCountryJSON, JSON(CitiesByCountry, JSONFormat.IndentFour ))
    
  7. 按住 Alt 键,并选择第二个按钮。

    标签将显示可读性更强的结果。

    [
        {
            "Cities": [
                {
                    "City": "London",
                    "Population": 8615000
                }
            ],
            "Country": "United Kingdom"
        },
        {
            "Cities": [
                {
                    "City": "Berlin",
                    "Population": 3562000
                },
                {
                    "City": "Hamburg",
                    "Population": 1760000
                },
                {
                    "City": "Munich",
                    "Population": 1494000
                }
            ],
            "Country": "Germany"
        },
        {
            "Cities": [
                {
                    "City": "Madrid",
                    "Population": 3165000
                },
                {
                    "City": "Barcelona",
                    "Population": 1602000
                }
            ],
            "Country": "Spain"
        }
    ]
    

base64 编码的图像和媒体

  1. 添加 Image 控件。

    这个控件带有 SampleImage

  2. 添加 Button 控件,并将其 OnSelect 属性设置为以下公式。

    Set( ImageJSON, JSON( SampleImage, JSONFormat.IncludeBinaryData ) )
    
  3. 按住 Alt 键,并选择此按钮。

  4. 添加一个标签,然后将 文本 属性设置为此变量。

    ImageJSON
    
  5. 调整控件的大小,并根据需要减小字体大小,以显示大部分结果。

    标签将显示 JSON 函数捕获的文本字符串。

    "data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4NCjxzdmcgdmVyc2lvbj0iMS4xIg0KCSB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHhtbG5zOnhsaW5rPSJodHRwOi8vd3d3LnczLm9yZy8xOTk5L3hsaW5rIiB4bWxuczphPSJodHRwOi8vbnMuYWRvYmUuY29tL0Fkb2JlU1ZHVmlld2VyRXh0ZW5zaW9ucy8zLjAvIg0KCSB4PSIwcHgiIHk9IjBweCIgd2lkdGg9IjI3MHB4IiBoZWlnaHQ9IjI3MHB4IiBlbmFibGUtYmFja2dyb3VuZD0ibmV3IDAgMCAyNzAgMjcwIiB4bWw6c3BhY2U9InByZXNlcnZlIj4NCgk8ZyBjbGFzcz0ic3QwIj4NCgkJPHJlY3QgeT0iMC43IiBmaWxsPSIjRTlFOUU5IiB3aWR0aD0iMjY5IiBoZWlnaHQ9IjI2OS4zIi8+DQoJCTxwb2x5Z29uIGZpbGw9IiNDQkNCQ0EiIHBvaW50cz0iMjc3LjksMTg3LjEgMjQ1LDE0My40IDE4OC42LDIwMi44IDc1LDgwLjUgLTQuMSwxNjUuMyAtNC4xLDI3MiAyNzcuOSwyNzIiLz4NCgkJPGVsbGlwc2UgZmlsbD0iI0NCQ0JDQSIgY3g9IjIwMi40IiBjeT0iODQuMSIgcng9IjI0LjQiIHJ5PSIyNC4zIi8+DQoJPC9nPg0KPC9zdmc+"