ฟังก์ชัน GUID

นําไปใช้กับ: แอป พื้นที่ทํางาน Copilot Studio Desktop โฟลว์ แอป แบบจําลอง Power Platform CLI ฟังก์ชัน Dataverse

GUID แปลงสตริง (ตัวระบุที่ไม่ซ้ํากันทั่วโลก) เป็นGUIDค่า หรือสร้างค่าใหม่GUID

คำอธิบาย

GUIDใช้ฟังก์ชันเพื่อแปลงสตริงที่มีการแสดงเลขฐานสิบหกของ GUID เป็นGUIDค่าที่คุณสามารถส่งผ่านไปยังฐานข้อมูลได้ ระบบฐานข้อมูล เช่น Microsoft Dataverse และ SQL Server ใช้ GUID ค่าเป็นคีย์

สตริงอาจมีตัวอักษรตัวพิมพ์ใหญ่หรือตัวพิมพ์เล็ก แต่จะต้องเป็นเลขฐานสิบหก 32 หลักในรูปแบบเหล่านี้:

• "123e4567-e89b-12d3-a456-426655440000" (เครื่องหมายขีดกลางในตำแหน่งมาตรฐาน)
• "123e4567e89b12d3a456426655440000" (ไม่มีเครื่องหมายขีดกลาง)

ถ้าคุณไม่ได้ระบุอาร์กิวเมนต์ ฟังก์ชันจะสร้าง ใหม่GUID

หากต้องการแปลงค่าเป็น GUID สตริง ให้ใช้ค่าดังกล่าวในบริบทสตริง ค่า GUID แปลงเป็นสตริงเลขฐานสิบหกที่มีเครื่องหมายยัติภังค์และตัวอักษรพิมพ์เล็ก

เมื่อสร้างใหม่ GUIDฟังก์ชันจะใช้ตัวเลขกึ่งสุ่มในการสร้างเวอร์ชัน 4 IETF RFC 4122GUID เมื่อแปลงสตริงเป็น GUIDฟังก์ชัน จะสนับสนุนเวอร์ชันใดก็ตาม GUID โดยการยอมรับสตริงที่มีเลขฐานสิบหก 32 หลัก

ฟังก์ชันที่เปลี่ยนแปลงได้

GUID เป็นฟังก์ชันที่เปลี่ยนแปลงได้เมื่อใช้โดยไม่มีอาร์กิวเมนต์ แต่ละครั้งที่ประเมินค่าฟังก์ชัน ก็จะส่งค่าแตกต่างกันกลับมา

เมื่อคุณใช้ฟังก์ชันที่เปลี่ยนแปลงได้ในสูตรกระแสข้อมูล จะส่งกลับค่าที่แตกต่างกันก็ต่อเมื่อสูตรถูกประเมินอีกครั้ง ถ้าไม่มีสิ่งใดเปลี่ยนแปลงในสูตร จะเก็บค่าเดียวกันในขณะที่แอปของคุณเปิดอยู่

ตัวอย่างเช่น ถ้าคุณตั้งค่าคุณสมบัติ Text ของตัวควบคุมป้ายชื่อเป็น GUID() ตัวควบคุมจะไม่เปลี่ยนแปลงในขณะที่แอปของคุณทํางานอยู่ คุณจะได้รับค่าอื่นเมื่อคุณปิดและเปิดแอปใหม่เท่านั้น

ฟังก์ชันจะถูกประเมินอีกครั้งถ้าเป็นส่วนหนึ่งของสูตรที่บางสิ่งเปลี่ยนแปลง ตัวอย่างเช่น ถ้าคุณตั้งค่าคุณสมบัติ ข้อความ ของตัวควบคุม ป้ายชื่อ เป็นสูตร GUID นี้ ระบบจะสร้าง ขึ้นทุกครั้งที่ผู้ใช้เปลี่ยนค่าของตัวควบคุม การป้อนข้อความ :

TextInput1.Text & " " && GUID()

เมื่อคุณใช้ GUID ใน สูตรลักษณะการทํางาน จะมีการประเมินแต่ละครั้งที่มีการประเมินสูตร ดูข้อมูลเพิ่มเติมได้จากตัวอย่างในส่วนท้ายของหัวข้อนี้

ไวยากรณ์

GUID( [ GUIDString ] )

• GUIDString – ไม่บังคับ สตริงข้อความที่มีการแสดงเลขฐานสิบหกของGUID ถ้าคุณไม่ใส่สตริง ฟังก์ชันจะสร้าง ใหม่GUID

GUID( ไดนามิก )

• Dynamic – จําเป็นต้องมี ค่าไดนามิกที่แสดงถึงGUID ค่าที่ยอมรับได้ขึ้นอยู่กับตัวให้บริการที่ไม่ระบุชนิด สําหรับ JSON ค่าไดนามิกคาดว่าจะแสดงเป็น GUID สตริง JSON

ตัวอย่าง

การใช้งานพื้นฐาน

เมื่อต้องการแสดง GUID ค่าตามสตริงเลขฐานสิบหก:

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

คุณยังสามารถใส่ GUID สตริงได้โดยไม่ต้องใส่ยัติภังค์ สูตรนี้ส่งกลับค่าเดียวกัน GUID :

GUID( "0f8fad5bd9cb469fa16570867728950e" )

ใช้ในบริบท เพื่อกำหนดฟิลด์ สถานะ ของเรกคอร์ดฐานข้อมูลใหม่ เป็นค่าที่สร้างไว้อย่างดี:

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

คุณอาจไม่ต้องการแสดง GUID ให้ผู้ใช้เห็น แต่ GUID สามารถช่วยคุณในการแก้จุดบกพร่องแอปของคุณ เมื่อต้องการแสดงค่าของเขตข้อมูล สถานะ ในระเบียนที่คุณสร้างขึ้นในตัวอย่างก่อนหน้า ให้ตั้งค่าคุณสมบัติ ข้อความ ของตัวควบคุม ป้ายชื่อ เป็นสูตรนี้:

First( Products ).Status

ตัวควบคุม ป้ายชื่อ แสดง f9168c5e-ceb2-4faa-b6bf-329bf39fa1e4

สร้างตารางของ GUID

1. กำหนดคุณสมบัติ OnSelect ของตัวควบคุม ปุ่ม สำหรับสูตรนี้:

   ClearCollect( NewGUIDs, ForAll( Sequence(5), GUID() ) )
   

   สูตรนี้สร้างตารางหนึ่งคอลัมน์ที่ใช้เพื่อทำซ้ำห้าครั้ง โดยทำให้ได้ GUID ห้ารายการ

2. เพิ่มตัวควบคุม ตารางข้อมูล โดยกำหนดคุณสมบัติของ Items สำหรับ NewGUIDs และแสดงฟิลด์ ค่า

3. กดปุ่ม Alt ค้างไว้ และเลือกปุ่ม

   ตารางข้อมูลแสดงรายการ GUID:

   

4. เลือกปุ่มอีกครั้งเพื่อแสดงรายการ GUID ใหม่:

   

หากต้องการสร้างตารางเดียว GUID แทนตาราง ให้ใช้สูตรนี้:

Set( NewGUID, GUID() )