Salesforce এক্সটেনশন

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন। তথ্য

ভার্সন: 2.0.2

আপনার Salesforce অ্যাকাউন্টে ডেটা অ্যাক্সেস করা। ডেটা যোগ, আপডেট, পুনরুদ্ধার ও কোয়েরি করা।

এই এক্সটেনশন কনফিগার ও ব্যবহার করার জন্য এই কন্টেন্ট রেফারেন্স প্রদান করে।

পূর্বশর্ত

এই এক্সটেনশন কনফিগার ও ব্যবহার করার জন্য এই কন্টেন্ট রেফারেন্স প্রদান করে। ExtensionCallout নীতি ব্যবহার করে API প্রক্সি থেকে এক্সটেনশন ব্যবহার করার আগে, আপনাকে অবশ্যই:

1. RSA x509 প্রাইভেট কী বা সার্টিফিকেশন পেয়ার তৈরি করুন।

   এক্সটেনশন কনফিগার করার সময় আপনি ব্যক্তিগত কী (.key) ক্রেডেনশিয়াল হিসেবে ব্যবহার করবেন। আপনি একটি কানেক্ট করা অ্যাপ তৈরি করার সময় সার্টিফিকেট (.crt) ফাইল ব্যবহার করবেন যা এক্সটেনশনকে Salesforce-এ অ্যাক্সেস দেবে।

   openssl req -x509 -sha256 -nodes -days 36500 -newkey rsa:2048 -keyout salesforce.key -out salesforce.crt
   
   

2. কানেক্ট করা অ্যাপ সেট-আপ করুন।

   Salesforce কানেক্ট করা অ্যাপ, Salesforce এক্সটেনশনের অ্যাক্সেস প্রদান করবে। অ্যাপ সেট-আপ করার নির্দেশাবলী দেখুন।

3. কানেক্ট করা অ্যাপের জন্য কনজিউমার কী পান। অ্যাপের সাথে যাচাই করার সময় এক্সটেনশন এটি ব্যবহার করবে।

   1. Salesforce সেট-আপে, বাঁদিকের নেভিগেশন থেকে, অ্যাপ > অ্যাপ ম্যানেজার বিকল্পে যান।
   2. তালিকায়, আপনার তৈরি করা কানেক্ট করা অ্যাপটি খুঁজে নিন।
   3. অ্যাপ্লিকেশনের সারিতে ডানদিকে থাকা ড্রপ-ডাউন মেনু থেকে, দেখুন বিকল্পে ক্লিক করুন।
   4. API (OAuth সেটিংস চালু করুন) বিকল্পের মধ্যে, গ্রাহক কী খুঁজে বের করুন এবং এক্সটেনশন কনফিগার করার সময় ব্যবহারের জন্য এর ভ্যালু কোনও নিরাপদ জায়গায় কপি করুন।

এক্সটেনশন অ্যাক্সেস করার জন্য কানেক্ট করা অ্যাপ সেট-আপ করা

Salesforce এক্সটেনশন Salesforce অ্যাক্সেস করার আগে, আপনাকে একটি Salesforce কানেক্ট করা অ্যাপ তৈরি করতে হবে যার মাধ্যমে এক্সটেনশনটি Salesforce-এর সাথে কানেক্ট করতে পারবে।

Salesforce-এ, কানেক্ট করা অ্যাপ হল এমন একটি উপায় যার মাধ্যমে এক্সটার্নাল অ্যাপ্লিকেশন API-এর মাধ্যমে Salesforce-এর সাথে কানেক্ট করতে পারে।

কানেক্ট করা অ্যাপ সেট-আপ করতে

1. Salesforce-এ সাইন-ইন করুন।
2. উপরে ডানদিকে গিয়ার আইকনে ক্লিক করুন, তারপর সেট-আপ করুন বিকল্পে ক্লিক করুন।
3. বাঁদিকের নেভিগেশনে, অ্যাপ > অ্যাপ ম্যানেজার বিকল্প বড় করে দেখুন।
4. অ্যাপ ম্যানেজার পৃষ্ঠায়, নতুন কানেক্ট করা অ্যাপ বিকল্পে ক্লিক করুন।
5. প্রাথমিক তথ্য বিকল্পের মধ্যে, প্রয়োজনীয় ফিল্ড পূরণ করুন। এই মানগুলি বুককিপিংয়ের জন্য; এক্সটেনশন এগুলি ব্যবহার করে না।
6. API (OAuth সেটিংস চালু করুন) বিকল্পের মধ্যে, OAuth সেটিংস চালু করুন চেকবক্স বেছে নিন।
7. এক্সটেনশন এটি ব্যবহার না করলেও, একটি কলব্যাক URL লিখুন। আপনি http://localhost/ বা অন্য কোনও প্লেসহোল্ডার হোস্ট ব্যবহার করতে পারেন।
8. ডিজিটাল স্বাক্ষর ব্যবহার করুন চেকবক্স বেছে নিন।
9. ডিজিটাল স্বাক্ষর ব্যবহার করুন বিকল্পের মধ্যে, আগে তৈরি করা salesforce.crt খুঁজে পেতে ও আপলোড করতে ফাইল বেছে নিন বিকল্পে ক্লিক করুন।
10. বেছে নেওয়া OAuth স্কোপ বিভাগে, নিম্নলিখিতগুলি যোগ করুন যাতে সেগুলি বেছে নেওয়া OAuth স্কোপ-এর অধীনে থাকে:
    • আপনার ডেটা অ্যাক্সেস ও ম্যানেজ করা (api)
    • যেকোনও সময় আপনার হয়ে অনুরোধ করা (refresh_token, offline_access)
