نسخ البيانات من QuickBooks عبر الإنترنت باستخدام Azure Data Factory أو Synapse Analytics (معاينة)

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

تلميح

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

توضح هذه المقالة كيفية استخدام نشاط النسخ في Azure Data Factory أو خط تدفق Synapse Analytics لنسخ البيانات من QuickBooks عبر الإنترنت. تعتمد هذه المقالة على مقالة نظرة عامة على نشاط النسخ التي تقدم نظرة عامة على نشاط النسخ.

هام

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

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

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

القدرات المدعومة	IR
نشاط النسخ (مصدر/-)	(1) (2)
نشاط البحث	(1) (2)

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

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

يدعم هذا الموصل مصادقة QuickBooks OAuth 2.0.

الشروع في العمل

لتنفيذ نشاط النسخ باستخدام أحد المسارات، يمكنك استخدام إحدى الأدوات أو عدد تطوير البرامج التالية:

• أداة نسخ البيانات
• مدخل Azure
• The .NET SDK
• عدة تطوير برامج Python
• Azure PowerShell
• واجهة برمجة تطبيقات REST
• قالب Azure Resource Manager

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

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

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

   Azure Data Factory

   

   Azure Synapse

   

2. ابحث عن QuickBooks وحدد موصل QuickBooks.

   

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

   

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

توفر الأقسام التالية تفاصيل حول الخصائص المستخدمة لتحديد كيانات Data Factory الخاصة بموصل QuickBooks.

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

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

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع على: QuickBooks	‏‏نعم‬
connectionProperties	مجموعة من الخصائص التي تحدد كيفية الاتصال بـ QuickBooks.	‏‏نعم‬
تحت connectionProperties:
نقطة النهاية	نقطة نهاية خادم QuickBooks عبر الإنترنت. (هذا هو، quickbooks.api.intuit.com)	‏‏نعم‬
companyId	معرّف شركة QuickBooks المطلوب ترخيصها. للحصول على معلومات حول كيفية العثور على معرف الشركة، راجع كيف أعمل على معرف الشركة.	‏‏نعم‬
consumerKey	معرّف العميل لتطبيق QuickBooks عبر الإنترنت لمصادقة OAuth 2.0. تعرف على المزيد من هنا .	‏‏نعم‬
consumerSecret	سر العميل لتطبيق QuickBooks عبر الإنترنت لمصادقة OAuth 2.0. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬
refreshToken	رمز تحديث OAuth 2.0 المرتبط بتطبيق QuickBooks. تعرف على المزيد من هنا . ملاحظة ستنتهي صلاحية رمز التحديث المميز بعد 180 يوماً. يحتاج العميل إلى تحديث رمز التحديث بانتظام. ضع علامة على هذا الحقل باعتباره SecureString لتخزينه بشكل آمن، أو قم بالإشارة إلى بيانات سرية مخزنة في Azure Key Vault.	‏‏نعم‬
useEncryptedEndpoints	يحدد ما إذا كانت نقاط نهاية مصدر البيانات مشفرة باستخدام HTTPS. القيمة الافتراضية هي صواب.	لا

مثال:

{
    "name": "QuickBooksLinkedService",
    "properties": {
        "type": "QuickBooks",
        "typeProperties": {
            "connectionProperties": {
                "endpoint": "quickbooks.api.intuit.com",
                "companyId": "<company id>",
                "consumerKey": "<consumer key>", 
                "consumerSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "refreshToken": {
                     "type": "SecureString",
                     "value": "<refresh token>"
            	},
                "useEncryptedEndpoints": true
            }
        }
    }
}

معالجة رموز التحديث المميزة للخدمة المرتبطة

عند استخدام موصل QuickBooks Online في خدمة مرتبطة، من المهم إدارة رموز تحديث OAuth 2.0 المميزة من QuickBooks بشكل صحيح. تستخدم الخدمة المرتبطة رمز تحديث مميز للحصول على رموز وصول جديدة. ومع ذلك، يقوم QuickBooks Online بتحديث الرمز المميز للتحديث بشكل دوري، ما يبطل الرمز السابق. لا تقوم الخدمة المرتبطة تلقائيا بتحديث رمز التحديث المميز في Azure Key Vault، لذلك تحتاج إلى إدارة تحديث رمز التحديث المميز لضمان الاتصال دون انقطاع. وإلا فقد تواجه فشل المصادقة بمجرد انتهاء صلاحية الرمز المميز للتحديث.

يمكنك تحديث رمز التحديث المميز يدويا في Azure Key Vault استنادا إلى نهج انتهاء صلاحية رمز التحديث المميز ل QuickBooks Online. ولكن هناك طريقة أخرى تتمثل في أتمتة التحديثات باستخدام مهمة مجدولة أو وظيفة Azure التي تتحقق من رمز تحديث جديد وتحديثه في Azure Key Vault.

خصائص مجموعة البيانات

للحصول على قائمة كاملة بالأقسام والخصائص المتوفرة لتعريف مجموعات البيانات، راجع مقالة مجموعات البيانات. يوفر هذا القسم قائمة بالخصائص التي تدعمها مجموعة بيانات QuickBooks.

لنسخ البيانات من QuickBooks عبر الإنترنت، قم بتعيين خاصية النوع لمجموعة البيانات إلى QuickBooksObject. تدعم الخصائص التالية:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع لمجموعة البيانات على: QuickBooksObject	‏‏نعم‬
اسم الجدول	ضع اسمًا للجدول.	لا (إذا تم تحديد "الاستعلام" في مصدر النشاط)

مثال

{
    "name": "QuickBooksDataset",
    "properties": {
        "type": "QuickBooksObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<QuickBooks linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

انسخ خصائص النشاط

للحصول على قائمة كاملة بالأقسام والخصائص المتوفرة لتعريف الأنشطة، راجع مقالة التدفقات. يوفر هذا القسم قائمة الخصائص التي يدعمها مصدر QuickBooks.

QuickBooks كمصدر

لنسخ البيانات من QuickBooks عبر الإنترنت، اضبط نوع المصدر في نشاط النسخ على QuickBooksSource. تُدعم الخصائص التالية في قسم مصدر نشاط النسخ:

الخاصية	الوصف	مطلوب
النوع	يجب تعيين خاصية النوع لمصدر نشاط النسخ على: QuickBooksSource	‏‏نعم‬
استعلام	استخدم استعلام SQL المخصص لقراءة البيانات. على سبيل المثال: "SELECT * FROM "Bill" WHERE Id = '123'".	لا (إذا تم تحديد "tableName" في مجموعة البيانات)

مثال:

"activities":[
    {
        "name": "CopyFromQuickBooks",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<QuickBooks input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "QuickBooksSource",
                "query": "SELECT * FROM \"Bill\" WHERE Id = '123' "
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

نسخ البيانات من Quickbooks Desktop

لا يمكن لنشاط النسخ في الخدمة نسخ البيانات مباشرة من Quickbooks Desktop. لنسخ البيانات من Quickbooks Desktop، قم بتصدير بيانات Quickbooks إلى ملف قيم مفصولة بفواصل (CSV) ثم قم بتحميل الملف إلى Azure Blob Storage. من هناك، يمكنك استخدام الخدمة لنسخ البيانات إلى المتلقي الذي تختاره.

بحث عن خصائص النشاط

لمعرفة تفاصيل حول الخصائص، تحقق من نشاط البحث.

المحتوى ذو الصلة

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