PowerApps의 Collect, Clear, ClearCollect 함수Collect, Clear, and ClearCollect functions in PowerApps

컬렉션을 만들고 지우고 데이터 원본레코드를 추가합니다.Creates and clears collections and adds records to any data source.

설명Description

CollectCollect

Collect 함수는 데이터 원본에 레코드를 추가합니다.The Collect function adds records to a data source. 추가할 수 있는 항목은 다음과 같습니다.The items to be added can be:

  • 단일 값: 값은 새 레코드의 Value 필드에 있습니다.A single value: The value is placed in the Value field of a new record. 다른 모든 속성은 공백으로 둡니다.All other properties are left blank.
  • 레코드: 명명된 각 속성은 새 레코드의 해당 속성에 배치됩니다.A record: Each named property is placed in the corresponding property of a new record. 다른 모든 속성은 공백으로 둡니다.All other properties are left blank.
  • 테이블: 테이블의 각 레코드는 위의 설명대로 데이터 원본의 별도 레코드로 추가됩니다.A table: Each record of the table is added as a separate record of the data source as described above. 테이블은 레코드에 중첩 테이블로 추가되지 않습니다.The table is not added as a nested table to a record. 이를 수행하려면 테이블을 레코드에 먼저 랩핑하십시오.To accomplish this, wrap the table in a record first.

컬렉션과 함께 사용하면, 필요에 따라 추가 이 생성됩니다.When used with a collection, additional columns will be created as needed. 다른 데이터 원본의 열이 데이터 원본으로 고정되며 새 열은 추가할 수 없습니다.The columns for other data sources are fixed by the data source and new columns cannot be added.

데이터 원본이 아직 없으면 컬렉션이 생성됩니다.If the data source doesn't already exist, a collection is created.

컬렉션은 전역 변수를 보관하거나 데이터 원본의 임시 복사본을 생성하는 데 사용되기도 합니다.Collections are sometimes used to hold global variables or make a temporary copy of a data source. PowerApps는 사용자가 앱과 상호 작용할 때 자동으로 다시 계산되는 수식을 기반으로 합니다.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. 컬렉션에는 이런 이점이 활용되지 않기 때문에 컬렉션을 사용하면 앱을 만들고 이해하기가 더 어려워질 수 있습니다.Collections do not enjoy this benefit and their use can make your app harder to create and understand. 이런 방식으로 컬렉션을 사용하기 전에 변수 작업을 참조하세요.Before using a collection in this manner, review working with variables.

Patch 함수를 사용하여 데이터 원본에 레코드를 생성할 수도 있습니다.You can also use the Patch function to create records in a data source.

Collect는 수정된 데이터 원본을 테이블로 반환합니다.Collect returns the modified data source as a table. Collect동작 수식에만 사용할 수 있습니다.Collect can only be used in a behavior formula.

지우기Clear

Clear 함수는 컬렉션의 모든 레코드를 삭제합니다.The Clear function deletes all the records of a collection. 컬렉션의 열은 그대로 유지됩니다.The columns of the collection will remain.

Clear는 컬렉션에서만 작동하며 다른 데이터 원본에는 작동하지 않습니다.Note that Clear only operates on collections and not other data sources. 이런 용도에는 RemoveIf( DataSource, true ) 를 사용할 수 있습니다.You can use RemoveIf( DataSource, true ) for this purpose. 데이터 원본의 저장소에서 모든 레코드를 제거하고 다른 사용자에게 영향을 줄 수 있으므로 주의해서 사용해야 합니다.Use caution as this will remove all records from the data source's storage and can affect other users.

Remove 함수를 사용하면 레코드를 선택적으로 제거할 수 있습니다.You can use the Remove function to selectively remove records.

Clear는 반환 값이 없습니다.Clear has no return value. 동작 수식에만 사용할 수 있습니다.It can only be used in a behavior formula.

ClearCollectClearCollect

ClearCollect 함수는 컬렉션에서 모든 레코드를 삭제한 다음 동일한 컬렉션에 다른 레코드 집합을 추가합니다.The ClearCollect function deletes all the records from a collection and then adds a different set of records to the same collection. ClearCollect는 단일 함수로 ClearCollect의 조합을 제공합니다.With a single function, ClearCollect offers the combination of Clear and then Collect.

ClearCollect는 수정된 컬렉션을 테이블로 반환합니다.ClearCollect returns the modified collection as a table. ClearCollect는 동작 수식에만 사용할 수 있습니다.ClearCollect can only be used in a behavior formula.

구문Syntax

