Asanaをデータパイプラインソースとして設定 ​

Asanaをデータパイプラインソースとして設定し、タスク、プロジェクト、ポートフォリオ、目標、およびそれらの関連レコードなどの作業管理データをAsana REST APIから抽出して、送信先に同期します。

このガイドでは、機能と前提条件を確認し、Asanaをデータパイプラインソースとして接続し、パイプラインを設定し、サポートされるオブジェクト、同期モード、スキーマ処理、および制限について理解します。

サポートされている機能 ​

Asanaをパイプラインソースとして使用する場合、次の機能がサポートされます:

• クラウド接続: https経由でAsana REST APIに接続します。オンプレミスエージェントは不要です。
• オブジェクトレベルの選択: パイプラインを設定するときに、同期するサポート対象オブジェクトを選択します。
• 同期モード: tasksオブジェクトと、それから派生したオブジェクトは増分同期されます。その他のすべてのオブジェクトはフル同期を使用します。
• カスタムフィールドのサポート: ワークスペースレベルのカスタムフィールドは、tasks、projects、portfolios、およびgoalsオブジェクトの動的列として同期されます。
• スキーマドリフト処理: ソースで新しく追加されたフィールドを自動同期するかブロックするかを選択します。
• フィールドレベルのデータ保護：転送先に到達する前に、フィールド値をそのままレプリケートするか、機密値をハッシュ化します。
• 設定可能な同期頻度：時間ベースまたはcronベースのスケジュールで同期をスケジュールします。最小間隔は15分です。

前提条件 ​

Asanaをデータパイプラインソースとして設定する前に、次の要件を満たしてください。

• 同期するワークスペースにアクセスできるAsanaアカウント。
• Asana OAuthフローを通じてサードパーティアプリケーションを承認する権限。

サポートされるコネクションタイプ ​

AsanaデータパイプラインはOAuth 2.0認証をサポートしています:

• OAuth 2.0: アカウントがアクセスできるAsanaワークスペースからWorkatoがデータを読み取ることを承認します。 Asanaアクセストークンは長期間有効で、取り消すまで期限切れになりません。

Asanaに接続 ​

Asanaに接続するには、次の手順を実行します:

パイプラインの設定 ​

Asanaをデータパイプラインソースとして設定するには、次の手順を実行します:

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

Asanaデータパイプラインは、Asana REST APIからデータを同期します。次の表は、サポートされるオブジェクトをカテゴリ別に示しています。各オブジェクトは、宛先内の個別のテーブルとして同期されます。

ワークスペースとユーザー ​

これらのオブジェクトは、コネクションがアクセスできるワークスペースと、その中のユーザーおよびタグを表します。

プロジェクト ​

これらのオブジェクトは、プロジェクトとその構造およびメンバーシップを表します。

カスタムフィールド ​

これらのオブジェクトは、Asanaのカスタムフィールド定義と、それらが有効化されているプロジェクトを表します。

タスク ​

これらのオブジェクトは、タスクとそれらから派生したレコードを表します。このカテゴリのすべてのオブジェクトはタスク抽出の一部として同期されるため、tasksオブジェクトの増分動作を継承します。

ポートフォリオと目標 ​

これらのオブジェクトは、プロジェクト横断のポートフォリオと組織目標を表します。 BusinessまたはEnterpriseプランが必要です。

同期モード ​

Asanaデータパイプラインは、フル同期と増分同期をサポートしています。 Asanaは各オブジェクトの同期モードを自動的に検出します。

フル同期 ​

フル同期では、各実行時にオブジェクトの利用可能なすべてのレコードを読み取ります。 tasksとそれから派生したオブジェクトを除くすべてのオブジェクトは、projectsを含めてフル同期を使用します。

増分同期 ​

増分同期では、前回の実行以降に作成または更新されたレコードのみを読み取ります。 tasksオブジェクトと、それから派生したオブジェクトは増分同期されます。 storiesオブジェクトは追記専用です。

各オブジェクトの同期モードを確認するには、サポートされるオブジェクトの表を参照してください。

削除追跡 ​

