إضافة خرائط XSLT لتحويل XML في مهام سير العمل باستخدام تطبيقات Azure Logic

مقالة
04/16/2022
قراءة خلال 13 دقائق

لتحويل XML بين التنسيقات، يمكن لسير عمل التطبيق المنطقي استخدام الخرائط مع إجراء تحويل XML . الخريطة هي وثيقة XML تستخدم لغة تحويل لغة ورقة الأنماط الموسعة (XSLT) لوصف كيفية تحويل البيانات من XML إلى تنسيق آخر. تتكون الخريطة من مخطط XML مصدر كمدخلات ومخطط XML هدف كمخرج. يمكنك تعريف تحويل أساسي، مثل نسخ اسم وعنوان من مستند إلى آخر. أو يمكنك إنشاء تحويلات أكثر تعقيدا باستخدام عمليات الخريطة الجاهزة. يمكنك معالجة البيانات أو التحكم فيها باستخدام وظائف مضمنة مختلفة، مثل معالجة السلسلة، والتعيينات الشرطية، والتعبيرات الحسابية، ووقت التاريخ للمسائل، وحتى بنيات الحلقات الحلقية.

على سبيل المثال، لنفترض أنك تتلقى بانتظام طلبات أو فواتير B2B من عميل يستخدم تنسيق تاريخ YearMonthDay (YYYYMMDD). ومع ذلك، تستخدم مؤسستك تنسيق تاريخ MonthDayYear (MMDDYYYYY). يمكنك تعريف واستخدام خريطة تحول تنسيق YYYYMMDD إلى تنسيق MMDDYYYY قبل تخزين تفاصيل الطلب أو الفاتورة في قاعدة بيانات نشاط العميل.

ملاحظة

تخصص Azure Logic Apps ذاكرة محدودة لمعالجة تحويلات XML. إذا قمت بإنشاء تطبيقات منطقية استنادا إلى نوع مورد تطبيق المنطق (الاستهلاك)، وكانت تحويلات الخريطة أو الحمولة الصافية ذات استهلاك ذاكرة مرتفع، فقد تفشل هذه التحويلات، مما يؤدي إلى نفاد أخطاء الذاكرة. لتجنب هذا السيناريو، ضع في اعتبارك الخيارات التالية:

قم بتحرير الخرائط أو الحمولات لتقليل استهلاك الذاكرة.
أنشئ تطبيقاتك المنطقية باستخدام نوع مورد تطبيق المنطق (قياسي) بدلا من ذلك.

يتم تشغيل مهام سير العمل هذه في Azure Logic Apps أحادية المستأجر، والتي توفر خيارات مخصصة ومرنة لموارد الحوسبة والذاكرة. ومع ذلك، لا يدعم نوع مورد تطبيق المنطق القياسي حاليا الرجوع إلى التجميعات الخارجية من الخرائط. أيضا، يتم حاليا دعم تحويل لغة ورقة الأنماط القابلة للتوسيع (XSLT) 1.0 فقط.

إذا كنت جديدا على التطبيقات المنطقية، فراجع ما المقصود بتطبيقات Azure المنطقية؟ لمزيد من المعلومات حول تكامل المؤسسة B2B، راجع مهام سير عمل تكامل المؤسسة B2B باستخدام تطبيقات Azure Logic وحزمة تكامل المؤسسة.

المتطلبات الأساسية

حساب واشتراك Azure. إذا لم يكن لديك اشتراك بعد، فقم بالتسجيل للحصول على حساب Azure مجاني.
لإنشاء خرائط، يمكنك استخدام الأدوات التالية:
- Visual Studio 2019 وملحق أدوات تكامل المؤسسات لتطبيقات Microsoft Azure المنطقية.
- Visual Studio 2015 وأدوات تكامل المؤسسات لتطبيقات Microsoft Azure المنطقية Visual Studio 2.0 2015.
هام

لا تقم بتثبيت الإضافة إلى جانب إضافة خادم BizTalk. قد ينتج عن وجود كلا الملحقين سلوك غير متوقع. تأكد من وجود واحد من هذه الملحقات المثبتة فقط.

