Gegevens transformeren in Zendesk (preview) met behulp van Azure Data Factory of Synapse Analytics

Artikel
01/05/2024

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u Gegevensstroom kunt gebruiken om gegevens te transformeren in Zendesk (preview). Lees het inleidende artikel voor Azure Data Factory of Azure Synapse Analytics voor meer informatie.

Belangrijk

Deze connector is momenteel beschikbaar in preview. U kunt het uitproberen en ons feedback geven. Neem contact op met de ondersteuning van Azure als u een afhankelijkheid van preview-connectors wilt opnemen in uw oplossing.

Ondersteunde mogelijkheden

Deze Zendesk-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden	IR
Toewijzingsgegevensstroom (bron/-)	①

(1) Azure Integration Runtime (2) Zelf-hostende Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

Een gekoppelde Zendesk-service maken met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde Zendesk-service te maken in de gebruikersinterface van Azure Portal.

Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en selecteer vervolgens Nieuw:
- Azure Data Factory
- Azure Synapse
Zoek naar Zendesk (preview) en selecteer de Zendesk-connector (preview).
Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

configuratiedetails Verbinding maken or

De volgende secties bevatten informatie over eigenschappen die worden gebruikt voor het definiëren van Data Factory- en Synapse-pijplijnentiteiten die specifiek zijn voor Zendesk.

Eigenschappen van gekoppelde service

De volgende eigenschappen worden ondersteund voor de gekoppelde Zendesk-service:

Eigenschappen	Beschrijving	Vereist
type	De typeeigenschap moet worden ingesteld op Zendesk.	Ja
URL	De basis-URL van uw Zendesk-service.	Ja
authenticationType	Type verificatie dat wordt gebruikt om verbinding te maken met de Zendesk-service. Toegestane waarden zijn basis- en token. Raadpleeg de bijbehorende secties hieronder over respectievelijk meer eigenschappen en voorbeelden.	Ja

Basisverificatie

Stel de eigenschap authenticationType in op Basic. Geef naast de algemene eigenschappen die in de vorige sectie worden beschreven, de volgende eigenschappen op:

Eigenschappen	Beschrijving	Vereist
gebruikersnaam	De gebruikersnaam die wordt gebruikt om u aan te melden bij Zendesk.	Ja
password	Geef een wachtwoord op voor het gebruikersaccount dat u hebt opgegeven voor de gebruikersnaam. Markeer dit veld als SecureString om het veilig op te slaan. U kunt ook verwijzen naar een geheim dat is opgeslagen in Azure Key Vault.	Ja

Voorbeeld:

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

Tokenverificatie

Stel het token van de eigenschap authenticationType in. Geef naast de algemene eigenschappen die in de vorige sectie worden beschreven, de volgende eigenschappen op:

Eigenschappen	Beschrijving	Vereist
apiToken	Geef een API-token op voor Zendesk. Markeer dit veld als SecureString om het veilig op te slaan. U kunt ook verwijzen naar een geheim dat is opgeslagen in Azure Key Vault.	Ja

Voorbeeld:

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

Eigenschappen van toewijzingsgegevensstroom

Wanneer u gegevens transformeert in de toewijzingsgegevensstroom, kunt u tabellen lezen uit Zendesk. Zie de brontransformatie in toewijzingsgegevensstromen voor meer informatie. U kunt alleen een inlinegegevensset gebruiken als brontype.

Brontransformatie

De onderstaande tabel bevat de eigenschappen die worden ondersteund door zendesk-bron. U kunt deze eigenschappen bewerken op het tabblad Bronopties .

Name	Beschrijving	Vereist	Toegestane waarden	Eigenschap gegevensstroomscript
Entiteit	De logische naam van de entiteit in Zendesk.	Ja wanneer de inlinemodus wordt gebruikt	`activities` `group_memberships` `groups` `organizations` `requests` `satisfaction_ratings` `sessions` `tags` `targets` `ticket_audits` `ticket_fields` `ticket_metrics` `tickets` `triggers` `users` `views`	entity

Voorbeelden van Zendesk-bronscripts

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

Zie Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.