POST முறை
POST என்பது சேல்ஸ்ஃபோர்ஸில் ஒரே நேரத்தில் ஒற்றை/பல பதிவுகளைச் சேர்க்கும் ஒரு http முறையாகும். தனிப்பயன் Apex REST API மூலமாகவோ அல்லது URI இலிருந்து நேரடியாகவோ URI உடன் பதிவுகளைச் செருகலாம்.
Apex இல் தனிப்பயன் ஓய்வு ஆதாரம்
Apex இல் REST ஐ எழுத, உங்கள் Apex வகுப்பில் REST API ஐ அணுகும் சில குறிப்புகளை நாங்கள் பயன்படுத்த வேண்டும்.
@HttpPost சிறுகுறிப்பு
இந்த முறை HTTP POST அனுப்பப்படும் போது அழைக்கப்படுகிறது, இது Apex முறையை REST ஆதாரமாக வெளிப்படுத்த உதவுகிறது. பின்னர், அது ஒரு புதிய வளத்தை உருவாக்குகிறது.
தொடரியல்: @httpPost
உதாரணமாக:
சேல்ஸ்ஃபோர்ஸ் 'கேஸ்' பொருளில் நிலை, முன்னுரிமை மற்றும் பொருள் புலங்களைச் செருக, REST 'POST' முறையை உள்ளடக்கிய 'RestApi_Post_Record.apxc' அபெக்ஸ் வகுப்பை எழுதவும்.
- Post_Method ஐ மூன்று அளவுருக்களுடன் உருவாக்கவும்: நிலை, முன்னுரிமை மற்றும் சரம் வகையின் பொருள்.
- இந்த அளவுருக்களை கடந்து ஒரு 'கேஸ்' பொருளை உருவாக்கவும்.
- சேல்ஸ்ஃபோர்ஸ் 'கேஸ்' ஆப்ஜெக்ட்டில் பதிவைச் செருக, டிஎம்எல் செருகலைப் பயன்படுத்தவும்.
உலகளாவிய வகுப்பு RestApi_Post_Record{
// ஓய்வு - பின் முறை
@httpPost
உலகளாவிய நிலையான வழக்கு Post_Method(சரம் முன்னுரிமை, சரம் நிலை, சரம் பொருள்){
வழக்கு_obj= புதிய வழக்கு (முன்னுரிமை=முன்னுரிமை, நிலை = நிலை, பொருள்=பொருள்);
// DML ஐச் செருகவும்
கேஸ்_ஆப்ஜை செருகவும்;
திரும்ப வழக்கு_பொருள்;
}
}
URI மற்றும் முடிவு:
வொர்க்பெஞ்சிற்குச் சென்று REST Explorer க்குச் செல்லவும். பின்வரும் URI ஐக் குறிப்பிட்டு அதை இயக்கவும்:
/services/apexrest/v56.0/RestApi_Post_Record/
கோரிக்கை உடலில் உள்ள தரவைக் குறிப்பிடவும்:
{'முன்னுரிமை':'உயர்',
'நிலை':'புதியது',
'பொருள்':'மொபைல் சிக்கல்'
}
சேல்ஸ்ஃபோர்ஸில் பதிவைத் திறக்கவும் (பயன்பாட்டுத் துவக்கியிலிருந்து 'கேஸ்' பொருளுக்குச் செல்லவும்).
URI இலிருந்து நேரடியாக ஒரு பதிவைச் செருகவும்
'பயன்பாடுகள்' தாவலின் கீழ் REST எக்ஸ்ப்ளோரருக்குச் சென்று பின்வரும் URI ஐக் குறிப்பிட்டு, கோரிக்கையின் கீழ் இந்தப் பதிவைக் குறிப்பிடவும்:
/services/data/v56.0/sobjects/Case/கோரிக்கை உடல்:
{'முன்னுரிமை':'நடுத்தரம்',
'நிலை':'புதியது',
'பொருள்':'மைக்ரோசாப்ட் அணிகள் - வரவில்லை'
}
சேல்ஸ்ஃபோர்ஸ் 'கேஸ்கள்' தாவலுக்குச் சென்று பதிவைப் பார்க்கவும்.
URI இலிருந்து நேரடியாக பல பதிவுகளைச் செருகவும்
நீங்கள் ஒரே நேரத்தில் பல பதிவுகளைச் செருக விரும்பினால், URI ஐப் பின்வருமாறு குறிப்பிட வேண்டும்: /services/data/v56.0/composite/tree/sObject
கோரிக்கை அமைப்பு பின்வரும் வடிவத்தில் பதிவுகளை வைத்திருக்கிறது:
'பதிவுகள்' :[{'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
புலம்:மதிப்பு,
...
...
},{
'attributes' : {'type' : 'Object', 'referenceId' : 'reference1'},
புலம்:மதிப்பு,
...
...
}]
}
சேல்ஸ்ஃபோர்ஸ் 'கேஸ்' பொருளில் இரண்டு பதிவுகளைச் செருகுவோம்.
URI: /services/data/v56.0/composite/tree/Case/கோரிக்கை உடல்:
{'பதிவுகள்' :[{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference1'},
'முன்னுரிமை':'உயர்',
'நிலை':'புதியது',
'பொருள்':'மெக்கானிக்கல் ரோட்டருடன் வடிவமைப்பு சிக்கல்',
'வகை':'மின்சாரம்'
},{
'attributes' : {'type' : 'Case', 'referenceId' : 'reference2'},
'முன்னுரிமை':'குறைவு',
'நிலை':'புதியது',
'பொருள்':'மின் தோல்விக்குப் பிறகு ஜெனரேட்டரைத் தொடங்குதல்' ,
'வகை':'மின்சாரம்'
}]
}
கேஸ் எண் 00001038 மற்றும் 00001039 உடன் சேல்ஸ்ஃபோர்ஸில் இரண்டு பதிவுகள் செருகப்பட்டன.
PUT முறை
நாம் முன்பு விவாதித்தபடி, PUT என்பது பதிவுகளை உருவாக்க/புதுப்பிக்கப் பயன்படும் ஒரு http முறையாகும். இந்த வழிகாட்டியில், தனிப்பயன் REST API ஐப் பயன்படுத்தி புதிய சேல்ஸ்ஃபோர்ஸ் பதிவை உருவாக்க இந்த முறையைப் பயன்படுத்துகிறோம்.
@httpPut : இந்த முறை HTTP PUT அனுப்பப்படும் போது அழைக்கப்படுகிறது, இது Apex முறையை REST ஆதாரமாக வெளிப்படுத்த உதவுகிறது. பின்னர், அது ஒரு புதிய ஆதாரத்தை உருவாக்குகிறது அல்லது ஏற்கனவே உள்ள வளத்தைப் புதுப்பிக்கிறது.
தொடரியல்: @httpPutஉதாரணமாக:
சேல்ஸ்ஃபோர்ஸ் 'கேஸ்' பொருளில் நிலை, முன்னுரிமை மற்றும் விளக்கப் புலங்களைச் செருக, REST 'PUT' முறையை உள்ளடக்கிய 'RestApi_Put_Record.apxc' அபெக்ஸ் வகுப்பை எழுதவும்.
@RestResource(urlMapping='/v56.0/RestApi_Put_Record/')உலகளாவிய வகுப்பு RestApi_Put_Record{
// ஓய்வு - போடும் முறை
@httpPut
உலகளாவிய நிலையான வழக்கு Put_Method(சரம் முன்னுரிமை, சரம் நிலை, சரம் பொருள்){
வழக்கு_obj= புதிய வழக்கு (முன்னுரிமை=முன்னுரிமை, நிலை = நிலை, பொருள்=பொருள்);
// DML ஐச் செருகவும்
கேஸ்_ஆப்ஜை செருகவும்;
திரும்ப வழக்கு_பொருள்;
}
}
URI மற்றும் முடிவு:
வொர்க்பெஞ்சிற்குச் சென்று REST Explorer க்குச் செல்லவும். பின்வரும் URI ஐக் குறிப்பிட்டு அதை இயக்கவும்:
/services/apexrest/v56.0/RestApi_Put_Record/கோரிக்கை உடலில் உள்ள தரவைக் குறிப்பிடவும்:
{'முன்னுரிமை':'உயர்',
'நிலை':'மூடப்பட்டது',
'பொருள்': 'காய்கறி-கிரைண்டர் வழிகாட்டி தேவை'
}
சேல்ஸ்ஃபோர்ஸில் பதிவைத் திறக்கவும் (பயன்பாட்டுத் துவக்கியிலிருந்து 'கேஸ்' பொருளுக்குச் செல்லவும்).
முடிவுரை
இப்போது, நீங்கள் http PUT மற்றும் POST முறைகளைப் பயன்படுத்தி சேல்ஸ்ஃபோர்ஸில் பதிவுகளைச் செருகலாம். வொர்க்பெஞ்சில் நேரடியாகப் பதிவுகளை எவ்வாறு செருகுவது மற்றும் அபெக்ஸ் வகுப்பின் மூலம் தனிப்பயன் REST API ஐப் பயன்படுத்துவது எப்படி என்பதை நாங்கள் கற்றுக்கொண்டோம். இந்த வழிகாட்டியில் சேல்ஸ்ஃபோர்ஸ் 'கேஸ்' ஆப்ஜெக்ட் ஒரு எடுத்துக்காட்டாகப் பயன்படுத்தப்படுகிறது. PUT மற்றும் POST ஆகியவற்றுக்கு இடையேயான உண்மையான வேறுபாடு என்னவென்றால், தரவைச் செருகுவதற்கு POST பயன்படுத்தப்படுகிறது, அதேசமயம் தரவைச் செருக/புதுப்பிக்க PUT பயன்படுத்தப்படுகிறது. @httpPut சிறுகுறிப்பு PUT முறைக்கும் @httpPost சிறுகுறிப்பு POST முறைக்கும் பயன்படுத்தப்படுகிறது.