> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana ツールキット

> ワークフロー内からAsanaのプロジェクト、タスク、ユーザーと連携します。

**Asana ツールキット**により、ワークフローからAsanaと連携できます。プロジェクト、タスク、ユーザー、ワークスペースの取得、およびタスクの作成と更新が可能です。

## 認証

すべてのAsanaツールには、Asanaアカウントの接続が必要です。各ツールには、2つのオプションを備えた**Asanaアカウント**セレクターがあります：

| オプション                | 説明                                  |
| -------------------- | ----------------------------------- |
| **自分のAsanaアカウントを使用** | 個人の接続済みAsanaアカウントを使用します。            |
| **チームアカウントを使用**      | プロジェクト用に設定された共有チームAsanaアカウントを使用します。 |

アカウントが接続されていない場合は、**Asanaアカウントを接続**をクリックして認証してください。

## ツール

### Asanaプロジェクトの取得

接続されたAsanaアカウントがアクセス可能なすべてのプロジェクトを取得します。

| フィールド          | 必須 | 説明                            |
| -------------- | -- | ----------------------------- |
| **Asanaアカウント** | はい | 個人またはチームのAsanaアカウントを選択してください。 |

### Asanaユーザーの取得

接続されたAsanaワークスペースのすべてのユーザーを取得します。

| フィールド          | 必須 | 説明                            |
| -------------- | -- | ----------------------------- |
| **Asanaアカウント** | はい | 個人またはチームのAsanaアカウントを選択してください。 |

### Asanaワークスペースの取得

接続されたAsanaアカウントがアクセス可能なすべてのワークスペースを取得します。

| フィールド          | 必須 | 説明                            |
| -------------- | -- | ----------------------------- |
| **Asanaアカウント** | はい | 個人またはチームのAsanaアカウントを選択してください。 |

### Asanaカスタムフィールドの取得

特定のAsanaプロジェクトに設定されたカスタムフィールド定義を取得します。

| フィールド          | 必須 | 説明                                             |
| -------------- | -- | ---------------------------------------------- |
| **Asanaアカウント** | はい | 個人またはチームのAsanaアカウントを選択してください。                  |
| **プロジェクトID**   | はい | カスタムフィールド定義を取得するプロジェクトのIDです。`@`と入力して変数を選択できます。 |

### Asanaタスクの取得

特定のAsanaプロジェクトからタスクを取得します。担当者、ワークスペース、ページネーションのオプションフィルターが利用可能です。

| フィールド          | 必須  | 説明                                                                 |
| -------------- | --- | ------------------------------------------------------------------ |
| **Asanaアカウント** | はい  | 個人またはチームのAsanaアカウントを選択してください。                                      |
| **プロジェクトID**   | はい  | タスクを取得するプロジェクトのIDです。`@`と入力して変数を選択できます。                             |
| **制限数**        | いいえ | APIリクエストごとに返すタスクの最大数です。デフォルトは`50`です。                               |
| **担当者**        | いいえ | 担当者のユーザーIDまたはメールアドレスでタスクをフィルターします。デフォルトは`null`です。                  |
| **ワークスペース**    | いいえ | ワークスペースIDでタスクをフィルターします。指定しない場合はデフォルトのワークスペースを使用します。デフォルトは`null`です。 |
| **オフセット**      | いいえ | ページネーション用の開始オフセットトークンです。すべてのページを取得するため、通常は不要です。デフォルトは`null`です。     |

### Asanaユーザータスクの取得

Asana内の特定のユーザーに割り当てられたすべてのタスクを取得します。

| フィールド          | 必須  | 説明                                                             |
| -------------- | --- | -------------------------------------------------------------- |
| **Asanaアカウント** | はい  | 個人またはチームのAsanaアカウントを選択してください。                                  |
| **担当者**        | はい  | タスクを取得する対象のユーザーIDまたはメールアドレスです。`@`と入力して変数を選択できます。               |
| **ワークスペース**    | いいえ | 検索するワークスペースIDです。指定しない場合はデフォルトのワークスペースを使用します。デフォルトは`null`です。    |
| **制限数**        | いいえ | APIリクエストごとに返すタスクの最大数です。デフォルトは`50`です。                           |
| **オフセット**      | いいえ | ページネーション用の開始オフセットトークンです。すべてのページを取得するため、通常は不要です。デフォルトは`null`です。 |

### Asanaタスクの作成

指定されたAsanaプロジェクトに新しいタスクを作成します。

| フィールド          | 必須  | 説明                                                                                                                             |
| -------------- | --- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Asanaアカウント** | はい  | 個人またはチームのAsanaアカウントを選択してください。                                                                                                  |
| **プロジェクトID**   | はい  | タスクを作成するプロジェクトのIDです。`@`と入力して変数を選択できます。                                                                                         |
| **名前**         | はい  | タスクの名前/タイトルです。`@`と入力して変数を選択できます。                                                                                               |
| **メモ**         | いいえ | タスクの説明またはメモです。デフォルトは`null`です。                                                                                                  |
| **担当者**        | いいえ | タスクを割り当てる人のメールアドレスまたはIDです。デフォルトは`null`です。                                                                                      |
| **期限日**        | いいえ | ISO形式（`YYYY-MM-DD`）または解析可能な日付形式の期限日です。デフォルトは`null`です。                                                                          |
| **タグ**         | いいえ | タスクに割り当てるタグ名またはタグGIDの配列です。デフォルトは`null`です。                                                                                      |
| **カスタムフィールド**  | いいえ | 辞書形式のカスタムフィールドです。形式：`{"field_gid": "value"}`または`{"field_name": "value"}`。enumフィールドにはenumオプションGIDまたは名前を使用してください。デフォルトは`null`です。 |

### Asanaタスクの更新

IDを使用して既存のAsanaタスクを更新します。

| フィールド          | 必須  | 説明                                                                                          |
| -------------- | --- | ------------------------------------------------------------------------------------------- |
| **Asanaアカウント** | はい  | 個人またはチームのAsanaアカウントを選択してください。                                                               |
| **タスクID**      | はい  | 更新するタスクのIDです。`@`と入力して変数を選択できます。                                                             |
| **名前**         | いいえ | タスクの新しい名前/タイトルです。デフォルトは`null`です。                                                            |
| **メモ**         | いいえ | タスクの新しい説明またはメモです。デフォルトは`null`です。                                                            |
| **完了**         | いいえ | タスクを完了（`true`）または未完了（`false`）としてマークします。デフォルトは`null`です。                                      |
| **カスタムフィールド**  | いいえ | 更新するカスタムフィールド（辞書形式）。形式：`{"field_gid": "value"}`または`{"field_name": "value"}`。デフォルトは`null`です。 |
