【App BUilder】Monday.com 連携用のAPI をノーコードで作ってApp Builder で使う方法

杉本和也
リードエンジニア

App Builder でMonday.comバックエンドAPI接続でお困りですか？CData API Serverでローコード開発、データ連携API構築を短時間実現。無償トライアルですぐにスタート。

App Builder はインフラジスティックス社が提供している「ドラッグアンドドロップで迅速なアプリケーション開発作成を可能にする」ローコードツールです。この記事では、CData API Server を使ってApp Builder から Monday.com に接続してデータを取得する方法を説明します。

API Server の設定

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

Monday.com への接続

App Builder からMonday.com のデータを操作するには、まずMonday.com への接続を作成・設定します。

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

Monday AuditLog API

Monday AuditLog API は、API トークンによる認証のみをサポートしています。
監査ログAPI トークンを生成するには：
1. monday.com アカウントにログインします。
2. 画面右上のアバター（画像アイコン）をクリックします。
3. 表示されたメニューからAdministration を選択します。
4. 左側のナビゲーションでSecurity をクリックします。
5. Audit タブをクリックします。
6. Monitor by API -> Copy をクリックして、AuditLog API トークンをコピーします。
API トークンを取得した後、以下の接続プロパティを設定します。
- Schema："AuditLog" に設定。
- AuthScheme：Token
- APIToken：取得した監査ログAPI トークン
- URL：Monday アカウントURL。ログイン後、自身のMonday ホームページのURL をコピーできます。例：https://your-account-name.monday.com/。
Monday GraphQL API

Monday GraphQL API は、API トークンまたはOAuth 標準による認証をサポートしています。
API トークン
API トークンで接続するには、AuthScheme をToken に設定し、次の手順でAPIToken を取得します。
1. monday.com アカウントにログインします。
2. 画面右上のアバター（画像アイコン）をクリックします。
3. 表示されたメニューからAdministration を選択します（管理者権限が必要です）。
4. 左側のナビゲーションでConnections をクリックし、表示されたページでAPI タブをクリックします。
5. Personal API Token で、Create token をクリックしてパーソナルAPI トークンを作成します。APIToken 接続プロパティをこの値に設定します。
  - すでにトークンを作成している場合は、Personal API Token でCopy ボタンをクリックしてAPI トークンをコピーします。APIToken 接続プロパティをこの値に設定します。
OAuth で認証する場合は、ヘルプドキュメントの「OAuth 認証の使用」セクションを参照してください。
接続情報の入力が完了したら、「保存およびテスト」をクリックします。

Monday 接続プロパティの取得・設定方法

Monday AuditLog API

Monday AuditLog API は、API トークンによる認証のみをサポートしています。

監査ログAPI トークンを生成するには：

monday.com アカウントにログインします。
画面右上のアバター（画像アイコン）をクリックします。
表示されたメニューからAdministration を選択します。
左側のナビゲーションでSecurity をクリックします。
Audit タブをクリックします。
Monitor by API -> Copy をクリックして、AuditLog API トークンをコピーします。

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

Schema："AuditLog" に設定。
AuthScheme：Token
APIToken：取得した監査ログAPI トークン
URL：Monday アカウントURL。ログイン後、自身のMonday ホームページのURL をコピーできます。例：https://your-account-name.monday.com/。

Monday GraphQL API

Monday GraphQL API は、API トークンまたはOAuth 標準による認証をサポートしています。

API トークン

API トークンで接続するには、AuthScheme をToken に設定し、次の手順でAPIToken を取得します。

monday.com アカウントにログインします。
画面右上のアバター（画像アイコン）をクリックします。
表示されたメニューからAdministration を選択します（管理者権限が必要です）。
左側のナビゲーションでConnections をクリックし、表示されたページでAPI タブをクリックします。
Personal API Token で、Create token をクリックしてパーソナルAPI トークンを作成します。APIToken 接続プロパティをこの値に設定します。
- すでにトークンを作成している場合は、Personal API Token でCopy ボタンをクリックしてAPI トークンをコピーします。APIToken 接続プロパティをこの値に設定します。

OAuth で認証する場合は、ヘルプドキュメントの「OAuth 認証の使用」セクションを参照してください。

API Server のユーザー設定

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

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

Monday.com 用のAPI エンドポイントの作成

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

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

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

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

オンプレミスDB やファイルからのAPI Server 使用（オプション）

オンプレミスRDB やExcel/CSV などのファイルのデータを使用する場合には、API Server のCloug Gateway / SSH ポートフォワーディングが便利です。是非、Cloud Gatway の設定方法記事を参考にしてください。

App Builder でプロジェクトを作成する

Web API の準備ができたら、App Builder で作業を進めていきます。

App Builder を立ち上げて「＋新しいアプリ」をクリックします。

テンプレートから任意のものを選択します。

これでアプリを作成するための下準備が整いました。

データソースの追加

前述の通りApp Builder ではREST API に接続したアプリを手軽に作成することができます。API 接続部分はあらかじめデータソースとして定義しておくことで、簡単にUI とバインドすることができるようになるので、まずはこのデータソースの準備を進めます。

画面左の「データ」タブに移動し新しく「REST API」を追加します。

「REST API データソースの設定」で任意の名称を入力し、ソースとして「OpenAPI」または「URL の追加」を選択します。今回はOpenAPI の手順で解説します。OpenAPI を使わない場合は「URL の追加」で手動で設定します。

ここでは先程CData Connect AI からダウンロードしておいたOpenAPI の定義を使用するので「定義のアップロード」をクリックします。

アップロードが完了したら「エンドポイントの設定」をクリックします。

「エンドポイントの設定」ではOpenAPI で定義されているエンドポイントの一覧の中から利用するものを選択し、App Builder で利用するデータソースとして定義します。今回はデータの一覧が取得できるGET エンドポイントを指定し、事前に作成したユーザーID・トークンを使って必要な認証情報を入力します。
「送信」をクリックして「200OK」を受け取ったら接続はOKです。