Dynamics 365

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

לפני שמתחילים

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

  • בפרויקט שלכם ב-Google Cloud:
    • מוודאים שהגדרתם חיבור לרשת. מידע על תבניות רשת זמין במאמר קישוריות לרשת.
    • מפעילים את השירותים הבאים:
      • ‫secretmanager.googleapis.com (Secret Manager API)
      • ‫connectors.googleapis.com (Connectors API)

      במאמר הפעלת שירותים מוסבר איך להפעיל שירותים.

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

הגדרת המחבר

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

  1. במסוף Cloud, עוברים לדף Integration Connectors > Connections ובוחרים או יוצרים פרויקט בענן.

    כניסה לדף Connections

  2. לוחצים על + יצירת חיבור חדש כדי לפתוח את הדף יצירת חיבור.
  3. בקטע מיקום, בוחרים את המיקום של החיבור.
    1. אזור: בוחרים מיקום מהרשימה הנפתחת.

      אזורים נתמכים למחברים:

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

    2. לוחצים על הבא.
  4. בקטע פרטי החיבור, ממלאים את הפרטים הבאים:
    1. מחבר: בוחרים באפשרות Dynamics 365 מהרשימה הנפתחת של המחברים הזמינים.
    2. גרסת כלי החיבור: בוחרים את גרסת כלי החיבור מהרשימה הנפתחת של הגרסאות הזמינות.
    3. בשדה Connection Name (שם החיבור), מזינים שם למופע החיבור.

      השמות של החיבורים צריכים לעמוד בקריטריונים הבאים:

      • שמות החיבורים יכולים לכלול אותיות, מספרים או מקפים.
      • האותיות צריכות להיות קטנות.
      • שמות החיבורים צריכים להתחיל באות ולהסתיים באות או במספר.
      • שמות החיבורים לא יכולים לכלול יותר מ-49 תווים.
    4. אופציונלי: מזינים תיאור למופע החיבור.
    5. אופציונלי: מפעילים את Cloud Logging ואז בוחרים רמת יומן. כברירת מחדל, רמת היומן מוגדרת כ-Error.
    6. חשבון שירות: בוחרים חשבון שירות שיש לו את התפקידים הנדרשים.
    7. אופציונלי: מגדירים את ההגדרות של צומת החיבור:

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

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

    8. דייר Azure: הדייר של Microsoft Online שמשמש לגישה לנתונים. אם לא תציינו דייר, המערכת תשתמש בדייר שמוגדר כברירת מחדל.
    9. כתובת ה-URL של הארגון: כתובת ה-URL של הארגון ב-Dynamics 365. לדוגמה, https://abc123.cloudax.dynamics.com/.
    10. שרת ADFS: שרת ADFS שמשמש לאימות. המאפיין הזה משמש רק במהדורת FinOpsOnPremise.
    11. ‫Api Version (גרסת ה-API): ערך ברירת המחדל הוא 9.0. אפשר לציין את זה כדי לגשת לגרסה חדשה של ה-API אחרי שהיא תפורסם. המאפיין הזה רלוונטי רק אם הערך של Edition הוא CustomerService, ‏ FieldService, ‏ Marketing, ‏ ProjectOperations או Sales.
    12. Cross Company (בין חברות): האם לשלוף נתונים לגבי כל החברות או רק לגבי חברת ברירת המחדל של המשתמש.
    13. מהדורה: המהדורה של Dynamics 365 שבה נעשה שימוש.
    14. הכללת ערכים מעוצבים: מציין אם עמודות שמכילות ערכים מעוצבים צריכות להיות גלויות.
    15. Include Navigation Properties (הכללת מאפייני ניווט): מציין אם מאפייני הניווט צריכים להיכלל ברשימת העמודות.
    16. שימוש בתהליכים מאוחסנים דינמיים: מציין אם צריך לחשוף תהליכים מאוחסנים דינמיים.
    17. רמת מלל: רמת המלל של החיבור, משתנה מ-1 עד 5. רמת הפירוט הגבוהה יותר תתעד את כל פרטי התקשורת (בקשה,תגובה ואישורי SSL).
    18. אופציונלי: לוחצים על + הוספת תווית כדי להוסיף תווית לקישור בצורה של צמד מפתח/ערך.
    19. לוחצים על הבא.
  5. בקטע אימות, מזינים את פרטי האימות.
    1. בוחרים סוג אימות ומזינים את הפרטים הרלוונטיים.

      החיבור ל-Dynamics 365 תומך בסוגי האימות הבאים:

      • הרשאת קוד אימות OAuth 2.0

      2. כדי להבין איך להגדיר את סוגי האימות האלה, אפשר לעיין במאמר בנושא הגדרת אימות.

    2. לוחצים על הבא.
  6. בדיקה: בודקים את פרטי החיבור והאימות.
  7. לוחצים על יצירה.

