GUID 함수

적용 대상: 캔버스 앱 데스크톱 흐름 모델 기반 앱 Power Platform CLI

GUID(Globally Unique Identifier) 문자열을 GUID 값으로 변환하거나 새 GUID 값을 만듭니다.

설명

GUID 함수를 사용하여 GUID의 16진수 표현을 포함하는 문자열을 데이터베이스로 전달할 수 있는 GUID 값으로 변환합니다. GUID 값은 Microsoft Dataverse 및 SQL Server.와 같은 데이터베이스 시스템에서 키로 사용됩니다.

전달된 문자열에는 대문자 또는 소문자가 포함될 수 있지만, 다음 형식 중 하나에는 32자리 16진수여야 합니다.

인수를 지정하지 않으면 이 함수는 새 GUID를 만듭니다.

GUID 값을 문자열로 변환하려면 문자열 컨텍스트에서 사용합니다. GUID 값은 하이픈과 소문자로 구성된 16진수 표현 문자열로 변환됩니다.

새 GUID를 생성 할 때 이 함수는 의사 난수를 사용하여 버전 4 IETF RFC 4122 GUID를 만듭니다. 문자열을 GUID로 변환 할 때 이 함수는 32개의 16 진수 문자열을 허용하여 모든 GUID 버전을 지원합니다.

GUID는 인수 없이 사용되는 일시적 함수입니다. 이러한 함수는 평가될 때마다 다른 값을 반환합니다.

데이터 흐름 수식을 사용하면 표시되는 수식을 다시 계산하는 경우 일시적 함수는 다른 값만을 반환합니다. 수식에서 변경되는 내용이 없으면 앱 실행 내내 같은 값을 갖습니다.

예를 들어 Text 속성이 GUID()로 설정된 레이블 컨트롤은 앱이 활성 상태인 동안에는 변경되지 않습니다. 앱을 닫았다가 다시 여는 것만 다른 값이 발생합니다.

함수가 다른 내용이 변경된 수식의 일부인 경우 다시 평가됩니다. 예를 들어 Label 컨트롤의 Text 속성을 이 수식으로 설정하면 사용자가 Text input 컨트롤의 값을 변경할 때마다 GUID가 생성됩니다.

TextInput1.Text & " " & GUID()

동작 수식에서 사용될 경우 GUID는 수식이 계산될 때마다 평가됩니다. 자세한 내용은 이 토픽 뒷부분에 있는 예제를 참조하십시오.

GUID( [ GUIDString ] )

GUIDString – 선택 사항입니다. GUID의 16진수 표현을 포함하는 텍스트 문자열입니다. 문자열이 제공되지 않으면 새 GUID가 생성됩니다.

GUID( 무형식 )

Untyped - 필수 항목입니다. 무형식 개체로, GUID를 나타냅니다. 허용되는 값은 무형식 공급자에 따라 다릅니다. JSON의 경우 형식이 지정되지 않은 개체는 JSON 문자열로 표현되는 GUID여야 합니다.

16진수 문자열 표현을 기반으로 하는 GUID 값을 반환하려면:

GUID( "0f8fad5b-d9cb-469f-a165-70867728950e" )

하이픈 없이 GUID 문자열을 제공할 수도 있습니다. 이 수식은 동일한 GUID 값을 반환합니다.

GUID( "0f8fad5bd9cb469fa16570867728950e" )

컨텍스트에서 사용하여 새 데이터베이스 레코드의 상태 필드를 잘 설정된 값으로 설정합니다.

Patch( Products, Default( Products ), { Status: GUID( "F9168C5E-CEB2-4faa-B6BF-329BF39FA1E4" ) } )

사용자에게 GUID를 표시하지 않을 수도 있지만 GUID를 사용하면 응용 프로그램을 디버그하는 데 도움이 될 수 있습니다. 이전 예에서 만든 레코드에서 상태 필드 값을 표시하려면 Label 컨트롤의 Text 속성을 다음 수식으로 설정합니다.

First( Products ).Status

Label 컨트롤에서 f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4가 표시됩니다.

Button 컨트롤의 OnSelect 속성을 다음 수식으로 설정합니다.
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
이 수식은 다섯 번 반복하는 데 사용되는 단일 열 테이블을 만들어 5개의 GUID를 생성합니다.
Data table 컨트롤을 추가하고, 해당 Items 속성을 NewGUIDs로 설정하고, Value 필드를 표시합니다.
Alt 키를 누른 채 클릭하거나 눌러 단추를 선택합니다.

데이터 테이블에는 다음과 같은 GUID 목록이 표시됩니다.
단추를 다시 선택하여 다른 GUID 목록을 표시합니다.

테이블 대신 단일 GUID를 생성하려면 이 수식을 사용합니다.

Set( NewGUID, GUID() )