مشاركة عبر


تحويل البيانات في Zendesk (إصدار أولي) باستخدام Azure Data Factory أو Synapse Analytics

ينطبق على: Azure Data Factory Azure Synapse Analytics

تلميح

جرب Data Factory في Microsoft Fabric، وهو حل تحليلي متكامل للمؤسسات. يغطي Microsoft Fabric كل شيء بدءا من حركة البيانات إلى علم البيانات والتحليلات في الوقت الحقيقي والمعلومات المهنية وإعداد التقارير. تعرف على كيفية بدء إصدار تجريبي جديد مجانا!

توضح هذه المقالة كيفية استخدام تدفق البيانات لتحويل البيانات في Zendesk (إصدار أولي). للتعرف على المزيد، اقرأ المقالة التمهيدية حول Azure Data Factory أو Azure Synapse Analytics.

هام

هذا الموصل قيد المعاينة حاليًا. يمكنك تجربته وإعطائنا ملاحظات. إذا كنت تريد أن تأخذ تبعية على موصلات الإصدار الأولي في حلك، يرجى الاتصال بدعم Azure.

القدرات المدعومة

موصل Zendesk هذا مدعوم للإمكانيات التالية:

القدرات المدعومة IR
تعيين تدفق البيانات (مصدر البيانات/-) (1)

① وقت تشغيل تكامل Azure ② وقت تشغيل التكامل المستضاف ذاتيًا

للحصول على قائمة مخازن البيانات المعتمدة كمصادر ومواضع تلقي، راجع جدول مخازن البيانات المعتمدة.

قم بإنشاء خدمة Zendesk المرتبطة باستخدام واجهة المستخدم

استخدم الخطوات التالية لإنشاء خدمة Zendesk المرتبطة في واجهة مستخدم مدخل Azure.

  1. استعرض للوصول إلى علامة تبويب "Manage" في Azure Data Factory أو مساحة عمل Synapse وحدد "Linked Services"، ثم حدد "New":

  2. ابحث عن Zendesk (معاينة) وحدد موصل Zendesk (إصدار أولي).

    لقطة شاشة توضح تحديد موصل Zendesk.

  3. قم بتكوين تفاصيل الخدمة، واختبر الاتصال، وأنشئ الخدمة المرتبطة الجديدة.

    لقطة شاشة لتكوين الخدمة المرتبطة بـ Zendesk.

تفاصيل تكوين الموصل

توفر المقاطع التالية معلومات حول الخصائص المستخدمة لتحديد كيانات البنية الأساسية لبرنامج ربط العمليات التجارية Synapse وData Factory المخصصة لـ Zendesk.

خصائص الخدمة المرتبطة

يتم اعتماد الخصائص التالية لخدمة Zendesk المرتبطة:

الخاصية الوصف مطلوب
النوع يجب تعيين خاصية النوع إلى: Zendesk. ‏‏نعم‬
عنوان URL عنوان URL الأساس لخدمة Zendesk. ‏‏نعم‬
نوع المصادقة نوع المصادقة المستخدمة للاتصال بخدمة Zendesk. القيم المسموح بها هي: Basic وtoken. راجع الأقسام المقابلة أدناه حول المزيد من الخصائص والأمثلة على التوالي. ‏‏نعم‬

المصادقة الأساسية

تعيين خاصية authenticationType إلى Basic. بالإضافة إلى الخصائص العامة الموصوفة في القسم السابق، حدد الخصائص التالية:

الخاصية الوصف مطلوب
userName اسم المستخِدم المُسْتَخْدَم لتسجيل الدخول إلى Zendesk. ‏‏نعم‬
كلمة المرور حدد كلمة مرور لحساب المستخدم الذي حددته لاسم المستخدم. وضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن. أو يمكنك أيضًا الإشارة إلى سر مخزن في Azure Key Vault. ‏‏نعم‬

مثال:

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

مصادقة الرمز المميز

تعيين خاصية authenticationType إلى token. بالإضافة إلى الخصائص العامة الموصوفة في القسم السابق، حدد الخصائص التالية:

الخاصية الوصف مطلوب
apiToken حدد رمزًا مميزًا لواجهة برمجة التطبيقات لـ Zendesk. وضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن. أو يمكنك أيضًا الإشارة إلى سر مخزن في Azure Key Vault. ‏‏نعم‬

مثال:

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

تعيين خصائص تدفق البيانات

عند تحويل البيانات في مخطط تدفق البيانات، يمكنك قراءة الجداول من Zendesk. للحصول على مزيدٍ من المعلومات، راجع تحويل المصدر في تعيين تدفقات البيانات. يمكنك استخدام مجموعة بيانات مضمنة كنوع مصدر فحسب.

تحويل المصدر

يسرد الجدول أدناه الخصائص المعتمدة من مصدر Zendesk. يمكنك تحرير هذه الخصائص في علامة التبويب "Source options".

Name ‏‏الوصف مطلوب القيم المسموح بها خاصية البرنامج النصي لتدفق البيانات
الكيان الاسم المنطقي للكيان في Zendesk. نعم، عند استخدام الوضع المضمن activities
group_memberships
groups
organizations
requests
satisfaction_ratings
sessions
tags
targets
ticket_audits
ticket_fields
ticket_metrics
tickets
triggers
users
views
الكيان

أمثلة البرنامج النصي لمصدر Zendesk

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

للحصول على قائمة بمخازن البيانات المدعومة كمصادر ومتلقين من خلال نشاط النسخ، انظر مخازن البيانات المدعومة .