Partage via


Transformer des données dans Zendesk (préversion) à l’aide d’Azure Data Factory ou de Synapse Analytics

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Conseil

Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, l’aide à la décision et la création de rapports. Découvrez comment démarrer un nouvel essai gratuitement !

Cet article explique l’utilisation de Data Flow pour transformer des données dans Zendesk (préversion). Pour en savoir plus, lisez l’article d’introduction pour Azure Data Factory ou Azure Synapse Analytics.

Important

Ce connecteur est actuellement en préversion. Essayez-le et envoyez-nous vos commentaires. Si vous souhaitez établir une dépendance sur les connecteurs en préversion dans votre solution, veuillez contacter le support Azure.

Fonctionnalités prises en charge

Ce connecteur Zendesk est pris en charge pour les activités suivantes :

Fonctionnalités prises en charge IR
Flux de données de mappage (source/-) 0

① Runtime d’intégration Azure ② Runtime d’intégration auto-hébergé

Pour obtenir la liste des magasins de données pris en charge en tant que sources et récepteurs, consultez la table Magasins de données pris en charge.

Créer un service lié Zendesk à l’aide de l’interface utilisateur

Utilisez les étapes suivantes pour créer un service lié Zendesk dans l’interface utilisateur du portail Azure.

  1. Accédez à l’onglet Gérer dans votre espace de travail Azure Data Factory ou Synapse, sélectionnez Services liés, puis sélectionnez Nouveau :

  2. Recherchez Zendesk (préversion) et sélectionnez le connecteur Zendesk (préversion).

    Screenshot showing selecting Zendesk connector.

  3. Configurez les informations du service, testez la connexion et créez le nouveau service lié.

    Screenshot of configuration for Zendesk linked service.

Informations de configuration des connecteurs

Les sections suivantes fournissent des informations sur les propriétés utilisées pour définir les entités Data Factory ou de pipeline Synapse propres à Zendesk.

Propriétés du service lié

Les propriétés suivantes sont prises en charge pour le service lié Zendesk :

Propriété Description Obligatoire
type La propriété de type doit être Zendesk. Oui
url URL de base de votre service Zendesk. Oui
authenticationType Type d’authentification utilisé pour se connecter au service Zendesk. Les valeurs autorisées sont basic et token. Pour d’autres propriétés et exemples, voir les sections correspondantes ci-dessous. Oui

Authentification de base

Définissez la propriété authenticationType sur De base. Outre les propriétés génériques décrites dans la section précédente, spécifiez les propriétés suivantes :

Propriété Description Obligatoire
userName Nom d’utilisateur utilisé pour se connecter à Zendesk. Oui
mot de passe Spécifiez un mot de passe pour le compte d’utilisateur que vous avez spécifié pour le nom d’utilisateur. Marquez ce champ comme SecureString pour le stocker en toute sécurité. Vous pouvez également référencer un secret stocké dans Azure Key Vault. Oui

Exemple :

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

Jeton d’authentification

Définissez la propriété authenticationType sur De base. Outre les propriétés génériques décrites dans la section précédente, spécifiez les propriétés suivantes :

Propriété Description Obligatoire
apiToken Spécifiez un jeton d’API pour Zendesk. Marquez ce champ comme SecureString pour le stocker en toute sécurité. Vous pouvez également référencer un secret stocké dans Azure Key Vault. Oui

Exemple :

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

Propriétés du mappage de flux de données

Lors de la transformation de données dans le flux de données de mappage, vous pouvez lire des tables à partir de Zendesk. Pour plus d’informations, consultez Transformation de la source dans des flux de données de mappage. Vous pouvez uniquement utiliser un Jeu de données inlined comme type de source.

Transformation de la source

Le tableau ci-dessous liste les propriétés prises en charge par une source Zendesk. Vous pouvez modifier ces propriétés sous l’onglet Options de la source.

Nom Description Obligatoire Valeurs autorisées Propriété du script de flux de données
Entité Nom logique de l’entité dans Zendesk. Oui lorsque vous utilisez le mode inline activities
group_memberships
groups
organizations
requests
satisfaction_ratings
sessions
tags
targets
ticket_audits
ticket_fields
ticket_metrics
tickets
triggers
users
views
entité

Exemples de scripts sources Zendesk

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

Consultez les magasins de données pris en charge pour obtenir la liste des sources et magasins de données pris en charge en tant que récepteurs par l’activité de copie.