ملاحظة

قد تواجه على أجهزة العرض عالية الدقةمشكلة عرض مع مصمم الخرائط في Visual Studio. لحل المشكلة العرض هذه، إما إعادة تشغيل Visual Studio في وضع DPI-unaware، أو إضافة قيمة التسجيل DPIUNAWARE.
مورد حساب تكامل حيث تقوم بتعريف القطع الأثرية وتخزينها، مثل الشركاء التجاريين والاتفاقيات والشهادات وما إلى ذلك، لاستخدامها في تكامل المؤسسة ومهام سير عمل B2B. يجب أن يفي هذا المورد بالمتطلبات التالية:
- مقترن بنفس اشتراك Azure مثل مورد التطبيق المنطقي.
- موجود في نفس الموقع أو منطقة Azure مثل مورد التطبيق المنطقي حيث تخطط لاستخدام إجراء تحويل XML .
- إذا كنت تستخدم نوع مورد تطبيق المنطق (الاستهلاك)، فيجب عليك ربط حساب التكامل الخاص بك بمورد التطبيق المنطقي قبل أن تتمكن من استخدام القطع الأثرية في سير العمل.
  
  لإنشاء خرائط وإضافتها لاستخدامها في مهام سير عمل Logic App (الاستهلاك)، لا تحتاج إلى مورد تطبيق منطقي حتى الآن. ومع ذلك، عندما تكون مستعدا لاستخدام هذه الخرائط في مهام سير العمل، يتطلب مورد التطبيق المنطقي حساب تكامل مرتبط يخزن هذه الخرائط.
- إذا كنت تستخدم نوع مورد تطبيق المنطق (قياسي)، فأنت بحاجة إلى مورد تطبيق منطقي موجود لأنك لا تخزن الخرائط في حساب التكامل الخاص بك. بدلا من ذلك، يمكنك إضافة الخرائط مباشرة إلى مورد التطبيق المنطقي باستخدام مدخل Azure أو التعليمات البرمجية Visual Studio. يتم دعم XSLT 1.0 فقط حاليا. يمكنك بعد ذلك استخدام هذه الخرائط عبر مهام سير عمل متعددة ضمن نفس مورد التطبيق المنطقي.
  
  لا تزال بحاجة إلى حساب تكامل لتخزين القطع الأثرية الأخرى، مثل الشركاء والاتفاقيات والشهادات، إلى جانب استخدام عمليات AS2 وX12 وEDIFACT . ومع ذلك، لا تحتاج إلى ربط مورد التطبيق المنطقي بحساب التكامل الخاص بك، وبالتالي فإن إمكانية الربط غير موجودة. لا يزال يتعين على حساب التكامل الخاص بك تلبية المتطلبات الأخرى، مثل استخدام نفس اشتراك Azure والموجود في نفس الموقع مثل مورد التطبيق المنطقي.
  
  ملاحظة
  
  حاليا، يدعم نوع مورد تطبيق المنطق (الاستهلاك) فقط عمليات RosettaNet . لا يتضمن نوع مورد تطبيق المنطق (القياسي) عمليات RosettaNet .

بينما يدعم Logic App (الاستهلاك) الرجوع إلى التجميعات الخارجية من الخرائط، لا يدعم Logic App (قياسي) حاليا هذه القدرة. يتيح الرجوع إلى تجميع إجراء مكالمات مباشرة من خرائط XSLT إلى رمز .NET المخصص.

