Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Connessione al Monday
Monday.com è un sistema operativo versatile che semplifica la gestione dei progetti e la collaborazione tra i team. Offre flussi di lavoro personalizzabili, pannelli di controllo visivi e strumenti di automazione per migliorare la produttività. Gli utenti possono monitorare le attività, gestire le risorse e comunicare in modo efficace in un'unica piattaforma integrata.
**Topics**
+ [AWS Glue supporto per lunedì](monday-support.md)
+ [Policy contenenti le operazioni API per creare e utilizzare le connessioni](monday-configuring-iam-permissions.md)
+ [Configurazione Monday](monday-configuring.md)
+ [Configurazione delle connessioni di Monday](monday-configuring-connections.md)
+ [Lettura dalle entità di Monday](monday-reading-from-entities.md)
+ [Indicazioni di riferimento alle opzioni di connessione a Monday](monday-connection-options.md)
+ [Limitazioni](monday-connector-limitations.md)
+ [Per creare un nuovo account Monday:](#monday-account-creation)
# AWS Glue supporto per lunedì
AWS Glue supporta il lunedì come segue:
**Supportato come origine?**
Sì. È possibile utilizzare i job AWS Glue ETL per interrogare i dati di lunedì.
**Supportato come destinazione?**
No.
**Versioni API di Monday supportate**
v2.
# Policy contenenti le operazioni API per creare e utilizzare le connessioni
La seguente politica di esempio descrive le AWS autorizzazioni richieste per la creazione e l'utilizzo delle connessioni. Se si sta creando un nuovo ruolo, creare una policy che contenga quanto segue:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
È anche possibile utilizzare le seguenti policy IAM per autorizzare l'accesso:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Garantisce l'accesso alle risorse che diversi AWS Glue processi richiedono per l'esecuzione per conto dell'utente. Queste risorse includono Amazon S3 AWS Glue, IAM, CloudWatch Logs e Amazon EC2. Se segui la convenzione di denominazione delle risorse specificata in questa politica, AWS Glue i processi dispongono delle autorizzazioni necessarie. Questa policy è in genere collegata ai ruoli specificati quando si definiscono crawler, processi ed endpoint di sviluppo.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Concede l'accesso completo alle AWS Glue risorse quando un'identità a cui è allegata la policy utilizza la AWS console di gestione. Se si segue la convenzione per la denominazione per le risorse specificate nella policy, gli utenti hanno la piena funzionalità della console. Questa policy è in genere associata agli utenti della AWS Glue console.
# Configurazione Monday
Prima di poter utilizzare AWS Glue il trasferimento di dati a partire da lunedì, è necessario soddisfare i seguenti requisiti:
## Requisiti minimi
+ Hai un account sviluppatore Monday con e-mail e password. Per ulteriori informazioni, consulta [Per creare un nuovo account Monday:](connecting-to-monday.md#monday-account-creation).
+ Il tuo account sviluppatore Monday è abilitato all'accesso alle API. Tutti gli utilizzi del lunedì APIs sono disponibili senza costi aggiuntivi durante il periodo di prova. Una volta terminato il periodo di prova, è necessario acquistare un abbonamento per creare e accedere ai dati. Per ulteriori informazioni, consulta la [pagina delle licenze di Monday](https://developer.monday.com/api-reference/reference/about-the-api-reference).
Se soddisfi questi requisiti, sei pronto per connetterti AWS Glue al tuo account Monday. Per le connessioni tipiche, non è necessario fare nient'altro in Monday.
# Configurazione delle connessioni di Monday
Monday supporta i due tipi di meccanismo di autenticazione seguenti:
1. OAuth Autenticazione: Monday supporta il tipo di concessione AUTHORIZATION\$1CODE per. OAuth2
+ Questo tipo di concessione è considerato «a tre gambe» in OAuth quanto si basa sul reindirizzamento degli utenti al server di autorizzazione di terze parti per autenticare l'utente. Viene utilizzato durante la creazione di connessioni tramite la console. AWS Glue Per impostazione predefinita, l'utente che crea una connessione può fare affidamento su un'app connessa di AWS Glue proprietà in cui non è necessario fornire alcuna informazione OAuth correlata ad eccezione dell'url dell'istanza di lunedì. La AWS Glue console reindirizzerà l'utente a Monday, dove l'utente deve effettuare il login e concedere le autorizzazioni richieste per accedere AWS Glue all'istanza di Monday.
+ Gli utenti devono scegliere di creare la propria app connessa lunedì e fornire il proprio ID client e il segreto del client quando creano connessioni tramite la AWS Glue Console. In questo scenario, verranno comunque reindirizzati a lunedì per effettuare il login e autorizzare l'accesso AWS Glue alle proprie risorse.
+ Questo tipo di concessione genera un token di aggiornamento e uno di accesso. Il token di accesso è attivo per un'ora e può essere aggiornato automaticamente senza l'interazione dell'utente utilizzando il token di aggiornamento.
+ Per ulteriori informazioni, consulta la [documentazione sulla creazione di un'app connessa per il flusso OAuth AUTHORIZATION\$1CODE](https://developers.Monday.com/docs/api/v1/Oauth).
1. Autenticazione personalizzata:
+ [Per la documentazione pubblica del lunedì sulla generazione delle chiavi API richieste per l'autorizzazione personalizzata, consulta docs/authentication\$1. https://developer.monday.com/api-reference/ api-token-permissions](https://developer.monday.com/api-reference/docs/authentication#api-token-permissions)
Per configurare una connessione a Monday:
1. Nel Gestione dei segreti AWS, crea un segreto con i seguenti dettagli. È necessario creare un segreto per ogni connessione in AWS Glue.
1. Per l' OAuth autenticazione:
+ Per l'app connessa gestita dal cliente, il segreto deve contenere l'app connessa Consumer Secret con USER\$1MANAGED\$1CLIENT\$1APPLICATION\$1CLIENT\$1SECRET come chiave.
1. Per l'autenticazione personalizzata:
+ Per le app connesse gestite dal cliente: il segreto deve contenere l'app connessa Consumer Secret con `personalAccessToken` come chiave.
1. In AWS Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti:
1. In Connessioni dati, scegliere **Crea connessione**.
1. Quando si seleziona una **Origine dati**, selezionare Monday.
1. Fornire la **InstanceURL** di Monday.
1. Seleziona il ruolo IAM che AWS Glue può assumere e dispone delle autorizzazioni per le seguenti azioni:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Selezionare il tipo di autenticazione per connetterti a Monday
+ Per l' OAuth autenticazione: fornisci l'**URL del token e l'****applicazione client gestita dagli utenti ClientId ** del lunedì a cui desideri connetterti.
+ Per l'autenticazione personalizzata: selezionare il tipo di autenticazione **CUSTOM** per connettersi a Monday.
1. Seleziona quello `secretName` che desideri utilizzare per questa connessione per AWS Glue inserire i token.
1. Selezionare le opzioni di rete se si desidera utilizzare la propria rete.
1. Concedi il permesso di lettura `secretName` al ruolo IAM associato al tuo AWS Glue lavoro. Scegli **Next (Successivo)**.
1. Nella configurazione del tuo AWS Glue lavoro, fornisci `connectionName` una **connessione di rete aggiuntiva**.
# Lettura dalle entità di Monday
**Prerequisiti**
+ Un oggetto di Monday da cui desideri leggere. Consulta la tabella delle entità supportate qui di seguito per verificare le entità disponibili.
**Entità supportate come origine**
Elenco delle entità:
+ Conto: [https://developer.monday.com/api-reference/docs/account](https://developer.monday.com/api-reference/docs/account#queries) \$1queries
+ [Bacheca: docs/boards \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/boards#queries)
+ [Colonna: docs/columns \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/columns#queries)
+ [Documenti: docs/docs \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/docs#queries)
+ [Blocco di documento: docs/blocks \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/blocks#queries)
+ [File: docs/files \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/files#queries)
+ [Cartelle: docs/folders \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/folders#queries)
+ [Gruppi: docs/groups \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/groups#queries)
+ [Elemento: docs/items \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/items#queries)
+ [Sottoelementi: docs/subitems \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/subitems#queries)
+ [Tag: docs/tags-queries \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/tags-queries#queries)
+ [https://developer.monday.com/api-reference/Squadre: docs/teams \$1queries](https://developer.monday.com/api-reference/docs/teams#queries)
+ [Aggiornamenti: docs/updates \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/updates#queries)
+ [Utenti: docs/users \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/users#queries)
+ [Spazi di lavoro: docs/workspaces \$1queries https://developer.monday.com/api-reference/](https://developer.monday.com/api-reference/docs/workspaces#queries)
| Entità | Può essere Filtrato | Supporta Limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta Partizionamento |
| --- | --- | --- | --- | --- | --- |
| Account | No | No | No | Sì | No |
| Bacheche | Sì | Sì | No | Sì | No |
| Colonne | No | No | No | Sì | No |
| Documenti | Sì | Sì | No | Sì | No |
| Blocchi documenti | No | Sì | No | Sì | No |
| File | Sì | No | No | Sì | No |
| Gruppi | No | No | No | Sì | No |
| Elemento | Sì | Sì | No | Sì | No |
| Elementi secondari | No | No | No | Sì | No |
| Tag | Sì | No | No | Sì | Sì |
| Team | Sì | No | No | Sì | No |
| Aggiornamenti | No | Sì | No | Sì | No |
| Utenti | Sì | Sì | No | Sì | No |
| WorkSpace | Sì | Sì | No | Sì | No |
| Cartelle | Sì | Sì | No | Sì | No |
**Esempio**
```
monday_read = glueContext.create_dynamic_frame.from_options(
connection_type="monday",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "account",
"API_VERSION": "v2"
}
```
# Indicazioni di riferimento alle opzioni di connessione a Monday
Di seguito sono riportate le opzioni di connessione per Monday:
+ `ENTITY_NAME`(Stringa): (obbligatorio) utilizzato per lettura/scrittura. Il nome del tuo oggetto in Monday.
+ `API_VERSION`(Stringa): (obbligatorio) utilizzato per lettura/scrittura. Versione dell'API Rest di Monday da utilizzare. Esempio: v2.
+ `SELECTED_FIELDS`(List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Colonne da selezionare per l'oggetto.
+ `FILTER_PREDICATE`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Dev'essere in formato Spark SQL.
+ `QUERY`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Query Spark SQL completa.
# Limitazioni
Di seguito sono riportate le limitazioni per il connettore di Monday:
+ La risposta dinamica ai metadati presenta alcuni conflitti con la documentazione, così come indicato qui di seguito:
+ L'entità Group, Column supporta le operazioni di filtro, ma non è presente nell'endpoint dinamico dei metadati, quindi viene mantenuta come entità non filtrabile.
+ L'endpoint dinamico è composto da più di 15.000 righe e restituisce i metadati di tutte le entità in un'unica risposta. Di conseguenza, il caricamento dei campi impiega in media 10 secondi, quindi ciò richiede del tempo aggiuntivo durante l'esecuzione di un processo.
+ Consulta la tabella seguente per il limite tariffario di Monday. La dimensione significativa dei dati di risposta dell'entità dinamica causa un notevole ritardo, con i campi che richiedono in media 10 secondi per il caricamento.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/monday-connector-limitations.html)
## Per creare un nuovo account Monday:
1. Vai alla home page di lunedì, [https://monday.com/](https://monday.com/)e scegli **Accedi**.
1. Verrai reindirizzato alla pagina di accesso. Nella parte inferiore della pagina, seleziona **Registrati**.
1. Inserisci il tuo indirizzo e-mail e seleziona **Continua**. In alternativa, puoi accedere con Google.
1. Inserisci i dati richiesti e seleziona **Continua**.
1. Rispondi alle domande del sondaggio e segui i passaggi indicati per completare la procedura di creazione dell'account.
**Registra un' OAuth applicazione:**
1. Accedi al tuo account monday.com. Fai clic sul tuo avatar (l'icona con l'immagine) nell'angolo in basso a sinistra dello schermo.
1. Seleziona **Sviluppatore**.
1. Seleziona **Crea app**.
1. Compila i campi obbligatori relativi al nome e alla descrizione.
1. Vai alla sezione «OAuth» presente sul lato destro, aggiungi gli ambiti e scegli «Salva funzione».
1. Passa alla scheda "Reindirizza URL" accanto all'ambito, quindi aggiungi l'URL di reindirizzamento e seleziona "Salva funzionalità".
1. URLsNella scheda **Redirect**, fornisci l'URL della tua app. Dovrebbe essere https://\$1region-code\$1.console.aws.amazon.com/appflow/ oauth. Ad esempio, se stai usando `us-east-1 `, puoi aggiungere `https://us-east-1.console.aws.amazon.com/appflow/oauth`.
1. A questo punto, l'applicazione è pronta per l'uso. Puoi trovare le tue credenziali nella sezione "Informazioni di base". Prendi nota delle stringhe ID client e segreto client. Queste stringhe vengono utilizzate per stabilire una connessione con questa app utilizzando un connettore. AppFlow
**Per generare un token di accesso personale:**
Al momento, monday.com offre solo i nostri token API V2, che sono tutti token personali. Per accedere ai tuoi token API, puoi usare uno dei due metodi disponibili a seconda del tuo livello utente. Gli utenti admin possono usare entrambi i metodi per acquisire i propri token API. Gli utenti membri possono accedere ai propri token API dalle schede Sviluppatore.
Admin: se sei un utente admin del tuo account monday.com, puoi accedere ai token API dalla scheda "Admin" seguendo questi passaggi:
1. Accedi al tuo account monday.com. Fai clic sul tuo avatar (l'icona con l'immagine) nell'angolo in basso a sinistra dello schermo.
1. Seleziona "Admin" dal menu che appare (per farlo devi avere i permessi di admin).
1. Vai alla sezione "API" e genera un "token API V2". Puoi copiare il tuo token e usarlo.
Sviluppatore: se sei un utente membro del tuo account monday.com, puoi accedere ai tuoi token API dalla scheda Sviluppatore seguendo questi passaggi:
1. Accedi al tuo account monday.com. Fai clic sul tuo avatar (l'icona con l'immagine) nell'angolo in basso a sinistra dello schermo.
1. Seleziona "Sviluppatori" dal menu che appare.
1. Nel menu in alto, seleziona il menu a discesa "Sviluppatore". Seleziona la prima opzione nel menu a discesa intitolato "I miei token di accesso".