Sdílet prostřednictvím


Transformace dat v Zendesku (Preview) pomocí služby Azure Data Factory nebo Synapse Analytics

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Tento článek popisuje, jak pomocí Tok dat transformovat data v Zendesku (Preview). Další informace najdete v úvodním článku pro Azure Data Factory nebo Azure Synapse Analytics.

Důležité

Tento konektor je aktuálně ve verzi Preview. Můžete to vyzkoušet a poslat nám svůj názor. Pokud do svého řešení chcete zavést závislost na konektorech ve verzi Preview, kontaktujte podporu Azure.

Podporované funkce

Tento konektor Zendesk je podporovaný pro následující funkce:

Podporované funkce IR
Mapování toku dat (zdroj/-) (1)

(1) Prostředí Azure Integration Runtime (2) Místní prostředí Integration Runtime

Seznam úložišť dat podporovaných jako zdroje nebo jímky najdete v tabulce Podporované úložiště dat.

Vytvoření propojené služby Zendesk pomocí uživatelského rozhraní

Pomocí následujících kroků vytvořte propojenou službu Zendesk v uživatelském rozhraní webu Azure Portal.

  1. Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak vyberte Nový:

  2. Vyhledejte Zendesk (Preview) a vyberte konektor Zendesk (Preview).

    Snímek obrazovky znázorňující výběr konektoru Zendesk

  3. Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

    Snímek obrazovky s konfigurací propojené služby Zendesk

Podrobnosti konfigurace konektoru

Následující části obsahují informace o vlastnostech, které slouží k definování entit kanálu Data Factory a Synapse specifických pro Zendesk.

Vlastnosti propojené služby

Propojená služba Zendesk podporuje následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu musí být nastavena na Zendesk. Ano
url Základní adresa URL služby Zendesk. Ano
authenticationType Typ ověřování sloužící k připojení ke službě Zendesk. Povolené hodnoty jsou základní a token. Další vlastnosti a příklady najdete níže v odpovídajících částech. Ano

Základní ověřování

Nastavte vlastnost authenticationType na základní. Kromě obecných vlastností popsaných v předchozí části zadejte následující vlastnosti:

Vlastnost Popis Povinní účastníci
userName Uživatelské jméno použité k přihlášení k Zendesku. Ano
Heslo Zadejte heslo pro uživatelský účet, který jste zadali pro uživatelské jméno. Označte toto pole jako SecureString , abyste ho bezpečně uložili. Nebo můžete odkazovat na tajný klíč uložený ve službě Azure Key Vault. Ano

Příklad:

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

Ověřování tokenu

Nastavte vlastnost authenticationType na token. Kromě obecných vlastností popsaných v předchozí části zadejte následující vlastnosti:

Vlastnost Popis Povinní účastníci
apiToken Zadejte token rozhraní API pro Zendesk. Označte toto pole jako SecureString , abyste ho bezpečně uložili. Nebo můžete odkazovat na tajný klíč uložený ve službě Azure Key Vault. Ano

Příklad:

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

Mapování vlastností toku dat

Při transformaci dat při mapování toku dat můžete číst tabulky z Zendesku. Další informace najdete v transformaci zdroje v mapování toků dat. Jako typ zdroje můžete použít jenom vloženou datovou sadu .

Transformace zdroje

Následující tabulka uvádí vlastnosti podporované zdrojem Zendesku. Tyto vlastnosti můžete upravit na kartě Možnosti zdroje.

Název Popis Povinní účastníci Povolené hodnoty Vlastnost skriptu toku dat
Entity Logický název entity v Zendesku. Ano při použití vloženého režimu activities
group_memberships
groups
organizations
requests
satisfaction_ratings
sessions
tags
targets
ticket_audits
ticket_fields
ticket_metrics
tickets
triggers
users
views
entity

Příklady zdrojových skriptů Zendesku

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

Seznam úložišť dat podporovaných jako zdroje a jímky aktivitou kopírování najdete v tématu Podporované úložiště dat.