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 a Zendesk Zendesk è una soluzione di gestione dell'help desk basata su cloud che offre strumenti personalizzabili per creare un portale di assistenza clienti, una knowledge base e una comunità online. **Topics** + [AWS Glue supporto per Zendesk](zendesk-support.md) + [Policy contenenti le operazioni API per creare e utilizzare le connessioni](zendesk-configuring-iam-permissions.md) + [Configurazione Zendesk](zendesk-configuring.md) + [Configurazione delle connessioni di Zendesk](zendesk-configuring-connections.md) + [Lettura da entità Zendesk](zendesk-reading-from-entities.md) + [Opzioni di connessione Zendesk](zendesk-connection-options.md) + [Limitazioni](zendesk-limitations.md) # AWS Glue supporto per Zendesk AWS Glue supporta Zendesk come segue: **Supportato come origine?** Sì. È possibile utilizzare i job AWS Glue ETL per interrogare i dati da Zendesk. **Supportato come destinazione?** No. **Versioni API Zendesk supportate** Sono supportate le seguenti versioni dell'API Zendesk + v2 # Policy contenenti le operazioni API per creare e utilizzare le connessioni La seguente policy di esempio descrive le autorizzazioni AWS IAM 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": "*" } ] } ``` ------ In alternativa, se non si desidera utilizzare il metodo precedente, usare le seguenti policy IAM gestite: + [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Garantisce l'accesso alle risorse che AWS Glue i vari processi richiedono per l'esecuzione per conto dell'utente. Queste risorse includono AWS Glue Amazon S3, 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 richieste. 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 Zendesk Prima di poter AWS Glue utilizzare il trasferimento di dati da Zendesk, è necessario soddisfare i seguenti requisiti: ## Requisiti minimi Di seguito sono riportati i requisiti minimi: + Possedere un account Zendesk. Per ulteriori informazioni, consulta [Creazione di un account Zendesk](#zendesk-configuring-creating-account). + L'account Zendesk è abilitato all'accesso alle API. + L'account Zendesk consente di installare app connesse. Se soddisfi questi requisiti, sei pronto per connetterti AWS Glue al tuo account Zendesk. ## Creazione di un account Zendesk Per creare un account Zendesk: 1. Vai alla registrazione/ https://www.zendesk.com/in/ 1. Inserire i dettagli come l'email di lavoro, il nome, il cognome, il numero di telefono, la qualifica, il nome dell'azienda, il numero di dipendenti dell'azienda, la password e la lingua preferita. Quindi scegliere **Completa la registrazione alla versione di prova.** 1. Una volta creato l'account, completare il link di verifica che è stato ricevuto per verificare il proprio indirizzo email. 1. Una volta verificato l'indirizzo email di lavoro, si verrà reindirizzati al proprio account Zendesk. Scegliere l'**opzione Acquista Zendesk** per il proprio piano preferito. Nota: per il connettore Zendesk si consiglia di acquistare il piano Suite Enterprise. ## Creazione di un'app client e OAuth credenziali 2.0 Per creare un'app client e credenziali OAuth 2.0: 1. Accedi al tuo account Zendesk dove desideri che venga creata l'app OAuth 2.0 login/ https://www.zendesk.com/in/ 1. Fare clic sull'icona Salva. Scegliere il link **Vai al centro di amministrazione** per aprire la pagina dell'interfaccia di amministrazione. 1. **Scegli **App e integrazioni** nella barra laterale sinistra, quindi seleziona > API Zendesk. **APIs**** 1. **Nella pagina API Zendesk, scegli la scheda Client. OAuth ** 1. Scegliere **Aggiungi client Oauth** sul lato destro. 1. Completare i seguenti campi per creare un cliente: 1. Nome client - Inserire un nome per l'app. Questo è il nome che gli utenti vedranno quando verrà chiesto loro di concedere l'accesso all'applicazione e quando controlleranno l'elenco delle app di terze parti che hanno accesso al loro Zendesk. 1. Descrizione - Facoltativa. Una breve descrizione dell'app che gli utenti vedranno quando verrà chiesto loro di concedere l'accesso. 1. Azienda - Facoltativo. Il nome dell'azienda che gli utenti vedranno quando verrà chiesto loro di concedere l'accesso all'applicazione. Le informazioni possono aiutarli a capire a chi concedono l'accesso. 1. Logo - Facoltativo. Questo è il logo che gli utenti vedranno quando verrà chiesto loro di concedere l'accesso all'applicazione. L'immagine può essere JPG, GIF o PNG. Per ottimizzare i risultati, caricare un'immagine quadrata. Verrà ridimensionata per la pagina di autorizzazione. 1. Identificatore univoco - Il campo viene compilato automaticamente con una versione riformattata del nome che è stato inserito per l'app. È possibile modificarlo, se necessario. 1. Reindirizzamento URLs : inserisci l'URL o l'URL URLs che Zendesk deve utilizzare per inviare la decisione dell'utente di concedere l'accesso all'applicazione. Ad esempio: oauth https://us-east-1.console.aws.amazon.com/gluestudio/ 1. Fare clic su **Salva**. 1. Dopo l'aggiornamento della pagina, nella parte inferiore viene visualizzato un nuovo campo **Segreto** precompilato. Questo è il valore «client\$1secret» specificato nella specifica. OAuth2 Copiare il valore Segreto negli appunti e salvarlo in un posto sicuro. Nota: I caratteri possono estendersi oltre la larghezza della casella di testo, quindi assicurarsi di selezionare tutto prima di copiarli. 1. Fare clic su **Salva**. # Configurazione delle connessioni di Zendesk Il connettore Zendesk supporta il tipo di concessione Authorization Code. + Questo tipo di concessione è considerato «a tre gambe» in OAuth quanto si basa sul reindirizzamento degli utenti a un 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ò affidarsi a un'app connessa di AWS Glue proprietà (AWS Glue-applicazione client gestita) in cui non deve fornire alcuna informazione OAuth correlata ad eccezione dell'URL dell'istanza Zendesk. La AWS Glue console reindirizzerà l'utente a Zendesk, dove l'utente deve effettuare il login e concedere le autorizzazioni richieste per accedere AWS Glue alla propria istanza Zendesk. + Puoi comunque scegliere di creare la tua app connessa in Zendesk e fornire il tuo ID cliente e il segreto del client quando crei connessioni tramite la console. AWS Glue In questo scenario, verrai comunque reindirizzato a Zendesk per effettuare il login e autorizzare l'accesso AWS Glue alle tue risorse. + Questo tipo di concessione genera un token di accesso. Il token di accesso non ha scadenza. Per la documentazione pubblica di Zendesk sulla creazione di un'app connessa per il OAuth flusso del codice di autorizzazione, consulta [OAuth Tokens](https://developer.zendesk.com/api-reference/ticketing/oauth/grant_type_tokens/) for Grant Types. Per configurare una connessione Zendesk: 1. In AWS Secrets Manager, crea un segreto con i seguenti dettagli: 1. Per il tipo di AuthorizationCode concessione: per un'app connessa gestita dal cliente, il segreto deve contenere l'app connessa Consumer Secret con `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` come chiave. 1. Nota: è necessario creare un segreto per la connessione in AWS Glue. 1. In AWS Glue Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti: 1. In **Tipo di connessione**, selezionare Zendesk. 1. Fornire INSTANCE\$1URL dell'istanza Zendesk a cui connettersi. 1. Fornire l'ambiente Zendesk. 1. Seleziona il ruolo AWS 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. 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. # Lettura da entità Zendesk **Prerequisito** Un oggetto Zendesk da cui si desidera leggere. Sarà necessario il nome dell'oggetto, ad esempio ticket, utente o articolo, come indicato nella tabella seguente. | Entità | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento | | --- | --- | --- | --- | --- | --- | | Ticket | Y | Y | Y | Y | N | | Utente | Y | Y | Y | Y | N | | Organizzazione | Y | Y | Y | Y | N | | Articolo | Y | Y | N | Y | N | | Evento Ticket | Y | Y | N | Y | N | | Evento Parametri Ticket | Y | Y | N | Y | N | | Commenti sui Ticket | Y | Y | Y | Y | N | | Campo Ticket | Y | Y | N | Y | N | | Parametri Ticket | Y | Y | N | Y | N | | Attività Ticket | Y | Y | N | Y | N | | Ignora Ticket | N | Y | N | Y | N | | Gruppo | Y | Y | Y | Y | N | | Appartenenza a un gruppo | N | Y | Y | Y | N | | Indice di soddisfazione | Y | Y | N | Y | N | | Vista | Y | Y | Y | Y | N | | Trigger | Y | Y | Y | Y | N | | Categoria Trigger | N | Y | Y | Y | N | | Macro | Y | Y | Y | Y | N | | Automazione | N | Y | Y | Y | N | **Esempio**: ``` Zendesk_read = glueContext.create_dynamic_frame.from_options( connection_type="Zendesk", connection_options={ "connectionName": "connectionName", "ENTITY_NAME": "Account", "API_VERSION": "v2" } ``` **Entità Zendesk e dettagli sui campi**: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/zendesk-reading-from-entities.html) **Nota** I tipi di dati Struct e List vengono convertiti in tipo di dati Stringa nella risposta del connettore. ## Query di partizionamento Le partizioni non sono supportate in Zendesk. # Opzioni di connessione Zendesk Le seguenti sono le opzioni di connessione per Zendesk: + `ENTITY_NAME`(String): (obbligatorio) utilizzato per la lettura. Il nome dell'oggetto in Zendesk. + `API_VERSION`(String): (obbligatorio) utilizzato per la lettura. Versione di Rest API di Zendesk da utilizzare. Ad esempio: v2. + `SELECTED_FIELDS`(List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Colonne che si desidera selezionare per l'oggetto. Ad esempio: id, nome, url, created\$1at + `FILTER_PREDICATE`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Deve essere in formato Spark SQL. Ad esempio: group\$1id = 100 + `QUERY`(Stringa): predefinito: vuoto. Utilizzato per la lettura. Query SQL Spark completa. Ad esempio: “SELECT id,url FROM users WHERE role=\$1"end-user\$1"” + `PARTITION_FIELD`(Stringa): utilizzato per la lettura. Campo da utilizzare per partizionare la query. Il campo predefinito è `update_at` per le entità che supportano l'API di esportazione incrementale (`created_at` per `ticket-events` e `time` for `ticket-metric-events`). + `LOWER_BOUND`(Stringa): utilizzato per la lettura. Un valore limite inferiore inclusivo del campo di partizione scelto. + `UPPER_BOUND`(Stringa): utilizzato per la lettura. Un valore limite superiore esclusivo del campo di partizione scelto. Facoltativo; questa opzione verrà gestita dal connettore se non fornita nell'opzione di lavoro. Valore predefinito: "2024-05-01T20:55:02.000Z + `NUM_PARTITIONS`(Intero): predefinito: 1. Utilizzato per la lettura. Numero di partizioni da leggere. Facoltativo; questa opzione verrà gestita dal connettore se non è fornita nell'opzione job. Valore predefinito: 1. + `IMPORT_DELETED_RECORDS`(Stringa): predefinito: FALSE. Utilizzato per la lettura. Per ottenere i record eliminati durante l'interrogazione. + `ACCESS_TOKEN` - Token di accesso da utilizzare nella richiesta. + `INSTANCE_URL` - URL dell'istanza in cui l'utente desidera eseguire le operazioni. Ad esempio: https://\$1subdomain\$1/.zendesk.com # Limitazioni Di seguito sono riportate le limitazioni del connettore Zendesk: + L'impaginazione basata su offset limita a 100 il numero di pagine che possono essere recuperate, ma non è consigliata in quanto il numero totale di record che è possibile recuperare è 10.000. Tuttavia, l'impaginazione basata sul cursore implementata per il connettore Zendesk supera questa limitazione. Solo l'operatore di filtro EQUAL\$1TO è supportato dall'API Zendesk. A causa di questa limitazione, per il connettore Zendesk non è supportato il partizionamento. + Per l'entità “Ticket Event” il limite di frequenza è di 10 richieste al minuto. Durante l'esecuzione di un processo AWS Glue ETL è possibile che venga visualizzato un errore 429 (troppe richieste).