Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Connexion à Monday
Monday.com est un système d’exploitation de travail polyvalent qui rationalise la gestion de projet et la collaboration en équipe. Il propose des flux de travail personnalisables, des tableaux de bord visuels et des outils d’automatisation pour améliorer la productivité. Les utilisateurs peuvent suivre les tâches, gérer les ressources et communiquer efficacement sur une plateforme intégrée.
**Topics**
+ [AWS Glue support pour le lundi](monday-support.md)
+ [Politiques contenant les opérations API pour la création et l’utilisation des connexions](monday-configuring-iam-permissions.md)
+ [Configuration de Monday](monday-configuring.md)
+ [Configuration de connexions Monday](monday-configuring-connections.md)
+ [Lecture à partir d’entités Monday](monday-reading-from-entities.md)
+ [Référence des options de connexion Monday](monday-connection-options.md)
+ [Limitations](monday-connector-limitations.md)
+ [Créer un compte Monday :](#monday-account-creation)
# AWS Glue support pour le lundi
AWS Glue prend en charge le lundi comme suit :
**Prise en charge en tant que source ?**
Oui. Vous pouvez utiliser les tâches AWS Glue ETL pour interroger les données à partir du lundi.
**Prise en charge en tant que cible ?**
Non.
**Versions d’API Monday prises en charge**
v2.
# Politiques contenant les opérations API pour la création et l’utilisation des connexions
L'exemple de politique suivant décrit les AWS autorisations requises pour créer et utiliser des connexions. Si vous créez un rôle, créez une politique contenant les éléments suivants :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Vous pouvez également utiliser les politiques IAM gérées suivantes pour autoriser l’accès :
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Accorde l'accès aux ressources dont AWS Glue les différents processus ont besoin pour s'exécuter en votre nom. Ces ressources incluent AWS Glue Amazon S3, IAM, CloudWatch Logs et Amazon EC2. Si vous suivez la convention de dénomination des ressources spécifiée dans cette politique, AWS Glue les processus disposent des autorisations requises. Cette politique est généralement attachée aux rôles spécifiés lorsque vous définissez les crawlers, les tâches et les points de terminaison de développement.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Accorde un accès complet aux AWS Glue ressources lorsqu'une identité à laquelle la politique est attachée utilise la console AWS de gestion. Si vous suivez la convention de dénomination pour les ressources spécifiées dans la politique, les utilisateurs bénéficient des capacités totales de la console. Cette politique s'applique généralement aux utilisateurs de la AWS Glue console.
# Configuration de Monday
Avant de pouvoir transférer AWS Glue des données à partir du lundi, vous devez remplir les conditions suivantes :
## Configuration requise
+ Vous disposez d’un compte de développeur Monday avec e-mail et mot de passe. Pour de plus amples informations, veuillez consulter [Créer un compte Monday :](connecting-to-monday.md#monday-account-creation).
+ Votre compte de développeur Monday est activé pour accéder à l’API. Toute utilisation du lundi APIs est disponible sans frais supplémentaires pendant la période d'essai. Une fois la période d’essai terminée, vous devez acheter un abonnement pour créer des données et y accéder. Pour plus d’informations, consultez la [page des licences de Monday](https://developer.monday.com/api-reference/reference/about-the-api-reference).
Si vous remplissez ces conditions, vous êtes prêt à vous connecter AWS Glue à votre compte Monday. Pour les connexions classiques, vous n’avez rien d’autre à faire dans Monday.
# Configuration de connexions Monday
Monday prend en charge les deux types de mécanismes d’authentification suivants :
1. OAuth Auth : Monday prend en charge le type de subvention AUTHORIZATION\$1CODE pour. OAuth2
+ Ce type de subvention est considéré comme « à trois étapes » OAuth car il repose sur la redirection des utilisateurs vers le serveur d'autorisation tiers pour authentifier l'utilisateur. Il est utilisé lors de la création de connexions via la AWS Glue console. L'utilisateur qui crée une connexion peut par défaut s'appuyer sur une application connectée AWS Glue détenue par lui, dans laquelle il n'a pas besoin de fournir d'informations OAuth connexes, à l'exception de l'URL de l'instance du lundi. La AWS Glue console redirigera l'utilisateur vers Monday, où il devra se connecter et autoriser AWS Glue les autorisations demandées pour accéder à son instance Monday.
+ Les utilisateurs doivent choisir de créer leur propre application connectée le lundi et de fournir leur propre identifiant client et leur propre secret client lors de la création de connexions via la AWS Glue console. Dans ce scénario, ils seront toujours redirigés vers le lundi pour se connecter et autoriser AWS Glue l'accès à leurs ressources.
+ Ce type d’autorisation donne lieu à un jeton d’actualisation et à un jeton d’accès. Le jeton d’accès est actif pendant une heure et pourra être actualisé automatiquement sans interaction de l’utilisateur à l’aide du jeton d’actualisation.
+ Pour plus d'informations, consultez [la documentation sur la création d'une application connectée pour le flux AUTHORIZATION\$1CODE OAuth ](https://developers.Monday.com/docs/api/v1/Oauth).
1. Authentification personnalisée :
+ Pour consulter la documentation publique du lundi sur la génération des clés d'API requises pour une autorisation personnalisée, voir [https://developer.monday.com/api-reference/api-token-permissionsdocs/authentication\$1](https://developer.monday.com/api-reference/docs/authentication#api-token-permissions).
Pour configurer une connexion Monday :
1. Dans AWS Secrets Manager, créez un secret avec les informations suivantes. Il est nécessaire de créer un secret pour chaque connexion dans AWS Glue.
1. Pour l' OAuth authentification :
+ Pour l’application connectée gérée par le client : le secret doit contenir le secret du consommateur de l’application connectée avec USER\$1MANAGED\$1CLIENT\$1APPLICATION\$1CLIENT\$1SECRET comme clé.
1. Pour l’authentification personnalisée :
+ Pour l’application connectée gérée par le client : le secret doit contenir le secret du consommateur de l’application connectée avec `personalAccessToken` comme clé.
1. Dans AWS Glue Studio, créez une connexion sous **Connexions de données** en suivant les étapes ci-dessous :
1. Sous Connexions de données, choisissez **Créer une connexion**.
1. Lorsque vous sélectionnez une **source de données**, sélectionnez Monday.
1. Indiquez l’**URL de votre instance** Monday.
1. Sélectionnez le rôle IAM qui AWS Glue peut assumer les actions suivantes et qui dispose des autorisations nécessaires pour celles-ci :
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Sélectionnez le type d’authentification pour vous connecter à Monday
+ Pour OAuth l'authentification : indiquez l'**URL du jeton** et **l'application client gérée par l'utilisateur ClientId ** du lundi auquel vous souhaitez vous connecter.
+ Pour une authentification personnalisée : sélectionnez le type d’authentification **CUSTOM** pour vous connecter à Monday.
1. Sélectionnez celui `secretName` que vous souhaitez utiliser pour cette connexion AWS Glue afin d'y placer les jetons.
1. Sélectionnez les options réseau si vous souhaitez utiliser votre réseau.
1. Accordez au rôle IAM associé à votre AWS Glue travail l'autorisation de lire`secretName`. Choisissez **Suivant**.
1. Dans la configuration de votre AWS Glue tâche, fournissez `connectionName` une **connexion réseau supplémentaire**.
# Lecture à partir d’entités Monday
**Conditions préalables**
+ Un objet Monday à partir duquel vous souhaitez lire. Reportez-vous au tableau des entités prises en charge ci-dessous pour vérifier les entités disponibles.
**Entités prises en charge pour la source**
Liste des entités :
+ Compte : [https://developer.monday.com/api-reference/docs/account \$1queries](https://developer.monday.com/api-reference/docs/account#queries)
+ Forum : [https://developer.monday.com/api-reference/docs/boards \$1queries](https://developer.monday.com/api-reference/docs/boards#queries)
+ Colonne : [https://developer.monday.com/api-reference/docs/columns \$1queries](https://developer.monday.com/api-reference/docs/columns#queries)
+ Documents : [https://developer.monday.com/api-reference/docs/docs](https://developer.monday.com/api-reference/docs/docs#queries) \$1queries
+ Bloc de documents : [https://developer.monday.com/api-reference/docs/blocks \$1queries](https://developer.monday.com/api-reference/docs/blocks#queries)
+ Fichiers : [https://developer.monday.com/api-reference/docs/files](https://developer.monday.com/api-reference/docs/files#queries) \$1queries
+ Dossiers : [https://developer.monday.com/api-reference/docs/folders](https://developer.monday.com/api-reference/docs/folders#queries) \$1queries
+ Groupes : [https://developer.monday.com/api-reference/docs/groups](https://developer.monday.com/api-reference/docs/groups#queries) \$1queries
+ Numéro d'objet : [https://developer.monday.com/api-reference/docs/items \$1queries](https://developer.monday.com/api-reference/docs/items#queries)
+ Sous-éléments : [https://developer.monday.com/api-reference/docs/subitems](https://developer.monday.com/api-reference/docs/subitems#queries) \$1queries
+ Mots clés : [https://developer.monday.com/api-reference/docs/tags-queries \$1queries](https://developer.monday.com/api-reference/docs/tags-queries#queries)
+ Équipes : [https://developer.monday.com/api-reference/docs/teams](https://developer.monday.com/api-reference/docs/teams#queries) \$1queries
+ Mises à jour : [https://developer.monday.com/api-reference/docs/updates](https://developer.monday.com/api-reference/docs/updates#queries) \$1queries
+ Utilisateurs : [https://developer.monday.com/api-reference/docs/users \$1queries](https://developer.monday.com/api-reference/docs/users#queries)
+ Espaces de travail : [https://developer.monday.com/api-reference/docs/espaces](https://developer.monday.com/api-reference/docs/workspaces#queries) de travail \$1queries
| Entité | Peut être filtré | Limit prise en charge | Order by prise en charge | Select prise en charge\$1 | Partitionnement pris en charge |
| --- | --- | --- | --- | --- | --- |
| Compte | Non | Non | Non | Oui | Non |
| Boards | Oui | Oui | Non | Oui | Non |
| Columns | Non | Non | Non | Oui | Non |
| Docs | Oui | Oui | Non | Oui | Non |
| Document Blocks | Non | Oui | Non | Oui | Non |
| Fichiers | Oui | Non | Non | Oui | Non |
| Groupes | Non | Non | Non | Oui | Non |
| Élément | Oui | Oui | Non | Oui | Non |
| Subitems | Non | Non | Non | Oui | Non |
| Étiquettes | Oui | Non | Non | Oui | Oui |
| Équipes | Oui | Non | Non | Oui | Non |
| Mises à jour | Non | Oui | Non | Oui | Non |
| Utilisateurs | Oui | Oui | Non | Oui | Non |
| Espaces de travail | Oui | Oui | Non | Oui | Non |
| Dossiers | Oui | Oui | Non | Oui | Non |
**Exemple**
```
monday_read = glueContext.create_dynamic_frame.from_options(
connection_type="monday",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "account",
"API_VERSION": "v2"
}
```
# Référence des options de connexion Monday
Les options de connexion pour Monday sont les suivantes :
+ `ENTITY_NAME`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Le nom de votre objet dans Monday.
+ `API_VERSION`(Chaîne) - (Obligatoire) Utilisé pour la lecture/l’écriture. Version d’API Rest Monday que vous souhaitez utiliser. Exemple : v2.
+ `SELECTED_FIELDS`(Liste) - Par défaut : vide (SELECT \$1). Utilisé pour la lecture. Colonnes que vous souhaitez sélectionner pour l’objet.
+ `FILTER_PREDICATE`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Doit être au format SQL Spark.
+ `QUERY`(Chaîne) - Par défaut : vide. Utilisé pour la lecture. Requête Spark SQL complète.
# Limitations
Les restrictions du connecteur Monday sont les suivantes :
+ La réponse de métadonnées dynamiques présente certains conflits avec la documentation, comme indiqué ci-dessous :
+ L’entité Group, Column prend en charge les opérations de filtrage, mais elle n’est pas présente dans le point de terminaison des métadonnées dynamiques et est donc conservée en tant qu’entité non filtrable.
+ Le point de terminaison dynamique comprend environ 15 000 lignes et renvoie les métadonnées de toutes les entités en une seule réponse. De ce fait, le chargement des champs prend en moyenne 10 secondes, ce qui nécessiterait un certain temps supplémentaire lors de l’exécution d’une tâche.
+ Consultez le tableau ci-dessous pour connaître la limite de débit de Monday. La taille importante des données de réponse de l’entité dynamique entraîne un retard notable, les champs nécessitant en moyenne 10 secondes pour se charger.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/glue/latest/dg/monday-connector-limitations.html)
## Créer un compte Monday :
1. Accédez à la page d'accueil de Monday, [https://monday.com/](https://monday.com/)et choisissez **Login**.
1. Vous serez redirigé vers la page de connexion. Au bas de la page, cliquez sur **S’inscrire**.
1. Entrez votre adresse e-mail, puis choisissez **Continuer**. Vous pouvez également vous connecter avec Google.
1. Saisissez les détails requis, puis choisissez **Continuer**.
1. Répondez aux questions de l’enquête et suivez les étapes pour terminer le processus de création de compte.
**Enregistrez une OAuth application :**
1. Connectez-vous à votre compte monday.com. Cliquez sur votre avatar (icône d’image) dans le coin inférieur gauche de votre écran.
1. Choisissez **Développeur**.
1. Sélectionnez **Créer une application**.
1. Renseignez les champs obligatoires pour le nom et la description.
1. Accédez à la section « OAuth » présente sur le côté droit, ajoutez les portées et choisissez « Enregistrer la fonctionnalité ».
1. Accédez à l’onglet « URL de redirection » à côté de la portée, ajoutez l’URL de redirection et choisissez « Enregistrer la fonctionnalité ».
1. Dans l'** URLsonglet Redirection**, indiquez l'URL de votre application. Cela devrait être https://\$1region-code\$1.console.aws.amazon.com/appflow/ OAuth. Par exemple, si vous utilisez `us-east-1 `, vous pouvez ajouter `https://us-east-1.console.aws.amazon.com/appflow/oauth`.
1. L’application est maintenant prête à être utilisée. Vous trouverez vos informations d’identification dans la section « Informations de base ». Notez vos chaînes d’ID client et de secret client. Ces chaînes sont utilisées pour établir une connexion avec cette application à l'aide d'un AppFlow connecteur.
**Générer un jeton d’accès personnel :**
Actuellement, monday.com ne propose que nos jetons API V2, qui sont tous des jetons personnels. Pour accéder à vos jetons d’API, vous pouvez utiliser l’une des deux méthodes suivantes en fonction de votre niveau d’utilisateur. Les utilisateurs administrateurs peuvent utiliser les deux méthodes pour acquérir leurs jetons d’API. Les utilisateurs membres peuvent accéder à leurs jetons d’API depuis leurs onglets Développeur.
Administrateurs : si vous êtes un utilisateur administrateur de votre compte monday.com, vous pouvez accéder à vos jetons d’API depuis l’onglet « Admin » en procédant comme suit :
1. Connectez-vous à votre compte monday.com. Cliquez sur votre avatar (icône d’image) dans le coin inférieur gauche de votre écran.
1. Sélectionnez « Administration » dans le menu qui s’affiche (vous devez disposer des autorisations d’administrateur).
1. Accédez à la section « API » et générez un « jeton d’API V2 ». Vous pouvez copier votre jeton et l’utiliser.
Développeur : si vous êtes un utilisateur membre de votre compte monday.com, vous pouvez accéder à vos jetons d’API depuis l’onglet Développeur en procédant comme suit :
1. Connectez-vous à votre compte monday.com. Cliquez sur votre avatar (icône d’image) dans le coin inférieur gauche de votre écran.
1. Sélectionnez « Développeurs » dans le menu qui s’affiche.
1. Dans le menu supérieur, choisissez le menu déroulant « Développeur ». Sélectionnez la première option dans le menu déroulant intitulé « Mes jetons d’accès ».