יצירת רשומת ישות

חל על: Dynamics 365 Customer Service ו-Dynamics 365 Sales

הערה

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

השתמש ביכולת זו כשאתה רוצה ליצור רשומת Dataverse חדשה ישירות מהצ'אט.

מה הוא עושה

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

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

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

• צור תיק בשם 'מכונת אספרסו דולפת' עבור חשבון Contoso.
• פתח תיק תמיכה לבעיה בחיוב בחשבון Contoso.
• תתעד מקרה 'גריינדר עושה רעש חזק' עבור פבריקאם.
• צרו חשבון חדש בשם Northwind Traders.
• הוסיפו איש קשר בשם פריה נאיר ב-Contoso.
• צור איש קשר, שם משפחה אוקאפור, שם פרטי אדה, דוא"ל ada@fabrikam.com.

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

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

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

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

עצה

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

מה קורה הלאה?

לאחר יצירת הרשומה, תוכל להמשיך עם הנחיות כמו:

• תראה את התקליט הזה.
• עדכן שדה באלבום הזה.
• צור רשומה נוספת.
• פתח את הרשומה הזו ב-Dynamics 365.

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

כן, זה יוצר רשומת Dataverse חדשה.

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

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

כלי זה זמין עבור המוצרים הרשומים בקו 'Apply' בראש עמוד זה. לא נדרשת תצורה נוספת. אתה צריך את הרשאת יצירת Dataverse על הישות שאתה יוצר.

סיכום הכלים

מאפיין‬	ערך:
שם המשתמש	יצירת רשומת ישות
שם הכלי הפנימי	create_entity_record
מטרה	יוצר מקרה חדש (אירוע), חשבון או רשומת קשר חדשה, פותר שמות חיפוש וביצוע שדות נדרשים לפני טיסה

התנהגות כלי

יוצר מקרה (אירוע), חשבון או רשומת קשר חדשה ב-Dynamics 365. השתמש כאשר המשתמש מבקש ליצור, לפתוח או לרשום תיק תמיכה, או ליצור חשבון חדש (חברה) או איש קשר (אדם). לכל פעילות (משימה, שיחת טלפון, פגישה, דואר אלקטרוני, מכתב, פקס, פעילות חברתית) השתמשו create_activityב; לשימוש בפתק create_note. שדות חיפוש המסופקים לפי שם (כגון לקוח המקרה או חברת איש הקשר) נפתרים אוטומטית לרשומה הרלוונטית; שם מעורפל מחזיר מועמדים להבחנה. אם שדה נדרש חסר, הכלי מחזיר את השדות החסרים כדי שהעוזר יוכל לבקש אותם ולנסות שוב. סוגי ישויות מחוץ למקרה, חשבון ואנשי קשר — כולל ישויות מערכת ואבטחה (משתמשים, צוותים, תפקידים, יחידות עסקיות) — אינם ניתנים ליצירת כאן.

ביאורים

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

מושגי קלט

סוג ישות

קלט	תיאור	חובה
entityLogicalName	entityLogicalName (מיתר נדרש). השם הלוגי של ישות Dataverse של הרשומה ליצירה: incident (case), account, or contact.	‏‏כן‬

ערכי שדות

קלט	תיאור	חובה
fields	fields (מפת מפתח-ערך). שמות לוגיים של שדות סקלריים לערכים (טקסט, מספרים, קודי אופציות, תאריכי ISO). לדוגמה: { "title": "Espresso machine leaking" } למקרה, { "name": "Northwind Traders" } לחשבון, או { "lastname": "Nair", "firstname": "Priya" } לאיש קשר.	לא

ערכי חיפוש

קלט	תיאור	חובה
lookups	lookups (מפת מפתח-ערך). חפש שמות לוגיים של שדות לשם רשומה או GUID קשור. דוגמה: { "customerid": "Contoso" } על תיק, או { "parentcustomerid": "Contoso" } על איש קשר. שמות נפתרים אוטומטית; שמות מעורפלים מחזירים מועמדים.	לא

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

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

סוג תגובה

תגובת טקסט (ללא רכיב אפליקציה בצ'אט)

הערות ניתוב

שימוש create_entity_record :

• יצירה, פתיחה או רישום של תיק תמיכה (incident).
• יצירת חשבון חדש—חברה או ארגון (account).
• יצירת קשר חדש—אדם (contact).

אל תשתמש create_entity_record ב:

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

כלים קשורים

כלי	קשר
get_entity_record	הצג רשומה לאחר יצירתו
update_entity_record	עדכון שדות ברשומה קיימת
delete_entity_record	מחיקת רשומה
list_entity_records	רשומות רשימה עבור סוג ישות

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

פעולת כתיבה (לא הרסנית, לא אידמפוטנטית).

הכלי הזה יוצר נתונים. רשומה חדשה מוזמנת ישירות ל-Dataverse. הפעולה אינה אידמפוטנטית; שיחות חוזרות יוצרות רשומות נוספות.