/
/
/
/
Server-Side Script و مثال‌های آموزشی برای سناریوهایی استفاده می‌شوند که اجرای Provider باید در سمت سرور انجام شود یا نیاز به پیاده‌سازی منطق پردازشی بیشتری وجود دارد. در این بخش نحوه فراخوانی Provider در C# و نمونه‌های عملی استفاده از Provider بررسی می‌شود.
فراخوانی Provider در C#
در سمت Server، Provider می‌تواند از طریق کد C# فراخوانی شود. این روش برای سناریوهایی استفاده می‌شود که منطق اجرا باید در محیط Server-Side انجام شود.
نکته مهم
اجرای Server-Side Provider باید مطابق قرارداد Provider انجام شود و Parameterها باید با ورودی‌های تعریف‌شده در Provider هماهنگ باشند.
مراحل کلی اجرای Server-Side Provider
- شناسایی Provider مورد نظر
- آماده‌سازی Parameterهای ورودی
- فراخوانی Provider از سمت Server
- دریافت و پردازش Result
- مدیریت خطاهای احتمالی اجرا
ساختار کلی کد
ساختار دقیق فراخوانی Provider در سمت Server به APIهای موجود در Build مقصد وابسته است. نمونه‌های کدنویسی باید بر اساس نسخه واقعی GraphBPMS تهیه و تست شوند.
// Execute Provider // Prepare parameters // Receive Result // Handle response
Warning
نام کلاس‌ها، Helperها و APIهای Server-Side نباید بدون بررسی Build مقصد مستند شوند. فقط APIهای تأییدشده GraphBPMS باید در Wiki قرار گیرند.
مثال‌های آموزشی Provider
برای درک بهتر نحوه استفاده از Provider، چند سناریوی کاربردی در سند اصلی ارائه شده است. این مثال‌ها مسیر استفاده از Provider در موقعیت‌های واقعی را نشان می‌دهند.
دریافت اطلاعات با Provider
در این سناریو، Provider برای دریافت اطلاعات از منبع داده اجرا شده و نتیجه دریافت‌شده در منطق برنامه استفاده می‌شود.
اجرای Command بدون خروجی
در برخی سناریوها هدف از اجرای Provider انجام یک عملیات است و خروجی داده‌ای نیاز نیست. در این حالت نتیجه اجرا باید فقط از نظر موفقیت یا خطا بررسی شود.
سناریو
اجرای عملیات ثبت، تغییر یا حذف اطلاعات بدون نیاز به دریافت داده خروجی.
Upload فایل به REST
در این سناریو، فایل به‌عنوان ورودی Provider استفاده شده و درخواست به یک سرویس REST ارسال می‌شود.
Download فایل
در این حالت Provider نتیجه فایل را دریافت کرده و خروجی به شکل فایل در اختیار مصرف‌کننده قرار می‌گیرد.
Upload + Process + Download
در این سناریو، فایل ورودی دریافت شده، پردازش مورد نیاز روی آن انجام می‌شود و فایل خروجی تولید می‌گردد.
Upload File
↓
Process Provider
↓
Download File
نکات توسعه Server-Side Provider
- Parameterهای ورودی قبل از اجرا بررسی شوند.
- نوع Result قبل از پردازش مشخص شود.
- خطاهای اجرای Provider مدیریت شوند.
- مثال‌های آموزشی قبل از انتشار در Build مقصد تست شوند.
Warning
مثال‌های Server-Side باید دقیقاً مطابق APIهای واقعی GraphBPMS باشند. از ایجاد نمونه‌هایی که فقط از نظر مفهومی صحیح هستند ولی در Build مقصد قابل اجرا نیستند، خودداری شود.