Salesforce用コネクター

Salesforceコネクタは、Salesforce SOQL REST APIを使用してSalesforceからユーザーデータをインポートします。 これにより、Nexthink Adoptに関連するユーザー属性を導入し、ターゲティングとパーソナライズを強化できます。 Salesforceコネクタを使用して、Nexthinkインターフェースのカスタムフィールドを充実させます。

このコネクタはOAuthおよびBasic Auth認証方法をサポートしています。 ただし、リスト中には2つの個別のコネクタとして表示されます:

  • Salesforce: ユーザー属性 (OAuth)

  • Salesforce: ユーザー属性 (Basic Auth)

前提条件

Salesforceコネクタを構成する前に、次を確認してください:

  • Salesforceで接続されたアプリケーションを構成するために必要な管理者権限を持っていること。 詳細については、公式のSalesforceドキュメントを参照してください。

  • 関連する認証方法を使用してコネクタの資格情報を構成してください。 詳細については、Nexthinkコネクタ資格情報ドキュメンテーションを参照してください。

Salesforceアプリケーションの設定

コネクタにOAuth 2.0認証を使用するには、Salesforceで接続アプリケーションを作成する必要があります。

手順と必要な設定は、お使いのSalesforceの構成によって異なる場合があります。 詳細については、Salesforce認証 ドキュメントを参照してください。

  1. 設定 > プラットフォームツール > アプリ > 外部アプリに移動します。

  2. 外部アプリマネージャ > 新しい外部アプリをクリックします。

  3. アプリケーションを作成するために、基本情報の必須フィールドを追加します。

  • 接続アプリ名: 例 Nexthink Adopt Integration

  • API名: 自動生成

  • 連絡先Eメール: 有効なメールアドレス

  • 配信状態: ローカルを選択

  1. 作成をクリックします。

  2. OAuth認証を使用する場合は、設定タブに移動して、[編集]をクリックしてOAuth設定を有効にします。

  3. OAuth設定で、OAuth設定を有効にするチェックボックスを選択します。

  4. アプリ設定に必要なフィールドを追加します。

  5. コールバックURL: http://localhost (プレースホルダー)を使用

  6. OAuthスコープ: 目的に応じたOAuthスコープを選択

  7. Flow有効化で、クライアント資格情報Flowチェックボックスを選択します。

  8. セキュリティで、次を選択します:

  • WebサーバFlowのシークレット必要チェックボックス

  • リフレッシュトークンFlowのシークレット必要チェックボックス

  1. 保存をクリックします。

  2. OAuth設定に移動し、コンシューマキーとシークレットをクリックして資格情報を取得します。

  • Salesforceのプロンプトに従って、本人確認を行ってください。

  • コンシューマキーおよびコンシューマシークレットキーをコピーするには、コピーをクリックします。

コネクタの資格情報の設定

Salesforceの資格情報を使用して、NexthinkとSalesforceの統合のために新しい資格情報を作成します。 詳細については、コネクタの資格情報 を参照してください。

Salesforceコネクタの設定

NexthinkのWebインターフェースから:

  1. 管理 > インバウンドコネクタに移動します。

  2. ページの右上隅にある新しいコネクタボタンをクリックします。

  3. 認証方法に応じて、Salesforce: ユーザー属性 (基本認証) または Salesforce: ユーザー属性 (OAuth) を選択します。

一般タブには以下が含まれます:

  • 名前: コネクタの意味のある名前。 この名前は管理ページに表示されます。

  • NQL ID: NQLクエリでSalesforceコネクタを参照する際に使用されるコネクタの一意の識別子。 提案されたNQL IDを最初に変更できますが、一度ワークフローを保存すると、NQL IDを変更することはできません。

  • 説明: コネクタの目的と動作の短い説明。

  • スケジューリング:

    • 再発: 実行時間と再発を設定します。 実行は、予約された時間に開始します。

  • 接続:

    • 資格情報: コネクタ資格情報ページから事前に設定された資格情報を選択します。 コネクタは基本認証とOAuth認証をサポートしています。 詳細については、コネクタ資格情報 ドキュメントを参照してください。

    • URL: 資格情報を選択すると、このURLは自動的に表示されます。

パラメータタブには以下が含まれます:

  • クエリ: Salesforceオブジェクトクエリ言語(SOQL)クエリを入力し、Salesforce APIによって実行されます。 クエリには、ユーザーオブジェクトのリストが含まれている必要があります。

    • インポートするフィールド(例: 名前、メール、部門)

    • ユーザーを特定するためにフィールドを使用し、それをNexthink識別子にマップします(例えば、メールアドレスやUPNの形で)。

データマッピングタブには以下が含まれます:

  • 識別: APIレスポンスからユーザーを識別するために使用されるフィールドを選択します。

    • ソース識別子 (JSONata): APIレスポンスによって返されたフィールド名を入力し、ユーザーを識別します。 必要に応じて、JSONataを使用して値を変換します。

    • Nexthink識別子: UPN (Collectorを通じたUPN収集が必要) または メールアドレス (Entra ID コネクタが必要)のいずれかを選択します。

  • フィールドマッピング: マッピングの追加をクリックし、APIレスポンスフィールドをNexthinkカスタムフィールドにマッチさせる方法を定義します。

    • ソース識別子 (JSONata): インポートするデータが含まれるAPIレスポンスのフィールド名を指定します。 マッピング前にデータを変換する必要があれば、JSONata を使用します。

    • Nexthinkフィールド: データインポート用にユーザーオブジェクトのカスタムフィールドを選択します。

既知の制限

  • もし従業員が同じUPNを持っている場合、UPNベースの識別は最初の1,000ユーザーレコードのみを処理します。

  • ユーザープリンシパル名 (UPN) はCollectorの設定が必要です。

  • メールアドレスはEntra ID (Azure AD) コネクタが必要です。

Last updated

Was this helpful?