הגדרת אימות

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

  • הרשאת קוד אימות OAuth 2.0
    • אסימון גישה: אסימון הגישה שמשמש לאימות בקשות עם חיבורים שמבוססים על תהליך אימות באמצעות קוד הרשאה.
    • Client ID: מזהה הלקוח שמשמש לבקשת אסימוני גישה.
    • סוד לקוח: סוד הלקוח שמשמש לבקשת טוקנים של גישה.

הגדרה של Dynamics365

כדי להגדיר את Dynamics365:

יצירת משתמש

  1. מתחברים לפורטל Azure.
  2. יוצרים משתמש חדש ומקצים לו את תפקיד אדמין המערכת.

יצירת אפליקציה

  1. בפורטל Azure, עוברים אל Azure Active Directory > Application Registrations.
  2. לוחצים על New registration.
  3. מזינים שם לאפליקציה.
  4. מציינים Single> כהגדרת הדייר.
  5. מגדירים את כתובת ה-URL להפניה או יציאה אחרת, ומגדירים את CallbackURL לכתובת ה-URL של התשובה שהגדרתם.http://localhost:33333
  6. לוחצים על הרשמה.
  7. עוברים אל Certificates & Secrets (אישורים וסודות) ומגדירים את סוג האימות של האפליקציה.
  8. בוחרים סוד לקוח חדש לאפליקציה ומציינים את משך הזמן שלו. אחרי שמירת הסוד של הלקוח, Microsoft Office 365 מציג את ערך המפתח.
  9. מעתיקים את ערך המפתח, שמשמש כסוד הלקוח.

כתובת ה-URL של הארגון, המהדורה, היקף ההרשאות וכתובת ה-URL להרשאה

אלה הערכים של כתובת ה-URL של הארגון, המהדורה, ההיקף וכתובת ה-URL לאישור:
  • כתובת ה-URL של הארגון היא כתובת ה-URL של המכונה.
  • אפשר לבחור באחת מהמהדורות הבאות: Marketing,‏ Sales או Customer service.
  • היקף: [כתובת האתר של הארגון]/.default
  • כתובת URL להרשאה: https://login.microsoftonline.com/TENANT_ID/oauth2/v2.0/authorize?prompt=consent

הגדרת כתובת ה-URL להפניה אוטומטית לאישור החיבור

  1. בפורטל Azure, בוחרים את האפליקציה מתוך App Registrations (רישום אפליקציות).
  2. בקטע Essentials, מוסיפים כתובת URL להפניה אוטומטית.
  3. מוסיפים פלטפורמה, בוחרים באפשרות אתר ומדביקים את כתובת ה-URL להפניה אוטומטית.

סוג החיבור של מהדורת Dynamics365 Customerservice

שם השדה פרטים
מיקום us-central1
מחבר Dynamics365
גרסת המחבר 1
שם החיבור google-cloud-dynamic365-rest-customerservice
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
דייר Azure AZURE_TENANT
כתובת ה-URL של הארגון https://orgurl.com
מהדורה שירות לקוחות
הכללת מאפייני ניווט נכון
רמת הפירוט 5
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 2
מזהה לקוח CLIENT_ID
היקפים [כתובת ה-URL של הארגון]/.default
סוד לקוח SECRET
Secret Version 5
כתובת אתר להרשאה https://login.microsoftonline.com/TENANT_ID/oauth2/v2.0/authorize?prompt=consent

סוג החיבור של מהדורת Dynamics365 Sales

שם השדה פרטים
מיקום us-central1
מחבר Dynamics365
גרסת המחבר 1
שם החיבור googlecloud-dynamic365-rest-sales
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
דייר Azure AZURE_TENANT
כתובת ה-URL של הארגון https://orgurl.com
מהדורה מכירות
הכללת מאפייני ניווט נכון
רמת הפירוט 5
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 2
מזהה לקוח CLIENT_ID
היקפים [כתובת ה-URL של הארגון]/.default
סוד לקוח SECRET
Secret Version 5
כתובת אתר להרשאה https://login.microsoftonline.com/TENANT_ID/oauth2/v2.0/authorize?prompt=consent

סוג החיבור של מהדורת Dynamics365 Marketing

שם השדה פרטים
מיקום us-central1
מחבר Dynamics365
גרסת המחבר 1
שם החיבור google-dynamic365-rest-marketing
חשבון השירות SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
דייר Azure AZURE_TENANT
כתובת ה-URL של הארגון https://orgurl.com
מהדורה שיווק
הכללת מאפייני ניווט נכון
רמת הפירוט 5
מספר הצמתים המינימלי 2
מספר הצמתים המקסימלי 2
מזהה לקוח CLIENT_ID
היקפים [כתובת ה-URL של הארגון]/.default
סוד לקוח SECRET
Secret Version 5
כתובת אתר להרשאה https://login.microsoftonline.com/TENANT_ID/oauth2/v2.0/authorize?prompt=consent

