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

BERLAKU UNTUK: Azure Data Factory Azure Synapse Analytics

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, hubungi Dukungan Azure.

Kemampuan yang didukung

Konektor Zendesk ini didukung untuk aktivitas berikut:

Membuat layanan tertaut Zendesk menggunakan antarmuka pengguna

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

  1. Telusuri ke tab Kelola di Azure Data Factory atau ruang kerja Synapse Anda dan pilih Layanan Tertaut, lalu pilih Baru:

  2. Cari Zendesk (Pratinjau) dan pilih konektor Zendesk (Pratinjau).

    Screenshot showing selecting Zendesk connector.

  3. Konfigurasikan detail layanan, uji koneksi, dan buat layanan terkait baru.

    Screenshot of configuration for Zendesk linked service.

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 Diperlukan
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 konektor umum yang dijelaskan di bagian sebelumnya, tetapkan properti berikut:

Properti Deskripsi Diperlukan
userName Nama pengguna yang digunakan untuk masuk ke Zendesk. Ya
kata sandi Menentukan 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 konektor umum yang dijelaskan di bagian sebelumnya, tetapkan properti berikut:

Properti Deskripsi Diperlukan
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 dapat mengedit properti ini di tab Opsi sumber.

Nama Deskripsi Diperlukan Nilai yang diizinkan Properti skrip aliran data
Entitas 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

Langkah berikutnya

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