تحويل XML في مهام سير العمل باستخدام Azure Logic Apps

ينطبق على: Azure Logic Apps (الاستهلاك + قياسي)

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

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

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

• حساب واشتراك Azure. إذا لم يكن لديك اشتراك حتى الآن، فقم بالتسجيل للحصول على حساب Azure مجاني.

• سير عمل تطبيق منطقي يبدأ بالفعل بمشغل بحيث يمكنك إضافة إجراء تحويل XML عند الضرورة في سير العمل.

• مورد حساب تكامل حيث تقوم بتحديد وتخزين البيانات الاصطناعية، مثل الشركاء التجاريين والاتفاقيات والشهادات وما إلى ذلك، لاستخدامها في تكامل مؤسستك ومهام سير عمل B2B. يجب أن يفي هذا المورد بالمتطلبات التالية:

  • مقترن بنفس اشتراك Azure مثل مورد تطبيق المنطق الخاص بك.

  • موجود في نفس الموقع أو منطقة Azure مثل مورد تطبيق المنطق حيث تخطط لاستخدام إجراء تحويل XML .

  • إذا كنت تعمل على مورد وسير عمل لتطبيق منطق الاستهلاك، فإن حساب التكامل الخاص بك يتطلب العناصر التالية:

    • الخريطة المراد استخدامها لتحويل محتوى XML.

    • رابط إلى مورد تطبيق المنطق الخاص بك.

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

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

    • إذا لم يكن لديك حساب تكامل أو كنت تخطط فقط لاستخدام البيانات الاصطناعية الخاصة بك عبر مهام سير عمل متعددة داخل نفس مورد تطبيق المنطق، فيمكنك إضافة خرائط مباشرة إلى مورد تطبيق المنطق الخاص بك باستخدام مدخل Microsoft Azure أو Visual Studio Code.

      إشعار

      يتيح لك الموصل المضمن في Liquid تحديد خريطة قمت بتحميلها مسبقا إلى مورد تطبيق المنطق الخاص بك أو إلى حساب تكامل مرتبط، ولكن ليس كليهما.

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

  ما زلت بحاجة إلى حساب تكامل لتخزين البيانات الملموسة الأخرى، مثل الشركاء والاتفاقيات والشهادات، إلى جانب استخدام عمليات AS2وX12وEDIFACT .

إجراء إضافة تحويل XML

قياسي

1. في مدخل Microsoft Azure، افتح تطبيق المنطق القياسي وسير العمل في المصمم.

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

   يستخدم هذا المثال مشغل الطلب .

3. ضمن الخطوة في سير العمل حيث تريد إضافة إجراء تحويل XML ، اتبع هذه الخطوات العامة لإضافة الإجراء المسمى تحويل XML.

4. في المربع المحتوى ، حدد محتوى XML الذي تريد تحويله باستخدام أي بيانات XML تتلقاها في طلب HTTP.

   1. لتحديد مخرجات من العمليات السابقة في سير العمل، في إجراء تحويل XML ، انقر داخل مربع المحتوى ، وحدد خيار قائمة المحتوى الديناميكي (أيقونة البرق).

   2. من قائمة المحتوى الديناميكي، حدد الرمز المميز للمحتوى الذي تريد تحويله.

      

      يحدد هذا المثال الرمز المميز للنص الأساسي من المشغل.

      إشعار

      تأكد من تحديد محتوى XML. إذا لم يكن المحتوى عبارة عن XML أو تم ترميزه base64، فيجب تحديد تعبير يعالج المحتوى. على سبيل المثال، يمكنك استخدام وظائف التعبير، مثل base64ToBinary() فك تشفير المحتوى أو xml() معالجة المحتوى بتنسيق XML.

5. من قائمة مصدر الخريطة ، حدد الموقع الذي قمت بتحميل خريطتك فيه، إما مورد LogicApp أو حساب IntegrationAccount الخاص بك.

6. من قائمة الخريطة ، حدد الخريطة.

7. عند الانتهاء، احفظ سير العمل الخاص بك.

   لقد انتهيت الآن من إعداد إجراء تحويل XML . في تطبيق العالم الحقيقي، قد ترغب في تخزين البيانات المحولة في تطبيق خط العمل (LOB) مثل SalesForce. لإرسال الإخراج الذي تم تحويله إلى Salesforce، أضف إجراء Salesforce.

