GUID פונקציה

חל על: אפליקציות Canvas Copilot Studio Desktop זורמות אפליקציות מונחות מודלים פונקציות Power Platform CLI Dataverse

המר מחרוזת GUID (מזהה ייחודי כללי) לערך GUID , או צור ערך GUID חדש.

תיאור

השתמש בפונקציה GUID כדי להמיר מחרוזת עם הייצוג ההקסדצימאלי GUIDGUID של ערך שניתן להעביר למסד נתונים. מערכות מסד נתונים כגון Microsoft Dataverse ו- SQL Server משתמשות GUID בערךים כמפתחות.

המחרוזת יכולה לכלול אותיות רישיות או קטנות, אך היא חייבת להיות 32 ספרות הקסדצימאליות באחת מהתבניות הבאות:

• "123e4567-e89b-12d3-a456-426655440000" (מקפים במיקומים סטנדרטיים)
• "123e4567e89b12d3a456426655440000" (ללא מקפים)

אם לא תציין ארגומנט, הפונקציה תיצור ארגומנט חדש GUID.

כדי להמיר GUID ערך למחרוזת, השתמש בו בהקשר מחרוזת. הערך GUID ממיר למחרוזת הקסדצימאלית עם מקפים ואותיות קטנות.

בעת יצירת ערך חדש GUID, הפונקציה משתמשת במספרים מדומה-אקראיים כדי ליצור גירסה 4 IETF RFC 4122GUID. בעת המרת מחרוזת ל- GUID, הפונקציה GUID תומכת בכל גירסה על-ידי קבלת כל מחרוזת של 32 ספרות הקסדצימאליות.

פונקציות נדיפות

GUID היא פונקציה נדיפות כאשר נעשה בה שימוש ללא ארגומנט. בכל פעם שהפונקציה מוערכת, היא מחזירה ערך אחר.

בעת שימוש בפונקציה נדיפות בנוסחת זרימת נתונים, היא מחזירה ערך שונה רק אם הנוסחה מוערכת מחדש. אם שום דבר אחר אינו משתנה בנוסחה, הוא שומר את אותו ערך כאשר האפליקציה פתוחה.

לדוגמה, אם תגדיר את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 של פקד Button‎ לנוסחה זו:

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

   נוסחה זו יוצרת טבלה בת עמודה אחת המשמשת לחזרה חמש פעמים, והתוצאה היא חמישה מזהי GUID.

2. הוסף פקד Data table, הגדר את המאפיין Items‎ שלו ל- NewGUIDs, והצג את השדה ערך.

3. החזק את מקש Alt לחוץ ובחר את הלחצן.

   טבלת הנתונים מציגה רשימה של מזהי GUID:

   

4. בחר שוב בלחצן כדי להציג רשימה חדשה של מזהי GUID:

   

כדי ליצור טבלה בודדת GUID במקום טבלה, השתמש בנוסחה זו:

Set( NewGUID, GUID() )