フル同期されるオブジェクトは削除追跡をサポートします。パイプラインは各フル同期を前回の実行と比較し、Asanaに存在しなくなったレコードを、送信先の_workato_is_deleted列でマークします。

tasksオブジェクトと、それから派生したオブジェクトは増分同期され、削除追跡をサポートしません。これは、増分実行では前回の実行以降に変更されたレコードのみを読み取り、削除を検出しないためです。

スキーマとデータ型の処理 ​

コネクターは、データを送信先に複製するときに、特定のAsanaフィールドタイプに固有の処理を適用します。

リッチテキストフィールド ​

いくつかのオブジェクトは、タスクやプロジェクトのnotesとhtml_notesのように、プレーンテキストフィールドとHTML形式の対応フィールドの両方を公開します。 HTMLバリアントにはプレーンテキストバリアントにはない書式設定が含まれるため、両方のバリアントは別々の列として同期されます。

カスタムフィールド列 ​

Asanaワークスペースは、管理者がプロジェクトに適用するカスタムフィールド定義のライブラリを維持します。コネクターは、tasks、projects、portfolios、およびgoalsオブジェクトのカスタムフィールド値を次のように処理します:

• custom_fields列には、フィールドのスコープがワークスペース、または個々のプロジェクト、ポートフォリオ、目標のいずれであっても、レコード上のすべてのカスタムフィールド値のJSONオブジェクトが含まれます。
• ワークスペーススコープのカスタムフィールドには、cf_がプレフィックスとして付いた独自の列も付与されるため、JSONを展開せずに直接クエリできます。ローカルスコープのフィールドは、custom_fields JSONにのみ表示されます。 2つのローカルスコープのフィールドが同じ名前を共有している場合、JSONオブジェクト内で衝突し、最後の値のみが保持されます。

機密データの処理 ​

Asanaオブジェクトには、個人を特定できる情報（PII）が含まれる場合があります。次のオブジェクトには、一般的に機密フィールドが含まれます:

タスクとプロジェクトのnotesおよびhtml_notesフィールドは自由テキストであり、ユーザーが説明に電話番号、住所、またはその他の個人データを入力できるため、リスクが最も高くなります。ユーザータイプのカスタムフィールドも、名前とメールアドレスを含むユーザーレコードを参照します。

パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。 Workatoでは、GDPRまたはCCPAの下で動作するパイプラインについて、ユーザーのメールアドレスと自由テキストの説明フィールドをハッシュ化することをお勧めします。詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

Asanaをデータパイプラインソースとして使用する場合、次の制限が適用されます:

増分同期はタスクに制限されています ​

tasksオブジェクトと、それから派生したオブジェクトのみが増分同期されます。 projectsを含むその他すべてのオブジェクトは、実行ごとに完全なレコードセットを再取得します。大規模な非タスクオブジェクトの同期頻度を設定するときは、完全な再取得を考慮してください。

コンテナ読み取りクォータ ​

Asanaは、プロジェクトまたはセクション内のタスクなど、単一コンテナー内のAPI読み取りを約50,000項目に制限しています。このクォータはすべてのオブジェクトに適用されますが、tasksとその関連オブジェクトで最も到達する可能性が高くなります。コンテナがクォータを超えると、Asanaはエラーを返し、そのオブジェクトの同期は失敗します。

パイプラインはプロジェクト単位ではなくセクション単位でタスクを読み取ることでリスクを軽減しますが、50,000件を超えるタスクを保持する単一セクションは引き続き失敗します。パイプラインは完了ステータスに関係なくタスクを抽出するため、この件数には完了済みタスクが含まれます。同期エラーを回避するには、いずれか1つのセクション内のタスク数をこのクォータ未満に維持します。

詳細については、AsanaのAPIクォータドキュメントを参照してください。

プランとワークスペースの要件 ​

特定のオブジェクトには、特定のAsanaプランまたはワークスペースタイプが必要です:

プランとワークスペースがサポートするオブジェクトのみを選択してください。必要なプランまたはワークスペースタイプがない状態でportfolio_memberships、goal_relationships、またはteam_membershipsオブジェクトを選択すると、同期はエラーで失敗します。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。これより高い頻度で同期をトリガーすることはできません。