11. সেভ করুন বিকল্পে ক্লিক করুন। কোনও সমস্যা থাকলে, আপনাকে salesforce.crt ফাইলটি আবার তৈরি করে আপলোড করতে হতে পারে।
12. এর ফলে যে অ্যাপ পৃষ্ঠাটি খুলবে, সেখানে ম্যানেজ করুন বিকল্পে ক্লিক করুন।
13. আপনি এইমাত্র যে অ্যাপ তৈরি করেছেন সেটির জন্য অ্যাপ ম্যানেজার পৃষ্ঠায়, নীতি এডিট করুন বিকল্পে ক্লিক করুন।
14. OAuth নীতি বিকল্পের মধ্যে, অনুমোদিত ব্যবহারকারী ড্রপ-ডাউনে ক্লিক করুন, তারপর অ্যাডমিন অনুমোদিত ব্যবহারকারীরা আগে থেকেই অনুমোদিত বিকল্পে ক্লিক করুন।
15. সেভ করুন বিকল্পে ক্লিক করুন।
16. অ্যাপ পৃষ্ঠায় ফিরে গিয়ে, প্রোফাইল বিকল্পের মধ্যে, প্রোফাইল ম্যানেজ করুন বিকল্পে ক্লিক করুন।

17. অ্যাপ্লিকেশন প্রোফাইল অ্যাসাইনমেন্ট পৃষ্ঠায়, সেইসব ব্যবহারকারীর প্রোফাইলের জন্য চেকবক্স বেছে নিন যারা এই অ্যাপ্লিকেশন ব্যবহার করতে পারবেন।

    এক্সটেনশন কনফিগার করার সময় আপনি যে ব্যবহারকারীর ইউজারনেম ব্যবহার করবেন, তার প্রোফাইলটিই বেছে নিয়েছেন কিনা তা নিশ্চিত করুন। এছাড়াও, নিশ্চিত করুন যে কমপক্ষে সিস্টেম অ্যাডমিনিস্ট্রেটর ব্যবহারকারীদের এই অ্যাপ্লিকেশন অ্যাক্সেস করার সুবিধা আছে।

    আপনি Salesforce-এ ব্যবহারকারীর প্রোফাইল সেটিং দেখতে পারবেন। সেট-আপ বিভাগে, ব্যবহারকারী > ব্যবহারকারী বিকল্পে গিয়ে এক্সটেনশনটি যে ব্যবহারকারীর হয়ে কাজ করবে তাকে খুঁজে নিন, তারপর প্রোফাইল কলামে তার প্রোফাইল খুঁজে নিন।

18. সেভ করুন বিকল্পে ক্লিক করুন।

Salesforce সম্পর্কে

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>

অনুরোধের প্যারামিটার

রেসপন্স

ইনসার্ট অপারেশন থেকে পাওয়া ফলাফল সহ results অ্যারে।

{
  results: [
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

আপডেট করুন

Salesforce রেকর্ড আপডেট করুন।

<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>

অনুরোধের প্যারামিটার

রেসপন্স

আপডেট থেকে পাওয়া ফলাফল সহ results অ্যারে।

{
  results: [
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

রিট্রিভ

তাদের আইডি দিয়ে sObjects হিসেবে রেকর্ড ফিরিয়ে আনুন। sObjectType-এর সব ফিল্ড রিটার্ন করে।

<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>

অনুরোধের প্যারামিটার

রেসপন্স

JSON হিসেবে দেখানো sObject-এর records অ্যারে। মনে রাখবেন, JSON-এ অবজেক্টের সব প্রপার্টি অন্তর্ভুক্ত থাকে, এমনকি প্রপার্টির ভ্যালু শূন্য হলেও।

{
  records: [
    { sobject-json },
    { sobject-json }
  ]
}

querySOQL

Salesforce Object Query Language (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>

অনুরোধের প্যারামিটার

রেসপন্স

কোয়েরির ফলাফল।

{
  totalSize: 2,
  records: [
    {
      attributes: { attributes-of-record },
      Id: '0011U00000LQ76KQAT',
      Name: 'AccountName1'
    },
    {
      attributes: { attributes-of-record },
      Id: '0011U00000LQ76LQAT',
      Name: 'AccountName2'
    }
  ],
  done: true
}

তালিকা

Salesforce.com রেকর্ড তালিকাভুক্ত করো। নির্দিষ্ট sObjectType-এর সব ফিল্ড রিটার্ন করে।

<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>

অনুরোধের প্যারামিটার

রেসপন্স

JSON হিসেবে তালিকাভুক্ত sObject সহ 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>

অনুরোধের প্যারামিটার

রেসপন্স

অপারেশনের ফলাফল সহ একটি results অ্যারে।

{
  results:[
    { id: '0011U00000LQ76KQAT', success: true, errors: [] },
    { id: '0011U00000LQ76LQAT', success: true, errors: [] }
  ]
}

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"
}

কনফিগারেশন রেফারেন্স

API প্রক্সিতে ব্যবহারের জন্য এই এক্সটেনশন কনফিগার ও ডেপ্লয় করার সময় নিম্নলিখিত বিষয়গুলি ব্যবহার করুন।

এক্সটেনশনের সাধারণ প্রপার্টি

নিম্নলিখিত বৈশিষ্ট্যগুলি প্রতিটি এক্সটেনশনের জন্য উপস্থিত রয়েছে।

এই এক্সটেনশন প্যাকেজের প্রপার্টি

এই এক্সটেনশনের জন্য নির্দিষ্ট নিম্নলিখিত কনফিগারেশন প্রপার্টির ভ্যালু উল্লেখ করুন।