إدارة logic apps باستخدام Visual Studio

التطبيق على:Azure Logic Apps (Consumption)

رغم أنه يمكنك إنشاء التطبيقات المنطقية وتحريرها وإدارتها وتوزيعها في مدخل Microsoft Azure، إلا إنه يمكنك أيضاً استخدام Visual Studio عندما تريد إضافة تطبيقاتك المنطقية للتحكم في المصدر وتوزيع إصدارات مختلفة وإنشاء Azure Resource Manager لبيئات التوزيع المختلفة. باستخدام Visual Studio Cloud Explorer، يمكنك العثور على تطبيقاتك المنطقية وإدارتها جنباً إلى جنب مع موارد Azure الأخرى. على سبيل المثال، يمكنك فتح وتنزيل وتحرير وتشغيل وعرض محفوظات التشغيل وتعطيل وتمكين التطبيقات المنطقية التي تم توزيعها بالفعل في مدخل Microsoft Azure. إذا كنت تستخدم Azure Logic Apps لأول مرة في Visual Studio، فتعرَّف على كيفية إنشاء تطبيقات منطقية باستخدام Visual Studio.

يمكنك أيضاً إدارة تطبيقاتك المنطقية في مدخل Microsoft Azure.

هام

يؤدي توزيع تطبيق منطق أو توزيعه من Visual Studio إلى الكتابة فوق إصدار هذا التطبيق في مدخل Microsoft Azure. لذلك، إذا أجريت تغييرات في مدخل Microsoft Azure الذي تريد الاحتفاظ به، فتأكد من تحديث تطبيق المنطق في Visual Studio من مدخل Microsoft Azure قبل المرة التالية التي تقوم فيها بالتوزيع أو التوزيع من Visual Studio.

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

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

• تنزيل هذه الأدوات وتثبيتها، في حالة عدم امتلاكها بالفعل:

  • Visual Studio 2019 أو 2017 أو 2015 - إصدار المجتمع أو إصدار أحدث . ملحق Azure Logic Apps غير متاح حالياً لبرنامج Visual Studio 2022. يستخدم هذا التطبيق السريع Visual Studio Community 2017، وهو مجاني.

    هام

    عند تثبيت Visual Studio 2019 أو 2017، يجب التأكد من تحديد حمل العمل لـ تطوير Azure . لمزيد من المعلومات، راجع إدارة الموارد المرتبطة بحسابات Azure في Visual Studio Cloud Explorer.

    لتثبيت Cloud Explorer لبرنامج Visual Studio 2015، نزِّل Cloud Explorer من Visual Studio Marketplace. لمزيد من المعلومات، راجع إدارة الموارد المرتبطة بحسابات Azure في Visual Studio Cloud Explorer (2015).

  • Azure SDK (2.9.1 أو أحدث)

  • Azure PowerShell

  • أحدث Azure Logic Apps Tools لملحق Visual Studio للإصدار المراد:

    • Visual Studio 2019

    • Visual Studio 2017

    • Visual Studio 2015

    يمكن تنزيل Azure Logic Apps Tools وتثبيتها مباشرةً من Visual Studio Marketplace، أو معرفة طريقة تثبيت هذا الملحق من داخل Visual Studio . التأكد من إعادة تشغيل Visual Studio بعد الانتهاء من التثبيت.

  • لاستخدام اشتراكات Azure Government مع Visual Studio، راجع هذه الموضوعات للحصول على إعداد إضافي:

    • Visual Studio 2019: التشغيل السريع: الاتصال بـ Azure Government باستخدام Visual Studio

    • Visual Studio 2017: تقديم ملحق Azure Environment Selector Visual Studio، والذي يمكنك تنزيله وتثبيته من Visual Studio Marketplace.

• قم بالوصول إلى الويب أثناء استخدام Logic Apps Designer المضمن

  يتطلب المصمم اتصالاً بالإنترنت لإنشاء موارد في Azure وقراءة الخصائص والبيانات من الموصلات في تطبيقك المنطقي.

ابحث عن تطبيقات المنطق

في Visual Studio، يمكنك العثور على جميع التطبيقات المنطقية المرتبطة باشتراك Azure الخاص بك والتي يتم توزيعها في مدخل Microsoft Azure باستخدام Cloud Explorer.

1. افتح Visual Studio. في القائمة View، حدد Cloud Explorer.

2. في Cloud Explorer، حدد رمز Account Management. حدد اشتراك Azure المرتبط بتطبيقاتك المنطقية، وحدد Apply. على سبيل المثال:

   

3. بجوار رمز إدارة الحساب، حدد Resource Types. ضمن اشتراك Azure الخاص بك، قم بتوسيع Logic Apps بحيث يمكنك عرض جميع التطبيقات المنطقية المنشورة والمرتبطة باشتراكك.

