UpdateContext 함수
적용 대상:
Canvas 앱
현재 화면의 컨텍스트 변수를 만들거나 업데이트합니다.
개요
UpdateContext 함수를 사용하여 사용자가 단추를 선택한 횟수 또는 데이터 작업의 결과와 같은 정보를 임시로 보관하는 컨텍스트 변수를 만듭니다.
컨텍스트 변수는 범위가 화면으로 한정되므로 다른 화면의 컨텍스트 변수를 참조하는 수식을 작성할 수 없습니다. 다른 프로그래밍 도구를 사용한 경우 컨텍스트 변수를 로컬 변수와 비슷하다고 생각할 수 있습니다. Set 함수를 사용하여 앱 전체에서 사용할 수 있는 전역 변수로 작업합니다.
Power Apps는 사용자가 앱과 상호 작용할 때 자동으로 다시 계산되는 수식을 기반으로 합니다. 컨텍스트 변수는 이러한 혜택들 제공하지 않기 때문에 앱을 만들고 이해하기 어려울 수 있습니다. 컨텍스트 변수를 사용하기 전에 변수 작업을 검토하십시오.
설명
컨텍스트 변수를 만들거나 업데이트하려면 UpdateContext 함수에 단일 레코드를 전달하십시오. 각 레코드에서 변수 이름을 정의하거나 일치시키는 열의 이름과 해당 변수를 설정할 값을 지정합니다.
- 이전에 정의한 변수의 이름을 지정하면 UpdateContext는 변수 값을 사용자가 지정하는 값으로 설정합니다.
- 아직 존재하지 않는 변수의 이름을 지정하면 UpdateContext는 해당 이름의 변수를 만들고 해당 변수의 값을 사용자가 지정하는 값으로 설정합니다.
- 이전에 변수를 정의했지만 이 특정 UpdateContext 수식에 지정하지 않은 경우 해당 값은 동일하게 유지됩니다.
컨텍스트 변수는 UpdateContext 또는 Navigate 함수를 사용하여 암시적으로 생성됩니다. 명시적 선언은 필요하지 않습니다. 컨텍스트 변수에 대한 모든 UpdateContext 및 Navigate 참조를 제거하는 경우 컨텍스트 변수가 사라집니다. 변수를 지우려면 변수 값을 Blank 함수의 결과로 설정하십시오.
변수의 값, 정의 및 용도는 작성 환경의 파일 메뉴에 있는 변수 보기를 사용하여 볼 수 있습니다.
변수의 열 이름을 사용하여 수식에서 컨텍스트 변수를 참조합니다. 예를 들어, UpdateContext( { ShowLogo: true } )는 ShowLogo라는 컨텍스트 변수를 만들고 해당 값을 true로 설정합니다. 그런 다음 수식에서 ShowLogo라는 이름을 사용하여 이 컨텍스트 변수 값을 사용할 수 있습니다. 이미지 컨트롤의 Visible 속성에 대한 수식으로 ShowLogo를 쓰고 컨텍스트 변수의 값이 true 또는 false인지 여부에 따라 해당 컨트롤을 표시하거나 숨길 수 있습니다.
이 항목의 뒷부분에 나오는 예제에서 알 수 있듯이 컨텍스트 변수는 다음을 비롯한 여러 가지 정보를 보유할 수 있습니다.
- 단일 값
- 레코드
- 테이블
- 개체 참조
- 수식의 결과
컨텍스트 변수는 앱이 닫힐 때까지 해당 값을 유지합니다. 컨텍스트 변수를 정의하고 특정 화면에서 해당 값을 설정하면 사용자가 다른 화면으로 전환하더라도 해당 정보가 그대로 유지됩니다. 앱이 닫히면 손실되는 컨텍스트 변수의 값은 앱이 다시 로드되면 다시 생성되어야 합니다.
모든 컨텍스트 변수는 범위가 화면으로 한정됩니다. 한 화면에서 컨텍스트 변수를 정의하고 해당 변수를 다른 화면에서 수정하려면 Navigate를 기반으로 수식을 작성해야 합니다. 또는 전역 변수를 사용합니다.
UpdateContext 에는 반환 값이 없으며, 동작 수식 내에서만 사용할 수 있습니다.
구문
업데이트 컨텍스트( 업데이트 레코드 )
- UpdateRecord – 필수. 하나 이상의 열 이름과 해당 열에 대한 값을 포함하는 레코드입니다. 컨텍스트 변수는 사용자가 지정한 각 열과 값에 대해 만들어지거나 업데이트됩니다.
UpdateContext( { 컨텍스트변수1: 값1 [, 컨텍스트변수2: 값2 [, ... ] ] } )
- ContextVariable1 - 필수. 만들거나 업데이트할 컨텍스트 변수의 이름입니다.
- Value1 - 필수. 컨텍스트 변수에 할당할 값입니다.
- ContextVariable2: Value2, ... - 선택 사항. 만들거나 업데이트할 추가 컨텍스트 변수 및 값입니다.
예제
| 수식 | 설명 | 결과 |
|---|---|---|
| UpdateContext( { 카운터: 1 } ) | 컨텍스트 변수 Counter를 생성하거나 수정하고 값을 1로 설정합니다. | 카운터 값은 1입니다. 수식에 Counter라는 이름을 사용하여 해당 변수를 참조할 수 있습니다. |
| UpdateContext( { 카운터: 2 } ) | 앞 예제의 Counter 컨텍스트 변수 값을 2로 설정합니다. | 카운터 값은 2입니다. |
| UpdateContext( { 이름: "Lily", 점수: 10 } ) | 컨텍스트 변수 Name 및 Score를 만들거나 수정하고 값을 각각 Lily 및 10으로 설정합니다. | Name 은 값 Lily를 갖고, Score 은 값 10을 갖습니다. |
| UpdateContext( { 사람: { 이름: "Milton", 주소: "1 Main St" } } ) | 컨텍스트 변수 Person을 만들거나 수정하고 해당 값을 레코드로 설정합니다. 이 레코드에는 Name과 Address라는 두 개의 열이 포함되어 있습니다. Name 열의 값은 Milton이고 Address 열의 값은 1 Main St입니다. | 사람 은 레코드 값 { 이름: "Milton", 주소: "1 Main St" } }을 갖습니다. 이 레코드 전체를 Person이라는 이름으로 참조하거나 이 레코드의 개별 열을 Person.Name 또는 Person.Address로 참조합니다. |
| UpdateContext( { 사람: 패치(사람, {주소: "2 Main St" } ) } ) | Patch 함수로 작업하여 Address 열의 값을 2 Main St로 설정하여 Person 컨텍스트 변수를 업데이트합니다. | 이제 Person 은 레코드 값인 { Name: "Milton", Address: "2 Main St" } }을 갖습니다. |
단계별 예제 1
기본 화면 이름을 Source로 지정하고 다른 화면을 추가한 후 이름을 Target으로 지정합니다.
Source 화면에서 단추 두 개를 추가하고 해당 Text 속성을 하나는 English로, 다른 하나는 Spanish로 설정합니다.
English 단추의 OnSelect 속성을 다음 식으로 설정합니다.
탐색(대상, ScreenTransition.Fade, {언어: "영어"})Spanish 단추의 OnSelect 속성을 다음 식으로 설정합니다.
탐색(대상, ScreenTransition.Fade, {언어: "스페인어"})Target 화면에서 레이블을 추가하고 해당 Text 속성을 다음 식으로 설정합니다.
If(Language="한국어", "안녕하세요!", "안녕하세요!")Target 화면의 Insert 탭에서 Shapes를 선택한 후 뒤로 화살표를 선택합니다.
뒤로 화살표의 OnSelect 속성을 다음 수식으로 설정합니다.
탐색(소스, 화면 전환.페이드)Source 화면에서 F5 키를 누른 후 두 언어 중 하나에 대한 단추를 선택합니다.
Target 화면에서 레이블이 선택한 단추에 해당하는 언어로 나타납니다.
뒤로 화살표를 선택하여 Source 화면으로 돌아간 후 다른 언어에 대한 단추를 선택합니다.
Target 화면에서 레이블이 선택한 단추에 해당하는 언어로 나타납니다.
기본 작업 영역으로 돌아가려면 Esc를 누릅니다.
단계별 예제 2
- 이 수식을 사용하려는 캔버스 앱을 엽니다.
- 명령 모음에서 새 화면을 선택하여 빈 화면을 새로 추가합니다.
- 단추를 추가하고 OnSelect 속성을 이 수식으로 설정합니다.
UpdateContext( { 이름: "Lily", 점수: 10 } )