بازگشت به مرکز دانش

توسعه Bizagi / Bizagi 11.2.5 On-Premises

چرخه توسعه Widget اختصاصی برای Bizagi

از تعریف نیاز و طراحی قرارداد داده تا ساخت، تست موبایل، مدیریت CSP، نصب و نسخه‌بندی فایل BWG.

BizagiWidgetJavaScriptBizagi 11.2.5

دامنه این آموزش: Bizagi Studio و Automation Server نسخه 11.2.5 On-Premises.

نکته نسخه: build دقیق 11.2.5 و تنظیمات محیط سازمان را پیش از اجرای تغییر در Test بررسی کنید. نسخه 11.2.5 از سپتامبر 2024 خارج از پشتیبانی رسمی Bizagi است؛ بنابراین تغییرات امنیتی و زیرساختی باید با ارزیابی ریسک انجام شوند.

Widget اختصاصی زمانی ارزشمند است که یک مسئله واقعی تجربه کاربر را حل کند، نه صرفاً ظاهر فرم را تغییر دهد. پیش از کدنویسی مطمئن شوید کنترل‌های استاندارد یا Widget Xchange نیاز را پوشش نمی‌دهند.

مرحله اول: تعریف مسئله و قرارداد

مشخص کنید Widget چه داده‌ای دریافت و چه داده‌ای ذخیره می‌کند. تفاوت استفاده داخل Table و خارج از Table را از ابتدا در نظر بگیرید؛ Collection در Bizagi رفتار متفاوتی از XPath ساده دارد.

معیار پذیرش بنویسید:

  • کاربر چه کاری انجام می‌دهد؟
  • خروجی ذخیره‌شده چیست؟
  • Widget روی موبایل و دسکتاپ چگونه رفتار می‌کند؟
  • حالت خالی، فقط خواندنی و خطا چگونه نمایش داده می‌شود؟
  • مرحله دوم: شروع کوچک

    مستندات رسمی Bizagi توصیه می‌کند قابلیت را تدریجی بسازید. ابتدا نمایش و ذخیره یک مقدار ساده را درست کنید، سپس کتابخانه‌ها و تعاملات پیچیده را اضافه کنید.

    Widget Editor قالب آماده، اعتبارسنجی Syntax، شبیه‌سازی روی دستگاه‌ها و APIهای Bizagi را فراهم می‌کند. با این حال نسخه فایل را در مخزن محلی نگهداری کنید و فقط به فضای مرورگر تکیه نکنید.

    مرحله سوم: ساختار و وابستگی‌ها

    Widget به‌صورت فایل BWG بسته‌بندی می‌شود و ساختار مشخصی شامل descriptor و فایل‌های پیاده‌سازی دارد. کتابخانه جانبی را فقط در صورت نیاز اضافه کنید. حجم و امنیت کتابخانه را بررسی کنید.

    اگر Widget سرویس خارجی فراخوانی می‌کند، تنظیمات Content Security Policy محیط Bizagi را بررسی کنید. بهتر است اطلاعات محرمانه و فراخوانی حساس از فرانت‌اند انجام نشود.

    مرحله چهارم: طراحی تجربه کاربری

  • حالت loading واضح داشته باشد.
  • خطا به زبان کاربر و همراه اقدام بعدی نمایش داده شود.
  • با صفحه‌کلید و اندازه‌های مختلف قابل استفاده باشد.
  • متن فارسی، RTL و اعداد را درست نمایش دهد.
  • در حالت read-only ظاهر قابل فهم داشته باشد.
  • مرحله پنجم: تست

  • ایجاد مقدار جدید
  • ویرایش مقدار موجود
  • پاک کردن یا مقدار null
  • استفاده داخل Table
  • چند ردیف Collection
  • موبایل، تبلت و دسکتاپ
  • کاربر بدون دسترسی
  • کندی یا خطای سرویس
  • باز کردن مجدد Activity
  • مرحله ششم: نصب و نسخه‌بندی

    فایل BWG را می‌توان به‌صورت دستی نصب یا برای ارتقا reinstall کرد. نام نسخه، تغییرات، وابستگی‌ها و فرآیندهای مصرف‌کننده را ثبت کنید. قبل از جایگزینی نسخه در محیط عملیاتی، فرآیندهای وابسته را در Test بررسی کنید.

    خطاهای رایج

  • قرار دادن منطق حساس کسب‌وکار فقط در JavaScript
  • استفاده از selectorهای شکننده
  • نبود حالت read-only
  • تست نکردن داخل Table
  • وابستگی به CDN یا سرویس مسدودشده
  • نداشتن نسخه پشتیبان فایل BWG
  • منابع رسمی:

    https://help.bizagi.com/platform/en/widgets_new.htm

    https://help.bizagi.com/platform/en/widgets_structure.htm

    https://help.bizagi.com/platform/en/widgets_manualinst.htm