GUID 함수

적용 대상: 캔버스 앱 Copilot Studio Desktop 흐름 모델 기반 앱 Power Platform CLI Dataverse 함수

GUID (전역적으로 고유한 식별자) 문자열을 값으로 GUID 변환하거나 새 GUID 값을 만듭니다.

설명

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

문자열은 대문자 또는 소문자를 가질 수 있지만 다음 형식 중 하나로 326진수여야 합니다.

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

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

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

GUID 는 인수 없이 사용할 때 휘발성 함수입니다. 이러한 함수는 평가될 때마다 다른 값을 반환합니다.

데이터 흐름 수식에서 휘발성 함수를 사용하는 경우 수식이 다시 평가되는 경우에만 다른 값을 반환합니다. 수식에서 아무것도 변경되지 않으면 앱이 열려 있는 동안 동일한 값을 유지합니다.

예를 들어 레이블 컨트롤 GUID의 Text 속성을 ()로 설정하면 앱이 활성 상태일 때 변경되지 않습니다. 앱을 닫았다가 다시 열 때만 다른 값을 얻습니다.

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

TextInput1.Text & " " & GUID()

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

GUID( [ GUIDString ] )

GUIDString – 선택 사항. 16진수 표현이 있는 텍스트 문자열입니다 GUID. 문자열을 제공하지 않으면 함수는 새 GUID문자열을 만듭니다.

GUID( 동적 )

동적 – 필수 요소입니다. 를 나타내는 동적 값입니다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는 앱을 디버그하는 데 도움이 될 수 있습니다. 이전 예제에서 만든 레코드의 상태 필드 값을 표시하려면 레이블 컨트롤의 Text 속성을 다음 수식으로 설정합니다.

First( Products ).Status

레이블 컨트롤은 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() )

이 페이지가 도움이 되었나요?