Freigeben über

Transformieren von Daten in Zendesk (Vorschau) mithilfe von Azure Data Factory oder Synapse Analytics

  • Artikel

GILT FÜR: Azure Data Factory Azure Synapse Analytics

Tipp

Testen Sie Data Factory in Microsoft Fabric, eine All-in-One-Analyselösung für Unternehmen. Microsoft Fabric deckt alle Aufgaben ab, von der Datenverschiebung bis hin zu Data Science, Echtzeitanalysen, Business Intelligence und Berichterstellung. Erfahren Sie, wie Sie kostenlos eine neue Testversion starten!

In diesem Artikel wird beschrieben, wie Sie mithilfe eines Datenflusses Daten in Zendesk (Vorschau) transformieren. Um mehr zu lernen, lesen Sie den Einführungsartikel für Azure Data Factory oder Azure Synapse Analytics.

Wichtig

Dieser Connector befindet sich derzeit in der Vorschauversion. Sie können ihn ausprobieren und uns Feedback geben. Wenden Sie sich an den Azure-Support, wenn Sie in Ihrer Lösung eine Abhängigkeit von Connectors verwenden möchten, die sich in der Vorschauphase befinden.

Unterstützte Funktionen

Für den Zendesk-Connector werden die folgenden Funktionen unterstützt:

Unterstützte Funktionen IR
Zuordnungsdatenfluss (Quelle/–) 0

① Azure Integration Runtime ② Selbstgehostete Integration Runtime

Eine Liste der Datenspeicher, die als Quellen/Senken unterstützt werden, finden Sie in der Tabelle Unterstützte Datenspeicher.

Erstellen eines mit Zendesk verknüpften Diensts über die Benutzeroberfläche

Verwenden Sie die folgenden Schritte, um einen mit Zendesk verknüpften Dienst auf der Azure-Portal Benutzeroberfläche zu erstellen.

  1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zur Registerkarte „Verwalten“, und wählen Sie „Verknüpfte Dienste“ und anschließend „Neu“ aus:

  2. Suchen Sie nach Zendesk (Vorschau), und wählen Sie den entsprechenden Connector aus.

    Screenshot showing selecting Zendesk connector.

  3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

    Screenshot of configuration for Zendesk linked service.

Details zur Connector-Konfiguration

Die folgenden Abschnitte enthalten Informationen zu Eigenschaften, die zum Definieren von Data Factory- und Synapse-Pipelineentitäten speziell für Zendesk verwendet werden.

Eigenschaften des verknüpften Diensts

Folgende Eigenschaften werden für den mit Zendesk verknüpften Dienst unterstützt:

Eigenschaft Beschreibung Erforderlich
Typ Die „type“-Eigenschaft muss auf Zendesk festgelegt sein. Ja
url Die Basis-URL Ihres Zendesk-Diensts. Ja
authenticationType Typ der Authentifizierung für die Verbindung mit dem Zendesk-Dienst. Zulässige Werte sind basic und token. Weitere Informationen zu anderen Eigenschaften und Beispiele finden Sie weiter unten in den jeweiligen Abschnitten. Ja

Standardauthentifizierung

Legen Sie die authenticationType-Eigenschaft auf basic fest. Geben Sie zusätzlich zu den im vorherigen Abschnitt beschriebenen generischen Eigenschaften die folgenden Eigenschaften an:

Eigenschaft Beschreibung Erforderlich
userName Der Benutzername, der für die Anmeldung bei Zendesk verwendet wird. Ja
password Geben Sie das Kennwort für das Benutzerkonto an, das Sie für den Benutzernamen angegeben haben. Markieren Sie dieses Feld als SecureString, um es sicher zu speichern. Alternativ können Sie auf ein in Azure Key Vault gespeichertes Geheimnis verweisen. Ja

Beispiel:

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

Tokenauthentifizierung

Legen Sie die authenticationType-Eigenschaft auf token fest. Geben Sie zusätzlich zu den im vorherigen Abschnitt beschriebenen generischen Eigenschaften die folgenden Eigenschaften an:

Eigenschaft Beschreibung Erforderlich
apiToken Geben Sie ein API-Token für Zendesk an. Markieren Sie dieses Feld als SecureString, um es sicher zu speichern. Alternativ können Sie auf ein in Azure Key Vault gespeichertes Geheimnis verweisen. Ja

Beispiel:

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

Eigenschaften von Mapping Data Flow

Beim Transformieren von Daten im Zuordnungsdatenfluss können Sie Tabellen aus Zendesk lesen. Weitere Informationen finden Sie im Artikel zur Quelltransformation im Zuordnungsdatenfluss. Sie können nur ein Inlinedataset als Quelltyp verwenden.

Quellentransformation

Die folgende Tabelle enthält die von einer Zendesk-Quelle unterstützten Eigenschaften. Sie können diese Eigenschaften auf der Registerkarte Quelloptionen bearbeiten.

Name BESCHREIBUNG Erforderlich Zulässige Werte Datenflussskript-Eigenschaft
Entität Der logische Name der Entität in Zendesk. Ja, bei Verwendung des Inlinemodus activities
group_memberships
groups
organizations
requests
satisfaction_ratings
sessions
tags
targets
ticket_audits
ticket_fields
ticket_metrics
tickets
triggers
users
views		 Entität

Beispiele für Zendesk-Quellskripts

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

Zugehöriger Inhalt

Eine Liste der Datenspeicher, die als Quelles und Senken für die Kopieraktivität unterstützt werden, finden Sie in Unterstützte Datenspeicher.