تحتاج إلى تجميع 64 بت. تقوم خدمة التحويل بتشغيل عملية 64 بت، لذلك لا يتم دعم تجميعات 32 بت. إذا كان لديك التعليمات البرمجية المصدر لتجميع 32 بت، فأعد ترجمة التعليمة البرمجية إلى تجميع 64 بت. إذا لم يكن لديك التعليمات البرمجية المصدر، ولكنك حصلت على الملف الثنائي من موفر تابع لجهة خارجية، فاحصل على الإصدار 64 بت من هذا الموفر. على سبيل المثال، يوفر بعض الموردين تجميعات في حزم تحتوي على كل من إصدارات 32 بت و 64 بت. إذا كان لديك الخيار، فاستخدم الإصدار 64 بت بدلا من ذلك.
يجب عليك تحميل كل من التجميع والخريطة بترتيب محدد إلى حساب التكامل الخاص بك. تأكد من تحميل التجميع أولا، ثم قم بتحميل الخريطة التي تشير إلى التجميع.

إذا كان حجم التجميع 2 ميغابايت أو أصغر، فيمكنك إضافة التجميع والتعيين إلى حساب التكامل الخاص بك مباشرة من مدخل Azure. ومع ذلك، إذا كان حجم التجميع أو الخريطة أكبر من 2 ميغابايت ولكن ليس أكبر من الحد الأقصى لحجم التجميعات أو الخرائط، فيمكنك استخدام حاوية نقطة Azure حيث يمكنك تحميل التجميع وموقع تلك الحاوية. وبهذه الطريقة، يمكنك توفير هذا الموقع لاحقا عند إضافة التجميع إلى حساب التكامل الخاص بك. لهذه المهمة، تحتاج إلى هذه العناصر:

العنصر	الوصف
⁧⁩حساب Azure Storage⁧⁩	في هذا الحساب، قم بإنشاء حاوية Azure blob للتجميع. تعرف على كيفية إنشاء حساب تخزين.
Blob container	في هذه الحاوية ، يمكنك تحميل التجميع الخاص بك. تحتاج أيضا إلى موقع URI لمحتوى هذه الحاوية عند إضافة التجميع إلى حساب التكامل الخاص بك. تعرف على كيفية إنشاء حاوية فقاعة.
Azure Storage Explorer	تساعدك هذه الأداة على إدارة حسابات التخزين وحاويات blob بسهولة أكبر. لاستخدام "مستكشف التخزين"، قم إما بتنزيل Azure Storage Explorer وتثبيته. بعد ذلك، قم بتوصيل "مستكشف التخزين" بحساب التخزين الخاص بك باتباع الخطوات الواردة في "بدء استخدام مستكشف التخزين". لمعرفة المزيد، راجع التشغيل السريع: إنشاء نقطة في تخزين الكائنات باستخدام Azure Storage Explorer. أو، في مدخل Azure، حدد حساب التخزين الخاص بك. من قائمة حساب التخزين، حدد مستكشف التخزين.

لإضافة خرائط أكبر لنوع مورد تطبيق المنطق (الاستهلاك)، يمكنك أيضا استخدام واجهة برمجة تطبيقات REST لتطبيقات Azure Logic - الخرائط. ومع ذلك، بالنسبة لنوع مورد التطبيق المنطقي (القياسي)، فإن واجهة برمجة تطبيقات REST لتطبيقات Azure المنطقية غير متوفرة حاليا.

الحدود

باستخدام تطبيق Logic (قياسي)، لا توجد حدود لأحجام ملفات الخريطة.
باستخدام تطبيق Logic (الاستهلاك)، توجد حدود لحسابات التكامل والتحف مثل الخرائط. لمزيد من المعلومات، راجع الحدود ومعلومات التكوين الخاصة بتطبيقات Azure Logic Apps.

إضافة تجميعات مرجعية (مورد الاستهلاك فقط)

في مدخل Azure، سجل الدخول باستخدام بيانات اعتماد حساب Azure.
في مربع البحث الرئيسي في Azure، أدخل integration accounts، وحدد حسابات التكامل.
حدد حساب التكامل حيث تريد إضافة التجميع.
في قائمة حساب الدمج، حدد نظرة عامة. ضمن الإعدادات، حدد التجميعات.
على شريط أدوات جزء التجميعات ، حدد إضافة.

