Asanaコネクター

​

はじめに

Asanaは、ユーザーがプロジェクト、タスク、ストーリー、その他のプロジェクト関連のワークフローを追跡できるようにするクラウドベースのプロジェクト管理プラットフォームです。Asana APIの詳細については、Asanaのウェブサイト（https://asana.com/developers/documen…arted/overview）を参照してください。

Asanaアカウントには、Data Centerから接続します。このトピックでは、Asanaコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「コネクターを使用してDataSetを追加する」を参照してください。

​

必要条件

Asanaアカウントに接続してDataSetを作成するには、AsanaにログインするためのメールアドレスとAsanaのパスワードが必要になります。または、Googleの認証情報を使用して接続することもできます。

​

Asanaアカウントに接続する

このセクションでは、Asanaコネクターページの**［認証情報］および［詳細］ペインのオプションについて説明します。このページのほかのペインの項目である［スケジュール設定］や［DataSetに名前を付け、説明を入力］**に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「コネクターを使用してDataSetを追加する」を参照してください。

​

［認証情報］ペイン

DomoのAsanaコネクターは接続にOAuthを使用しているので、Domo内で認証情報を入力する必要はありません。**［接続］をクリック（または、Domoに既存のAsanaアカウントがある場合は［アカウントを追加］を選択）すると、Asana OAuth画面が開き、AsanaまたはGoogleの認証情報を入力できます。有効な認証情報を一度入力しておくと、随時同じアカウントを使用して、新しいAsana DataSetを作成することができます。コネクターのアカウントはData Centerの［アカウント］**タブで管理できます。このタブの詳細については、「コネクター/アダプターアカウントを管理する」を参照してください。

**注記：Domoで接続する際、既にAsanaにログインしている場合は、［アカウントを追加］**をクリックすると自動的に認証されます。ログインしているアカウントとは異なるアカウントに接続したい場合は、まずAsanaからログアウトする必要があります。

また、Asanaアカウント用のAPIキーも必要です。アカウント設定ダイアログにアクセスし、［App］タブをクリックすると、任意のユーザーが独自のAPIキーを取得できます。APIキーは、このダイアログボックスの下部にあります。

​

［詳細］ペイン

このペインには、メインとなる**［Reports］**メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューが含まれています。「Tasks」レポートを選択すると［Subreport］メニューが表示され、そこから二次レポートを選択できます。

メニュー	説明
Report	実行するAsanaレポートを選択します。以下のレポートが利用できます。 Attachments このレポートでは、指定したワークスペースのAsana添付ファイルを取得します。 Custom Fields このレポートでは、指定したワークスペースのAsanaカスタムフィールドを取得します。 Projects ワークスペース内のすべてのプロジェクトを取得します。 Stories ワークスペース内のすべてのストーリーを取得します。 Subtasks ワークスペース内のすべてのサブタスクを取得します。 Subtasks For Team ワークスペース内の選択したチームのすべてのサブタスクを取得します。 Tags ワークスペース内のすべてのタスクで作成されたすべてのタグを取得します。 Tasks ワークスペース内のすべてのタスクを取得します。 Teams ワークスペース内のすべてのチームを取得します。 Time Tracking Entries タスクの時間追跡エントリを返します。 Users ワークスペース内のすべてのユーザーを取得します。 Workspaces 特定のクライアント向けのすべてのワークスペースを取得します。
Subreport	以下のサブレポートがあります。 サブレポート 説明 Custom Fields カスタムフィールドデータで拡張されたワークスペース内のすべてのタスクを取得します。 Custom Field Settings カスタムフィールド設定データの配列を返します。 Followers フォロワーデータで拡張されたワークスペース内のすべてのタスクを取得します。 Hearts このレポートは、ハートデータで拡張されたワークスペース内のすべてのタスクを取得します。 Memberships メンバーシップデータで拡張されたワークスペース内のすべてのタスクを取得します。 None ワークスペース内のすべてのタスクを取得します。 Projects タスクプロジェクトで拡張されたワークスペース内のすべてのタスクを取得します。 Tags タグデータで拡張されたワークスペース内のすべてのタスクを取得します。
Action on 403 Error	特定のタスクIDのサブタスクを取得するリクエストが403（アクセスエラーなし）で失敗した場合に実行するアクションを選択します。**［Skip failed record and continue］**を選択すると、失敗したタスクをスキップし、残りのタスクを続行します。
Workspace	データを取得したいワークスペースを選択します。
Tasks Completed Since（オプション）	未完了のタスクまたはこの日付までに完了したタスクを返す日付を選択します（ 注記：****SubtasksレポートおよびSubtaks For Teamレポートの場合、未完了のタスクまたはこの日付以降に完了したタスクのサブタスクが取得されます）。
Use Extended Run（チェックボックス）	大量のデータがあり、インポートに24時間以上かかりそうな場合は、このチェックボックスをオンにします。24時間以上かかるコネクターの実行はキャンセルされる場合があります。Extended Run機能を使用すると、コネクターは24時間の時間枠ごとに可能な限り多くのデータをインポートし、次の利用可能な24時間の時間枠にユーザーが介入することなくデータのインポートを再開できます。
Exclude Nested Subtasks（チェックボックス）	ほかのサブタスクの下にネストされたサブタスクをインポートしない場合は、このチェックボックスをオンにします。
Action On 403 Error	コネクターを実行しているユーザーにタスクリストに含まれるタスクの詳細へのアクセス権がない場合、コネクターは失敗し、「403 - No Access」というエラーメッセージが表示されます。コネクターにこれらのエラーを無視して続行させることができるオプションがあります。その場合は、**［Skip failed record and continue］を選択します。403エラーが発生したときにコネクターが失敗するようにするには、［Throw Exception］オプションを選択します。デフォルトの動作は［Throw Exception］**です。

​

その他のペイン

スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「コネクターを使用してDataSetを追加する」を参照してください。

​

よくある質問

データはどのくらいの頻度で更新できますか？

DataSetは、1時間に1回更新できます。

注意すべきAPI制限はありますか？

AsanaのAPIには制限は設けられていません。