Condividi tramite

Trasformare i dati in Zendesk (anteprima) usando Azure Data Factory o Synapse Analytics

  • Articolo

SI APPLICA A: Azure Data Factory Azure Synapse Analytics

Suggerimento

Provare Data Factory in Microsoft Fabric, una soluzione di analisi all-in-one per le aziende. Microsoft Fabric copre tutto, dallo spostamento dati al data science, all'analisi in tempo reale, alla business intelligence e alla creazione di report. Vedere le informazioni su come iniziare una nuova prova gratuita!

Questo articolo illustra come usare Flusso di dati per trasformare i dati in Zendesk (anteprima). Per altre informazioni, leggere l'articolo introduttivo per Azure Data Factory o Azure Synapse Analytics.

Importante

Questo connettore è attualmente disponibile in anteprima. È possibile provarlo e inviare commenti e suggerimenti. Se si vuole accettare una dipendenza dai connettori in versione di anteprima nella propria soluzione, contattare il supporto tecnico di Azure.

Funzionalità supportate

Questo connettore Zendesk è supportato per le funzionalità seguenti:

Funzionalità supportate IR
Flusso di dati per mapping (origine/-) (1)

① Azure Integration Runtime ② Runtime di integrazione self-hosted

Per un elenco degli archivi dati supportati come origini o sink, vedere la tabella Archivi dati supportati.

Creare un servizio collegato Zendesk usando l'interfaccia utente

Usare la procedura seguente per creare un servizio collegato Zendesk nell'interfaccia utente di portale di Azure.

  1. Passare alla scheda Gestisci nell'area di lavoro di Azure Data Factory o Synapse e selezionare Servizi collegati, quindi selezionare Nuovo:

  2. Cercare Zendesk (anteprima) e selezionare il connettore Zendesk (anteprima).

    Screenshot che mostra la selezione del connettore Zendesk.

  3. Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.

    Screenshot della configurazione per il servizio collegato Zendesk.

Dettagli di configurazione del connettore

Le sezioni seguenti forniscono informazioni sulle proprietà usate per definire le entità della pipeline di Data Factory e Synapse specifiche di Zendesk.

Proprietà del servizio collegato

Per il servizio collegato Zendesk sono supportate le proprietà seguenti:

Proprietà Descrizione Richiesto
type La proprietà type deve essere impostata su Zendesk. Sì
URL. URL di base del servizio Zendesk. Sì
authenticationType Tipo di autenticazione usato per connettersi al servizio Zendesk. I valori consentiti sono di base e token. Per altre proprietà ed esempi su ogni valore, vedere le sezioni corrispondenti di seguito. Sì

Autenticazione di base

Impostare la proprietà authenticationType su basic. Oltre alle proprietà generiche descritte nella sezione precedente, specificare le proprietà seguenti:

Proprietà Descrizione Richiesto
userName Nome utente usato per accedere a Zendesk. Sì
password Specificare una password per l'account utente specificato per nome utente. Contrassegnare questo campo come SecureString per archiviarlo in modo sicuro. In alternativa, fare riferimento a un segreto archiviato in Azure Key Vault. Sì

Esempio:

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

Autenticazione tramite token

Impostare la proprietà authenticationType su token. Oltre alle proprietà generiche descritte nella sezione precedente, specificare le proprietà seguenti:

Proprietà Descrizione Richiesto
apiToken Specificare un token API per Zendesk. Contrassegnare questo campo come SecureString per archiviarlo in modo sicuro. In alternativa, fare riferimento a un segreto archiviato in Azure Key Vault. Sì

Esempio:

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "token",
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

Proprietà del flusso di dati per mapping

Quando si trasformano i dati nel flusso di dati di mapping, è possibile leggere le tabelle da Zendesk. Per altre informazioni, vedere la trasformazione dell'origine nei flussi di dati per mapping. È possibile usare solo un set di dati inline come tipo di origine.

Trasformazione origine

La tabella seguente elenca le proprietà supportate dall'origine Zendesk. È possibile modificare queste proprietà nella scheda Opzioni origine.

Nome Descrizione Richiesto Valori consentiti Proprietà script del flusso di dati
Entità Nome logico dell'entità in Zendesk. Sì quando si usa la modalità inline activities
group_memberships
groups
organizations
requests
satisfaction_ratings
sessions
tags
targets
ticket_audits
ticket_fields
ticket_metrics
tickets
triggers
users
views		 entità

Esempi di script di origine Zendesk

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'zendesk',
	format: 'rest',
	entity: 'tickets') ~> ZendeskSource

Contenuto correlato

Per un elenco degli archivi dati supportati come origini e sink dall'attività di copia, vedere Archivi dati supportati.