Transformera data i Zendesk (förhandsversion) med Hjälp av Azure Data Factory eller Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Den här artikeln beskriver hur du använder Dataflöde för att transformera data i Zendesk (förhandsversion). Mer information finns i introduktionsartikeln för Azure Data Factory eller Azure Synapse Analytics.

Viktigt!

Den här anslutningsappen är för närvarande i förhandsversion. Du kan prova och ge oss feedback. Om du vill skapa ett beroende på anslutningsappar som är i förhandsversion i din lösning kan du kontakta Azure-supporten.

Funktioner som stöds

Den här Zendesk-anslutningsappen stöds för följande funktioner:

Funktioner som stöds IR
Mappa dataflöde (källa/-)

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

En lista över datalager som stöds som källor/mottagare finns i tabellen Datalager som stöds.

Skapa en Zendesk-länkad tjänst med hjälp av användargränssnittet

Använd följande steg för att skapa en Länkad Zendesk-tjänst i Användargränssnittet för Azure-portalen.

  1. Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och välj sedan Nytt:

  2. Sök efter Zendesk (förhandsversion) och välj Zendesk-anslutningsappen (förhandsversion).

    Screenshot showing selecting Zendesk connector.

  3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

    Screenshot of configuration for Zendesk linked service.

Anslut eller konfigurationsinformation

Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory- och Synapse-pipelineentiteter som är specifika för Zendesk.

Länkade tjänstegenskaper

Följande egenskaper stöds för den länkade Zendesk-tjänsten:

Property Beskrivning Obligatoriskt
type Typegenskapen måste vara inställd på Zendesk. Ja
URL Bas-URL:en för din Zendesk-tjänst. Ja
authenticationType Typ av autentisering som används för att ansluta till Zendesk-tjänsten. Tillåtna värden är grundläggande och token. Se motsvarande avsnitt nedan om fler egenskaper respektive exempel. Ja

Grundläggande autentisering

Ange egenskapen authenticationType till grundläggande. Förutom de allmänna egenskaper som beskrivs i föregående avsnitt anger du följande egenskaper:

Property Beskrivning Obligatoriskt
userName Användarnamnet som användes för att logga in på Zendesk. Ja
password Ange ett lösenord för det användarkonto som du angav för användarnamnet. Markera det här fältet som SecureString för att lagra det på ett säkert sätt. Eller så kan du referera till en hemlighet som lagras i Azure Key Vault. Ja

Exempel:

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

Tokenautentisering

Ange egenskapen authenticationType till token. Förutom de allmänna egenskaper som beskrivs i föregående avsnitt anger du följande egenskaper:

Property Beskrivning Obligatoriskt
apiToken Ange en API-token för Zendesk. Markera det här fältet som SecureString för att lagra det på ett säkert sätt. Eller så kan du referera till en hemlighet som lagras i Azure Key Vault. Ja

Exempel:

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

Mappa dataflödesegenskaper

När du transformerar data i dataflödet för mappning kan du läsa tabeller från Zendesk. Mer information finns i källtransformeringen i mappning av dataflöden. Du kan bara använda en infogad datauppsättning som källtyp.

Källtransformering

I tabellen nedan visas de egenskaper som stöds av Zendesk-källan. Du kan redigera dessa egenskaper på fliken Källalternativ .

Name beskrivning Obligatoriskt Tillåtna värden Egenskap för dataflödesskript
Enhet Det logiska namnet på entiteten i Zendesk. Ja när du använder infogat läge activities
group_memberships
groups
organizations
requests
satisfaction_ratings
sessions
tags
targets
ticket_audits
ticket_fields
ticket_metrics
tickets
triggers
users
views
entity

Exempel på Zendesk-källskript

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

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i Datalager som stöds.