הצג רשומת ישות

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

הערה

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

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

מה הוא עושה

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

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

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

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

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

העוזר מציג טופס רשומה אינטראקטיבי כרכיב אפליקציה בצ'אט. הטופס מציג את שדות הרשומה כפי שהוגדרו על ידי תצורת טופס מערכת Dynamics 365.

עצות שימושיות

• אתה יכול להשתמש בשם רשומה או GUID כדי לפתוח רשומה מסוימת.
• אתה צריך לציין את סוג הישות, למשל "הזדמנות פתוחה ל-Project Alpha."
• לכלול columns שדות שאינם מופיעים בטופס הרשומה (עד 50). שדות מחוץ לטופס שאתה מבקש מוצגים בפרטי הרשומה.
• לגבי חשבונות, תגיד "פתח חשבון Contoso" במקום. לגבי אנשי קשר, תגיד "קשר פתוח ג'ורדן." לגבי תיקים, נאמר "תיק פתוח CAS-01010-A0A0A0."

עצה

לאחר הופעת טופס הרשומה, תוכל לשאול שאלות המשך כמו "עדכן רשומה זו" או "מחק את הרשומה הזו".

מה קורה הלאה?

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

• עדכן שדה באלבום הזה.
• מחק את הרשומה הזו.
• רשום עוד אלבומים כאלה.
• חפש רשומות קשורות.

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

לא, צפייה ברשומה לא משנה נתונים.

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

מה אפשר לעשות מהרכיב של אפליקציה בצ'אט

מטופס הרשומה בצ'אט, אתם יכולים:

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

דרישות מוקדמות

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

סיכום הכלים

מאפיין‬	ערך:
שם המשתמש	הצג רשומת ישות
שם הכלי הפנימי	get_entity_record
מטרה	מחזיר רשומה אחת לכל ישות Dataverse בתצוגת פרטים מונחית טופס עם עריכה פנימית

התנהגות כלי

מחזיר רשומה אחת לכל ישות Dataverse בתצוגת פרטים מונחית טופס עם עריכה פנימית. שימוש לסוגי ישויות שאינם מכוסים על ידי get_account, get_contact, או get_case, כגון הזדמנויות, לידים או טבלאות מותאמות אישית.

ביאורים

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

מושגי קלט

סוג ישות

קלט	תיאור	נדרש
entityLogicalName	entityLogicalName (מיתר נדרש). השם הלוגי של ישות Dataverse.	‏‏כן‬

מזהה רשומה

קלט	תיאור	נדרש
recordId	recordId (מיתר נדרש). רשם GUID או שם ראשי לחיפוש.	‏‏כן‬

בחירת צורה

קלט	תיאור	נדרש
formId	formId (מחרוזת, אופציונלי). טופס GUID של מערכת לשימוש ברינדור.	לא

תחומים נוספים

קלט	תיאור	נדרש
columns	columns (מערך מחרוזות, אופציונלי, מקסימום 50). שמות לוגיים נוספים של שדות לכלול מעבר לשדות הצורה (לדוגמה ["createdon", "industrycode"]). שדות מבוקשים שאינם מופיעים בטופס מוקרנים לטופס המוחזר כך שהערכים שלהם מופיעים בתגובה. שמות לא מוכרים או בלתי קריאים מתעלמים מהם. שדות חיפוש בקשה, בעלים ולקוח לפי שם הלוגי הבסיסי שלהם (למשל customerid, לא _customerid_value); הערך שלהם מוחזר כשם התצוגה של החיפוש.	לא

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

כלי זה מציג צורת ישות אינטראקטיבית של אפליקציה בצ'אט.

כלי MCP זה נתמך על ידי אפליקציית MCP.

סוג תגובה

צורה אינטראקטיבית (תצוגת פרטים)

הטופס מציג את שדות הרשומה כפי שמוגדר בטופס המערכת שנבחר.

הערות ניתוב

שימוש get_entity_record :

• כל סוג ישות בלי כלי פרטי ייעודי.
• פתח [סוג ישות] [שם], הצג פרטי [סוג ישות].

אל תשתמש get_entity_record כשההודעה אומרת במפורש:

• חשבון — נתיב ל- get_account.
• מגע—נתיב ל- get_contact.
• מקרה — נתיב ל- get_case.
• רשומות "רשימה"—נתיב ל- list_entity_records.

כלים קשורים

כלי	קשר
list_entity_records	מפרט רשומות עבור אותו סוג ישות
update_entity_record	עדכון שדות בכל רשומת ישות
delete_entity_record	מוחק כל רשומת ישות
get_account	כלי ייעודי לפירוט חשבון
get_contact	כלי פרטי פרטי קשר ייעודי
get_case	כלי ייעודי לפרטי קייס

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

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

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