ادغام Salesforce، Node.js و React: راهنمای گام به گام

در این مقاله، من شما را با نحوه اتصال بک‌اند ساخته شده با آن آشنا می‌کنم Node.js به نیروی فروش با استفاده از OAuth 2.0 و سپس آن را با a ادغام کنید واکنش نشان دهید پیشانی این راه حل با برنامه Connected موجود است نیروی فروش، و sf-jwt-token & jsforce بسته های موجود در باطن
من نحوه انجام این کار را در محلی خود در ماشین محلی و در محیط آزمایشی توضیح خواهم داد و همه ابزارهای مورد نیاز را در اختیار شما قرار می دهم.

1. پیکربندی نیروی فروش

قبل از کدنویسی، باید Salesforce را پیکربندی کنیم تا اجازه ادغام با برنامه ما را بدهد.

مراحل نیروی فروش:

1. یک برنامه متصل ایجاد کنید:

   • رفتن به راه اندازی → مدیر برنامه → ایجاد یک برنامه متصل.
   • فعال کردن API (فعال کردن تنظیمات OAuth).
   • در محدوده های OAuth انتخاب شده، انتخاب کنید:
     • Refresh token
     • API
     • Full access.

2. سیاست های OAuth را تنظیم کنید:

   • در داخل برنامه جدید ما، به آن بروید مدیریت → ویرایش سیاست ها
     و تنظیم کنید:
     • کاربران مجاز: کاربران تایید شده توسط ادمین از قبل مجاز هستند.
   • همچنین باید نمایه ای را که می خواهیم در آن استفاده کنیم اختصاص دهیم مدیریت پروفایل ها.

3. کلید مصرف کننده و راز:
   از API (فعال کردن تنظیمات OAuth)، روی Manage Consumer Details کلیک کرده و ذخیره کنید کلید مصرف کننده (Consumer_Id) و راز مصرف کننده (Consumer_Secret) برای فایل .env بعداً در باطن ما.

4. رمز امنیتی خود را بازنشانی کنید:

   • از تنظیمات شخصی خود در Salesforce (در نمایه عکس خود)، می توانید رمز امنیتی خود را بازنشانی کنید و آن را به متغیرهای محیط خود اضافه کنید (در زیر توضیح داده شده است).

2. راه اندازی سرور Node.js

بعد، ما یک را راه اندازی می کنیم اکسپرس باطن و ابزارهای مورد نیاز برای تعامل با Salesforce.

برای این منظور می توانید از این مخزن از قبل آماده شده استفاده کنید:
گره پشتیبان

نصب Dependencies:

npm install express jsforce sf-jwt-token

توجه داشته باشید:

من این پست را در دسامبر 24 می نویسم، و این ممکن است جدیدترین ابزارها نباشند، اما دو ویژگی جدید گره خوب وجود دارد که دانستن آنها خوب است. بنابراین من فقط در مورد آنها به شما اطلاع می دهم، فقط در صورت امکان.
اگر از Node.js 22.12 یا جدیدتر استفاده می کنید:

• شما نیاز ندارید dotenv برای متغیرهای محیطی دیگر، می توانید استفاده کنید process.loadEnvFile() در عوض
• همچنین می توانید استفاده کنید node --watch به جای بدون دیو برای راه اندازی مجدد خودکار سرور بنابراین، دو بسته کمتر برای نصب.

متغیرهای محیطی:

ایجاد یک .env فایل و موارد زیر را تعریف کنید:

CONSUMER_ID=your_consumer_id
SF_USERNAME=your_salesforce_username
LOGIN_URL=https://login.salesforce.com OR https://test.salesforce.com

تست محلی؟ از Ngrok استفاده کنید

برای اینکه سرور محلی خود را در معرض Salesforce قرار دهید (که عمدتاً در تماس اول مورد نیاز است):

1. نصب و اجرا کنید ngrok.
2. سرور خود را اجرا کنید
3. ngrok را به درگاهی که باطن شما روی آن اجرا می شود، تایپ کنید ngrok.exe http در ترمینال شما
4. URL تولید شده توسط ngrok را کپی کرده و آن را به عنوان URL برگشت به تماس در برنامه Salesforce Connected خود در بخش API (فعال کردن تنظیمات OAuth).

3. کلید خصوصی و گواهی

با دستور ترمینال زیر یک کلید خصوصی و گواهی ایجاد کنید:

$ openssl req  -nodes -new -x509  -keyout private.pem -out server.cert

امضای دیجیتال را در SF آپلود کنید

اکنون این دو فایل در پروژه شما هستند. زمان فعال کردن گزینه Use Digital signatures in your Connected App، و آپلود گواهی تولید شده در راه اندازی → گواهینامه ها و مدیریت کلید.

اکنون مسیر توکن را در مرورگر خود اجرا کنید

http://localhost:3000/token

اگر همه چیز خوب پیش رفت، اکنون access_token خود را دریافت خواهید کرد.

{
  access_token: '',
  scope: 'api full',
  instance_url: '',
  id: '',
  token_type: 'Bearer'
}

کاری که من در راه حل خود انجام دادم، همه چیز انجام شد، من یک توکن جدید از SF دریافت کردم. ممکن است همان یکی جدید باشد زیرا SF هر از گاهی یک مورد جدید تولید می کند.

5. استفاده از JSforce

با توکن، می توانید از سرور Node.js خود با Salesforce تعامل برقرار کنید. در اینجا یک مثال ساده آورده شده است:

const jsforce = require('jsforce');

const conn = new jsforce.Connection({
  instanceUrl: 'https://your-instance.salesforce.com',
  accessToken: 'your_access_token',
});

conn.query('SELECT Id, Name FROM Account', (err, result) => {
  if (err) return console.error(err);
  console.log('Accounts:', result.records);
});

6. ادغام با React

در نهایت، از React برای ایجاد یک فرانت اند که داده ها را از باطن مصرف می کند و به صورت تعاملی نمایش می دهد، استفاده کنید. به عنوان مثال، می توانید بسازید:

• فرمی برای ایجاد رکورد در Salesforce.
• جدولی برای نمایش داده های حساب بازیابی شده از باطن.

در مورد استفاده من، من به روشی نیاز داشتم که در آن کارمندان یک شرکت بتوانند داده های رفت و آمد را در آن قرار دهند، و رجیسترها را در SF، در Net Zero Cloud بتن ریزی کنند، اما برای این تمرین من فقط شی مورد نیاز را ایجاد کردم و راه حل را با یک سازمان رایگان توسعه دهنده نسخه ی نمایشی.

همچنین می توانید از این مخزن فرم React Frontend برای این منظور استفاده کنید.

React Frontend.

نتیجه گیری

Salesforce، Node.js، و React را به روشی آسان ادغام کنید، فقط برای بازی کردن با ابزارها و کار کردن همه چیز.
امیدوارم این مقاله به شما کمک کند راه حل یکپارچه سازی خود را شروع کنید.

سؤال یا ایده ای برای بهبود این گردش کار دارید؟ آنها را در نظرات بگذارید.