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

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 TeamDesk (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/–)	①

① 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 TeamDesk verknüpften Diensts über die Benutzeroberfläche

Verwenden Sie die folgenden Schritte, um einen mit TeamDesk 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:

   Azure Data Factory

   

   Azure Synapse

   

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

   

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

   

Details zur Connector-Konfiguration

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

Eigenschaften des verknüpften Diensts

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

Eigenschaft	Beschreibung	Erforderlich
Typ	Die Eigenschaft „type“ muss auf TeamDesk festgelegt sein.	Ja
url	Die URL Ihrer TeamDesk-Datenbank. z. B. https://www.teamdesk.net/secure/db/xxxxx.	Ja
authenticationType	Typ der Authentifizierung für die Verbindung mit dem TeamDesk-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 TeamDesk 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": "TeamDeskLinkedService",
    "properties": {
        "type": "TeamDesk",
        "typeProperties": {
            "url": "https://www.teamdesk.net/secure/db/xxxxx",
            "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 TeamDesk 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": "TeamDeskLinkedService",
    "properties": {
        "type": "TeamDesk",
        "typeProperties": {
            "url": "https://www.teamdesk.net/secure/db/xxxxx",
            "authenticationType": "token",
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

Eigenschaften von Mapping Data Flow

Beim Transformieren von Daten im Zuordnungsdatenfluss können Sie Tabellen aus TeamDesk 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 TeamDesk-Quelle unterstützten Eigenschaften. Sie können diese Eigenschaften auf der Registerkarte Quelloptionen bearbeiten.

Name	BESCHREIBUNG	Erforderlich	Zulässige Werte	Datenflussskript-Eigenschaft
Tabelle	Der Datenfluss ruft alle Daten aus der in den Quelloptionen angegebenen Tabelle ab.	Ja, bei Verwendung des Inlinemodus	-	table
Sicht	Der Datenfluss ruft die angegebene Ansicht in der in den Quelloptionen angegebenen Tabelle ab.	Nein	-	Ansicht

Beispiele für TeamDesk-Quellskripts

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'teamdesk',
	format: 'rest',
	table: 'Table',
	view: 'View') ~> TeamDesksource

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.