GUID chức năng

Áp dụng cho: Ứng dụng Canvas Copilot Studio Desktop dòng ứng dụng dựa trên mô hình Power Platform CLI Dataverse chức năng

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

Mô tả

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

Chuỗi có thể có chữ hoa hoặc chữ thường nhưng phải có 32 chữ số thập lục phân ở một trong các đị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 xác định đối số, hàm sẽ tạo ra một đối số mới GUID.

Để chuyển đổi giá GUID trị thành chuỗi, hãy sử dụng giá trị đó trong ngữ cảnh chuỗi. Giá GUID trị chuyển đổi thành một chuỗi thập lục phân với các gạch nối và chữ thường.

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

Hàm biến đổi

GUID là một hàm biến đổi khi được 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 bạn sử dụng hàm biến đổi trong công thức dòng dữ liệu, nó chỉ trả về giá trị khác nếu công thức được đánh giá lại. Nếu không có gì thay đổi trong công thức, nó sẽ giữ cùng một giá trị trong khi ứng dụng của bạn đang mở.

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

Hàm được đánh giá lại nếu nó là một phần của công thức khi có thay đổi khác. Ví dụ: nếu bạn đặt thuộc tính Văn bản của điều khiển Nhãn thành công thức này, GUID thì mỗi lần người dùng thay đổi giá trị của điều khiển nhập Văn bản:

TextInput1.Text & " " & GUID()

Khi bạn sử GUID dụng trong công thức hành vi, nó được đánh giá mỗi lần 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( [ GUIDString ] )

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

GUID( Động )

• Động – Bắt buộc. Giá trị động đại diện cho GUID. Các giá trị có thể chấp nhận phụ thuộc vào nhà cung cấp chưa nhập. Đối với JSON, giá trị động dự kiến sẽ là một GUID giá trị được thể hiện dưới dạng chuỗi JSON.

Ví dụ

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

Để trả về GUID một giá trị dựa trên biểu diễn chuỗi thập lục phân:

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

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

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" ) } )

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

First( Products ).Status

Điều khiển Nhãn hiển thị f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4.

Tạo một bảng GUID

1. Đặ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.

2. 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.

3. Nhấn và giữ phím Alt, rồi chọn nút đó.

   Bảng dữ liệu hiển thị danh sách GUID:

   

4. Chọn nút một lần nữa để hiển thị danh sách GUID mới:

   

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

Set( NewGUID, GUID() )