استنادا إلى حجم ملف التجميع، اتبع الخطوات لتحميل تجميع يصل حجمه إلى 2 ميغابايت أو يزيد عن 2 ميغابايت ولكن حتى 8 ميغابايت فقط. لمعرفة القيود المفروضة على كميات التجميع في حسابات التكامل، راجع الحدود والتكوين لتطبيقات Azure Logic Apps.

ملاحظة

إذا قمت بتغيير التجميع، فيجب عليك أيضا تحديث الخريطة سواء كانت الخريطة تحتوي على تغييرات أم لا.

إضافة تجميعات تصل إلى 2 ميغابايت

ضمن إضافة تجميع، أدخل اسما للتجميع. احتفظ بملف صغير محددا. بجوار مربع التجميع ، حدد رمز المجلد. ابحث عن التجميع الذي تقوم بتحميله وحدده.

بعد تحديد التجميع، تعرض الخاصية اسم التجميع تلقائيا اسم ملف التجميع.
عندما تنتهي، حدد OK.

بعد انتهاء تحميل ملف التجميع، يظهر التجميع في قائمة التجميعات . في جزء " نظرة عامة" في حساب التكامل، ضمن القطع الأثرية، يظهر أيضا التجميع الذي تم تحميله.

إضافة تجميعات أكثر من 2 ميغابايت

لإضافة تجميعات أكبر، يمكنك تحميل التجميع إلى حاوية نقطة Azure في حساب تخزين Azure الخاص بك. تختلف خطواتك لإضافة التجميعات بناء على ما إذا كانت حاوية blob الخاصة بك تتمتع بوصول عام للقراءة. لذا أولا ، تحقق مما إذا كانت حاوية blob الخاصة بك تتمتع بوصول عام للقراءة باتباع الخطوات التالية: تعيين مستوى الوصول العام لحاوية blob أم لا

تحقق من مستوى الوصول إلى الحاوية

افتح Azure Storage Explorer. في نافذة المستكشف، قم بتوسيع اشتراكك في Azure إذا لم يكن قد تم توسيعه بالفعل.
قم بتوسيع حسابات> التخزين {your-storage-account} >حاويات Blob. حدد حاوية الفقاعة الخاصة بك.
من القائمة المختصرة لحاوية blob، حدد تعيين مستوى الوصول العام.
- إذا كانت حاوية blob الخاصة بك تتمتع بوصول عام على الأقل، فحدد إلغاء، واتبع الخطوات التالية لاحقا في هذه الصفحة: Upload إلى حاويات ذات وصول عام
- إذا لم يكن لحاوية blob وصول عام، فحدد إلغاء الأمر، واتبع الخطوات التالية لاحقا في هذه الصفحة: Upload إلى حاويات بدون وصول عام

Upload إلى حاويات مع وصول الجمهور

Upload التجميع إلى حساب التخزين الخاص بك. في النافذة الموجودة على الجانب الأيسر، حدد Upload.
بعد الانتهاء من التحميل، حدد التجميع الذي تم تحميله. على شريط الأدوات، حدد نسخ عنوان URL بحيث تنسخ عنوان URL للتجميع.
ارجع إلى مدخل Azure حيث يكون جزء إضافة تجميع مفتوحا. أدخل اسما للتجميع. حدد ملف كبير (أكبر من 2 ميغابايت).

يظهر الآن مربع عنوان URI للمحتوى ، بدلا من مربع التجميع .
في المربع عنوان URI للمحتوى ، الصق عنوان URL الخاص بالتجميع. أكمل إضافة التجميع.

بعد انتهاء التجميع من التحميل، يظهر التجميع في قائمة التجميعات . في جزء " نظرة عامة" في حساب التكامل، ضمن القطع الأثرية، يظهر أيضا التجميع الذي تم تحميله.

Upload إلى الحاويات دون وصول الجمهور