8. لاختبار إجراء التحويل الخاص بك، قم بتشغيل سير العمل وتشغيله. على سبيل المثال، بالنسبة لمشغل الطلب، أرسل طلبا إلى عنوان URL لنقطة نهاية المشغل.

   يتم تشغيل إجراء تحويل XML بعد تشغيل سير العمل وعندما يكون محتوى XML متاحا للتحويل.

استهلاك

1. في مدخل Microsoft Azure، افتح تطبيق منطق الاستهلاك وسير العمل في المصمم.

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

   يستخدم هذا المثال مشغل الطلب .

3. ضمن الخطوة في سير العمل حيث تريد إضافة إجراء تحويل XML ، اتبع هذه الخطوات العامة لإضافة الإجراء المسمى تحويل XML.

4. في المربع المحتوى ، حدد محتوى XML الذي تريد تحويله باستخدام أي بيانات XML تتلقاها في طلب HTTP.

   1. لتحديد مخرجات من العمليات السابقة في سير العمل، في الإجراء تحويل XML ، انقر داخل مربع المحتوى ، الذي يفتح قائمة المحتوى الديناميكي.

   2. من قائمة المحتوى الديناميكي، حدد الرمز المميز للمحتوى الذي تريد تحويله.

   

   يحدد هذا المثال الرمز المميز للنص الأساسي من المشغل.

   إشعار

   تأكد من تحديد محتوى XML. إذا لم يكن المحتوى عبارة عن XML أو تم ترميزه base64، فيجب تحديد تعبير يعالج المحتوى. على سبيل المثال، يمكنك استخدام وظائف التعبير، مثل base64ToBinary() فك تشفير المحتوى أو xml() معالجة المحتوى بتنسيق XML.

5. من قائمة الخريطة ، حدد الخريطة.

6. عند الانتهاء، احفظ سير العمل الخاص بك.

   لقد انتهيت الآن من إعداد إجراء تحويل XML . في تطبيق العالم الحقيقي، قد ترغب في تخزين البيانات المحولة في تطبيق خط العمل (LOB) مثل SalesForce. لإرسال الإخراج الذي تم تحويله إلى Salesforce، أضف إجراء Salesforce.

7. لاختبار إجراء التحويل الخاص بك، قم بتشغيل سير العمل وتشغيله. على سبيل المثال، بالنسبة لمشغل الطلب، أرسل طلبا إلى عنوان URL لنقطة نهاية المشغل.

   يتم تشغيل إجراء تحويل XML بعد تشغيل سير العمل وعندما يكون محتوى XML متاحا للتحويل.

قدرات متقدمة

التجميعات المرجعية أو استدعاء التعليمات البرمجية المخصصة من الخرائط

يدعم إجراء تحويل XML الرجوع إلى التجميعات الخارجية من الخرائط، والتي تتيح استدعاء التعليمات البرمجية المخصصة .NET مباشرة من خرائط XSLT. لمزيد من المعلومات، راجع إضافة خرائط XSLT لمهام سير العمل في Azure Logic Apps.

كائنات الملحق المرجعي

في مهام سير العمل القياسية، يدعم إجراء تحويل XML تحديد كائن ملحق XML لاستخدامه مع الخريطة.

1. في إجراء تحويل XML ، افتح قائمة المعلمات المتقدمة ، وحدد XML Extension Object، الذي يضيف المعلمة إلى الإجراء.

2. في المربع XML Extension Object ، حدد كائن الملحق، على سبيل المثال:

   

علامة ترتيب البايت

بشكل افتراضي، تبدأ الاستجابة من التحويل بعلامة ترتيب البايت (BOM). لا يمكنك الوصول إلى هذه الوظيفة إلا عند العمل في محرر عرض التعليمات البرمجية. لتعطيل هذه الوظيفة، قم بتعيين الخاصية transformOptions إلى disableByteOrderMark:

"Transform_XML": {
    "inputs": {
        "content": "@{triggerBody()}",
        "integrationAccount": {
            "map": {
                "name": "TestMap"
            }
        },
        "transformOptions": "disableByteOrderMark"
    },
    "runAfter": {},
    "type": "Xslt"
}

الخطوات التالية

• إضافة خرائط XSLT لتحويل XML في Azure Logic Apps
• التحقق من صحة XML لمهام سير العمل في Azure Logic Apps