PowerApps의 Set 함수Set function in PowerApps

전역 변수의 값을 설정합니다.Sets the value of a global variable.

개요Overview

Set 함수를 사용하면 정보(예: 사용자가 버튼을 선택한 횟수 또는 데이터 작업의 결과)를 임시로 보관하는 전역 변수의 값을 설정할 수 있습니다.Use the Set function to set the value of a global variable, which temporarily holds a piece of information, such as the number of times the user has selected a button or the result of a data operation.

전역 변수는 앱 전체의 모든 화면에서 사용할 수 있습니다.Global variables are available throughout your app on all screens. 가장 간단한 종류의 변수이며 대부분의 상황에서 필요를 충족합니다.These are the simplest kind of variables and fill the needs of most situations. 또한 테이블에 대한 행 수준 수정을 허용하는 컬렉션 및 단일 화면으로 범위가 지정된 컨텍스트 변수도 있습니다.There are also context variables which are scoped to a single screen and collections that allow row level modifications to tables. 다른 옵션에 대한 자세한 내용은 변수 작업을 참조하세요.For more information on these other options see working with variables.

PowerApps는 사용자가 앱과 상호 작용할 때 자동으로 다시 계산되는 수식을 기반으로 합니다.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. 전역 변수는 이러한 이점이 활용되지 않기 때문에 앱을 만들고 이해하기 어려울 수 있습니다.Global variables don't offer this benefit and can make your app harder to create and understand. 변수를 사용하기 전에 변수 작업을 검토하세요.Before you use a variable, review working with variables.

설명Description

전역 변수는 Set 함수를 사용하여 암시적으로 생성됩니다.Global variables are implicitly created by using the Set function. 명시적 선언은 필요하지 않습니다.There is no explicit declaration required. 전역 변수에 대한 Set 함수를 모두 제거하면 해당 전역 변수가 사라집니다.If you remove all the Set functions for a global variable, then that global variable will cease to exist. 변수를 지우려면 변수의 값을 Blank 함수의 결과로 설정하십시오.To clear a variable set its value to the result of the Blank function.

변수의 값, 정의 및 용도는 제작 환경의 파일 메뉴에 있는 변수 보기를 사용하여 볼 수 있습니다.You can see your variables' values, definitions, and uses with the Variables view under the File menu in the authoring environment.

이 문서의 뒷부분에 나오는 예제에서 보듯이 전역 변수는 다음을 비롯한 여러 가지 정보를 보유할 수 있습니다.As the examples later in this topic show, global variables can hold several kinds of information, including these:

  • 단일 값a single value
  • 레코드a record
  • 테이블a table
  • 개체 참조an object reference
  • 수식의 결과any result from a formula

전역 변수는 앱을 닫을 때까지 값을 유지합니다.A global variable holds its value until the app is closed. 전역 변수의 값은 앱이 닫히면 손실되고 앱이 다시 로드될 때 다시 생성되어야 합니다.Once closed, the global variable's value will be lost and must be recreated when the app is loaded again.

전역 변수는 기존 컬렉션이나 컨트롤과 동일한 이름을 사용할 수 없습니다.Global variables cannot use the same name as an existing collection or control. 컨텍스트 변수와 동일한 이름을 사용할 수 있습니다.It can use the same name as a context variable. 둘 사이의 모호함을 해결하려면 명확성 연산자를 사용하십시오.To disambiguate between the two, use the disambiguation operator.

Set에는 반환 값이 없으며 동작 수식 내에만 사용할 수 있습니다.Set has no return value, and you can use it only within a behavior formula.

구문Syntax

Set( VariableName, Value )Set( VariableName, Value )

  • VariableName - 필수 항목입니다.VariableName - Required. 만들거나 업데이트할 전역 변수의 이름입니다.The name of a global variable to create or update.
  • Value - 필수 항목입니다.Value - Required. 컨텍스트 변수에 할당할 값입니다.The value to assign to the context variable.

Examples

수식Formula 설명Description 결과Result
Set( Counter, 1 )Set( Counter, 1 ) 전역 변수 Counter를 생성하거나 수정하고 값을 1로 설정합니다.Creates or modifies the global variable Counter, setting its value to 1. Counter의 값은 1입니다.Counter has the value 1. 원하는 화면의 수식에 Counter라는 이름을 사용하여 해당 변수를 참조할 수 있습니다.You can reference that variable by using the name Counter in a formula on any screen.
Set( Counter, 2 )Set( Counter, 2 ) 앞 예제의 Counter 전역 변수 값을 2로 설정합니다.Sets the value of the Counter global variable from the previous example to 2. Counter의 값은 2입니다.Counter has the value 2.
Set( Counter, Counter + 1 )Set( Counter, Counter + 1 ) 앞 예제의 Counter 전역 변수 값을 3으로 증가시킵니다.Increments the value of the Counter global variable from the previous example to 3. Counter의 값은 3입니다.Counter has the value 3.
Set( Name, "Lily" )Set( Name, "Lily" ) 전역 변수 Name를 생성하거나 수정하고 값을 Lily로 설정합니다.Creates or modifies the global variable Name setting its value to Lily. Name의 값은 Lily입니다.Name has the value Lily.
Set( Person, { Name: "Milton", Address: "1 Main St" } )Set( Person, { Name: "Milton", Address: "1 Main St" } ) 전역 변수 Person을 생성하거나 수정하고 값을 레코드로 설정합니다.Creates or modifies the global variable Person, setting its value to a record. 이 레코드는 NameAddress라는 두 개의 열을 포함합니다.The record contains two columns, named Name and Address. Name 열의 값은 Milton이고 Address 열의 값은 1 Main St입니다.The value of the Name column is Milton, and the value of the Address column is 1 Main St. Person 의 값은 { Name: "Milton", Address: "1 Main St" }라는 레코드입니다.Person has the value of record { Name: "Milton", Address: "1 Main St" }.

이 레코드 전체를 Person이라는 이름으로 참조하거나 이 레코드의 개별 열을 Person.Name 또는 Person.Address로 참조합니다.Reference this record as a whole with the name Person, or reference an individual column of this record with Person.Name or Person.Address.
Set( Person, Patch( Person, {Address: "2 Main St" } ) )Set( Person, Patch( Person, {Address: "2 Main St" } ) ) Patch 함수로 Address 열의 값을 2 Main St로 설정하여 Person 전역 변수를 업데이트합니다.Works with the Patch function to update the Person global variable by setting the value of the Address column to 2 Main St. 이제 Person의 값은 { Name: "Milton", Address: "2 Main St" }라는 레코드입니다.Person now has the value of record { Name: "Milton", Address: "2 Main St" }.