ישויות, פעולות ופעולות

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

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

    עם זאת, יכול להיות שמחבר לא תומך בישויות או שאין לו ישויות, ובמקרה כזה הרשימה Entities תהיה ריקה.

  • פעולה: פעולה היא הפעילות שאפשר לבצע בישות. אפשר לבצע כל אחת מהפעולות הבאות בישות:

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

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

מגבלות המערכת

מחבר Dynamics 365 יכול לעבד עסקה אחת בשנייה, לכל צומת, ולהגביל את מספר העסקאות מעבר למגבלה הזו. כברירת מחדל, Integration Connectors מקצה 2 צמתים (לזמינות טובה יותר) לחיבור.

מידע על המגבלות שחלות על Integration Connectors זמין במאמר מגבלות.

דוגמאות לפעולות על ישויות

בקטע הזה מוסבר איך לבצע חלק מהפעולות על ישויות במחבר הזה.

דוגמה – רשימה של כל המוצרים

בדוגמה הזו מפורטים כל המוצרים בישות Products.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Products מהרשימה Entity.
  3. בוחרים את הפעולה List ולוחצים על סיום.
  4. אופציונלי: בקטע Task Input (קלט משימה) במשימה Connectors (מחברים), אפשר לסנן את קבוצת התוצאות על ידי ציון filter clause (סעיף סינון). תמיד מציינים את הערך של סעיף המסנן בתוך גרשיים בודדים (').

דוגמה – קבלת ליד

בדוגמה הזו מאחזרים ליד עם המזהה שצוין מהישות Leads.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Leads מהרשימה Entity.
  3. בוחרים את הפעולה Get ולוחצים על סיום.
  4. בקטע Task Input (קלט של משימה) במשימה Connectors (מחברים), לוחצים על EntityId (מזהה ישות) ואז מזינים c5233ad8-a1a4-ee11-a568-000d3ac9f67f בשדה Default Value (ערך ברירת מחדל).

    כאן, c5233ad8-a1a4-ee11-a568-000d3ac9f67f הוא מזהה רשומה ייחודי בישות Leads.

דוגמה – יצירת ליד

בדוגמה הזו נוצר ליד בישות Leads.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Leads מהרשימה Entity.
  3. בוחרים את הפעולה Create ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך שדומה לערך הבא בשדה Default Value: 
    {
"fullname": "nameadded1703832358758",   
"subject": "test subject",   
"firstname": "firstname1703832358766",   
"lastname": "lastname1703832358767"
}

    אם השילוב יצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

    [{
"leadid": "220166e8-15a6-ee11-a569-002248d5dd6b"
}]

דוגמה – עדכון הזמנה

בדוגמה הזו מעדכנים רשומה בישות SalesOrder.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות SalesOrder מהרשימה Entity.
  3. בוחרים את הפעולה Update ולוחצים על סיום.
  4. בקטע Task Input (קלט המשימה) של המשימה Connectors (מחברים), לוחצים על connectorInputPayload ואז מזינים ערך שדומה לערך הבא בשדה Default Value: 
    {
"name": "Nameupdated1704863189087"
 }
  5. לוחצים על entityId ואז מזינים 580775a4-17aa-ee11-a568-000d3ac9f67f בשדה ערך ברירת מחדל.

    אם השילוב יצליח, בשדה connectorOutputPayload של משימת המחבר יופיע ערך שדומה לערך הבא:

    [{
"salesorderid": "580775a4-17aa-ee11-a568-000d3ac9f67f"
}]

דוגמה – מחיקה של איש קשר

בדוגמה הזו נמחק איש הקשר עם המזהה שצוין בישות Contacts.

  1. בתיבת הדו-שיח Configure connector task, לוחצים על Entities.
  2. בוחרים באפשרות Contacts מהרשימה Entity.
  3. בוחרים את הפעולה Delete ולוחצים על סיום.
  4. בקטע Task Input (קלט משימה) של המשימה Connectors (מחברים), לוחצים על entityId ואז מזינים 524f543b-3ea5-ee11-a568-000d3ac9f67f בשדה Default Value (ערך ברירת מחדל).

שימוש בחיבור ל-Dynamics 365 בשילוב

אחרי שיוצרים את החיבור, הוא זמין גם ב-Apigee Integration וגם ב-Application Integration. אפשר להשתמש בחיבור בשילוב באמצעות המשימה Connectors.

  • כדי להבין איך ליצור ולהשתמש במשימה Connectors ב-Apigee Integration, אפשר לעיין במאמר משימת Connectors.
  • מידע על יצירה ושימוש במשימת מחברים ב-Application Integration זמין במאמר משימת מחברים.

קבלת עזרה מקהילת Google Cloud

אתם יכולים לפרסם את השאלות שלכם ולדון במחבר הזה בקהילת Google Cloud בפורומים של Cloud.

המאמרים הבאים