Dynamics 365: रिकॉर्ड बनाएं या अपडेट करें

Dynamics 365: रिकॉर्ड बनाएं या अपडेट करें का उपयोग एक यात्रा चरण से एक Dataverse पंक्ति को अपसर्ट करने के लिए करें, जो एक वैकल्पिक कुंजी कॉलम पर मेल खाती है: यह पंक्ति को तब अपडेट करता है जब मान पहले से मौजूद होता है और जब नहीं होता है तो इसे बनाता है। Dataverse के पास कोई स्थिर API कुंजी नहीं है, इसलिए यह बिंदु पूरे खाते के लिए एक बार पंजीकृत Entra ID एप्लिकेशन के माध्यम से प्रमाणित होता है। बिंदु पर ही कोई टोकन फ़ील्ड नहीं है।

विशिष्ट उपयोग:

• Dynamics 365 को सिंक में रखें: यात्री के यात्रा के माध्यम से आगे बढ़ने पर एक पंक्ति बनाएं या अपडेट करें, ताकि आपका CRM वर्तमान डेटा देख सके।
• यात्रा गतिविधि को CRM में सिंक करें: जब कोई यात्री एक मील के पत्थर तक पहुंचता है तो एक कॉलम सेट करें, ताकि आपकी टीम इसे फ़िल्टर या रिपोर्ट कर सके।
• डुप्लिकेट पंक्तियों से बचें: वैकल्पिक कुंजी द्वारा मिलान करने का मतलब है कि एक यात्री जो इस बिंदु से फिर से गुजरता है, वह एक नई बनाने के बजाय उसी पंक्ति को अपडेट करता है।

शुरू करने से पहले

Entra ID में एक एप्लिकेशन पंजीकृत करें और इसे सेटिंग्स > तृतीय-पक्ष एकीकरण > Microsoft Dynamics 365 के तहत कनेक्ट करें:

1. Microsoft Entra एडमिन सेंटर में, एक एप्लिकेशन पंजीकृत करें और उसके लिए एक क्लाइंट सीक्रेट बनाएं।
2. Power Platform एडमिन सेंटर में, अपना लक्ष्य परिवेश खोलें, एप्लिकेशन को एप्लिकेशन उपयोगकर्ता के रूप में जोड़ें, और इसे एक सुरक्षा भूमिका सौंपें जो उस तालिका पर पंक्तियाँ बना और अपडेट कर सकती है जिस पर आप लिखने की योजना बना रहे हैं।
3. Pushwoosh में, परिवेश URL में, परिवेश का URL https:// के साथ और बिना किसी अनुगामी पथ के दर्ज करें, उदाहरण के लिए https://acme.crm4.dynamics.com।
4. डायरेक्टरी (टेनेंट) ID और एप्लिकेशन (क्लाइंट) ID में, इसके Entra ID अवलोकन पृष्ठ से एप्लिकेशन की ID दर्ज करें।
5. क्लाइंट सीक्रेट में, सीक्रेट का मान पेस्ट करें। यह केवल-लिखने के लिए संग्रहीत है: Pushwoosh इसे फिर कभी नहीं दिखाता है, इसलिए इसे बदलने के लिए एक नया पेस्ट करें।
6. Dynamics 365 कनेक्ट करें पर क्लिक करें।

Dynamics 365 कनेक्ट करने के बाद, एकीकरण स्थापित करें ताकि बिंदु यात्रा बिल्डर में दिखाई दे।

नोट

जिस वैकल्पिक कुंजी पर आप मिलान करने की योजना बना रहे हैं, वह Dataverse में तालिका पर पहले से मौजूद होनी चाहिए। इसे पहले Power Platform एडमिन सेंटर (या अपने समाधान में) में सेट करें — बिंदु आपके लिए एक नहीं बना सकता है।

बिंदु को कॉन्फ़िगर करें

1. बाएं पैनल के एकीकरण अनुभाग से Dynamics 365: रिकॉर्ड बनाएं या अपडेट करें को कैनवास पर खींचें।
2. बिंदु पर डबल-क्लिक करें और एक चरण का नाम दर्ज करें।
3. परिवेश होस्ट में, उसी परिवेश का होस्ट https:// के बिना दर्ज करें, उदाहरण के लिए acme.crm4.dynamics.com।

4. तालिका में, इकाई सेट का नाम, बहुवचन में दर्ज करें — contacts, leads, या एक कस्टम तालिका का सेट नाम।

5. वैकल्पिक कुंजी कॉलम में, उस तालिका पर एक वैकल्पिक कुंजी द्वारा कवर किया गया कॉलम दर्ज करें, उदाहरण के लिए pw_hwid।

