ربط منظمة Salesforce الخاصة بك
يتصل TranSFlator بـ Salesforce باستخدام OAuth 2.0 مع PKCE (طريقة تحدي الرمز S256). لا توجد خطوة “لصق اسم المستخدم وكلمة المرور”، ونظام TranSFlator الخلفي ليس وسيطاً — حيث يتم تبادل رمز التفويض على جهازك الخاص.
الخطوات
Section titled “الخطوات”- في التطبيق، انقر على Add Connection (إضافة اتصال) في أعلى اليمين.
- أعطِ الاتصال تسمية (مثلاً “EMEA sandbox” أو “Acme production”)، واختر ما إذا كان مثيلاً لـ Production/Developer (
login.salesforce.com) أو Sandbox (test.salesforce.com) وانقر على Authorize (تفويض). - يفتح متصفحك. قم بتسجيل الدخول إلى Salesforce كما تفعل عادةً. إذا كانت منظمتك تستخدم تسجيل الدخول الموحد (SSO) أو المصادقة متعددة العوامل (MFA)، فإن التدفق العادي يعمل هنا.
- تطلب منك Salesforce السماح لـ TranSFlator Connected App بالوصول إلى البيانات الوصفية. انقر على Allow (سماح).
- تعيد Salesforce التوجيه إلى
http://localhost:1717/oauth/callbackالذي يستمع إليه تطبيق سطح المكتب. هذا الاتصال المحلي (loopback) لا يغادر جهازك أبداً. - يقوم التطبيق بتبادل رمز التفويض برمز تحديث ورمز وصول. يتم تشفير رمز التحديث باستخدام AES-256-CBC وكتابته في
transflate.db؛ بينما يبقى رمز الوصول في ذاكرة RAM فقط.
أنت الآن متصل. يظهر الاتصال في الشريط الجانبي مع نقطة حالة خضراء. انقر فوقه لفتح شبكة الترجمة لتلك المنظمة — سيقوم TranSFlator فوراً بفحص المنظمة بحثاً عن كل عنصر قابل للترجمة:
استخدام نطاق مخصص (My Domain)
Section titled “استخدام نطاق مخصص (My Domain)”إذا كانت منظمتك تستخدم My Domain (acme.my.salesforce.com)، فاختر Custom Domain من منتقي المثيل والصق اسم المضيف الكامل https://.... سيستخدم التطبيق ذلك كمضيف لـ OAuth بدلاً من نقطة نهاية تسجيل الدخول القياسية.
منظمات الخدش (Scratch orgs)
Section titled “منظمات الخدش (Scratch orgs)”تعمل منظمات الخدش تماماً مثل المنظمات التجريبية: اختر Sandbox في منتقي المثيل. يعيش رمز التحديث طالما بقيت منظمة الخدش نشطة — عندما تنتهي صلاحيتها، سيخبرك TranSFlator في اختبار الاتصال التالي.
ما يراه TranSFlator
Section titled “ما يراه TranSFlator”بمجرد الاتصال، يتمتع التطبيق بنفس إمكانية الوصول إلى البيانات الوصفية التي يتمتع بها المستخدم المسجل دخوله — لا أكثر. إذا كان بإمكان المستخدم رؤية حقل، فيمكن لـ TranSFlator ترجمته. إذا لم يكن للمستخدم وصول إلى نوع سجل، فلا يمكن لـ TranSFlator فحصه أيضاً. قم بتعيين مجموعة أذونات لمستخدم الاختبار قبل إجراء فحص كامل إذا كنت تريد تضييق نطاق الوصول.