接続の確立

接続プロファイルの設定

［CData］リボンから［データの取得］をクリックし、［取得元：Monday］> 設定済みの接続を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、［新しいMonday 接続］をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。

Monday への接続

Monday AuditLog API

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

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

Monday アカウントにログインします。
Admin セクションにアクセスします。
Security に移動します。
Audit タブをクリックします。
Monitor by API をクリックします。Monday がAPI トークンを表示します。

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

Schema=AuditLog
AuthScheme=Token
APIToken=取得した監査ログAPI トークン
Domain=https://yourdomain.monday.com

これで、Monday AuditLog API に接続する準備が整いました。

Monday GraphQL API

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

API トークン

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

Monday アカウントにログインします。
左ペインのManage Applications に移動します。Monday は管理するアプリケーションのリストを表示します。
トークンを作成するアプリケーションを選択します。最初にアプリケーションを作成する必要がある場合があります。
APIToken を生成するには、Create token をクリックします。

OAuth

Monday はOAuth 認証のみサポートします。この認証を有効にするには、すべてのOAuth フローでAuthScheme をOAuth に設定し、カスタムOAuth アプリケーションを作成する必要があります。

以下のサブセクションでは、3つの標準的な認証フローでのMonday への認証について詳しく説明します。

デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。
Web：共有ウェブサイト経由でデータにアクセスします。
ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。

カスタムOAuth アプリケーションの作成については、カスタムOAuth アプリケーションの作成を参照してください。

Monday で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。

デスクトップアプリケーション

カスタムOAuth アプリケーションの資格情報を使用して認証するには、OAuth アクセストークンを取得し、更新する必要があります。これらを設定すると、接続の準備が整います。

OAuth アクセストークンの取得およびリフレッシュ：

InitiateOAuth = GETANDREFRESH。OAuthAccessToken を自動的に取得およびリフレッシュするために使用します。
OAuthClientId = アプリケーションの登録時に割り当てられたクライアントId。
OAuthClientSecret = アプリケーションの登録時に割り当てられたクライアントシークレット。
CallbackURL = アプリケーションの登録時に定義されたリダイレクトURI。

接続すると、本製品はデフォルトブラウザでMonday のOAuth エンドポイントを開きます。ログインして、アプリケーションにアクセス許可を与えます。

アプリケーションにアクセス許可を与えると、本製品はOAuth プロセスを完了します。

本製品はMonday からアクセストークンを取得し、それを使ってデータをリクエストします。
OAuth 値はOAuthSettingsLocation で指定されたパスに保存されます。これらの値は接続間で永続化されます。

アクセストークンの期限が切れたときは、本製品は自動でアクセストークンをリフレッシュします。

OAuth アクセストークンの自動リフレッシュ：

本製品がOAuth アクセストークンを自動的にリフレッシュするようにするには、次のように設定します。

はじめてデータに接続する際、次の接続プロパティを設定します。
- InitiateOAuth = REFRESH。
- OAuthClientId = アプリケーション設定のクライアントId。
- OAuthClientSecret = アプリケーション設定のクライアントシークレット。
- OAuthAccessToken = によって返されたアクセストークン。
- OAuthSettingsLocation = 本製品がOAuth 値を保存する場所のパス。これは接続間で維持されます。
その後のデータ接続では、以下を設定します。
- InitiateOAuth
- OAuthSettingsLocation

接続プロパティ

最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。

接続の管理

Monday への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理を参照してください。

Excel Add-In for Monday