--- title: "How To Use Outputs from Connector Functions In Apps" slug: "understanding-arrays-and-objects-in-connector-function-outputs-1" tags: ["Connectors", "Arrays", "Objects", "Connector Function", "Outputs"] updated: 2025-01-23T09:34:55Z published: 2025-01-23T09:34:55Z canonical: "support.tulip.co/understanding-arrays-and-objects-in-connector-function-outputs-1" --- > ## 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 데이터베이스에서 특정 운영자에 대한 모든 데이터를 가져오고 싶다고 가정해 보겠습니다. 이를 위해 *badge_id를* 입력으로 받고 모든 운영자 정보를 출력에 저장하는 SQL 커넥터 함수를 작성할 수 있습니다. 이 경우 출력은 *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) 실제로 커넥터 함수를 만들 때 출력을 배열이나 객체로 저장하는 옵션은 없습니다. 다음은 "출력" 섹션에서 허용되는 데이터 유형입니다. ![](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://cdn.document360.io/7c6ff534-cad3-4fc8-9583-912c4016362f/Images/Documentation/How%20To%20Use%20Outputs%20from%20Connector%20Functions%20In%20Apps_103715527.png) 이 경우 5개의 필드가 있는 객체를 저장하는 "Order Details"라는 변수가 있습니다: - orderPlaced - quantity - address1 - address2 - address3 변수 검색 상자에서 개체를 선택하자마자 앱에 속성 이름에 따라 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) ![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" - "데이터 조작" "저장" 데이터: "Expression" "MAP_TO_TEXT_LIST(Variable.test_out.Test Parent, 'Test Child') 맵 함수에 전달된 첫 번째 매개변수는 객체 배열입니다. 두 번째 매개변수인 '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 또는 배열 표시하기 HTTP 커넥터의 여러 행의 SQL 출력 또는 배열을 앱에서 대화형 목록으로 전환하려면 [다음 별도의 가이드를 확인하세요.](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) 이동하여 질문을 게시하거나 다른 사람들이 비슷한 문제를 겪었는지 확인할 수도 있습니다!