> ## 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.

# Toolkit Asana

> Interagir avec les projets, tâches et utilisateurs Asana depuis un workflow.

Le **Toolkit Asana** permet à vos workflows d'interagir avec Asana — récupération de projets, tâches, utilisateurs et espaces de travail, ainsi que création et mise à jour des tâches.

## Authentification

Tous les outils Asana nécessitent une connexion de compte Asana. Chaque outil inclut un sélecteur **Compte Asana** avec deux options :

| Option                          | Description                                                        |
| ------------------------------- | ------------------------------------------------------------------ |
| **Utiliser mon compte Asana**   | Utilise votre compte Asana personnel connecté.                     |
| **Utiliser le compte d'équipe** | Utilise un compte Asana d'équipe partagé configuré pour le projet. |

Si aucun compte n'est connecté, cliquez sur **Connecter un compte Asana** pour vous authentifier.

## Outils

### Obtenir les projets Asana

Récupère tous les projets accessibles au compte Asana connecté.

| Champ            | Obligatoire | Description                                            |
| ---------------- | ----------- | ------------------------------------------------------ |
| **Compte Asana** | Oui         | Sélectionnez votre compte Asana personnel ou d'équipe. |

### Obtenir les utilisateurs Asana

Récupère tous les utilisateurs dans l'espace de travail Asana connecté.

| Champ            | Obligatoire | Description                                            |
| ---------------- | ----------- | ------------------------------------------------------ |
| **Compte Asana** | Oui         | Sélectionnez votre compte Asana personnel ou d'équipe. |

### Obtenir les espaces de travail Asana

Récupère tous les espaces de travail accessibles au compte Asana connecté.

| Champ            | Obligatoire | Description                                            |
| ---------------- | ----------- | ------------------------------------------------------ |
| **Compte Asana** | Oui         | Sélectionnez votre compte Asana personnel ou d'équipe. |

### Obtenir les champs personnalisés Asana

Récupère les définitions de champs personnalisés configurées pour un projet Asana spécifique.

| Champ            | Obligatoire | Description                                                                                                           |
| ---------------- | ----------- | --------------------------------------------------------------------------------------------------------------------- |
| **Compte Asana** | Oui         | Sélectionnez votre compte Asana personnel ou d'équipe.                                                                |
| **Project Id**   | Oui         | L'ID du projet pour lequel obtenir les définitions de champs personnalisés. Tapez `@` pour sélectionner une variable. |

### Obtenir les tâches Asana

Récupère les tâches d'un projet Asana spécifique avec des filtres optionnels pour le responsable, l'espace de travail et la pagination.

| Champ            | Obligatoire | Description                                                                                                                                      |
| ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Compte Asana** | Oui         | Sélectionnez votre compte Asana personnel ou d'équipe.                                                                                           |
| **Project Id**   | Oui         | L'ID du projet pour lequel récupérer les tâches. Tapez `@` pour sélectionner une variable.                                                       |
| **Limit**        | Non         | Nombre maximum de tâches à retourner par requête API. La valeur par défaut est `50`.                                                             |
| **Assignee**     | Non         | Filtrez les tâches par ID d'utilisateur ou email du responsable. La valeur par défaut est `null`.                                                |
| **Workspace**    | Non         | Filtrez les tâches par ID d'espace de travail. Utilise l'espace de travail par défaut si non fourni. La valeur par défaut est `null`.            |
| **Offset**       | Non         | Token de décalage de départ pour la pagination. Généralement non nécessaire car cela récupère toutes les pages. La valeur par défaut est `null`. |

### Obtenir les tâches de l'utilisateur Asana

Récupère toutes les tâches assignées à un utilisateur spécifique dans Asana.

| Champ            | Obligatoire | Description                                                                                                                                      |
| ---------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Compte Asana** | Oui         | Sélectionnez votre compte Asana personnel ou d'équipe.                                                                                           |
| **Assignee**     | Oui         | L'ID d'utilisateur ou l'adresse email pour lequel obtenir les tâches. Tapez `@` pour sélectionner une variable.                                  |
| **Workspace**    | Non         | ID de l'espace de travail à rechercher. Utilise l'espace de travail par défaut si non fourni. La valeur par défaut est `null`.                   |
| **Limit**        | Non         | Nombre maximum de tâches à retourner par requête API. La valeur par défaut est `50`.                                                             |
| **Offset**       | Non         | Token de décalage de départ pour la pagination. Généralement non nécessaire car cela récupère toutes les pages. La valeur par défaut est `null`. |

### Créer une tâche Asana

Crée une nouvelle tâche dans un projet Asana spécifié.

| Champ             | Obligatoire | Description                                                                                                                                                                                                                 |
| ----------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Compte Asana**  | Oui         | Sélectionnez votre compte Asana personnel ou d'équipe.                                                                                                                                                                      |
| **Project Id**    | Oui         | L'ID du projet dans lequel créer la tâche. Tapez `@` pour sélectionner une variable.                                                                                                                                        |
| **Name**          | Oui         | Le nom ou titre de la tâche. Tapez `@` pour sélectionner une variable.                                                                                                                                                      |
| **Notes**         | Non         | Description ou notes pour la tâche. La valeur par défaut est `null`.                                                                                                                                                        |
| **Assignee**      | Non         | Email ou ID de la personne à qui assigner la tâche. La valeur par défaut est `null`.                                                                                                                                        |
| **Due Date**      | Non         | Date d'échéance au format ISO (`YYYY-MM-DD`) ou tout format de date analysable. La valeur par défaut est `null`.                                                                                                            |
| **Tags**          | Non         | Tableau de noms de balises ou de GID de balises à assigner à la tâche. La valeur par défaut est `null`.                                                                                                                     |
| **Custom Fields** | Non         | Champs personnalisés sous forme de dictionnaire. Format : `{\"field_gid\": \"value\"}` ou `{\"field_name\": \"value\"}`. Pour les champs enum, utilisez le GID ou le nom de l'option enum. La valeur par défaut est `null`. |

### Mettre à jour une tâche Asana

Met à jour une tâche Asana existante par son ID.

| Champ             | Obligatoire | Description                                                                                                                                                               |
| ----------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Compte Asana**  | Oui         | Sélectionnez votre compte Asana personnel ou d'équipe.                                                                                                                    |
| **Task Id**       | Oui         | L'ID de la tâche à mettre à jour. Tapez `@` pour sélectionner une variable.                                                                                               |
| **Name**          | Non         | Nouveau nom ou titre pour la tâche. La valeur par défaut est `null`.                                                                                                      |
| **Notes**         | Non         | Nouvelle description ou notes pour la tâche. La valeur par défaut est `null`.                                                                                             |
| **Completed**     | Non         | Marquer la tâche comme terminée (`true`) ou incomplète (`false`). La valeur par défaut est `null`.                                                                        |
| **Custom Fields** | Non         | Champs personnalisés à mettre à jour sous forme de dictionnaire. Format : `{\"field_gid\": \"value\"}` ou `{\"field_name\": \"value\"}`. La valeur par défaut est `null`. |
