אימות הקשר

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

הערה

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

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

מה הוא עושה

העוזר קורא ישירות את ה-GUID של אנשי הקשר שסופק. הוא מדווח האם איש הקשר קיים, האם אחד משלושת שדות הדוא"ל של Dataverse (emailaddress1, , או emailaddress3) מאוכלס, והאם telephone1 הוא מאוכלס או mobilephoneemailaddress2מאוכלס. הוא לא משנה את Dataverse ולא מבצע חיפושים נוספים.

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

  • אימות איש קשר c49f9900-fe78-f111-ab0f-000d3a339c63
  • האם קיים איש קשר c49f9900-fe78-f111-ab0f-000d3a339c63 ויש לו פרטי אימייל וטלפון?
  • בדוק אם יש כתובת דוא"ל כלשהי ל-c49f9900-fe78-f111-ab0f-000d3a339c63 יש כתובת דוא"ל כלשהי
  • האם ליצירת קשר c49f9900-fe78-f111-ab0f-000d3a339c63 יש מספר טלפון?

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

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

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

  • ספק את ה-GUID של Dataverse של איש הקשר. הכלי לא פותר שמות או מחפש רשומות קשורות.
  • כל ערך לא ריק ב emailaddress1-, emailaddress2, או emailaddress3 עומד בבדיקת האימייל.
  • השתמש get_contact בפתיחת רשומת יצירת הקשר כאשר נדרשים שדות נוספים או תיקון מאושר.

מה קורה הלאה?

  • בדוק את תוצאות הנוכחות בדוא"ל ובטלפון.
  • פתח את רישום ההתקשרות המלא.
  • תקן את השדות המאושרים בטופס get_contact .
  • הרץ מחדש את האימות אחרי הניקוי.

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

לא, validate_contact לא משנה נתונים.

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

המשתמש זקוק לגישה קריאה לרשומות אנשי קשר בסביבת Dynamics 365 הנבחרת.

סיכום הכלים

מאפיין‬ ערך:
שם המשתמש אימות הקשר
שם הכלי הפנימי validate_contact
מטרה מאשר קיומו של יצירת הקשר ונוכחות בדוא"ל או בטלפון.

התנהגות כלי

הכלי מבצע קריאה ישירה אחת של רשומת מגע ומחזיר אם המגע קיים, פלוס hasEmail ו-בוליאנים hasPhone . איש קשר חסר מוחזר כ- exists: false; כשלים בהרשאה ובהובלה נשארים שגיאות כי הכלי אינו יכול לקבוע את קיומו במקרים אלו.

ביאורים

ביאור ערך: משמעות
readOnlyHint true כלי זה אינו משנה נתונים.
destructiveHint לא הוגדר לא ישים.
idempotentHint לא הוגדר לא ישים.
openWorldHint לא הוגדר משתמש בהתנהגות ברירת מחדל.

מושגי קלט

קלט תיאור חובה
contactId Dataverse צור קשר עם GUID. ‏‏כן‬

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

תגובת הטקסט בלבד כוללת את ה-GUID של איש הקשר, hasEmail, hasPhone, וכאשר יש קשר וניתן לבנות קישור עמוק, קישור עמוק של מגע.

הערות ניתוב

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

כלי מערכת יחסים
get_contact מחזיר את כל רישום יצירת הקשר.
get_contact_summary מספק תדריך קשר ממוקד מערכות יחסים.
update_stakeholder מוסיף בעל עניין או מעדכן תפקיד קיים.

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

לקריאה בלבד.