بعد ذلك، افتح تطبيقك المنطقي في Logic App Editor.

افتح التطبيقات المنطقية في Visual Studio

في Visual Studio، يمكنك فتح التطبيقات المنطقية التي تم إنشاؤها وتوزيعها مسبقاً إما مباشرة من خلال مدخل Microsoft Azure وإما كمشروعات Azure Resource Group باستخدام Visual Studio.

1. افتح Cloud Explorer وابحث عن تطبيق المنطق.

2. من القائمة المختصرة لتطبيق المنطق، حدد Open with Logic App Editor.

   تلميح

   في حالة عدم امتلاك هذا الأمر فيVisual Studio 2019، فيجب التحقق من وجود آخر تحديثات Visual Studio.

   

   بعد فتح التطبيق المنطقي في Logic Apps Designer، في الجزء السفلي من المصمم، يمكنك تحديد Code View بحيث يمكنك مراجعة بنية تعريف تطبيق المنطق الأساسي. إذا كنت تريد إنشاء قالب توزيع للتطبيق المنطقي، فتعرَّف على كيفية تنزيل قالب Azure Resource Manager لتطبيق المنطق هذا. تعرَّف على المزيد حول قوالب Azure Resource Manager.

تنزيل من Azure

يمكنك تنزيل تطبيقات منطقية من مدخل Microsoft Azure وحفظها كقوالب Azure Resource Manager. يمكنك بعد ذلك تحرير القوالب محلياً باستخدام Visual Studio وتخصيص التطبيقات المنطقية لبيئات التوزيع المختلفة. تنزيل التطبيقات المنطقية تلقائياً يضع معلمات تعريفاتها داخل قوالب Azure Resource Manager، والتي تستخدم أيضاً JavaScript Object Notation (JSON).

1. في Visual Studio، باستخدام Cloud Explorer، افتح تطبيق المنطق الذي تريد تنزيله من Azure.

2. من القائمة المختصرة لتطبيق المنطق، حدد Open with Logic App Editor.

   تلميح

   في حالة عدم امتلاك هذا الأمر فيVisual Studio 2019، فيجب التحقق من وجود آخر تحديثات Visual Studio.

   يتم فتح تطبيق المنطق في Logic App Designer.

3. في شريط أدوات المصمم، حدد Download.

   

4. عندما تتم مطالبتك بتحديد موقع، استعرض وصولاً إلى هذا الموقع واحفظ قالب Azure Resource Manager لتعريف التطبيق المنطقي بتنسيق ملف JSON (.json).

   يظهر تعريف التطبيق المنطقي في القسم الفرعي resources داخل قالب Resource Manager. يمكنك الآن تحرير تعريف التطبيق المنطقي وقالب Resource Manager باستخدام Visual Studio. يمكنك أيضاً إضافة القالب كـ مشروع Azure Resource Group إلى حل Visual Studio. تعرَّف على معلومات حول مشاريع Azure Resource Group لتطبيقات المنطق في Visual Studio.

ربط حساب التكامل

لإنشاء تطبيقات منطقية لسيناريوهات تكامل المؤسسة بين الشركات (B2B)، يمكنك ربط تطبيقك المنطقي بحساب تكامل تم إنشاؤه مسبقاً والموجود في نفس المنطقة التي يوجد بها تطبيقك المنطقي. يحتوي حساب التكامل على أدوات B2B، مثل الشركاء التجاريين والاتفاقيات والمخططات والخرائط، ويسمح لتطبيقك المنطقي باستخدام موصلات B2B للتحقق من صحة XML وترميز أو فك تشفير الملفات الثابتة. رغم أنه يمكنك إنشاء هذا الارتباط باستخدام مدخل Microsoft Azure، يمكنك أيضاً استخدام Visual Studio بعد تلبية المتطلبات الأساسية، ويتواجد تطبيقك المنطقي كملف JSON (.json) داخل ملف مشروع Azure Resource Group. تعرَّف على معلومات حول مشاريع Azure Resource Group لتطبيقات المنطق في Visual Studio.

1. في Visual Studio، افتح مشروع Azure Resource Group الذي يحتوي على تطبيق المنطق الخاص بك.

2. في مستكشف الحلول، افتح القائمة المختصرة لملف <logic-app-name>.json وحدد Open With Logic App Designer. (لوحة المفاتيح: Ctrl + L)

   

   تلميح

   إذا لم يكن لديك هذا الأمر في Visual Studio 2019، فتحقق من أن لديك آخر تحديثات Visual Studio وملحق Azure Logic Apps Tools.

