Tableau からPostmark にOData フィードとして接続する方法

加藤龍彦
加藤龍彦
デジタルマーケティング
API Server を使用して、BI ツールTableau からPostmark のデータに接続する方法をわかりやすく説明します。



CData API Server は、API JDBC Driver（またはほかの240を超える ADO.NET Providers）と組み合わせることでOData Web サービスとしてPostmark を提供します。この記事では、API Server を使用してBI ツールTableau にPostmark への接続を提供する方法について説明します。

API Server の設定

以下のリンクからAPI Server の無償トライアルをスタートしたら、セキュアなPostmark OData サービスを作成していきましょう。

Postmark への接続

Tableau からPostmark のデータを操作するには、まずPostmark への接続を作成・設定します。

  1. API Server にログインして、「Connections」をクリック、さらに「接続を追加」をクリックします。 接続を追加
  2. 「接続を追加」をクリックして、データソースがAPI Server に事前にインストールされている場合は、一覧から「Postmark」を選択します。
  3. 事前にインストールされていない場合は、コネクタを追加していきます。コネクタ追加の手順は以下の記事にまとめてありますので、ご確認ください。
    CData コネクタの追加方法はこちら >>
  4. それでは、Postmark への接続設定を行っていきましょう！ 接続設定

  5. API キー認証の設定

    Postmark は、リクエストの認証にサーバー API トークンを使用します。各 Postmark サーバーは独自の API トークンを持ち、そのサーバーに関連付けられたメッセージ、バウンス、テンプレート、統計情報へのアクセスを制御します。

    Server API Token を取得するには、Postmark アカウントにログインし、接続したいサーバーに移動します。サーバー設定の API Tokens に移動して、Server API token というラベルのトークンをコピーしてください。

    以下の接続プロパティを設定して接続を確立してください：

    • AuthScheme：APIKey に設定します。
    • APIKey：Postmark の Server API Token に設定します。この値は、すべてのリクエストで X-Postmark-Server-Token ヘッダーとして送信されます。

    接続文字列の例：

    Profile=C:\profiles\Postmark.apip;AuthScheme=APIKey;ProfileSettings="APIKey=your-server-api-token"

    Postmark への接続

    認証を設定すると、Postmark に接続して、OutboundMessages、Bounces、Templates などの利用可能なテーブルからデータをクエリできます。

  6. 接続情報の入力が完了したら、「保存およびテスト」をクリックします。

API キー認証の設定

Postmark は、リクエストの認証にサーバー API トークンを使用します。各 Postmark サーバーは独自の API トークンを持ち、そのサーバーに関連付けられたメッセージ、バウンス、テンプレート、統計情報へのアクセスを制御します。

Server API Token を取得するには、Postmark アカウントにログインし、接続したいサーバーに移動します。サーバー設定の API Tokens に移動して、Server API token というラベルのトークンをコピーしてください。

以下の接続プロパティを設定して接続を確立してください：

  • AuthScheme：APIKey に設定します。
  • APIKey：Postmark の Server API Token に設定します。この値は、すべてのリクエストで X-Postmark-Server-Token ヘッダーとして送信されます。

接続文字列の例：

Profile=C:\profiles\Postmark.apip;AuthScheme=APIKey;ProfileSettings="APIKey=your-server-api-token"

Postmark への接続

認証を設定すると、Postmark に接続して、OutboundMessages、Bounces、Templates などの利用可能なテーブルからデータをクエリできます。

API Server のユーザー設定

次に、API Server 経由でPostmark にアクセスするユーザーを作成します。「Users」ページでユーザーを追加・設定できます。やってみましょう。

  1. 「Users」ページで ユーザーを追加をクリックすると、「ユーザーを追加」ポップアップが開きます。
  2. 次に、「ロール」、「ユーザー名」、「権限」プロパティを設定し、「ユーザーを追加」をクリックします。
  3. その後、ユーザーの認証トークンが生成されます。各ユーザーの認証トークンとその他の情報は「Users」ページで確認できます。

Postmark 用のAPI エンドポイントの作成

ユーザーを作成したら、Postmark のデータ用のAPI エンドポイントを作成していきます。

  1. まず、「API」ページに移動し、 「 テーブルを追加」をクリックします。
  2. アクセスしたい接続を選択し、次へをクリックします。
  3. 接続を選択した状態で、各テーブルを選択して確認をクリックすることでエンドポイントを作成します。

OData のエンドポイントを取得

以上でPostmark への接続を設定してユーザーを作成し、API Server でPostmark データのAPI を追加しました。これで、OData 形式のPostmark データをREST API で利用できます。API Server の「API」ページから、API のエンドポイントを表示およびコピーできます。

Postmark のデータ可視化を作成する

それでは、Postmark のデータを使用した可視化を作成していきましょう。

  1. Tableau で「データ接続」を選択します。「On a server」セクションで「OData」をクリックします。

    An OData data source, in the 'On a server' section in the 'Connect to data' wizard in Tableau.

  2. 表示されるウィザードで、API Server のOData エンドポイントのURL を入力します。OData エントリのURL にアクセスするテーブルの名前を追加します。例： 

            https://your-server/api.rsc/Bounces
  3. 「Use a Username and Password」オプションを選択し、API Server にアクセスできるユーザーのユーザー名とパスワードを入力します。 The URL of the OData endpoint of the API Server and the username and password (authtoken) of an API Server user.

  4. Tableau は、API Server によって公開されるテーブルメタデータを使用してディメンションカラムとメタデータカラムを検出します。

    Columns organized into dimensions and measures in Tableau.(Salesforce is shown.)

  5. Postmark のデータを表示するには、ダッシュボードの「Data」セクションでテーブル名の下を右クリックし、「View Data」オプションを選択します。 Postmark のデータがTableau に表示されます。

    A grid of data in Tableau.(Salesforce is shown.)

はじめる準備はできましたか？

詳細はこちら、または無料トライアルにお申し込みください：

CData API Server

この記事の内容

関連記事