Chức năng GUID

Bài viết
03/22/2024

Áp dụng cho: Ứng dụng Canvas Luồng máy tính để bàn Ứng dụng dựa trên mô hình Power Platform CLI

Chuyển đổi chuỗi GUID (Mã định danh duy nhất toàn cầu) thành giá trị GUID hoặc tạo giá trị GUID mới.

Mô tả

Sử dụng hàm GUID để chuyển đổi một chuỗi chứa dạng thập lục phân của GUID thành giá trị GUID có thể chuyển vào cơ sở dữ liệu. Giá trị GUID được các hệ thống cơ sở dữ liệu như Microsoft Dataverse và SQL Server sử dụng làm khóa.

Chuỗi được chuyển có thể chứa chữ hoa hoặc chữ thường, nhưng nó phải gồm 32 chữ số thập lục phân ở một trong hai định dạng sau:

"123e4567-e89b-12d3-a456-426655440000" (dấu gạch nối ở vị trí chuẩn)
"123e4567e89b12d3a456426655440000" (không có dấu gạch nối)

Nếu bạn không chỉ định một đối số, hàm này sẽ tạo GUID mới.

Để chuyển đổi giá trị GUID thành chuỗi, chỉ cần sử dụng giá trị đó trong ngữ cảnh chuỗi. Giá trị GUID sẽ được chuyển đổi thành chuỗi thập lục phân với dấu gạch nối và chữ thường.

Khi tạo GUID mới, hàm này sử dụng các số giả ngẫu nhiên để tạo GUID phiên bản 4 IETF RFC 4122. Khi chuyển đổi một chuỗi thành GUID, hàm này hỗ trợ bất kỳ phiên bản GUID nào bằng cách chấp nhận mọi chuỗi gồm 32 chữ số thập lục phân nào.

Hàm biến đổi

GUID là một hàm biến động khi sử dụng mà không có đối số. Mỗi khi thực thi, hàm này sẽ trả về một giá trị khác nhau.

Khi được sử dụng trong công thức luồng dữ liệu, hàm biến đổi sẽ chỉ trả về một giá trị khác nếu công thức trong hàm được đánh giá lại. Nếu các yếu tố khác trong công thức không đổi, công thức sẽ có cùng giá trị trong suốt quá trình ứng dụng hoạt động.

Ví dụ: một công cụ điều khiển nhãn có thuộc tính Văn bản được đặt thành GUID() sẽ không thay đổi khi ứng dụng của bạn đang hoạt động. Chỉ cần đóng rồi mở lại ứng dụng, hàm sẽ trả về một giá trị khác.

Hàm này sẽ được đánh giá lại nếu nằm trong công thức có yếu tố thay đổi. Nếu đặt thuộc tính Văn bản của công cụ điều khiển Label thành công thức sau, chẳng hạn như GUID được tạo mỗi khi người dùng thay đổi giá trị của Text input:

TextInput1. Văn bản & " " & GUID()

Khi được sử dụng trong công thức hành vi, hàm GUID sẽ được đánh giá mỗi khi công thức được đánh giá. Để biết thêm thông tin, hãy xem các ví dụ ở cuối chủ đề này.

Cú pháp

GUID( [ Chuỗi GUID ] )

GUIDString – Tùy chọn. Một chuỗi văn bản chứa chuỗi thập lục phân của GUID. Nếu không có chuỗi nào, hàm sẽ tạo giá trị GUID mới.

GUID( Không được gõ )

Không gõ - Bắt buộc. đối tượng chưa được phân loại đại diện cho GUID. Các giá trị được chấp nhận phụ thuộc vào nhà cung cấp chưa được nhập. Đối với JSON, Đối tượng chưa được phân loại sẽ là GUID được biểu thị ở dạng chuỗi JSON.

Ví dụ

Cách sử dụng cơ bản

Để trả về giá trị GUID dựa trên chuỗi thập lục phân:

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

Bạn cũng có thể thêm chuỗi GUID không có dấu gạch nối. Công thức này trả về cùng giá trị GUID:

GUID( "0f8fad5bd9cb469fa16570867728950e" )

Sử dụng trong ngữ cảnh, đặt trường Status (Trạng thái) của một bản ghi cơ sở dữ liệu mới thành giá trị rõ ràng:

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

Có thể bạn không muốn hiển thị GUID với người dùng, nhưng GUID có thể giúp bạn gỡ lỗi ứng dụng. Để hiển thị giá trị của trường Status trong bản ghi mà bạn đã tạo ở ví dụ trước, hãy đặt thuộc tính Văn bản của công cụ điều khiển Label thành công thức sau:

First( Products ).Status

Công cụ điều khiển Label sẽ hiển thị f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Tạo một bảng GUID

Đặt thuộc tính OnSelect của công cụ điều khiển Button thành công thức sau:
```
ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
```
Công thức này tạo bảng một cột được sử dụng lặp lại 5 lần, dẫn đến 5 giá trị GUID.
Thêm tùy chọn Bảng dữ liệu, đặt thuộc tính Items thành NewGUIDs và hiển thị trường Value.
Chọn nút bằng cách bấm hoặc nhấn vào nút đó đồng thời nhấn và giữ phím Alt.

Bảng dữ liệu hiển thị danh sách GUID:
Chọn lại nút để hiển thị danh sách GUID khác:

Để tạo một GUID duy nhất thay vì bảng, hãy sử dụng công thức sau:

Set( NewGUID, GUID() )

Chia sẻ qua