3. تأكد من تركيز Logic App Designer عن طريق تحديد علامة تبويب المصمم أو السطح بحيث تعرض نافذة الخصائص خاصية حساب التكامل لتطبيقك المنطقي.

   

   تلميح

   إذا لم تكن نافذة الخصائص مفتوحة بالفعل، من القائمة View، فحدد Properties Window. (لوحة المفاتيح: اضغط F4)

4. افتح قائمة مواقع Integration Account، وحدد حساب التكامل الذي تريد ربطه بتطبيق المنطق، على سبيل المثال:

   

5. عند الانتهاء، تذكر حفظ حل Visual Studio الخاص بك.

عند تعيين خاصية حساب التكامل في Visual Studio وحفظ تطبيقك المنطقي كقالب Azure Resource Manager، فإن هذا القالب يتضمن أيضاً إعلان معلمة لحساب التكامل المحدد. لمزيد من المعلومات حول معلمات النماذج وتطبيقات المنطق، راجع نظرة عامة: توزيع تطبيق المنطق تلقائياً.

تغيير موقع التوزيع

في Visual Studio، إذا كان تطبيقك المنطقي موجوداً كملف JSON (.json) ضمن Azure Resource Group project الذي تستخدمه للتنفيذ التلقائي فيما يخص التوزيع، يتم تعيين هذا التطبيق المنطقي على نوع الموقع وموقع محدد. هذا الموقع إما منطقة Azure أو بيئة خدمة تكامل (ISE)موجودة.

لتغيير نوع موقع تطبيق المنطق أو موقعه، يجب عليك فتح ملف تعريف سير العمل (.json) لتطبيقك المنطقي من مستكشف الحلول باستخدام Logic App Designer. لا يمكنك تغيير هذه الخصائص باستخدام Cloud Explorer.

هام

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

1. في Visual Studio، افتح مشروع Azure Resource Group الذي يحتوي على تطبيق المنطق الخاص بك.

2. في مستكشف الحلول، افتح <logic-app-name>.json file's shortcut menu, and select Open With Logic App Designer. (لوحة المفاتيح: Ctrl + L)

   

   تلميح

   إذا لم يكن لديك هذا الأمر في Visual Studio 2019، فتحقق من أن لديك آخر تحديثات Visual Studio وملحق Azure Logic Apps Tools.

3. تأكد من تركيز Logic App Designer عن طريق تحديد علامة تبويب المصمم أو السطح بحيث تعرض نافذة الخصائص خصائص اختيار نوع الموقع والموقع لتطبيقك المنطقي. يتم تعيين نوع موقع المشروع إما على المنطقة وإما بيئة خدمة التكامل.

   

   تلميح

   إذا لم تكن نافذة الخصائص مفتوحة بالفعل، من القائمة View، فحدد Properties Window. (لوحة المفاتيح: اضغط F4)

4. لتغيير نوع الموقع، افتح قائمة خصائص Choose Location Type، وحدد نوع الموقع الذي تريده.

   على سبيل المثال، إذا كان نوع الموقع هو بيئة خدمة التكامل، فيمكنك تحديد Region.

   

5. لتغيير الموقع المحدد، افتح قائمة خصائص Location. بناءً على نوع الموقع، حدد الموقع الذي تريده، على سبيل المثال:

   • حدد منطقة Azure مختلفة:

     

   • حدد ISE مختلفاً:

     

6. عند الانتهاء، تذكر حفظ حل Visual Studio الخاص بك.

عند تغيير نوع الموقع أو الموقع في Visual Studio وحفظ التطبيق المنطقي كقالب Azure Resource Manager، يتضمن هذا القالب أيضاً إعلانات المعلمات لنوع الموقع والموقع هذا. لمزيد من المعلومات حول معلمات النماذج وتطبيقات المنطق، راجع نظرة عامة: توزيع تطبيق المنطق تلقائياً.

تحديث من Azure

إذا قمت بتحرير تطبيق المنطق في مدخل Microsoft Azure وأردت الاحتفاظ بهذه التغييرات، فتأكد من تحديث إصدار هذا التطبيق في Visual Studio بهذه التغييرات.

• في Visual Studio، في شريط أدوات Logic App Designer، حدد Refresh.

  -أو -

• في Visual Studio Cloud Explorer، افتح القائمة المختصرة لتطبيق المنطق، وحدد Refresh.

نشر تحديثات تطبيق المنطق

عندما تكون جاهزاً لتوزيع تحديثات تطبيق منطقك من Visual Studio إلى Azure، في شريط أدوات Logic App Designer، حدد Publish.

قم بتشغيل تطبيق المنطق يدوياً

يمكنك يدوياً تشغيل تطبيق منطق تم توزيعه في Azure من Visual Studio. في شريط أدوات Logic App Designer، حدد Run Trigger.

