POST طریقہ
POST ایک HTTP طریقہ ہے جو سیلز فورس میں ایک وقت میں ایک/متعدد ریکارڈز کا اضافہ کرتا ہے۔ ہم URI کے ساتھ اپنی مرضی کے Apex REST API کے ذریعے یا براہ راست URI سے ریکارڈ داخل کر سکتے ہیں۔
اپیکس میں کسٹم ریسٹ ریسورس
اپیکس میں REST لکھنے کے لیے، ہمیں کچھ تشریحات کا استعمال کرنا ہوگا جو آپ کی Apex کلاس میں REST API تک رسائی حاصل کرتے ہیں۔
@HttpPost تشریح
یہ طریقہ اس وقت کہا جاتا ہے جب HTTP POST بھیجا جاتا ہے جو Apex طریقہ کو REST وسائل کے طور پر سامنے لانے کے قابل بناتا ہے۔ پھر، یہ ایک نیا وسیلہ بناتا ہے۔
نحو: @httpPost
مثال:
'RestApi_Post_Record.apxc' Apex کلاس لکھیں جس میں سیلز فورس 'کیس' آبجیکٹ میں اسٹیٹس، ترجیح، اور موضوع کے فیلڈز داخل کرنے کے لیے REST 'POST' طریقہ شامل ہے۔
- تین پیرامیٹرز کے ساتھ Post_Method بنائیں: حیثیت، ترجیح، اور سٹرنگ کی قسم کا موضوع۔
- ان پیرامیٹرز کو پاس کرکے ایک 'کیس' آبجیکٹ بنائیں۔
- سیلز فورس 'کیس' آبجیکٹ میں ریکارڈ داخل کرنے کے لیے Insert DML کا استعمال کریں۔
گلوبل کلاس RestApi_Post_Record{
// REST - پوسٹ کا طریقہ
@httpپوسٹ
عالمی جامد کیس پوسٹ_میتھڈ(سٹرنگ کی ترجیح، اسٹرنگ کی حیثیت، اسٹرنگ سبجیکٹ){
کیس کیس_obj = نیا کیس (ترجیح = ترجیح، حیثیت = حیثیت، موضوع = موضوع)؛
// DML داخل کریں۔
کیس_obj داخل کریں؛
واپسی کیس_obj؛
}
}
URI اور نتیجہ:
ورک بینچ پر جائیں اور REST ایکسپلورر پر جائیں۔ درج ذیل URI کی وضاحت کریں اور اس پر عمل کریں:
/services/apexrest/v56.0/RestApi_Post_Record/
درخواست کے باڈی میں ڈیٹا کی وضاحت کریں:
{'ترجیح': 'اعلی'،
'Status': 'نیا'،
'موضوع': 'موبائل کا مسئلہ'
}
سیلز فورس میں ریکارڈ کھولیں (ایپ لانچر سے 'کیس' آبجیکٹ پر جائیں)۔
URI سے براہ راست ایک ریکارڈ داخل کریں۔
'Utilities' ٹیب کے تحت REST Explorer پر جائیں اور درج ذیل URI کی وضاحت کریں اور Request Body کے تحت اس ریکارڈ کی وضاحت کریں:
/services/data/v56.0/sobjects/Case/درخواست کا باڈی:
{'ترجیح': 'میڈیم'،
'Status': 'نیا'،
'موضوع': 'مائیکروسافٹ ٹیمیں - نہیں آرہی'
}
سیلز فورس 'کیسز' ٹیب پر جائیں اور ریکارڈ دیکھیں۔
URI سے براہ راست متعدد ریکارڈ داخل کریں۔
اگر آپ ایک وقت میں ایک سے زیادہ ریکارڈ داخل کرنا چاہتے ہیں تو ہمیں URI کو مندرجہ ذیل طور پر بیان کرنا ہوگا: /services/data/v56.0/composite/tree/sObject
درخواست کی باڈی درج ذیل فارمیٹ میں ریکارڈ رکھتی ہے۔
'ریکارڈز' :[{'صفات' : {'قسم' : 'آبجیکٹ'، 'ریفرنس آئی ڈی' : 'ریفرنس1'}،
فیلڈ: ویلیو،
...
...
}،{
'صفات' : {'قسم' : 'آبجیکٹ'، 'ریفرنس آئی ڈی' : 'ریفرنس1'}،
فیلڈ: ویلیو،
...
...
}]
}
آئیے سیلز فورس 'کیس' آبجیکٹ میں دو ریکارڈ داخل کریں۔
URI: /services/data/v56.0/composite/tree/Case/درخواست کا باڈی:
{'ریکارڈز' :[{
'صفات' : {'قسم' : 'کیس'، 'ریفرنس آئی ڈی' : 'ریفرنس1'}،
'ترجیح': 'اعلی'،
'Status': 'نیا'،
'موضوع': 'مکینیکل روٹر کے ساتھ ڈیزائن کا مسئلہ',
'قسم': 'الیکٹریکل'
}،{
'صفات' : {'قسم' : 'کیس'، 'ریفرنس آئی ڈی' : 'ریفرنس2'}،
'ترجیح': 'کم'،
'Status': 'نیا'،
'موضوع': 'بجلی کی خرابی کے بعد جنریٹر شروع کرنا' ,
'قسم': 'الیکٹریکل'
}]
}
کیس نمبر 00001038 اور 00001039 کے ساتھ سیلز فورس میں دو ریکارڈ داخل کیے گئے ہیں۔
PUT طریقہ
جیسا کہ ہم نے پہلے بات کی ہے، PUT ایک HTTP طریقہ ہے جو ریکارڈ بنانے/اپ ڈیٹ کرنے کے لیے استعمال ہوتا ہے۔ اس گائیڈ میں، ہم حسب ضرورت REST API کا استعمال کرتے ہوئے ایک نیا Salesforce ریکارڈ بنانے کے لیے اس طریقہ کو استعمال کرتے ہیں۔
@httpPut : یہ طریقہ کہا جاتا ہے جب HTTP PUT بھیجا جاتا ہے جو Apex طریقہ کو REST وسائل کے طور پر سامنے لانے کے قابل بناتا ہے۔ پھر، یہ ایک نیا وسیلہ بناتا ہے یا موجودہ وسائل کو اپ ڈیٹ کرتا ہے۔
نحو: @httpPutمثال:
'RestApi_Put_Record.apxc' Apex کلاس لکھیں جس میں سیلز فورس 'کیس' آبجیکٹ میں اسٹیٹس، ترجیح، اور تفصیل والے فیلڈز داخل کرنے کے لیے REST 'PUT' طریقہ شامل ہے۔
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')گلوبل کلاس RestApi_Put_Record{
// REST - طریقہ رکھو
@httpPut
عالمی جامد کیس Put_Method(سٹرنگ کی ترجیح، سٹرنگ کی حیثیت، سٹرنگ سبجیکٹ){
کیس کیس_obj = نیا کیس (ترجیح = ترجیح، حیثیت = حیثیت، موضوع = موضوع)؛
// DML داخل کریں۔
کیس_obj داخل کریں؛
واپسی کیس_obj؛
}
}
URI اور نتیجہ:
ورک بینچ پر جائیں اور REST ایکسپلورر پر جائیں۔ درج ذیل URI کی وضاحت کریں اور اس پر عمل کریں:
/services/apexrest/v56.0/RestApi_Put_Record/درخواست کے باڈی میں ڈیٹا کی وضاحت کریں:
{'ترجیح': 'اعلی'،
'Status': 'بند'،
'موضوع': 'سبزی گرائنڈر گائیڈ درکار ہے'
}
سیلز فورس میں ریکارڈ کھولیں (ایپ لانچر سے 'کیس' آبجیکٹ پر جائیں)۔
نتیجہ
اب، آپ HTTP PUT اور POST طریقوں کا استعمال کرتے ہوئے سیلز فورس میں ریکارڈ داخل کرنے کے قابل ہیں۔ ہم نے سیکھا کہ ریکارڈز کو براہ راست ورک بینچ میں کیسے داخل کرنا ہے اور اپیکس کلاس کے ذریعے کسٹم REST API کا استعمال کرنا ہے۔ سیلز فورس 'کیس' آبجیکٹ کو اس گائیڈ میں بطور مثال استعمال کیا گیا ہے۔ PUT اور POST کے درمیان اصل فرق یہ ہے کہ POST ڈیٹا کو داخل کرنے کے لیے استعمال ہوتا ہے جبکہ PUT ڈیٹا کو داخل کرنے/اپ ڈیٹ کرنے کے لیے استعمال ہوتا ہے۔ @httpPut تشریح PUT طریقہ کے لیے استعمال ہوتی ہے اور @httpPost تشریح POST طریقہ کے لیے استعمال ہوتی ہے۔