पोस्ट विधि
POST एक http विधि है जो Salesforce में एक समय में एकल/एकाधिक रिकॉर्ड जोड़ती है। हम कस्टम एपेक्स रेस्ट एपीआई के माध्यम से या सीधे यूआरआई से यूआरआई के साथ रिकॉर्ड सम्मिलित कर सकते हैं।
एपेक्स में कस्टम रेस्ट रिसोर्स
एपेक्स में REST लिखने के लिए, हमें कुछ एनोटेशन का उपयोग करना होगा जो आपके एपेक्स क्लास में REST API तक पहुंच बनाते हैं।
@HttpPost एनोटेशन
जब HTTP POST भेजा जाता है तो इस विधि को कॉल किया जाता है जो एपेक्स विधि को REST संसाधन के रूप में उजागर करने में सक्षम बनाता है। फिर, यह एक नया संसाधन बनाता है।
सिंटैक्स: @httpPost
उदाहरण:
'RestApi_Post_Record.apxc' एपेक्स क्लास लिखें जिसमें सेल्सफोर्स 'केस' ऑब्जेक्ट में स्थिति, प्राथमिकता और विषय फ़ील्ड सम्मिलित करने के लिए REST 'POST' विधि शामिल है।
- तीन मापदंडों के साथ Post_Method बनाएं: स्थिति, प्राथमिकता और स्ट्रिंग प्रकार का विषय।
- इन पैरामीटर्स को पास करके एक 'केस' ऑब्जेक्ट बनाएं।
- सेल्सफोर्स 'केस' ऑब्जेक्ट में रिकॉर्ड डालने के लिए इन्सर्ट डीएमएल का उपयोग करें।
वैश्विक वर्ग रेस्टएपीआई_पोस्ट_रिकॉर्ड{
// बाकी - पोस्ट विधि
@httpपोस्ट
वैश्विक स्थैतिक केस Post_Method(स्ट्रिंग प्राथमिकता, स्ट्रिंग स्थिति, स्ट्रिंग विषय){
केस केस_ओबीजे = नया केस (प्राथमिकता = प्राथमिकता, स्थिति = स्थिति, विषय = विषय);
// डीएमएल डालें
केस_ओबीजे डालें;
वापसी केस_ओबीजे;
}
}
यूआरआई और परिणाम:
वर्कबेंच पर जाएं और REST एक्सप्लोरर पर नेविगेट करें। निम्नलिखित यूआरआई निर्दिष्ट करें और इसे निष्पादित करें:
/services/apexrest/v56.0/RestApi_Post_Record/
अनुरोध निकाय में डेटा निर्दिष्ट करें:
{'प्राथमिकता': 'उच्च',
'स्थिति': 'नया',
'विषय': 'मोबाइल समस्या'
}
सेल्सफोर्स में रिकॉर्ड खोलें (ऐप लॉन्चर से 'केस' ऑब्जेक्ट पर नेविगेट करें)।
यूआरआई से सीधे एकल रिकॉर्ड डालें
'यूटिलिटीज़' टैब के अंतर्गत REST एक्सप्लोरर पर जाएँ और निम्नलिखित URI निर्दिष्ट करें और अनुरोध निकाय के अंतर्गत इस रिकॉर्ड को निर्दिष्ट करें:
/सेवाएं/डेटा/v56.0/sobjects/केस/अनुरोध निकाय:
{'प्राथमिकता': 'मध्यम',
'स्थिति': 'नया',
'विषय': 'Microsoft टीमें - नहीं आ रही हैं'
}
सेल्सफोर्स 'केस' टैब पर जाएं और रिकॉर्ड देखें।
यूआरआई से सीधे एकाधिक रिकॉर्ड डालें
यदि आप एक समय में एकाधिक रिकॉर्ड सम्मिलित करना चाहते हैं, तो हमें यूआरआई को निम्नानुसार निर्दिष्ट करना होगा: /services/data/v56.0/composite/tree/sObject
अनुरोध निकाय निम्नलिखित प्रारूप में रिकॉर्ड रखता है:
'रिकॉर्ड' :[{'विशेषताएं': {'प्रकार': 'ऑब्जेक्ट', 'संदर्भआईडी': 'संदर्भ1'},
फ़ील्ड:मूल्य,
...
...
},{
'विशेषताएं': {'प्रकार': 'ऑब्जेक्ट', 'संदर्भआईडी': 'संदर्भ1'},
फ़ील्ड:मूल्य,
...
...
}]
}
आइए सेल्सफोर्स 'केस' ऑब्जेक्ट में दो रिकॉर्ड डालें।
यूआरआई: /services/data/v56.0/composite/tree/Case/अनुरोध निकाय:
{'रिकॉर्ड' :[{
'विशेषताएं': {'प्रकार': 'केस', 'संदर्भआईडी': 'संदर्भ1'},
'प्राथमिकता': 'उच्च',
'स्थिति': 'नया',
'विषय': 'मैकेनिकल रोटर के साथ डिज़ाइन समस्या',
'प्रकार': 'इलेक्ट्रिकल'
},{
'विशेषताएं': {'प्रकार': 'केस', 'संदर्भआईडी': 'संदर्भ2'},
'प्राथमिकता': 'निम्न',
'स्थिति': 'नया',
'विषय': 'विद्युत विफलता के बाद जनरेटर शुरू करना',
'प्रकार': 'इलेक्ट्रिकल'
}]
}
Salesforce में CaseNumber 00001038 और 00001039 के साथ दो रिकॉर्ड डाले गए हैं।
विधि डालो
जैसा कि हमने पहले चर्चा की, PUT एक http विधि है जिसका उपयोग रिकॉर्ड बनाने/अपडेट करने के लिए किया जाता है। इस गाइड में, हम कस्टम REST API का उपयोग करके एक नया Salesforce रिकॉर्ड बनाने के लिए इस पद्धति का उपयोग करते हैं।
@httpPut : HTTP PUT भेजे जाने पर इस विधि को कॉल किया जाता है जो एपेक्स विधि को REST संसाधन के रूप में उजागर करने में सक्षम बनाता है। फिर, यह एक नया संसाधन बनाता है या मौजूदा संसाधन को अद्यतन करता है।
सिंटैक्स: @httpPutउदाहरण:
'RestApi_Put_Record.apxc' एपेक्स क्लास लिखें जिसमें सेल्सफोर्स 'केस' ऑब्जेक्ट में स्थिति, प्राथमिकता और विवरण फ़ील्ड सम्मिलित करने के लिए REST 'PUT' विधि शामिल है।
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')वैश्विक वर्गrestApi_Put_Record{
// रेस्ट - पुट मेथड
@httpPut
वैश्विक स्थैतिक केस पुट_मेथड (स्ट्रिंग प्राथमिकता, स्ट्रिंग स्थिति, स्ट्रिंग विषय) {
केस केस_ओबीजे = नया केस (प्राथमिकता = प्राथमिकता, स्थिति = स्थिति, विषय = विषय);
// डीएमएल डालें
केस_ओबीजे डालें;
वापसी केस_ओबीजे;
}
}
यूआरआई और परिणाम:
वर्कबेंच पर जाएं और REST एक्सप्लोरर पर नेविगेट करें। निम्नलिखित यूआरआई निर्दिष्ट करें और इसे निष्पादित करें:
/services/apexrest/v56.0/RestApi_Put_Record/अनुरोध निकाय में डेटा निर्दिष्ट करें:
{'प्राथमिकता': 'उच्च',
'स्थिति': 'बंद',
'विषय': 'सब्जी-चक्की गाइड की आवश्यकता'
}
सेल्सफोर्स में रिकॉर्ड खोलें (ऐप लॉन्चर से 'केस' ऑब्जेक्ट पर नेविगेट करें)।
निष्कर्ष
अब, आप http PUT और POST विधियों का उपयोग करके Salesforce में रिकॉर्ड सम्मिलित करने में सक्षम हैं। हमने सीखा कि रिकॉर्ड्स को सीधे वर्कबेंच में कैसे सम्मिलित किया जाए और एपेक्स क्लास के माध्यम से कस्टम REST API का उपयोग कैसे किया जाए। सेल्सफोर्स 'केस' ऑब्जेक्ट का उपयोग इस गाइड में एक उदाहरण के रूप में किया गया है। PUT और POST के बीच वास्तविक अंतर यह है कि POST का उपयोग डेटा डालने के लिए किया जाता है जबकि PUT का उपयोग डेटा डालने/अपडेट करने के लिए किया जाता है। @httpPut एनोटेशन का उपयोग PUT विधि के लिए किया जाता है और @httpPost एनोटेशन का उपयोग POST विधि के लिए किया जाता है।