【ノーコード】SAP LumiraでMailerSend のOData フィードを取り込んでみる

CData API Server を使って、SAP Lumira でMailerSend に基づくビジュアライゼーションを作成できます。API Server により、リアルタイムデータへの接続が可能になります。ダッシュボードとレポートはオンデマンドで更新できます。この記事では、常に最新であるグラフを作成する方法を説明します。

API Server の設定

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

MailerSend への接続

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

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

5. MailerSend API は、Authorization リクエストヘッダー内の Bearer トークンを介した API キー認証を使用します。

   API キー認証の設定

   接続を作成するには、MailerSend の API トークンが必要です。API トークンを取得するには、以下のステップで進めます：

   1. app.mailersend.com で MailerSend アカウントにログインします。
   2. アカウントダッシュボードの Settings > API Tokens に移動します。
   3. Generate new token をクリックし、名前を入力して適切な権限を選択します。
   4. 生成された API トークンをコピーします。

   API トークンを取得したら、以下の接続プロパティを設定します：

   • AuthScheme：APIKey に設定します。
   • APIKey：MailerSend の API トークンに設定します。

   接続文字列の例：

   Profile=C:\profiles\Mailersend.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_token';
   

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

MailerSend API は、Authorization リクエストヘッダー内の Bearer トークンを介した API キー認証を使用します。

API キー認証の設定

接続を作成するには、MailerSend の API トークンが必要です。API トークンを取得するには、以下のステップで進めます：

1. app.mailersend.com で MailerSend アカウントにログインします。
2. アカウントダッシュボードの Settings > API Tokens に移動します。
3. Generate new token をクリックし、名前を入力して適切な権限を選択します。
4. 生成された API トークンをコピーします。

API トークンを取得したら、以下の接続プロパティを設定します：

• AuthScheme：APIKey に設定します。
• APIKey：MailerSend の API トークンに設定します。

接続文字列の例：

Profile=C:\profiles\Mailersend.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_api_token';

API Server のユーザー設定

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

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

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

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

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

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

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

SAP Lumira からMailerSend への接続

以下のステップに従って、MailerSend をSAP Lumira に取得します。SQL クエリを実行するか、UI を使用できます。

1. SAP Lumira で［File］->［New］->［Query with SQL］とクリックします。Add New Dataset ダイアログが表示されます。
2. ［Generic］セクションを展開し、［Generic OData 2.0 Connector］オプションをクリックします。
3. ［Service Root URI］ボックスに、API Server のOData エンドポイントを入力します。URL は次の例のようになります。

   https://your-server:8032/api.rsc
   

4. ［User Name］と［Password］のボックスにAPI ユーザーのユーザー名と認証トークンを入力します。これらの資格情報は、HTTP 基本認証で使用されます。

5. ツリーでエンティティを選択するか、SQL クエリを入力します。この記事では、MailerSend Activity エンティティをインポートします。

   

6. ［Connect］をクリックすると、SAP Lumira は対応するOData 要求を生成し、結果をメモリにロードします。その後、フィルタ、集計、要約関数など、SAP Lumira で使用可能な任意のデータ処理ツールを使用できます。

   

データのビジュアライゼーションを作成

データをインポートした後、［Visualize］ルームでデータのビジュアライゼーションを作成できます。以下のステップに従って、基本グラフを作成します。

1. ［Measures and Dimensions］ペインで、メジャーとディメンションを［Visualization Tools］ペインの［x-axis］フィールドと［y-axis］フィールドにドラッグします。SAP Lumira は、API Server のメタデータサービスからディメンションとメジャーを自動的に検出します。

   デフォルトでは、SUM 関数はすべてのメジャーに適用されます。メジャーの横にある歯車のアイコンをクリックしてデフォルトの要約を変更します。

2. ［Visualization Tools］ペインで、グラフの種類を選択します。
3. ［Chart Canvas］ペインで、フィルタを適用し、メジャーで並べ替え、ランキングを追加して現在のMailerSend でグラフを更新します。