הקצאת ישות

רלוונטי ל: Dynamics 365 Sales

הערה

• הכלים והדוגמאות בתיעוד זה ממחישים את היכולות הנוכחיות. שמות הכלים, תיאורים, פרמטרים, פורמטי תגובה והפונקציונליות הזמינה יכולים להשתנות עם הזמן.
• כשאתה בונה סוכנים, אינטגרציות או לוגיקת אורקסטרציה, אל תקודד תלות קשיחת על שמות כלים מסוימים, מבני פרמטרים, מטא-דאטה של כלי או סכימות תגובה. במקום זאת, עצב את הפתרון שלך כך שיגלה וישתמש בכלים זמינים בזמן הריצה.
• ככל שהפלטפורמה מתפתחת, Microsoft עשויה להוסיף, להסיר, לשנות שם או לשנות כלים ומטא-דאטה של כלים. עיצוב לפי יכולות ולא לפי מזהי כלים ספציפיים מסייע לשמור על תאימות בין עדכוני השירות.

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

מה הוא עושה

העוזר מעדכן את בעלות הרשומה עבור מטרות משתמש או קבוצה באמצעות פעולת ההקצאה של Dataverse. עבור יעדי תור, הוא מנתב את הרשומה לתור כאשר הטבלה תומכת בניתוב תור.

לפני שהוא מבצע שינוי, העוזר בודק את המטא-דאטה של Dataverse של הטבלה כאשר המטא-דאטה זמינה. אם הטבלה בבעלות הארגון (הרשומות שלה ללא בעלים), או אם תבקש לנתב רשומה מטבלה שלא מופעלת לתורים, העוזר מחזיר הסבר ברור במקום לנסות פעולה ש-Dataverse הייתה דוחה. אם המטא-דאטה לא ניתנת לקריאה, Dataverse נשארת מקור האמת והפעולה ממשיכה לבדיקת הפלטפורמה.

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

נסה הנחיות כמו

• תן לי את ההזדמנות הזו.
• נתב את זה לתור המכירות הארגוני.
• הקצו את החשבון הזה לג'ורדן רייס.
• העבר את הרשומה המותאמת לצוות החידוש.

מה שתראו בצ'אט

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

טיפים שימושיים

• השתמש בכלים ספציפיים לרשומות כשיש להם דרישות עסקיות נוספות. לדוגמה, שימוש reassign_case במקרים של תמיכה שדורשים פתק העברה.
• השתמש בשמות יעד מדויקים, כתובות אימייל או GUIDs כשאפשר כדי להימנע מהתאמות מעורפלות.
• השתמש targetId בערך me רק כאשר הוא משיך למשתמש הנוכחי ו targetType - הוא user.

מה קורה הלאה?

• פתח את התקליט.
• הצג פעילות עדכנית.
• הוסף הערה לגבי ההעברה.

האם זה משנה את הנתונים?

כן, זה יכול לשנות נתונים.

‏‫דרישות מוקדמות‬

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

סיכום הכלים

מאפיין‬	ערך:
שם המשתמש	הקצאת ישות
שם הכלי הפנימי	assign_entity
מטרה	הקצה רשומת Dataverse למשתמש או צוות, או נתב אותה לתור.

התנהגות כלי

הכלי משנה את בעל הרשומה עבור יעדי משתמשים וצוותים. עבור יעדי תור, הוא מוסיף את הרשומה לתור שצוין כאשר Dataverse תומך בניתוב תור עבור אותה טבלה. הוא לא יוצר הערות העברה או מבצע שלבי עבודה ספציפיים לתחום.

לפני שהוא מקצה או מנתב רשומה, הכלי קורא את OwnershipType הטבלאות והמטא-דאטה IsValidForQueue מ-Dataverse. הוא מחזיר הודעת קדם-טיסה ברורה כאשר הקצאה לא מצליחה — לדוגמה, כאשר הטבלה בבעלות הארגון ואין לה בעלים לשנות, או כאשר הטבלה אינה מופעלת לתורים. אם המטא-דאטה הזה לא ניתן לקריאה, הכלי ממשיך ומאפשר ל-Dataverse לאכוף את הכלל.

ביאורים

ביאור	ערך:	משמעות
readOnlyHint	false	כלי זה משנה נתונים.
destructiveHint	false	הכלי הזה לא מבצע שינויים הרסניים.
idempotentHint	false	קריאות חוזרות אינן מובטחות להיות שוות ערך — ניתוב תור מוסיף פריט תור בכל פעם.
openWorldHint	לא הוגדר	משתמש בהתנהגות ברירת מחדל.

מושגי קלט

רשומה ומטרה

קלט	תיאור	חובה
entityLogicalName	שם לוגי של Dataverse עבור הרשומה להקצאה, כגון account, opportunity, lead, או incident.	‏‏כן‬
recordId	GUID של Dataverse עבור הרשומה להקצה.	‏‏כן‬
targetType	סוג יעד הקצאה: user, team, או queue.	‏‏כן‬
targetId	משתמש יעד, צוות או GUID בתור; me למשתמש הנוכחי; כתובת דוא"ל כאשר נתמך; או שם תצוגה.	‏‏כן‬

תגובה והתנהגות ממשק משתמש

סוג תגובה

טקסט בלבד

לא מופיע רכיב אינטראקטיבי.

הערות ניתוב

השתמש assign_entity כאשר המשתמש רוצה:

• הקצה רשומת Dataverse כללית למשתמש או לצוות.
• נתב רשומה נתמכת לתור.
• שנה בעלות עבור סוג רשומה שאין לו כלי הקצאה ספציפי יותר.

אל תשתמש assign_entity כשהמשתמש רוצה:

• הוספת הערת העברה בעת העברת מארז תמיכה; שימוש reassign_caseב-.
• עדכן ערך שדה רגיל; השתמש update_entity_recordב-.
• צור משימה או פעילות ציר זמן; השתמש create_activityב-.

כלים קשורים

כלי	מערכת יחסים
reassign_case	שימוש בהעברות לתיק תמיכה שדורשות פתק מסירה.
update_entity_record	משתמשים בו לעדכוני שדה שאינם הקצאות בעלים או תורים.
get_entity_record	השתמש בבדיקת הרשומה לפני או אחרי ההקצאה.

סיווג מוטציות נתונים

כתיבה / מוטציה.

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