如何在应用程序中使用连接器函数的输出

目的

SQL和HTTP连接器函数将 "输出 "作为对象或数组发送到应用程序。学习如何在应用程序中操作这些对象。

在这篇文章中，你将学习...
*如何在应用程序中使用连接器函数的 "输出"。

如何在应用程序中使用连接器函数的输出

数组和对象是两种流行的数据结构，在许多编程语言中都有使用。Tulip在连接器函数中利用了这两种数据结构。

1. 当一个SQL连接器函数输出多行时，其输出会以充满对象的数组形式发送到应用程序中。
2. 当一个HTTP连接器函数返回一个包含数组的输出时，该数组将作为一个充满对象的数组出现在一个应用程序中。
3. 当一个SQL连接器函数输出一个单行，或者一个HTTP连接器函数有任何输出时，这些值会作为键/值对存储在一个对象中

对象只有在成功完成连接器函数后才能自动创建。

本指南将向您展示连接器函数输出是如何自动组织的。然后，你将看到如何在应用程序中使用这些输出。

从连接器收集输出

想象一下，你想根据某个特定操作员的Tulip徽章ID，从SQL数据库中提取关于他的所有数据。

要做到这一点，你要写一个SQL连接器函数，将badge_id作为输入，并将操作员的所有信息保存在一个输出中。在这种情况下，输出被称为group_name。这就是它的样子。

这个函数有一个输出，group_name，它被存储为一个字符串。这是以输出部分的 "文本 "标签为基础的。

事实上，当你创建一个连接器函数时，没有选项可以将输出存储为数组或对象。下面是 "输出 "部分中允许的数据类型。

因此，你必须把它存储为 "文本"，然后在触发器编辑器中操作它。

在触发器编辑器中运行这个函数，将输出存储在一个对象中。

• "运行连接器函数" 连接器。"SBD-测试" "操作员导航"
• 徽章ID："静态值" "文本" "2222"，并将结果保存为。"变量" "test_var"

在这种情况下，你使用一个2222的值作为输入，并将输出存储在一个名为 "test_var "的变量中。

在一个应用程序中使用对象

在上面的例子中，我们取了一个叫做group_name的输出，然后把它保存在一个叫做test_var的变量中。App Variables视图显示，这个变量实际上是一个对象，有一个名为 "group_name "的属性。

事实上，如果连接器函数有多个输出，每个输出都将被存储为触发器中创建的名为 "test_var "的对象的一个新属性。这样，你就可以把一个函数调用的所有输出组织在一个地方。

你可以通过在你的应用程序中添加一些变量文本，然后从上下文窗格的Widget标签中选择变量来测试函数的输出。

在本例中，我们有一个名为 "订单详情 "的变量，它存储了一个有5个字段的对象。

• orderPlaced
• 数量
• 地址1
• 地址2
• 地址3

只要你从变量搜索框中选择对象，你就会看到所有5个字段在你的应用程序中弹出，并有基于属性名称的标签。你可能需要展开变量文本字段，以便一次看到所有的变量。

显示对象

如果你的对象有多个属性，你可能想在你的应用程序的一个步骤中一次性显示所有的属性。这比为每个单独的属性创建新的变量文本要容易。

要从对象中重新排序/移除单个属性，在上下文窗格中点击属性上的x或网格符号。

要改变列的数量，使用上下文窗格中的 "列 "选项。

要改变标签和数值的显示，在上下文窗格中调整颜色和字体大小。

要看这些数据将如何显示给操作者，在播放器中运行该应用程序，你将能够看到整个对象。如果你首先运行收集数值的连接器函数，数值将被包括在内。

操纵对象

在你的应用程序中使用一个对象数组可能会限制你提取你想要的目标数据点的选择。你可以对连接器函数输出的对象数组进行操作，使其更容易访问你希望在逻辑中使用的数据等。这可以通过指定你希望提取的对象中的键来实现。这将有助于简化你的数据输出，使你能够更好地利用你所感兴趣的数据。

下面是一个连接器函数的例子。

上面的输出是一个对象的数组。当连接器函数返回一个对象数组时，在表达式编辑器中有一些操作可以帮助操作它们。这些映射函数允许你根据一个给定的键来映射相应的值。输出的值可以被映射到一个选定类型的数组中。你可能会使用MAP_TO_TEXT_LIST()来获得一个所有Titles的文本数组。

• "运行连接器功能" 连接器。"测试" "测试功能 "并将结果保存为。"test_output"
• "数据操作" "存储 "数据。"表达式" "MAP_TO_TEXT_LIST(Variable.test_out.Test Parent, 'Test Child')

传入map函数的第一个参数是对象的数组。第二个参数，'Test Child'，是连接器函数输出中概述的提取器名称。提取器名称被用作提取值的关键。这将在一个字符串数组中输出所有标题。

审查一个应用程序中的所有对象变量

为了操作应用程序中的数据结构，它必须已经被存储为一个变量。你可以通过进入应用程序编辑器的上下文窗格，并在应用程序标签中选择 "变量 "旁边的西格玛符号来查看你现有的变量。

对象将以通用对象符号"{}"显示。

从HTTP连接器显示多行SQL或数组

如果你想把SQL输出的多行或HTTP连接器的数组变成应用程序中的交互式列表，请查看此单独指南

进一步阅读

• 如何在应用程序中使用数组
• 如何使用触发器调用连接器函数
• 应用程序编辑器中的表达式编辑器指南

你找到你要找的东西了吗？

你也可以到community.tulip.co去发表你的问题，或者看看其他人是否遇到过类似的问题!