Power BI Connector for Marketo

Build 23.0.8839

DSN の作成

このセクションでは、DSN 設定の編集方法と、Marketo API への認証および接続について説明します。

DSN 設定

Microsoft ODBC データソースアドミニストレーターを使ってDSN 設定を編集できます。インストールプロセスではコネクタのインストール で説明のとおり、ユーザーDSN とシステムDSN の両方が作成されることに注意してください。

Note: 本製品 は、接続情報をWindows レジストリに保存します。本製品 がレジストリに書き込めるようにするには、Power BI を管理者として実行するか、接続にシステムDSN ではなくユーザーDSN を使用します。

ユーザーDSN

DSN 設定を編集するには、次の手順を実行してください。

  1. スタート -> 検索 を選択し、検索ボックスにODBC データソース と入力します。
  2. Power BI Desktop インストールのビット数(32-bit または64-bit)に対応するODBC アドミニストレーターのバージョンを選択してください。
  3. システムデータソースを選択して構成をクリックします。
  4. 接続タブの情報を編集してOK をクリックします。

システムDSN

システムDSN をユーザーDSN と同じ方法で設定します。ただし、ステップ3を実行する前に、システムDSN タブに切り替える必要があります。

Power BI のOn-Premises Data Gateway をStandard モードで使用している場合、システムDSN を使用する必要があります。

OAuthSettingsLocation(OAuth のプロンプトが繰り返されるのを避けるため、OAuth 認証情報をローカルに保存するパス)にも有効な場所を指定する必要があります。

これは、Standard モードがサービスモードで動作し、C:\Windows\ServiceProfiles\PBIEgwService\AppData\Local\Microsoft\On-premises data gateway のような許可された場所にしかアクセスできないためです。

Marketo への接続

Marketo は2つのAPI を提供しています。REST およびSOAP です。使用するAPI を指定するには、 Schema プロパティをREST またはSOAP のいずれかに設定します。

REST API

REST API は、OAuth 認証を使用してユーザーのアクセスを検証します。REST API 経由の Marketo へのアクセスを設定するには:

  1. カスタムサービスを作成します。
  2. 適切なOAuth 認証情報を取得します。
  3. 接続変数を設定します。

カスタムサービスの作成

この手順では、REST API 権限を持つ新しいロールを作成し、そのロールを既存または新規のユーザーに割り当て、新しいサービスを作成します。これは管理者権限を持つユーザーによって実行される必要があります。

  1. Marketo アプリケーションの[管理]エリアに移動します。
  2. [セキュリティ]セクションに移動します。
  3. ユーザ& ロールをクリックします。
  4. API アクセス用の新しいロールを作成します。
    1. ロールタブを選択します。
    2. 新規ロールをクリックします。
    3. [ロール名]を指定し、ロールの権限を選択します。REST API に固有の[API へのアクセス]権限を指定します。
  5. API アクセスを実行するユーザーを割り当てるか、新規作成します。
    1. ユーザタブを選択します。
    2. 作成したロールを新規ユーザーに割り当てるには、新規ユーザの招待をクリックします。
    3. 新しいユーザーの情報を入力し、先ほど作成した、REST API に接続可能なロールを割り当てます。API 専用ユーザーとして指定するには、API のみオプションを選択します。
  6. 新しいサービスを作成します。
    1. 管理 -> 統合に移動して、LaunchPoint オプションをクリックします。
    2. 新規サービスをクリックします。
    3. サービスタイプをカスタムに指定します。
    4. サービスの[表示名]および[詳細]を入力します。
    5. 作成したユーザーをサービスに割り当てます。

Marketo は、Marketo への接続および認証ために設計された新しいREST API サービスを作成します。 また、REST API へのユーザーのアクセスを検証するために必要なOAuth ベースの認証情報も生成します。

OAuth 資格情報を取得

新しいサービスのOAuth 資格情報を取得して記録するには、Marketo [管理]エリアに戻り、 LaunchPoint オプションに移動します。

作成したサービスの詳細の表示リンクをクリックします。Marketo は、認証資格情報を表示するウィンドウを開きます。 これらの資格情報は、OAuthClientId およびOAuthClientSecret の値を提示します。

接続変数の設定

以下の接続変数を設定したら、REST API 経由での接続準備は完了です。

  • SchemaREST
  • OAuthClientId:カスタムサービスに紐付けられたOAuth クライアントID。
  • OAuthClientSecret:カスタムサービスに紐付けられたOAuth クライアントシークレット。
  • RESTEndpoint:管理エリアにある、REST Web サービスエンドポイントのURL。 REST API の統合 -> ウェブ サービスセクションに移動して、このURL を見つけます。 Identity Endpoint は空白のままにします。

SOAP API

以下の接続変数を設定したら、SOAP API 経由での接続準備は完了です。

  • SchemaSOAP
  • UserId:Marketo の[管理]SOAP API パネルの統合セクションにあるクライアントアクセスID。
  • EncryptionKey:Marketo Web サイトの[管理]ページで生成される、Marketo SOAP API 暗号化キー。
  • SOAPEndpoint:Marketo Web サイトの[管理]ページにある、SOAP Web サービスエンドポイントのURL。

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 23.0.8839