Upload التجميع إلى حساب التخزين الخاص بك. في النافذة الموجودة على الجانب الأيسر، حدد Upload.
بعد الانتهاء من التحميل، قم بإنشاء توقيع وصول مشترك (SAS) للتجميع. من القائمة المختصرة للتجميع، حدد الحصول على توقيع الوصول المشترك.
في جزء توقيع الوصول المشترك، حدد إنشاء توقيع وصول مشترك على مستوى الحاوية URICreate>. بعد إنشاء عنوان URL ل SAS، بجوار المربع عنوان URL ، حدد نسخ.
ارجع إلى مدخل Azure حيث يكون جزء إضافة تجميع مفتوحا. أدخل اسما للتجميع. حدد ملف كبير (أكبر من 2 ميغابايت).

يظهر الآن مربع عنوان URI للمحتوى ، بدلا من مربع التجميع .
في المربع عنوان URI للمحتوى ، الصق عنوان SAS URI الذي قمت بإنشائه مسبقا. أكمل إضافة التجميع.

بعد انتهاء التجميع من التحميل، يظهر التجميع في قائمة التجميعات . في صفحة نظرة عامة على حساب التكامل، ضمن القطع الأثرية، يظهر أيضا التجميع الذي تم تحميله.

إنشاء خرائط

لإنشاء مستند تحويل لغة ورقة أنماط قابلة للتوسيع (XSLT) يمكنك استخدامه كخريطة، يمكنك استخدام Visual Studio 2015 أو 2019 لإنشاء مشروع تكامل باستخدام Enterprise Integration SDK. في هذا المشروع، يمكنك إنشاء ملف خريطة تكامل، والذي يتيح لك تعيين العناصر بشكل مرئي بين ملفين من ملفات مخطط XML. بعد إنشاء هذا المشروع، تحصل على مستند XSLT. لمعرفة القيود المفروضة على كميات الخرائط في حسابات التكامل، راجع الحدود والتكوين لتطبيقات Azure Logic Apps.

يجب أن تحتوي الخريطة على السمات التالية وقسم CDATA يحتوي على استدعاء رمز التجميع:

name هو اسم التجميع المخصص.
namespace هي مساحة الاسم في التجميع الخاص بك والتي تتضمن التعليمات البرمجية المخصصة.

يوضح المثال التالي خريطة تشير إلى تجميع مسمى XslUtilitiesLib وتستدعي الأسلوب من التجميع circumference .

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:msxsl="urn:schemas-microsoft-com:xslt" xmlns:user="urn:my-scripts">
<msxsl:script language="C#" implements-prefix="user">
    <msxsl:assembly name="XsltHelperLib"/>
    <msxsl:using namespace="XsltHelpers"/>
    <![CDATA[public double circumference(int radius){ XsltHelper helper = new XsltHelper(); return helper.circumference(radius); }]]>
</msxsl:script>
<xsl:template match="data">
<circles>
    <xsl:for-each select="circle">
        <circle>
            <xsl:copy-of select="node()"/>
                <circumference>
                    <xsl:value-of select="user:circumference(radius)"/>
                </circumference>
        </circle>
    </xsl:for-each>
</circles>
</xsl:template>
</xsl:stylesheet>

أدوات وقدرات الخرائط

عندما تقوم بإنشاء خريطة باستخدام Visual Studio و Enterprise Integration SDK، فإنك تعمل مع تمثيل رسومي للخريطة، والذي يعرض جميع العلاقات والارتباطات التي تقوم بإنشائها.
يمكنك عمل نسخة بيانات مباشرة بين مخططات XML التي تستخدمها لإنشاء الخريطة. تتضمن حزمة SDK لتكامل المؤسسات Visual Studio مخططا يجعل هذه المهمة بسيطة مثل رسم خط يربط العناصر الموجودة في مخطط XML المصدر بنظيراتها في مخطط XML الهدف.
تتوفر عمليات أو وظائف لخرائط متعددة، بما في ذلك دالات السلسلة ووظائف وقت التاريخ وما إلى ذلك.
لإضافة نموذج لرسالة XML، يمكنك استخدام إمكانية اختبار الخريطة. باستخدام إيماءة واحدة فقط ، يمكنك اختبار الخريطة التي أنشأتها ، ومراجعة الإخراج الذي تم إنشاؤه.