تمرين - إنشاء موصِّل مخصص من سير عمل واستدعاؤه في Azure Logic Apps
لديك واجهة برمجة تطبيقات ويب Web API تسمى Print Framer API والتي تحسب تكلفة إطار الصورة بناءً على الأبعاد التي ترسلها إليه. يرغب المطورون في جميع أنحاء شركتك في استخدام واجهة برمجة التطبيقات هذه في مهام سير عمل Azure Logic Apps الخاصة بهم، ولكن لا توجد حاليا طريقة لإجراء هذا الاتصال.
في هذا التمرين، ستنشئ موصِّلاً مخصصاً لـ Print Framer API وتستخدمه لإرسال البيانات وتلقيها من سير عمل تطبيق منطقي إلى واجهة برمجة تطبيقات الويب. في البداية، نحتاج إلى سير عمل تطبيق منطقي.
إنشاء سير عمل تطبيق منطقي
في قائمة مدخل Azure أو من الصفحة الرئيسية، ضمن Azure services، حدد Create a resource. يظهر إنشاء جزء مصدر.
في جزء القائمة على اليسار، حدد Integration، وابحث عن Logic App وحدده.
في الجزء Create Logic App، أسفل Basics، أدخل القيم التالية لكل إعداد.
الإعداد القيمة تفاصيل المشروع الاشتراك اشتراك Concierge مجموعة الموارد حدد Sandbox resource group تفاصيل المثيل إدخال اسم التطبيق قم بتوفير اسم مميز. تذكر الاسم لاستخدامه لاحقاً. نشر سير العمل المنطقة حدد منطقة قريبة منك. تمكين تحليلات السجل لا تخطيط نوع الخطة الاستهلاك التكرار في المنطقة التكرار في المنطقة اتركه كافتراضي (معطل) تُتيح لك بيئة الاختبار المعزولة المجانية إنشاء موارد في مجموعة فرعية من مناطق Azure العالمية. حدد منطقة من القائمة التالية عند إنشاء الموارد:
- West US 2
- South Central US
- Central US
- شرق الولايات المتحدة
- أوروبا الغربية
- جنوب شرق آسيا
- شرق اليابان
- جنوب البرازيل
- جنوب شرق أستراليا
- وسط الهند
حدد Review + create، ثم حدد Create بعد نجاح التحقق من الصحة.
بعد إنشاء المدخل لمورد تطبيقك المنطقي، حدد Go to resource.
يوضِّح مدخل Azure معرضاً للمشغّلات وأنماط مهام سير العمل المستخدمة بشكل متكرر.
حدد Logic app designer في القائمة اليسرى، ثم حدد Add a trigger.
ابحث عن وحدد عند تلقي طلب HTTP.
سيعرض مصمم سير العمل الآن المشغّل الذي حددته.
حدد Show all في قسم Advanced parameters .
حدد GET في القائمة المنسدلة Method .
أدخل
{height}/{width}كسلسلة حرفية في حقل المسار النسبي.
في شريط أدوات المصمم، حدد "Save".
لدينا الآن سير عمل تطبيق منطقي أساسي. دعنا نجرّب إضافة موصِّل مخصص لاستدعاء واجهة برمجة تطبيقات Print Framer المخصصة من سير العمل لدينا.
إنشاء موصِّل Azure Logic Apps مخصص جديد في مدخل Azure
في قائمة مدخل Azure أو من الصفحة الرئيسية، ضمن Azure services، حدد Create a resource. يظهر إنشاء جزء مصدر.
في مربع البحث، ابحث عن Logic Apps Custom Connector وحدده.
في الجزء Logic Apps Custom Connector، حدد Create.
في الجزء Create logic apps custom connector، أسفل Basics، أدخل القيم التالية لكل إعداد.
الإعداد القيمة تفاصيل المشروع الاشتراك اشتراك Concierge مجموعة الموارد حدد Sandbox resource group تفاصيل المثيل اسم موصل مخصص PrintFramerConnector المنطقة حدد منطقة بالقرب منك ومدعمة أيضاً من قبل بيئة الاختبار المعزولة. إقران ببيئة خدمة التكامل اتركها دون تحديد حدد "Review + create". بعد نجاح عملية التحقق، حدد «إنشاء».
بعد اكتمال التوزيع، حدد «Go to resource».
استيراد تعريف OpenAPI
استخدم الآن ملف OpenAPI الذي حفظته مسبقاً لتعريف الموصِّل المخصص.
في مدخل Azure أو من الصفحة الرئيسية، حدد كل الموارد ثم حدد PrintFramerConnector.
في صفحة نظرة عامة ، حدد تحرير.
في قسم الروابط المخصصة،حددملف OpenAPIثم حدداستيراد. افتح ملف JSON الذي حفظته في التمرين السابق.
تكوين الموصل المخصص
يخبر الملف OpenAPI الموصل المخصص حول العمليات المتوافرة في واجهة برمجة تطبيقات Web API. توجد بعض الخصائص الأخرى التي يجب عليك تعيينها للموصِّل المخصص.
في قسمGeneral Information في Description اكتب الحصول على تقدير لإطار صورة. قد تحتاج إلى التمرير لأسفل لمشاهدة هذا الجزء من جزء التكوين.
في مربع النص Host ، أدخل عنوان URL المثال الذي لاحظته سابقا.
في الجزء Security، تأكد من تحديد No Authentication.
هام
لهذا العرض التوضيحي، لا بأس من السماح بالوصول إلى واجهة برمجة التطبيقات API دون أي مصادقة. بالنسبة إلى واجهات برمجة التطبيقات APIs في العالم الحقيقي، والتي تحتوي على بيانات حساسة أو تتطلب اشتراكًا مدفوعًا، فإن المصادقة ضرورية.
في جزء Definition في مربع النص Summary اكتب تقدير تكلفة إطار الصورة.
ضمن الرؤية، حدد هام.
في أعلى اللوحة، حدد «تحديث موصل»Update connector.
إضافة الموصِّل المخصص إلى سير عمل تطبيقك المنطقي
يمكنك الآن استخدام الموصِّل المخصص في سير عمل تطبيقك المنطقي.
في مدخل Azure أو من الصفحة Home، أسفل Azure resources، حدد All resources، ثم حدد مورد التطبيق المنطقي الذي أنشأته في الدرس 3.
من قائمة مورد تطبيقك المنطقي، حدد Overview. في شريط أدوات الجزء Overview، حدد Edit.
على المصمم، حدد خطوة>جديدة إضافة إجراء.
أسفل مربع البحث Choose an operation، حدد Custom ثم حدد PrintFramerConnector.
ضمن «الإجراءات» Actions حدد تقدير تكلفة إطار الصورة.
في المربع Estimate the cost of a picture frame، ضع المؤشر في الحقل Height. من قائمة المحتوى الديناميكي التي ستفتح أمامك، حدد height.
توضح لقطة الشاشة التالية هذا التحديد:
عُد إلى الموصِّل المخصص وضع المؤشر داخل الحقل Width. من قائمة المحتوى الديناميكي، حدد width.
معلمات الارتفاع والعرض التي نتلقاها من كل طلب HTTP يشغّل سير العمل لدينا مرتبطة الآن بمعلمات الارتفاع والعرض التي نمررها إلى PrintFramerConnector.
أكمل سير العمل
وأخيراً، يحتاج سير العمل إلى طريقة لعرض النتائج. يمكنك استخدام الإجراء Response لإظهار التقدير:
في مصمم سير العمل، حدد New step.
في مربع البحث Choose an operation، أدخل Response، ثم حدد الإجراء المُسمى Response.
في الحقل Body، اكتب التكلفة التقريبية لإطارك تساوي:$.
من قائمة المحتوى الديناميكي التي ستظهر أمامك، حدد Body من المقطع Estimate the cost of a picture frame.
تظهر لقطة الشاشة التالية هذا التحديد:
عند الانتهاء، حدد حفظ لحفظ سير العمل.
اختبر سير العمل
أصبح سير العمل مكتملاً الآن، وسوف يستدعي واجهة برمجة تطبيقات الويب باستخدام الموصِّل المخصص. كل ما عليك فعله الآن هو إرسال طلب يشغّل سير العمل، وذلك باستخدام المستعرض.
في مصمم سير العمل، قم بتوسيع الإجراء When an HTTP request is received.
بجوار الحقل HTTP GET URL، حدد Copy URL.
افتح علامة تبويب متصفح جديدة وقم بلصق عنوان URL في شريط العناوين.
في عنوان URL الملصق، بدلاً من المعلمة {height} استخدم المعلمة 10. وبدلاً من المعلمة {width}، استخدم المعلمة 4. اضغط عَلى إدخال.
سيوضِّح جزء المستعرض تكلفة تقريبية.
حاول إدخال ارتفاعات وعروض أخرى.
تهانينا! لقد نجحت في إنشاء سير عمل تطبيق منطقي يمكنه استدعاء واجهة برمجة تطبيقات Print Framer المحلية باستخدام موصِّل مخصص!