接続の確立
接続プロファイルの設定
［CData］リボンから［データの取得］をクリックし、［取得元：Asana］> 設定済みの接続 を選択してCData クエリウィンドウを起動します。新しい接続を設定するには、［新しいAsana 接続］をクリックします。ここでは、接続の設定、接続のテスト、および接続プロファイルの保存を行うことができます。
Asana への接続
以下をオプションで設定して、Asana から返されたデータを絞り込むことができます。
- WorkspaceId：指定したワークスペースのプロジェクトのみを返す、Asana ワークスペースに関連付けられたグローバル一意識別子（gid）。ワークスペースId を取得するには、Asana にログインした状態でhttps://app.asana.com/api/1.0/workspaces に移動します。ワークスペースの名前とId を含むJSON オブジェクトが表示されます。
- ProjectId：指定したプロジェクトの下にマッピングされたデータのみを返す、Asana プロジェクトに関連付けられたグローバル一意識別子（gid）。プロジェクトId は、プロジェクトの概要ページのURL で確認できます。これは/0/ の直後の数字になります。
Asana への認証
Asana はOAuth またはOAuthPKCE 認証標準を利用しています。
ユーザーアカウント（OAuth）
AuthScheme は、すべてのユーザーアカウントフローでOAuth に設定する必要があります。
デスクトップアプリケーション
CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。代わりに、カスタムOAuth アプリケーションを作成することも可能です。カスタムアプリケーションの作成およびその理由については、カスタムOAuth アプリの作成 を参照してください。OAuth アクセストークンの取得およびリフレッシュ
以下を設定して、接続してください。
- OAuthClientId（カスタムアプリケーションのみ）：アプリの登録時に割り当てられたクライアントId。
- OAuthClientSecret（カスタムアプリケーションのみ）：アプリの登録時に割り当てられたクライアントシークレット。
- CallbackURL（カスタムアプリのみ）：アプリの登録時に定義されたリダイレクトURI。次に例を示します。 https://localhost:3333
OAuth PKCE
AuthScheme をOAuthPKCE に設定します。
デスクトップアプリケーション
CData は、OAuth デスクトップ認証を簡略化する埋め込みOAuth アプリケーションを提供します。代わりに、カスタムOAuth アプリケーションを作成することも可能です。カスタムアプリケーションの作成およびその理由については、カスタムOAuth アプリの作成 を参照してください。OAuth アクセストークンの取得およびリフレッシュ
以下を設定して、接続してください。
- OAuthClientId（カスタムアプリケーションのみ）：アプリの登録時に割り当てられたクライアントId に設定。
- OAuthClientSecret（カスタムアプリケーションのみ）：アプリの登録時に割り当てられたクライアントシークレットに設定。OAuth カスタムアプリケーションの作成プロセスで値が生成されなかった場合、この値の指定は任意です。
- CallbackURL（カスタムアプリのみ）：アプリの登録時に定義されたリダイレクトURI に設定。例： http://localhost:3333
サービスアカウント
サーバーアカウント（Enterprise のみ）で認証するには、以下の接続プロパティを設定してパーソナルアクセストークンを使用します。- InitiateOAuth：OFF。
- OAuthAccessToken：アクセストークンの値。
詳しくは、Asana ドキュメントのpersonal access tokens とservice accounts を参照してください。
接続プロパティ
最後に、Connection プロパティを参照してください。接続の確立に使用できるさまざまなオプションの説明があります。
接続の管理
Asana への認証に成功すると、インポートするデータをカスタマイズすることができます。詳しくは、接続の管理 を参照してください。
関連項目
- データのクエリ：［データ選択］ウィザードを使用してスプレッドシートにデータをプルします。また、ここではスケジュールされたデータのリフレッシュも設定できます。
- Excel アドインの使用：利用可能なCData Excel 関数 を使用するなど、Asana データとやり取りする他の方法が見つかります。