サポート (英語のみ)

Salesforceコネクタ

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

コネクタは、OAuthおよびベーシック認証の認証方法をサポートします。

前提条件

Salesforceコネクタを設定する前に、以下を確認してください：

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

  • 関連する認証方法を使用してコネクタの資格情報を設定します。 詳細な情報については、Nexthinkコネクタ資格情報ドキュメントを参照してください。

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

Salesforceコネクタを設定するには管理者権限が必要です。必要な管理者権限を持っていることを確認してください。

コネクタでOAuth 2.0認証を使用するには、SalesforceでConnected Appを作成する必要があります：

Stepと必要な設定は、お使いのSalesforce設定に基づいて変わる場合があります。 詳細な情報については、Salesforce認証ドキュメントを参照してください。

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

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

  3. 基本情報の下で必要なフィールドを追加してアプリケーションを作成します：

    • 接続されたアプリケーション名： 例：Nexthink Adopt Integration

    • API名：自動生成されます

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

    • 配布状態：ローカルを選択

  4. 作成をクリック

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

  6. OAuth設定の下で、OAuth設定の有効化のチェックボックスを選択します。

  7. アプリ設定の下で必要なフィールドを追加します：

    1. コールバックURL： http://localhost（プレースホルダ）を使用

    2. OAuthスコープ：関連するOAuthスコープを選択

  8. フロー対応の下で、クライアント資格情報フローのチェックボックスを選択します。

  9. セキュリティの下で、次を選択します：

    • Webサーバーフロー用のシークレットが必要チェックボックス

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

  10. 保存をクリック

  11. OAuth設定に移動し、Consumer Key and Secretをクリックして認証情報を取得

  • Salesforceのプロンプトに従って、自分の身元を確認してください

  • Consumer KeyとConsumer Secret keyをコピーするには、コピーをクリックします。

認証情報キーを安全に保管して、無許可のアクセスを防ぐようにしてください。

コネクタ資格情報の設定

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

Salesforceコネクタの設定

Nexthink Webインターフェイスから：

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

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

  3. Salesforce: ユーザー属性を選択します。

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

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

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

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

  • スケジューリング：

    • 繰り返し：実行時間と繰り返しを設定。 実行はスケジュールされた時間に開始されます。

  • 接続:

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

    • URL：資格情報を選択すると自動的に入力されます。

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

  • クエリ： Salesforce Object Query Language（SOQL）クエリをSalesforce APIによって実行する。 そのクエリには、以下を含むユーザーオブジェクトのリストを返します：

    • インポートするフィールド（例：名前、メール、部署）

    • ユーザーを特定し、Nexthink識別子にマップするためのフィールドを使用（例えば、電子メールアドレスまたはUPN形式のユーザー名）。

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

  • 識別: ユーザーを識別するためにAPI応答から選択するフィールド。

    • ソース識別子（JSONata）：API応答によって返されるユーザーを識別するフィールド名を入力。 必要に応じて値を変換するために、JSONataを使用します。 フィールド名にスペースかJSONataの予約文字（例：., +, -, *, /, { など）が含まれる場合は、バックティック (\`)で囲む必要があります。

    • Nexthink識別子： UPN（CollectorによるUPNコレクションが必要）または電子メールアドレス（Entra IDコネクタが必要）のいずれかを選択。

  • フィールドマッピング： マッピングの追加をクリックして、API応答フィールドがNexthinkカスタムフィールドにどのようにマッチするかを定義します。

    • ソース識別子（JSONata）： インポートするデータが含まれるAPI応答内のフィールド名を指定します。 マッピング前のデータを変換する必要がある場合は、JSONataを使用します。

    • Nexthinkフィールド： ユーザーオブジェクトのカスタムフィールドを選択してデータをインポート。 フィールド名にスペースかJSONataの予約文字（例：., +, -, *, /, { など）が含まれる場合は、バックティック (\`)で囲む必要があります。

既知の制限事項

  • コネクタは1回の同期で300万件以上のレコードを処理できません。

  • 社員が同じUPNを共有している場合、UPNベースの識別は最初の1,000件のユーザーレコードのみ処理されます。

  • ユーザー主要名（UPN）のための設定はCollectorで必要です。

  • 電子メールアドレスにはEntra ID（Azure AD）コネクタが必要です。

NQLを使用して実行ログをクエリ

NQLを使用すると、以下のテーブルをクエリすることで、Saleforceコネクタインスタンスの実行に関する詳細なインサイトを取得できます：

フィールド
タイプ
説明

時間

datetime

コネクタ実行ログエントリのタイムスタンプ。

ステータス

enumeration

実行ステータス: • 成功: すべての行が受信および処理されました。 • 部分成功: 行の制限により一部の行が無視されました。 • 失敗: コネクタがデータを受信または処理できませんでした。

details.name

文字列

コネクタインスタンスの名前。

details.description

文字列

エラーの説明（該当する場合）。 以下のような説明を含む: • 受信した行が多すぎる... • フィールドに対する無効な JSONata 式

details.connector

文字列

使用されたコネクタテンプレートの名前。

details.credentials

文字列

インスタンスで使用された資格情報のラベル。

details.credentials_id

文字列

資格情報の一意の識別子。

details.nql_id

文字列

コネクタ インスタンスのNQL ID。

details.number_of_received_rows

数値

ソースから受信した行の総数。

details.number_of_processed_rows

数値

コネクタによって処理された行の総数―インポートされた行と異なる場合があります。

platform.inbound_connector_logsクエリを実行して、すべてのインバウンドコネクタ実行に関する包括的なログ情報を取得します。

このテーブルにアクセスするには、データモデルの可視性でプラットフォームログ権限が有効になっている必要があります。

NQLの例

過去24時間のインポート失敗を取得
過去24時間における platform.inbound_connector_logs | statusが失敗の場合 | time, details.connector, details.name, details.error_descriptionを列挙 | timeを降順で並べ替え
過去24時間のインポート失敗を取得
過去24時間における platform.inbound_connector_logs | statusが失敗の場合 | time, details.connector, details.name, details.error_descriptionを列挙 | timeを降順で並べ替え

Last updated

Was this helpful?