接続の確立

接続プロファイルの設定

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

Trello への接続

Trello は、トークンベース認証を使用してサードパーティアプリケーションにAPI へのアクセスを許可します。ユーザーがアプリケーションにデータへのアクセスを許可すると、アプリケーションにはTrello のAPI へのリクエストに使用できるトークンが付与されます。

Trello API は、Trello 自身の認可ルート、またはOAuth 経由でアクセスできます。

Trello 認可ルート

登録の時点で、Trello はAPI キーとトークンをアカウントに割り当てます。

認可ルート経由のアクセスを有効にするには：

AuthScheme をToken に設定します。
アカウントのAPI キーを取得するには：
- Trello にログインします。
- https://trello.com/app-key にアクセスします。
このURLを調整します：https://trello.com/1/authorize?expiration=never&name=MyPersonalToken&scope=read,write,account&response_type=token&key={Key} key を、取得したAPI キーに変更します。
URL にアクセスします。
トークンの有効期間を変更するには、expiration= フィールドを変更します。有効な値は、1hour、1day、30days、および never です。
アプリケーションにアカウントの使用を認可するには、Allow をクリックします。Trello はトークンのページにリダイレクトします。
次の接続プロパティを設定します。
- APIKey = https://trello.com/app-key にあるキー。
- Token = 取得したトークン。

API キーとトークンの両方が取得できたら、Trello APIへのリクエストの準備は完了です。

OAuth

認可の使用と同様に、OAuth は、アカウントの作成時にApplication Id とSecret を作成します。Web、デスクトップ、またはヘッドレスサーバーからOAuth を介して認証するには、カスタムOAuth アプリケーションの作成で説明するとおり、AuthScheme をOAuth に設定してカスタムOAuth アプリケーションを作成する必要があります。

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

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

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

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

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

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

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

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

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

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

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

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

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

接続プロパティ

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

接続の管理

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

Excel Add-In for Trello