Salesforce組織の接続
TranSFlatorは、PKCE（コードチャレンジメソッド S256）を使用したOAuth 2.0を使用してSalesforceに接続します。「ユーザー名とパスワードを貼り付ける」ステップはなく、TranSFlatorのバックエンドが介在することもありません。認証コードの交換は、お客様自身のマシン上で行われます。
- アプリの右上の**[接続を追加]**をクリックします。
- 接続にラベル（例：“EMEA サンドボックス”や”Acme 本番”）を付け、[本番/開発用]（
login.salesforce.com）または**[サンドボックス]（test.salesforce.com）のいずれかを選択して、[認証]**をクリックします。 - ブラウザが開きます。通常通りSalesforceにログインしてください。組織でSSOやMFAを使用している場合、通常のフローがここで実行されます。
- Salesforceから、TranSFlator 接続アプリにメタデータへのアクセスを許可するかどうか尋ねられます。**[許可]**をクリックします。
- Salesforceは、デスクトップアプリが待機している
http://localhost:1717/oauth/callbackにリダイレクトします。このループバックコールバックがお客様のマシン外に出ることはありません。 - アプリは認証コードをリフレッシュトークンとアクセストークンに交換します。リフレッシュトークンはAES-256-CBCで暗号化され、
transflate.dbに書き込まれます。アクセストークンはRAM内のみに保持されます。
これで接続されました。サイドバーに緑色のステータスドットが付いた接続が表示されます。それをクリックしてその組織の翻訳グリッドを開くと、TranSFlatorはすぐに組織をスキャンして、すべての翻訳可能な要素を探します。
カスタムドメインの使用
Section titled “カスタムドメインの使用”組織で「私のドメイン」（acme.my.salesforce.com）を使用している場合は、インスタンスセレクターから**[カスタムドメイン]**を選択し、https://...で始まる完全なホスト名を貼り付けてください。アプリは標準のログインエンドポイントの代わりに、それをOAuthホストとして使用します。
スクラッチ組織
Section titled “スクラッチ組織”スクラッチ組織はサンドボックスとまったく同じように動作します。インスタンスピッカーで**[サンドボックス]**を選択してください。リフレッシュトークンはスクラッチ組織が存在する限り有効です。スクラッチ組織の期限が切れると、次回の接続テスト時にTranSFlatorが通知します。
TranSFlatorがアクセスできる範囲
Section titled “TranSFlatorがアクセスできる範囲”接続後、アプリはログインしたユーザーと同じメタデータアクセス権を持ちます。それ以上ではありません。ユーザーがフィールドを表示できる場合、TranSFlatorはそのフィールドを翻訳できます。ユーザーがレコードタイプにアクセスできない場合、TranSFlatorもそれをスキャンできません。フルスキャンを実行する前に、影響範囲を絞りたい場合はテストユーザーの権限セットを調整してください。