--- title: "How To Use Outputs from Connector Functions In Apps" slug: "how-to-use-outputs-from-connector-functions-in-apps" updated: 2025-01-23T09:34:37Z published: 2025-01-23T09:34:37Z canonical: "support.tulip.co/how-to-use-outputs-from-connector-functions-in-apps" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # 了解连接器函数输出中的数组和对象 ## 用途 *SQL 和 HTTP 连接器函数将 "输出 "作为对象或数组发送到应用程序。了解如何在应用程序中操作这些对象。* **在本文中,您将学习......*****如何在应用程序中使用连接器函数的 "输出"**。 ## 如何在应用程序中使用连接器函数的输出 [数组](https://www.w3schools.com/js/js_arrays.asp)和[对象](https://www.w3schools.com/js/js_objects.asp)是许多编程语言中常用的两种数据结构。Tulip 在连接器函数中使用了这两种数据结构: 1. 当 SQL 连接器函数输出多行时,[输出会以数组对象的形式发送给应用程序](https://support.tulip.co/docs/how-to-write-a-sql-connector-function) 2. 当 HTTP 连接器函数返回一个包含数组的输出时,该数组将以包含对象的数组形式出现在应用程序中。 3. 当 SQL 连接器函数输出单行或 HTTP 连接器函数有任何输出时,这些值将作为键/值对存储在一个对象中。 只有在连接器函数成功完成后,才能自动创建对象。 本指南将向你展示如何自动组织连接器函数输出。然后,您将看到如何在应用程序中使用这些输出。 ## 从连接器收集输出 想象一下,你想根据某个操作员的郁金香徽章 ID,从 SQL 数据库中提取有关该操作员的所有数据。 为此,您需要编写一个 SQL 连接器函数,将*badge_id*作为输入,并在输出中保存操作员的所有信息。在本例中,输出名为*group_name*。这就是它的外观: ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_156363686.png) 此函数有一个输出,即以字符串形式存储的*group_name*。这是基于输出部分中的 "文本 "标签。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_156363883.png) 事实上,在创建 Connector 函数时,没有将输出存储为数组或对象的选项。以下是 "输出 "部分允许的数据类型。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_177837567.png) 因此,必须将其存储为 "文本",然后在触发器编辑器中对其进行操作。 在 "触发器编辑器 "中运行此函数,将输出存储到对象中。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715525.png) - "运行连接器函数 "连接器:"SBD - 测试""操作员导航 - 徽标 ID:"静态值""文本""2222",并将结果保存为"变量" "test_var" 本例中,输入值为 2222,输出结果保存在名为 "test_var "的变量中。 ## 在应用程序中使用对象 在上面的示例中,我们获取了名为*group_name 的*输出,然后将其保存在名为*test_var* 的变量中。应用程序变量视图显示,这个变量实际上是一个对象,它有一个名为 "group_name "的属性。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715526.png) 事实上,如果连接器函数有多个输出,那么每个输出都将被存储为触发器中创建的名为 "test_var "的对象的一个新属性。这样,您就可以在一个地方组织一次函数调用的所有输出。 您可以[在应用程序中](https://support.tulip.co/docs/data-types-in-tulip)添加一些[变量文本](https://support.tulip.co/docs/data-types-in-tulip),然后从上下文窗格的 "部件 "选项卡中选择变量,从而测试函数的输出。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715527.png) 在本例中,我们有一个名为 "订单详细信息 "的变量,它存储了一个包含 5 个字段的对象: - 订单位置 - 数量 - 地址1 - 地址2 - 地址3 从 "变量 "搜索框中选择对象后,您将看到应用程序中弹出全部 5 个字段,并根据属性名称添加标签。您可能需要展开变量文本字段才能同时看到所有字段。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715529.png) ### 显示对象 如果对象有多个属性,您可能希望在应用程序的一个步骤中同时显示所有属性。这比为每个属性创建新的变量文本要容易得多。 要重新排序/删除对象中的单个属性,请单击上下文窗格中属性上的 x 或网格符号。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715530.png) 要更改列数,请使用侧窗格中的 "列 "选项。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715531.png) 要更改标签和数值的显示方式,请调整侧窗格中的颜色和字体大小。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715533.png) 要查看操作员如何显示这些数据,请在播放器中运行应用程序,然后就能看到整个对象。如果首先运行收集数值的连接器函数,则会包含数值。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715534.png) ### **操作对象** 在应用程序中使用对象数组可能会限制您提取目标数据点的选择。您可以操作从连接器函数中输出的对象数组,以便更轻松地访问您希望在逻辑等中使用的数据。这可以通过指定要提取的对象中的键来实现。这将有助于简化数据输出,从而更好地利用您感兴趣的数据。 下面是一个连接器函数示例: ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%2836%29.png){height="" width="""} ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%2837%29.png) 上面的输出是一个对象数组。当连接器函数返回一个对象数组时,表达式编辑器中的一些操作有助于对其进行操作。通过这些映射函数,可以根据给定的键映射相应的值。输出的值可以映射到所选类型的数组中。您可以使用 MAP_TO_TEXT_LIST()来获取包含所有*标题*的文本数组。 ![image.png](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/image%2838%29.png) - "运行连接器功能 "连接器:"测试" "测试功能 "并将结果保存为"test_output - "数据操作" "存储 "数据:"表达式" "MAP_TO_TEXT_LIST(Variable.test_out.Test Parent, 'Test Child') 传入 map 函数的第一个参数是对象数组。第二个参数 "Test Child "是连接器函数输出中列出的提取器名称。提取器名称用作提取值的键。这将以字符串数组的形式输出所有标题。 #### 查看应用程序中的所有对象变量 要在应用程序中操作数据结构,必须将其存储为变量。进入应用程序编辑器的侧窗格,选择应用程序选项卡中 "变量 "旁边的西格玛符号,即可查看现有变量。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715514.png) 对象将以通用对象符号"{}"显示。 ![](https://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715518.png) ## 从 HTTP 连接器显示多行 SQL 或数组 如果想在应用程序中将多行 SQL 输出或来自 HTTP 连接器的数组转化为交互式列表,[请查看本单独指南](https://support.tulip.co/docs/displaying-interactive-lists-of-table-records-or-connector-output-in-apps) ## 更多阅读 - [如何在应用程序中使用数组](https://support.tulip.co/docs/how-to-use-arrays-in-apps) - [如何使用触发器调用连接器函数](/r230/docs/how-to-call-a-connector-function-using-triggers) - [应用程序编辑器中的表达式编辑器指南](https://support.tulip.co/docs/how-to-use-the-expression-editor-in-the-app-editor) --- 找到您想要的内容了吗? 您还可以前往[community.tulip.co](https://community.tulip.co/?utm_source=intercom&utm_medium=article-link&utm_campaign=all)发布您的问题,或查看其他人是否遇到过类似问题!