Mengubah data di Zendesk (Pratinjau) menggunakan Azure Data Factory atau Synapse Analytics

Artikel
01/05/2024

BERLAKU UNTUK:Azure Data Factory Azure Synapse Analytics

Tip

Cobalah Data Factory di Microsoft Fabric, solusi analitik all-in-one untuk perusahaan. Microsoft Fabric mencakup semuanya mulai dari pergerakan data hingga ilmu data, analitik real time, kecerdasan bisnis, dan pelaporan. Pelajari cara memulai uji coba baru secara gratis!

Artikel ini menguraikan cara menggunakan Aliran Data untuk mengubah data di Zendesk (Pratinjau). Untuk mempelajari lebih lanjut, baca artikel pengantar untuk Azure Data Factory atau Azure Synapse Analytics.

Penting

Konektor ini saat ini dalam Pratinjau. Anda dapat mencobanya dan memberi kami umpan balik. Jika Anda ingin mengambil dependensi pada konektor pratinjau dalam solusi Anda, harap hubungi dukungan Azure.

Kemampuan yang didukung

Konektor Zendesk ini didukung untuk kemampuan berikut:

Kemampuan yang didukung	IR
Alur data pemetaan (sumber/-)	①

① Runtime integrasi Azure ② Runtime integrasi yang dihost sendiri

Untuk daftar penyimpanan data yang didukung sebagai sumber/sink, lihat tabel Penyimpanan data yang didukung.

Membuat layanan tertaut Zendesk menggunakan antarmuka pengguna

Gunakan langkah-langkah berikut untuk membuat layanan tertaut Zendesk di antarmuka pengguna portal Microsoft Azure.

Telusuri ke tab Kelola di ruang kerja Azure Data Factory atau Synapse Anda dan pilih Layanan Tertaut, lalu pilih Baru:
- Azure Data Factory
- Azure Synapse
Cari Zendesk (Pratinjau) dan pilih konektor Zendesk (Pratinjau).
Konfigurasikan detail layanan, uji koneksi, dan buat layanan tertaut baru.

Detail konfigurasi konektor

Bagian berikut ini menyediakan informasi tentang properti yang digunakan untuk menentukan Data Factory dan entitas alur Synapse khusus untuk Zendesk.

Properti layanan tertaut

Properti berikut ini didukung untuk layanan tertaut Zendesk:

Properti	Deskripsi	Wajib
jenis	Properti jenis harus diatur ke Zendesk.	Ya
url	URL dasar layanan Zendesk Anda.	Ya
authenticationType	Jenis autentikasi yang digunakan untuk terhubung ke layanan Zendesk. Nilai yang diizinkan adalah dasar dan token. Lihat bagian terkait di bawah ini tentang properti dan contoh masing-masing selengkapnya.	Ya

Autentikasi dasar

Atur properti authenticationType ke dasar. Selain properti generik yang dijelaskan di bagian sebelumnya, atur properti berikut:

Properti	Deskripsi	Wajib diisi
userName	Nama pengguna yang digunakan untuk masuk ke Zendesk.	Ya
kata sandi	Tentukan kata sandi untuk akun pengguna yang Anda tentukan untuk nama pengguna. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman. Atau, Anda dapat mereferensikan rahasia yang disimpan di Azure Key Vault.	Ya

Contoh:

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

Autentikasi token

Atur properti authenticationType ke token. Selain properti generik yang dijelaskan di bagian sebelumnya, atur properti berikut:

Properti	Deskripsi	Wajib diisi
apiToken	Tentukan token API untuk Zendesk. Tandai bidang ini sebagai SecureString untuk menyimpannya dengan aman. Atau, Anda dapat mereferensikan rahasia yang disimpan di Azure Key Vault.	Ya

Contoh:

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

Properti pemetaan aliran data

Saat mengubah data dalam aliran data pemetaan, Anda dapat membaca tabel dari Zendesk. Untuk informasi selengkapnya, lihat transformasi sumber dalam memetakan aliran data. Anda hanya dapat menggunakan himpunan data sebaris sebagai jenis sumber.

Transformasi sumber

Tabel di bawah ini mencantumkan properti yang didukung oleh sumber Zendesk. Anda bisa mengedit properti ini di tab opsi Sumber.

Nama	Deskripsi	Wajib diisi	Nilai yang diizinkan	Properti skrip aliran data
Entity	Nama logis entitas di Zendesk.	Ya, saat menggunakan mode sebaris	`activities` `group_memberships` `groups` `organizations` `requests` `satisfaction_ratings` `sessions` `tags` `targets` `ticket_audits` `ticket_fields` `ticket_metrics` `tickets` `triggers` `users` `views`	entitas

Contoh skrip sumber Zendesk

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

Untuk daftar penyimpanan data yang didukung sebagai sumber dan sink oleh aktivitas salin, lihat Penyimpanan data yang didukung.