Collect( DataSource, Item, ... )Collect( DataSource, Item, ... )

  • DataSource – 필수 항목입니다.DataSource – Required. 데이터를 추가할 데이터 원본입니다.The data source that you want to add data to. 없는 경우 새로운 컬렉션이 생성됩니다.If it does not already exist, a new collection is created.
  • Item(s) - 필수 항목입니다.Item(s) - Required. 데이터 원본에 추가할 하나 이상의 레코드 또는 테이블입니다.One or more records or tables to add to the data source.

Clear( Collection )Clear( Collection )

  • Collection – 필수 항목입니다.Collection – Required. 지울 컬렉션입니다.The collection that you want to clear.

ClearCollect( Collection, Item, ... )ClearCollect( Collection, Item, ... )

  • Collection – 필수 항목입니다.Collection – Required. 지우고 데이터를 추가할 컬렉션입니다.The collection that you want to clear and then add data to.
  • Item(s) - 필수 항목입니다.Item(s) - Required. 데이터 원본에 추가할 하나 이상의 레코드 또는 테이블입니다.One or more records or tables to add to the data source.

Examples

데이터 원본 지우기 및 레코드 추가Clearing and adding records to a data source

이 예제에서는 IceCream이라는 컬렉션을 지우고 추가합니다.In these examples, you'll erase and add to a collection that's named IceCream. 데이터 원본은 다음 콘텐츠로 시작됩니다.The data source begins with these contents:

수식Formula 설명Description 결과Result
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) IceCream 컬렉션의 모든 데이터를 지운 다음 일정량의 Strawberry 아이스크림이 포함된 레코드를 추가합니다.Clears all data from the IceCream collection and then adds a record that includes a quantity of strawberry ice cream.

IceCream 데이터 원본 역시 수정되었습니다.The IceCream data source has also been modified.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) 일정량의 Pistachio 및 Orange 아이스크림이 포함된 두 개의 레코드를 IceCream 컬렉션에 추가합니다.Adds two records to the IceCream collection that includes a quantity of pistachio and Orange ice cream.

IceCream 데이터 원본 역시 수정되었습니다.The IceCream data source has also been modified.
Clear( IceCream )Clear( IceCream ) IceCream 컬렉션에서 모든 레코드를 제거합니다.Removes all records from the IceCream collection.

IceCream 데이터 원본 역시 수정되었습니다.The IceCream data source has also been modified.

정적 목록을 수집합니다.Collect a static list

  1. 단추 하나를 추가하고 아래 함수에 OnSelect 속성을 설정합니다.Add a button, and set its OnSelect property to this function:
    Collect(Products, "Europa", "Ganymede", "Callisto")Collect(Products, "Europa", "Ganymede", "Callisto")

    이 함수는 세 개 제품 이름 각각에 대한 행이 포함된 Products라는 컬렉션을 생성합니다.This function creates a collection that's named Products and that contains a row for each of three product names.

  2. Alt 키를 누른 상태에서 단추를 선택합니다.While holding down the Alt key, select the button.

  3. (선택 사항) 만든 컬렉션을 미리 보려면 파일 메뉴에서 컬렉션을 선택합니다.(optional) To preview the collection that you created, select Collections on the File menu.

컬렉션에 SharePoint 목록 넣기Put a SharePoint list into a collection

  1. SharePoint 목록에 대한 연결을 만듭니다.Create a connection to a SharePoint list.

  2. 단추를 추가하고 단추의 OnSelect 속성을 이 함수로 설정합니다. 이때 ListName을 SharePoint 목록의 이름으로 바꿉니다.Add a button, and set its OnSelect property to this function, replacing ListName with the name of your SharePoint list:
    Collect(MySPCollection, ListName)Collect(MySPCollection, ListName)

    이 함수는 SharePoint 목록과 동일한 데이터를 포함하는, MySPCollection이라는 컬렉션을 만듭니다.This function creates a collection that's named MySPCollection and that contains the same data as your SharePoint list.

  3. Alt 키를 누른 상태에서 단추를 선택합니다.While holding down the Alt key, select the button.

  4. (선택 사항) 만든 컬렉션을 미리 보려면 파일 메뉴에서 컬렉션을 선택합니다.(optional) To preview the collection that you created, select Collections on the File menu.

갤러리에서 SharePoint 목록의 데이터(예: 날짜, 선택 항목 및 사용자)를 표시하는 방법은 갤러리에서 데이터 표시를 참조하세요.For information about how to show data from a SharePoint list (such as dates, choices, and people) in a gallery, see Show data in a gallery. 양식에서 드롭다운 목록, 날짜 선택 및 사람 선택을 사용해 데이터를 표시하는 방법은 양식 편집 및 양식 컨트롤 표시를 참조하세요.For information about how to show data in a form (with drop-down lists, date pickers, and people pickers), see Edit form and Display form controls.