Salesforce アプリケーション スコープ

UiPath.Salesforce.Activities.SalesforceApplicationScope

指定された Salesforce Org への接続を確立し、後続のすべてのアクティビティのスコープを提供します。アクティビティの本体にある [設定] ボタンをクリックすると、接続ウィザードが開き、Salesforce Org への接続を確立できます。

注: コンシューマー キーとコンシューマー シークレットは、Salesforce Connected App を識別します。これらは、Salesforce 管理者から取得できます。

接続の詳細のすべてがそれぞれのフィールドに挿入されると、[テスト接続] ボタンが利用可能になります。

[テスト接続] をクリックすると、入力した資格情報の有効性を検証し、結果を知らせます。接続が検証されると、それぞれのウィザードですべての子アクティビティの構成を開始できるため、この接続は設計時にのみ使用されます。

重要: ウィザードのフィールドを設定しても、[Salesforce アプリケーション スコープ] のプロパティ フィールドには入力されません。ウィザードは、設計時のみに使用される Salesforce への接続を確立し、このスコープ アクティビティに含まれる Salesforce アクティビティを設定できるようにします。

プロパティ

重要: [新しい接続] と [既存の接続を使用] プロパティのセクションは、相互に排他的です。いずれかのセクションを構成すると、もう一方が無効化されます。実行時にアクティビティを Salesforce に接続するには、いずれかを構成する必要があります。

Assignment Rule ヘッダー

• Sforce-Auto-Assign - 取引先、ケース、リードを作成または更新する際に適用される、要求のヘッダーです。このフィールドには、Boolean 値および一意の識別子の値を指定できます。以下の値を入力できます。

  • TRUE - 作成または更新される取引先、ケース、リードに、アクティブな割り当てルールが適用されます。
  • FALSE - 作成または更新される取引先、ケース、リードに、アクティブな割り当てルールは適用されません。
  • AssignmentRule ID - 作成される取引先、ケース、リードに、指定した AssignmentRule が適用されます。
  • 値なし - REST API ヘッダーに、アクティブな割り当てルールが使用されます。

共通

• 表示名 - アクティビティの表示名です。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

新規の接続

• ConsumerKey - Salesforce Connected App のコンシューマキーです。このフィールドは、文字列と String 型変数のみをサポートします。
• コンシューマー シークレット - SecureString 変数に格納された Salesforce Connected App のコンシューマー シークレットです。このフィールドは、SecureString 型変数のみをサポートします。
• Password - SecureString に格納される、ログインに使用するユーザーのパスワードです。このフィールドでは SecureString 型変数のみがサポートされています。
• セキュリティ トークン - SecureString 変数に格納されているクレデンシャルが Salesforce へログインするために使用されているユーザーのセキュリティトークンです。このフィールドでは SecureString 型変数のみがサポートされています。このプロパティは、Salesforce Org の設定によってはオプションです。
• サーバー - 接続先のサーバーのインスタンスです。このフィールドでサポートされている 3 つの値は、Live (https://login.salesforce.com) と Test (https://test.salesforce.com)、Custom です。このフィールドは、文字列と String 型の変数のみをサポートします。
• カスタム サーバー - [サーバー] を Custom に設定した場合の接続先となるカスタムの Salesforce インスタンスです。これは、標準ドメインである https://login.salesforce.com または https://test.salesforce.com 経由のログインが制限されている場合に使用します。例: https://mycompany.my.salesforce.com/
• ユーザー名 - Salesforce へのログインに使用するユーザー名です。このフィールドは、文字列と String 型変数のみをサポートします。

プロキシ設定

• プロキシ アドレス - プロキシ サーバーのアドレスです。プロトコルがアドレスに指定されていない場合は、自動的に規定値 http が設定されます。このフィールドでは、文字列と String 型変数のみがサポートされています。
• プロキシ ポート - プロキシ サーバーのポートです。このフィールドは、文字列と String 型変数のみをサポートします。
• プロキシ ユーザー - 認証用にプロキシ サーバーに送信するユーザー名です。このフィールドは任意です。このフィールドは、文字列と String 型変数のみをサポートします。
• プロキシ ユーザー パスワード - プロキシ ユーザーのパスワードです。このフィールドは任意です。このフィールドは、SecureStrings および SecureString 型変数のみをサポートします。
  重要: コンシューマー シークレットとセキュリティ トークンは Microsoft .NET データ保護 API (DPAPI) を使用して暗号化され、ワークフロー ファイル自体に格納されます。これらは、同じユーザー アカウントと同じマシンでワークフローを開くことによってのみ解読できます。ワークフローが別のユーザーまたは別のマシンで開かれている場合、エラー メッセージが表示され、2 つのプロパティを再構成する必要があります。

オプション

• API エラーを例外として報告 - 選択すると、このアプリケーション スコープを使用するすべての子アクティビティにより API エラー応答が Salesforce 例外として報告されます。選択しないと、子アクティビティは API エラー メッセージを SalesforceStatus 出力プロパティに追加し、ワークフローの実行を続行します。ワークフローが正常に実行されたかどうかを確認するには SalesforceStatus プロパティを確認します。

出力

• SalesforceConnection - IConnectionService オブジェクトに格納されている Salesforce への接続の詳細です。このオブジェクトは、簡単に同じ接続を再利用する [既存の Salesforce 接続] プロパティの後続の [Salesforce アプリケーション スコープ] アクティビティに渡すことができます。このフィールドでは IConnectionService オブジェクトのみがサポートされています。
  注: IConnectionService オブジェクトは、生成された親スコープ内に含まれるスコープ アクティビティでのみ再利用可能です。

既存の接続を使用

• 既存の Salesforce 接続 - このスコープのアクティビティに再利用する、IConnectionService オブジェクトに格納されている Salesforce への既に確立された接続です。IConnectionService オブジェクトは、親 [Salesforce アプリケーション スコープ] アクティビティの [Salesforce 接続] プロパティから取得することができます。このフィールドでは IConnectionService オブジェクトのみがサポートされています。