6. वैकल्पिक कुंजी मान में, मिलान करने के लिए मान दर्ज करें, आमतौर पर {{device:hwid}} जैसा मैक्रो। उद्धरण चिह्नों वाले मानों से बचें, क्योंकि मान अनुरोध URL में जाता है।

7. कॉलम में, लिखने के लिए प्रति Dataverse कॉलम एक पंक्ति जोड़ें। कॉलम का नाम और मान दर्ज करें। नाम गैर-रिक्त और अद्वितीय होने चाहिए। एक मान निश्चित पाठ या एक यात्री मैक्रो हो सकता है जैसे {{device:hwid}}, वेबहूक बॉडी में समान मैक्रो। या इस यात्रा में पहले के चरण द्वारा उत्पादित एक विशेषता चुनने के लिए गतिशील मान डालें पर क्लिक करें, उदाहरण के लिए एक LLM प्रतिक्रिया या एक मैप किया गया वेबहूक मान।

उदाहरण

तालिका को contacts पर, वैकल्पिक कुंजी कॉलम को pw_hwid पर, और वैकल्पिक कुंजी मान को यात्री की डिवाइस ID ({{device:hwid}}) पर सेट करने के साथ, बिंदु एक मौजूदा पंक्ति से मेल खाता है या एक नई बनाता है। कॉलम को यात्री के ईमेल ({{tag:Email}}) के साथ emailaddress1 पर सेट करने से वह कॉलम भर जाता है।

8. सेव करें पर क्लिक करें।

प्रतिक्रिया

यात्री कैनवास पर आपके द्वारा आगे कनेक्ट किए गए किसी भी चरण पर जारी रहता है।

चरण चलने के बाद की विशेषताएँ

Salesforce: रिकॉर्ड बनाएं या अपडेट करें के विपरीत, यह बिंदु पंक्ति की ID को यात्री विशेषता में वापस नहीं करता है। यदि बाद के चरण को इसकी आवश्यकता है, तो उसी वैकल्पिक कुंजी मान द्वारा पंक्ति को फिर से देखें।

विफलताएं और अप्रत्याशित प्रतिक्रियाएं

बिंदु के ड्रॉअर में कॉल लॉग खोलें और प्रतिक्रिया की जांच करें:

• 401 — कनेक्शन का क्लाइंट सीक्रेट अस्वीकार कर दिया गया था या समाप्त हो गया है; सेटिंग्स > तृतीय-पक्ष एकीकरण के तहत फिर से कनेक्ट करें।
• 403 — एप्लिकेशन उपयोगकर्ता की सुरक्षा भूमिका उस तालिका पर बनाने या अपडेट करने की पहुंच प्रदान नहीं करती है।
• 404 — परिवेश होस्ट या तालिका उस परिवेश में किसी भी चीज़ से मेल नहीं खाती है।
• 400 — वैकल्पिक कुंजी कॉलम उस तालिका पर एक वैकल्पिक कुंजी के रूप में परिभाषित नहीं है, या कॉलम में एक नाम एक वास्तविक कॉलम नहीं है।

एक असफल अनुरोध यात्री को यात्रा से हटा देता है। त्रुटियाँ और असफल अनुरोध देखें।

उदाहरण परिदृश्य: Dynamics 365 में एक एंटरप्राइज़ मूल्य निर्धारण अनुरोध को सिंक करना

एक B2B SaaS ऐप एक उपयोगकर्ता को इन-ऐप एंटरप्राइज़ मूल्य निर्धारण का अनुरोध करें पर टैप करने देता है। टीम चाहती है कि वह अनुरोध Dynamics 365 में अपसर्ट हो, इस तरह से मिलान किया जाए कि एक दोहराया गया टैप डुप्लिकेट बनाने के बजाय उसी पंक्ति को अपडेट करे।

1. एक ट्रिगर-आधारित प्रविष्टि तत्व जोड़ें और इसे EnterprisePricingRequested ईवेंट पर फायर करने के लिए सेट करें।
2. इसके ठीक बाद Dynamics 365: रिकॉर्ड बनाएं या अपडेट करें जोड़ें। तालिका को contacts पर, वैकल्पिक कुंजी कॉलम को pw_hwid पर, और वैकल्पिक कुंजी मान को {{device:hwid}} पर सेट करें। कॉलम में, emailaddress1 को {{tag:Email}} पर सेट करें।
3. सेव करें पर क्लिक करें।

एक बार जब यह चलता है, तो अनुरोध डिवाइस द्वारा मिलान किए गए Dynamics 365 संपर्क के रूप में मौजूद होता है, जो बिक्री टीम के लिए ऐप के अपने डेटा के बजाय CRM से काम करने के लिए तैयार है।