সেলসফোর্স এক্সটেনশন, সেলসফোর্স এক্সটেনশন

আপনি 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 সেটআপে, বাম দিকের নেভিগেশনে, Apps > App Manager এ যান।
   2. তালিকায়, আপনার তৈরি করা সংযুক্ত অ্যাপটি সনাক্ত করুন।
   3. অ্যাপ্লিকেশনের সারির ডানদিকের ড্রপ-ডাউন থেকে, View এ ক্লিক করুন।
   4. API (Enable OAuth Settings) এর অধীনে, Consumer Keyটি সনাক্ত করুন এবং এক্সটেনশনটি কনফিগার করার সময় ব্যবহারের জন্য এর মানটি একটি নিরাপদ স্থানে কপি করুন।

এক্সটেনশনের মাধ্যমে অ্যাক্সেসের জন্য একটি সংযুক্ত অ্যাপ সেট আপ করুন

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

সেলসফোর্সে, একটি সংযুক্ত অ্যাপ বহিরাগত অ্যাপ্লিকেশনগুলিকে API-এর মাধ্যমে সেলসফোর্সের সাথে সংযোগ স্থাপনের একটি উপায় প্রদান করে।

একটি সংযুক্ত অ্যাপ সেট আপ করতে

1. সেলসফোর্সে সাইন ইন করুন।
2. উপরের ডানদিকে গিয়ার আইকনে ক্লিক করুন, তারপর সেটআপ ক্লিক করুন।
3. বাম দিকের নেভিগেশনে, Apps > App Manager প্রসারিত করুন।
4. অ্যাপ ম্যানেজার পৃষ্ঠায়, নতুন সংযুক্ত অ্যাপ ক্লিক করুন।
5. "মৌলিক তথ্য" এর অধীনে, প্রয়োজনীয় ক্ষেত্রগুলি পূরণ করুন। মানগুলি হিসাবরক্ষণের জন্য; এগুলি এক্সটেনশন দ্বারা ব্যবহৃত হয় না।
6. API (Enable OAuth Settings) এর অধীনে, Enable OAuth Settings চেকবক্সটি নির্বাচন করুন।
7. যদিও এটি এক্সটেনশন দ্বারা ব্যবহৃত হয় না, একটি কলব্যাক URL লিখুন। আপনি http://localhost/ অথবা অন্য কোনও প্লেসহোল্ডার হোস্ট ব্যবহার করতে পারেন।
8. ডিজিটাল স্বাক্ষর ব্যবহার করুন চেকবক্সটি নির্বাচন করুন।
9. ডিজিটাল স্বাক্ষর ব্যবহার করুন এর অধীনে, আপনার আগে তৈরি করা salesforce.crt সনাক্ত এবং আপলোড করতে ফাইল চয়ন করুন এ ক্লিক করুন।
10. Selected OAuth Scopes বিভাগে, নিম্নলিখিতগুলি যোগ করুন যাতে সেগুলি Selected OAuth Scopes এর অধীনে থাকে:
    • আপনার ডেটা (api) অ্যাক্সেস এবং পরিচালনা করুন
    • যেকোনো সময় আপনার পক্ষ থেকে অনুরোধগুলি সম্পাদন করুন (refresh_token, offline_access)
11. সংরক্ষণ করুন এ ক্লিক করুন। যদি কোনও ত্রুটি থাকে, তাহলে আপনাকে salesforce.crt ফাইলটি পুনরায় তৈরি করে আপলোড করতে হতে পারে।
12. ফলাফলস্বরূপ অ্যাপ পৃষ্ঠায়, Manage এ ক্লিক করুন।
13. আপনার তৈরি করা অ্যাপের অ্যাপ ম্যানেজার পৃষ্ঠায়, নীতি সম্পাদনা করুন এ ক্লিক করুন।
14. OAuth নীতিমালার অধীনে, Permitted Users ড্রপ-ডাউনে ক্লিক করুন, তারপর Admin approved users are pre-authorized এ ক্লিক করুন।
15. সংরক্ষণ করুন ক্লিক করুন।
16. অ্যাপ পৃষ্ঠায় ফিরে, প্রোফাইলের অধীনে, প্রোফাইল পরিচালনা করুন ক্লিক করুন।

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

    এক্সটেনশনটি কনফিগার করার সময় আপনি যে ব্যবহারকারীর ব্যবহারকারীর নাম ব্যবহার করবেন তার সাথে সঙ্গতিপূর্ণ একটি প্রোফাইল নির্বাচন করতে ভুলবেন না। এছাড়াও নিশ্চিত করুন যে কমপক্ষে সিস্টেম অ্যাডমিনিস্ট্রেটর ব্যবহারকারীদের এই অ্যাপ্লিকেশনটিতে অ্যাক্সেস আছে।

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

18. সংরক্ষণ করুন ক্লিক করুন।

সেলসফোর্স সম্পর্কে

সেলসফোর্স একটি গ্রাহক সম্পর্ক ব্যবস্থাপনা (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: [] }
  ]
}

আপডেট

সেলসফোর্স রেকর্ড আপডেট করুন।

<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: [] }
  ]
}

উদ্ধার করা

তাদের ID দ্বারা sObjects হিসাবে রেকর্ডগুলি পুনরুদ্ধার করে। 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>

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

প্রতিক্রিয়া

JSON হিসেবে উপস্থাপিত sObjects-এর একটি records অ্যারে। মনে রাখবেন যে বস্তুর সমস্ত বৈশিষ্ট্য JSON-এ অন্তর্ভুক্ত করা হয়েছে, এমনকি যদি সম্পত্তির মান শূন্য হয়।

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

কোয়েরি SOQL

Salesforce অবজেক্ট কোয়েরি ল্যাঙ্গুয়েজ (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 রেকর্ড তালিকাভুক্ত করে। নির্দিষ্ট 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>

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

প্রতিক্রিয়া

JSON হিসেবে তালিকাভুক্ত sObjects ধারণকারী একটি 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: [] }
  ]
}

অ্যাক্সেস টোকেন পান

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 প্রক্সিতে ব্যবহারের জন্য এই এক্সটেনশনটি কনফিগার এবং স্থাপন করার সময় নিম্নলিখিতগুলি ব্যবহার করুন।

সাধারণ এক্সটেনশন বৈশিষ্ট্য

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

এই এক্সটেনশন প্যাকেজের বৈশিষ্ট্যাবলী

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