مراجعة محفوظات التشغيل

للتحقق من الحالة وتشخيص المشكلات المتعلقة بتشغيل تطبيق المنطق، يمكنك مراجعة التفاصيل، مثل المدخلات والمخرجات، لتلك التي يتم تشغيلها في Visual Studio.

1. في Cloud Explorer، افتح القائمة المختصرة لتطبيق المنطق، وحدد Open run history.

   

2. لعرض تفاصيل تشغيل معين، انقر نقراً مزدوجاً فوق تشغيل. على سبيل المثال:

   

   تلميح

   لفرز الجدول حسب الخاصية، حدد رأس العمود لتلك الخاصية.

3. قم بتوسيع الخطوات التي تريد مراجعة مدخلاتها ومخرجاتها، على سبيل المثال:

   

تعطيل تطبيقات المنطق أو تمكينها

لإيقاف تشغيل المُشغل في المرة التالية عند استيفاء شرط المشغل، قم بتعطيل تطبيق المنطق الخاص بك. يؤثر تعطيل تطبيق المنطق على مثيلات سير العمل بالطرق التالية:

• تستمر Azure Logic Apps في كافة العمليات قيد التقدم ومتابعة التشغيل حتى تنتهي. استنادًا إلى وحدة التخزين أو تراكم، قد تستغرق هذه العملية وقتًا لتكتمل.

• لا تنشئ Azure Logic Apps مثيلات سير عمل جديدة أو تقوم بتشغيلها.

• لن يتم إطلاق الزناد في المرة التالية التي يتم فيها استيفاء شروطه.

• تتذكر حالة المشغل النقطة التي تم فيها إيقاف تطبيق المنطق. لذلك، إذا قمت بإعادة تنشيط التطبيق المنطقي، فإن المشغل يطلق النار على جميع العناصر غير المجهزة منذ آخر تشغيل.

  لإيقاف تشغيل المشغل على العناصر غير المعالجة منذ آخر تشغيل، قم بإلغاء تحديد حالة المشغل قبل إعادة تنشيط تطبيق المنطق:

  1. في تطبيق المنطق، قم بتحرير أي جزء من مشغل سير العمل.
  2. احفظ تغييراتك. تُعيد هذه الخطوة تعيين الحالة الحالية للمشغل الخاص بك.
  3. أعد تنشيط تطبيق المنطق الخاص بك.

• عند تعطيل سير عمل، ما زال بإمكانك إعادة إرسال عمليات التشغيل.

تعطيل تطبيقات المنطق

في Cloud Explorer، افتح القائمة المختصرة لتطبيق المنطق، وحدد Disable.

تمكين تطبيقات المنطق

في Cloud Explorer، افتح القائمة المختصرة لتطبيق المنطق، وحدد Enable.

حذف تطبيقات المنطق

يؤثر حذف تطبيق منطق على حالات سير العمل بالطرق التالية:

• تبذل Azure Logic Apps قصارى جهدها لإلغاء عمليات تشغيل قيد التقدم ومعلقة.

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

• لا تنشئ Azure Logic Apps مثيلات سير عمل جديدة أو تقوم بتشغيلها.

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

لحذف تطبيق المنطق الخاص بك من مدخل Microsoft Azure، في Cloud Explorer، افتح القائمة المختصرة لتطبيق المنطق، وحدد Delete.

استكشاف الأخطاء وإصلاحها

عند فتح مشروع تطبيق المنطق في Logic Apps Designer، قد لا تحصل على خيار تحديد اشتراك Azure الخاص بك. بدلاً من ذلك، يتم فتح تطبيق المنطق الخاص بك باشتراك Azure ليس هو الاشتراك الذي تريد استخدامه. يحدث هذا السلوك لأنه بعد فتح ملف .json لتطبيق منطقي، يخزن Visual Studio أول اشتراك محدد للاستخدام في المستقبل. لحل هذه المشكلة، جرّب إحدى الخطوات التالية:

• أعد تسمية ملف json الخاص بتطبيق المنطق. تعتمد ذاكرة التخزين المؤقت للاشتراك على اسم الملف.

• لإزالة الاشتراكات المحددة مسبقاً لـ جميع التطبيقات المنطقية في الحل الخاص بك، احذف مجلد إعدادات Visual Studio المخفي (.vs) في دليل الحل الخاص بك. يخزن هذا الموقع معلومات اشتراكك.

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

في هذه المقالة، تعلمت كيفية إدارة التطبيقات المنطقية المنشورة باستخدام Visual Studio. بعد ذلك، تعرَّف على تخصيص تعريفات التطبيقات المنطقية للتوزيع:

تعريفات تطبيق منطق المؤلف في JSON