আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশনে যান । তথ্য
সংস্করণ: 1.0.3
আপনার Salesforce অ্যাকাউন্টে ডেটা অ্যাক্সেস করুন। ঢোকান, আপডেট করুন, পুনরুদ্ধার করুন এবং ডেটা জিজ্ঞাসা করুন।
এই বিষয়বস্তু কনফিগার এবং এই এক্সটেনশন ব্যবহার করার জন্য রেফারেন্স প্রদান করে.
পূর্বশর্ত
এই বিষয়বস্তু কনফিগার এবং এই এক্সটেনশন ব্যবহার করার জন্য রেফারেন্স প্রদান করে. ExtensionCallout নীতি ব্যবহার করে একটি API প্রক্সি থেকে এক্সটেনশন ব্যবহার করার আগে, আপনাকে অবশ্যই:
একটি RSA x509 ব্যক্তিগত কী/শংসাপত্র জোড়া তৈরি করুন।
এক্সটেনশন কনফিগার করার সময় আপনি শংসাপত্র হিসাবে ব্যক্তিগত কী (.key) ব্যবহার করবেন। একটি সংযুক্ত অ্যাপ তৈরি করার সময় আপনি সার্টিফিকেট (.crt) ফাইলটি ব্যবহার করবেন যা Salesforce-এ এক্সটেনশনকে অ্যাক্সেস দেবে।
openssl req -x509 -sha256 -nodes -days 36500 -newkey rsa:2048 -keyout salesforce.key -out salesforce.crt
একটি সংযুক্ত অ্যাপ সেট আপ করুন।
একটি Salesforce সংযুক্ত অ্যাপ Salesforce এক্সটেনশনের জন্য অ্যাক্সেস প্রদান করবে। অ্যাপ সেট আপ করার জন্য নীচের নির্দেশাবলী দেখুন।
সংযুক্ত অ্যাপের জন্য ভোক্তা কী পান। অ্যাপের সাথে প্রমাণীকরণ করার সময় এক্সটেনশন এটি ব্যবহার করবে।
- Salesforce সেটআপে, বাম নেভিগেশনে, অ্যাপস > অ্যাপ ম্যানেজারে যান।
- তালিকায়, আপনার তৈরি করা সংযুক্ত অ্যাপটি সনাক্ত করুন।
- অ্যাপ্লিকেশনের সারিতে ডানদিকের ড্রপডাউন থেকে, দেখুন ক্লিক করুন।
- API (OAuth সেটিংস সক্ষম করুন) এর অধীনে, কনজিউমার কীটি সনাক্ত করুন এবং এক্সটেনশনটি কনফিগার করার সময় ব্যবহারের জন্য একটি নিরাপদ স্থানে এর মানটি অনুলিপি করুন৷
এক্সটেনশন দ্বারা অ্যাক্সেসের জন্য একটি সংযুক্ত অ্যাপ সেট আপ করুন৷
Salesforce এক্সটেনশন Salesforce অ্যাক্সেস করার আগে, আপনাকে একটি Salesforce সংযুক্ত অ্যাপ তৈরি করতে হবে যার মাধ্যমে এক্সটেনশন Salesforce এর সাথে সংযোগ করতে পারে।
Salesforce-এ, একটি সংযুক্ত অ্যাপ বহিরাগত অ্যাপ্লিকেশনগুলিকে API-এর মাধ্যমে Salesforce-এর সাথে সংযোগ করার একটি উপায় প্রদান করে।
একটি সংযুক্ত অ্যাপ সেট আপ করতে
- Salesforce এ লগ ইন করুন।
- উপরের ডানদিকে গিয়ার আইকনে ক্লিক করুন, তারপর সেটআপ এ ক্লিক করুন।
- বামদিকে নেভিগেশনে, অ্যাপস > অ্যাপ ম্যানেজার প্রসারিত করুন।
- অ্যাপ ম্যানেজার পৃষ্ঠায়, নতুন সংযুক্ত অ্যাপে ক্লিক করুন।
- মৌলিক তথ্যের অধীনে, প্রয়োজনীয় ক্ষেত্রগুলি পূরণ করুন। মান হিসাবরক্ষণের জন্য; তারা এক্সটেনশন দ্বারা ব্যবহার করা হয় না.
- API (OAuth সেটিংস সক্ষম করুন) এর অধীনে, OAuth সেটিংস সক্ষম করুন চেক বক্স নির্বাচন করুন৷
- যদিও এটি এক্সটেনশন দ্বারা ব্যবহৃত হয় না, একটি কলব্যাক URL লিখুন। আপনি
http://localhost/
বা অন্য কিছু স্থানধারক হোস্ট ব্যবহার করতে পারেন। - ডিজিটাল স্বাক্ষর ব্যবহার করুন চেক বক্স নির্বাচন করুন।
- ডিজিটাল স্বাক্ষর ব্যবহার করুন এর অধীনে, আপনি আগে তৈরি করা
salesforce.crt
সনাক্ত করতে এবং আপলোড করতে ফাইল চয়ন করুন ক্লিক করুন৷ - নির্বাচিত OAuth স্কোপ বিভাগে, নিম্নলিখিত যোগ করুন যাতে তারা নির্বাচিত OAuth স্কোপের অধীনে থাকে:
- আপনার ডেটা (এপিআই) অ্যাক্সেস এবং পরিচালনা করুন
- যেকোনো সময় আপনার পক্ষ থেকে অনুরোধগুলি সম্পাদন করুন (refresh_token, offline_access)
- Save এ ক্লিক করুন। কোনো ত্রুটি থাকলে, আপনাকে
salesforce.crt
ফাইলটি পুনরায় তৈরি এবং আপলোড করতে হতে পারে। - ফলস্বরূপ অ্যাপ পৃষ্ঠায়, পরিচালনা ক্লিক করুন।
- আপনি এইমাত্র যে অ্যাপটি তৈরি করেছেন তার অ্যাপ ম্যানেজার পৃষ্ঠায়, নীতি সম্পাদনা করুন ক্লিক করুন।
- OAuth নীতির অধীনে, অনুমোদিত ব্যবহারকারীদের ড্রপডাউনে ক্লিক করুন, তারপরে অ্যাডমিন অনুমোদিত ব্যবহারকারীরা প্রাক-অনুমোদিত ।
- Save এ ক্লিক করুন।
- অ্যাপ পৃষ্ঠায় ফিরে, প্রোফাইলের অধীনে, প্রোফাইল পরিচালনা করুন ক্লিক করুন।
অ্যাপ্লিকেশন প্রোফাইল অ্যাসাইনমেন্ট পৃষ্ঠায়, এই অ্যাপ্লিকেশনটি ব্যবহার করতে পারে এমন ব্যবহারকারী প্রোফাইলগুলির জন্য চেক বক্সগুলি নির্বাচন করুন৷
এক্সটেনশন কনফিগার করার সময় আপনি যে ব্যবহারকারীর নাম ব্যবহার করবেন সেই ব্যবহারকারীর সাথে সামঞ্জস্যপূর্ণ একটি প্রোফাইল নির্বাচন করতে ভুলবেন না। এছাড়াও নিশ্চিত করুন যে অন্তত সিস্টেম অ্যাডমিনিস্ট্রেটর ব্যবহারকারীদের এই অ্যাপ্লিকেশনটিতে অ্যাক্সেস রয়েছে৷
আপনি Salesforce এ ব্যবহারকারীর জন্য প্রোফাইল সেটিং দেখতে পারেন। সেটআপ এলাকায়, ব্যবহারকারীদের > ব্যবহারকারীদের প্রসারিত করুন, এক্সটেনশনটি প্রতিনিধিত্ব করবে এমন ব্যবহারকারীকে সনাক্ত করুন, তারপর প্রোফাইল কলামে তাদের প্রোফাইলটি সনাক্ত করুন।
Save এ ক্লিক করুন।
সেলসফোর্স সম্পর্কে
Salesforce হল একটি গ্রাহক সম্পর্ক ব্যবস্থাপনা (CRM) প্ল্যাটফর্ম। কাস্টমার রিলেশনশিপ ম্যানেজমেন্ট কোম্পানিগুলিকে তাদের গ্রাহকদের চাহিদা বুঝতে সাহায্য করে এবং গ্রাহকের তথ্য এবং মিথস্ক্রিয়া আরও ভালভাবে পরিচালনা করার মাধ্যমে সমস্যাগুলি সমাধান করতে সাহায্য করে — সমস্ত একটি একক প্ল্যাটফর্মে যা যেকোনো ডেস্কটপ বা ডিভাইস থেকে সর্বদা অ্যাক্সেসযোগ্য।
কর্ম
সন্নিবেশ
sObject প্রকার হিসাবে রেকর্ড সন্নিবেশ করান।
সিনট্যাক্স
<Action>insert</Action>
<Input><![CDATA[{
"sobject": records-sObject-type,
"records":[ records-to-insert ],
"allOrNone": true | false
}]]></Input>
উদাহরণ
<Action>insert</Action>
<Input><![CDATA[{
"sobject": "Account",
"records":[
{ "Name": "MyAccountName" }
],
"allOrNone": true
}]]></Input>
পরামিতি অনুরোধ
প্যারামিটার | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
বিষয় | সন্নিবেশ করার জন্য রেকর্ডের sObject প্রকার । | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
রেকর্ড | JSON-এ sObject রেকর্ডের অ্যারে। সর্বাধিক: 1000। | অ্যারে | কোনোটিই নয়। | হ্যাঁ। |
allOrNone | আপডেটের কোনো অংশ ব্যর্থ হলে সম্পূর্ণ আপডেট ব্যর্থ করার জন্য true । | বুলিয়ান | মিথ্যা | না. |
প্রতিক্রিয়া
সন্নিবেশ অপারেশন থেকে ফলাফল সহ একটি results
অ্যারে।
{
results: [
{ id: '0011U00000LQ76KQAT', success: true, errors: [] },
{ id: '0011U00000LQ76LQAT', success: true, errors: [] }
]
}
সম্পত্তি | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
ফলাফল [*].id | নতুন রেকর্ডের জন্য sObject ID তৈরি করা হয়েছে। | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
ফলাফল[*].সাফল্য | যে রেকর্ড সন্নিবেশ সফল হলে true . | বুলিয়ান | কোনোটিই নয়। | হ্যাঁ। |
ফলাফল[*].ত্রুটি | ত্রুটির অ্যারে, যদি থাকে, মৃত্যুদন্ডের সময় ধরা পড়ে। | অ্যারে | কোনোটিই নয়। | হ্যাঁ। |
আপডেট
সেলসফোর্স রেকর্ড আপডেট করুন।
সিনট্যাক্স
<Action>update</Action>
<Input><![CDATA[{
"sobject": records-sObject-type,
"records": [ records-to-update ],
"allOrNone": true | false
}]]></Input>
উদাহরণ
<Action>update</Action>
<Input><![CDATA[{
"sobject": "Account",
"records":[
{
"id":"0011U00000LQ76KQAT",
"Name": "MyNewAccountName"
}
],
"allOrNone": true
}]]></Input>
পরামিতি অনুরোধ
প্যারামিটার | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
বিষয় | আপডেট করার জন্য রেকর্ডের sObject প্রকার । | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
রেকর্ড | JSON-এ sObject রেকর্ডের অ্যারে। আপডেট করার জন্য প্রতিটি রেকর্ডে অবশ্যই রেকর্ডের আইডি মান অন্তর্ভুক্ত করতে হবে। সর্বাধিক: 1000। | অ্যারে | কোনোটিই নয়। | হ্যাঁ। |
allOrNone | আপডেটের কোনো অংশ ব্যর্থ হলে সম্পূর্ণ আপডেট ব্যর্থ করার জন্য true । | বুলিয়ান | মিথ্যা | না. |
প্রতিক্রিয়া
আপডেট থেকে ফলাফল ধারণকারী একটি results
অ্যারে।
{
results: [
{ id: '0011U00000LQ76KQAT', success: true, errors: [] },
{ id: '0011U00000LQ76LQAT', success: true, errors: [] }
]
}
প্যারামিটার | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
ফলাফল [*].id | আপডেট করা রেকর্ডের জন্য তৈরি করা বস্তু আইডি। | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
ফলাফল[*].সাফল্য | যে রেকর্ড সন্নিবেশ সফল হলে true . | বুলিয়ান | কোনোটিই নয়। | হ্যাঁ। |
ফলাফল[*].ত্রুটি | ত্রুটির অ্যারে, যদি থাকে, মৃত্যুদন্ডের সময় ধরা পড়ে। | অ্যারে | কোনোটিই নয়। | হ্যাঁ। |
পুনরুদ্ধার
তাদের আইডি দ্বারা sObject হিসাবে রেকর্ড পুনরুদ্ধার করুন. sObject প্রকারের সমস্ত ক্ষেত্র প্রদান করে।
সিনট্যাক্স
<Action>retrieve</Action>
<Input><![CDATA[{
"sobject": records-sObject-type,
"ids":[ IDs-of-records-to-retrieve ]
}]]></Input>
উদাহরণ
<Action>retrieve</Action>
<Input><![CDATA[{
"sobject": "Account",
"ids":["0011U00000LQ76KQAT"]
}]]></Input>
পরামিতি অনুরোধ
প্যারামিটার | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
বিষয় | পুনরুদ্ধার করার জন্য রেকর্ডের sObject প্রকার । | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
আইডি | পুনরুদ্ধার করার জন্য sObject আইডি রেকর্ডের অ্যারে। সর্বাধিক: 1000। | অ্যারে | কোনোটিই নয়। | হ্যাঁ। |
allOrNone | অনুরোধের কোনো অংশ ব্যর্থ হলে সম্পূর্ণ অপারেশন ব্যর্থ করার জন্য true । | বুলিয়ান | মিথ্যা | না. |
প্রতিক্রিয়া
JSON হিসাবে উপস্থাপিত বস্তুর একটি records
অ্যারে। উল্লেখ্য যে অবজেক্টের সমস্ত বৈশিষ্ট্য JSON-এ অন্তর্ভুক্ত করা হয়েছে, এমনকি যদি সম্পত্তির মান শূন্য হয়।
{
records: [
{ sobject-json },
{ sobject-json }
]
}
querySOQL
সেলসফোর্স অবজেক্ট কোয়েরি ল্যাঙ্গুয়েজ (SOQL) ব্যবহার করে Salesforce.com-কে কোয়েরি করুন।
সিনট্যাক্স
<Action>querySOQL</Action>
<Input><![CDATA[{
"soql": soql-query-statement
}]]></Input>
উদাহরণ
<Action>querySOQL</Action>
<Input><![CDATA[{
"soql": "SELECT Id, Name FROM Account"
}]]></Input>
পরামিতি অনুরোধ
প্যারামিটার | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
soql | প্রশ্ন করার জন্য SOQL বিবৃতি। | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
প্রতিক্রিয়া
প্রশ্নের ফলাফল।
{
totalSize: 2,
records: [
{
attributes: { attributes-of-record },
Id: '0011U00000LQ76KQAT',
Name: 'AccountName1'
},
{
attributes: { attributes-of-record },
Id: '0011U00000LQ76LQAT',
Name: 'AccountName2'
}
],
done: true
}
প্যারামিটার | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
মোট আকার | ক্যোয়ারী দ্বারা ফেরত রেকর্ডের সংখ্যা. | পূর্ণসংখ্যা | কোনোটিই নয়। | হ্যাঁ। |
রেকর্ড | JSON-এ sObject হিসাবে ফেরত রেকর্ডের অ্যারে। সর্বাধিক: 1000। | অ্যারে | কোনোটিই নয়। | হ্যাঁ। |
সম্পন্ন | ক্যোয়ারী অপারেশন সম্পন্ন হলে true । | বুলিয়ান | কোনোটিই নয়। | হ্যাঁ। |
তালিকা
Salesforce.com রেকর্ডের তালিকা করুন। নির্দিষ্ট sObject প্রকারের সমস্ত ক্ষেত্র প্রদান করে।
সিনট্যাক্স
<Action>list</Action>
<Input><![CDATA[{
"sobject": records-sObject-type,
"limit": max-number-of-records,
"offset": record-index-at-which-to-begin-response-set
}]]></Input>
উদাহরণ
<Action>list</Action>
<Input><![CDATA[{
"sobject": "Account",
"limit": 1000,
"offset": 0
}]]></Input>
পরামিতি অনুরোধ
প্যারামিটার | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
বিষয় | তালিকা করার জন্য রেকর্ডের বিষয়বস্তুর ধরন । | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
সীমা | ফেরত দেওয়ার জন্য সর্বাধিক রেকর্ডের সংখ্যা। | পূর্ণসংখ্যা | 1000 | না. |
অফসেট | তালিকার রেকর্ডের জন্য অফসেট। | পূর্ণসংখ্যা | 0 | না. |
প্রতিক্রিয়া
JSON হিসাবে তালিকাভুক্ত বস্তু ধারণকারী একটি records
অ্যারে।
{
records: [
{ sobject-json },
{ sobject-json }
]
}
ডেল
নির্দিষ্ট আইডি সহ রেকর্ড মুছুন।
সিনট্যাক্স
<Action>del</Action>
<Input><![CDATA[{
"sobject": records-sObject-type,
"ids":[ IDs-of-records-to-retrieve ]
}]]></Input>
উদাহরণ
<Action>del</Action>
<Input><![CDATA[{
"sobject": "Account",
"ids":["0011U00000LQ76KQAT"]
}]]></Input>
পরামিতি অনুরোধ
প্যারামিটার | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
বিষয় | মুছে ফেলার জন্য রেকর্ডের sObject প্রকার । | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
আইডি | মুছে ফেলার জন্য রেকর্ডের জন্য sObject ID এর অ্যারে। সর্বাধিক: 1000। | অ্যারে | কোনোটিই নয়। | হ্যাঁ। |
প্রতিক্রিয়া
অপারেশনের ফলাফল ধারণকারী একটি results
বিন্যাস।
{
results:[
{ id: '0011U00000LQ76KQAT', success: true, errors: [] },
{ id: '0011U00000LQ76LQAT', success: true, errors: [] }
]
}
সম্পত্তি | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
ফলাফল [*].id | উল্লেখিত রেকর্ডের অবজেক্ট আইডি। | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
ফলাফল[*].সাফল্য | true যদি রেকর্ডের জন্য অপারেশন সফল হয়। | বুলিয়ান | কোনোটিই নয়। | হ্যাঁ। |
ফলাফল[*].ত্রুটি | ত্রুটির অ্যারে, যদি থাকে, মৃত্যুদন্ডের সময় ধরা পড়ে। | অ্যারে | কোনোটিই নয়। | হ্যাঁ। |
getAccessToken
Salesforce.com API অ্যাক্সেস টোকেন পান। REST API গুলি জিজ্ঞাসা করতে ব্যবহার করা যেতে পারে।
সিনট্যাক্স
<Action>getAccessToken</Action>
<Input><![CDATA[{}]]></Input>
পরামিতি অনুরোধ
কোনোটিই নয়।
প্রতিক্রিয়া
JSON-এ অ্যাক্সেস টোকেন।
{
"accessToken":"00D1U0000014m3hqswvoM22I5GTw9EJrztlZ8eSSka88Q",
"scope":"api",
"instanceUrl": "https://na85.salesforce.com",
"id": "https://login.salesforce.com/id/00D1U0004564mutUAA/0051U43214qecVQAQ",
"tokenType": "Bearer"
}
সম্পত্তি | বর্ণনা | টাইপ | ডিফল্ট | প্রয়োজন |
---|---|---|---|---|
অ্যাক্সেস টোকেন | অ্যাক্সেস টোকেন। | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
সুযোগ | স্কোপ যার মধ্যে টোকেন অ্যাক্সেস প্রদান করে। | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
instanceUrl | Salesforce org দ্বারা ব্যবহৃত উদাহরণের জন্য URL। | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
আইডি | সংযুক্ত অ্যাপের আইডি। | স্ট্রিং | কোনোটিই নয়। | হ্যাঁ। |
টোকেন টাইপ | অ্যাক্সেস টোকেনের জন্য টাইপ করুন। | স্ট্রিং | বহনকারী | হ্যাঁ। |
কনফিগারেশন রেফারেন্স
আপনি API প্রক্সিগুলিতে ব্যবহারের জন্য এই এক্সটেনশনটি কনফিগার এবং স্থাপন করার সময় নিম্নলিখিতগুলি ব্যবহার করুন৷
সাধারণ এক্সটেনশন বৈশিষ্ট্য
The following properties are present for every extension.
Property | Description | Default | Required |
---|---|---|---|
name |
Name you're giving this configuration of the extension. | None | Yes |
packageName |
Name of the extension package as given by Apigee Edge. | None | Yes |
version |
Version number for the extension package from which you're configuring an extension. | None | Yes |
configuration |
Configuration value specific to the extension you're adding. See Properties for this extension package | None | Yes |
এই এক্সটেনশন প্যাকেজ জন্য বৈশিষ্ট্য
এই এক্সটেনশনের জন্য নির্দিষ্ট নিম্নলিখিত কনফিগারেশন বৈশিষ্ট্যগুলির জন্য মান নির্দিষ্ট করুন।
সম্পত্তি | বর্ণনা | ডিফল্ট | প্রয়োজন |
---|---|---|---|
অনুমোদন সার্ভার URL | Salesforce থেকে অনুমোদন পাওয়ার সময় ব্যবহার করা URL। সাধারণত, এটি https://login.salesforce.com | কোনোটিই নয়। | হ্যাঁ। |
সংযুক্ত অ্যাপ ভোক্তা কী | আপনার তৈরি করা সংযুক্ত অ্যাপের জন্য Salesforce দ্বারা প্রদত্ত ভোক্তা কী। আপনার ভোক্তা কী পুনরুদ্ধার করার জন্য পূর্বশর্তের অধীনে নির্দেশাবলী দেখুন। | কোনোটিই নয়। | হ্যাঁ। |
শংসাপত্র | Apigee Edge কনসোলে প্রবেশ করা হলে, উপরের ধাপে আপনার তৈরি করা salesforce.key ফাইলের বিষয়বস্তু এটি। ম্যানেজমেন্ট এপিআই এর মাধ্যমে পাঠানো হলে, এটি salesforce.key ফাইল থেকে উৎপন্ন একটি base64-এনকোডেড মান। | কোনোটিই নয়। | হ্যাঁ। |
Salesforce ব্যবহারকারীর ব্যবহারকারীর নাম | আপনার তৈরি করা সংযুক্ত অ্যাপের সাথে যুক্ত ব্যবহারকারীর নাম। Salesforce এক্সটেনশন Salesforce থেকে অনুমোদন পেতে এটি ব্যবহার করবে। | কোনোটিই নয়। | হ্যাঁ। |