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 に予約されている文字（例えば .、+、-、*、/、{ など）は、バックティックで囲む必要があります。

テスト結果パネル

テスト結果パネルは、サポートされているコネクタでのみ利用可能です。 コネクタの可用性はライセンスに依存します。

右側のテスト結果パネルを使用して、コネクタをリアルデータで随時実行し、レスポンスとエラーを確認します。 テストパネルは設定時のデバッグと検証を迅速化し、試行錯誤が少なく、より信頼性のあるマッピングを実現します。

テスト実行ボタンを選択して API を呼び出し、認証情報を検証し、対象エンドポイントへの接続を確認します。

基本情報として、レスポンスのステータスコードや時間の他に、パネルの下部にサンプルレスポンスレコードが表示されます。

エラーが発生した場合、システムはAPIレジポンスを表示して問題の診断を支援します。

既知の制限事項

• コネクタは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を降順で並べ替え