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

Article
01/05/2024

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.

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 :
- Azure Data Factory.
- Azure Synapse
Recherchez Zendesk (préversion) et sélectionnez le connecteur Zendesk (préversion).
Configurez les informations du service, testez la connexion et créez le nouveau service lié.

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.