13. WSDL Parser و Provider از نوع WSDL
Wsdl را بر اساس همان سرویس ساخته‌شده تعریف می‌کنید.
به بیان ساده، Provider از نوع WSDL مستقیماً از روی یک URL خام شروع نمی‌شود؛ بلکه از روی سرویس WSDLای استفاده می‌کند که قبلاً در بخش مجزای WSDL Parser تعریف، فعال و تحلیل شده است. به همین دلیل این بخش باید قبل از استفاده از منبع داده WSDL به‌صورت کامل مستندسازی و طی شود.
13.1. جایگاه WSDL Parser در محصول
ماژول WSDL Parser زیرمجموعه مدیریت منابع اطلاعاتی است و هدف آن ثبت، نگهداری و تحلیل ساختار سرویس‌های SOAP/WSDL است. این بخش مسئول شناسایی Methodها، پارامترهای ورودی و ساختار خروجی سرویس است. بعد از انجام این مرحله، خروجی آن در Wizard ساخت Provider قابل استفاده خواهد بود.
مدیریت منابع اطلاعاتی
├── تفسیرگر WSDL / مدیریت سرویس‌های اطلاعاتی
└── مدیریت منابع داده
└── ایجاد Provider از نوع WSDL بر پایه سرویس‌های ثبت‌شده
13.2. صفحه لیست WSDLها
در صفحه اصلی تفسیرگر WSDL، سرویس‌های ثبت‌شده در قالب یک Grid نمایش داده می‌شوند و از دکمه «ایجاد وب سرویس» می‌توان سرویس جدید اضافه کرد. هر ردیف معمولاً شناسه، نام، آدرس، تاریخ ثبت و وضعیت فعال سرویس را نشان می‌دهد. پس از ایجاد هر سرویس، همین رکورد در این جدول ثبت می‌شود و در ادامه می‌تواند مبنای ساخت Provider قرار گیرد.
13.3. فرم ایجاد / ویرایش وب‌سرویس در WSDL Parser
فرم ایجاد/ویرایش وب‌سرویس محلی است که Contract سرویس SOAP/WSDL را برای استفاده‌های بعدی در سامانه ثبت می‌کنید. توضیح فیلدهای اصلی این فرم به‌صورت زیر است:
| فیلد | توضیح |
|---|---|
| نام وب سرویس | عنوان داخلی سرویس در سامانه. این نام در لیست WSDLها و هنگام انتخاب سرویس در ساخت Provider نمایش داده می‌شود. |
| آدرس وب سرویس | آدرس سرویس یا Endpoint/WSDL مربوطه که سامانه برای تحلیل ساختار سرویس از آن استفاده می‌کند. |
| نام کاربری اعتبارسنجی | در صورت نیاز سرویس مقصد به احراز هویت، شناسه کاربری مرتبط در این فیلد وارد می‌شود. |
| توضیحات | شرح تکمیلی برای مستندسازی داخلی و سهولت نگهداری سرویس. |
| آدرس سرور پروکسی | اگر دسترسی به سرویس از طریق Proxy انجام می‌شود، تنظیمات مربوط در این قسمت درج می‌گردد. |
| بروزرسانی ساختار سرویس | برای Parse مجدد و بازخوانی ساختار سرویس پس از تغییر Contract سرویس مقصد کاربرد دارد. |
| فعال | وضعیت فعال/غیرفعال سرویس. سرویس فعال برای استفاده در جریان‌های بعدی در دسترس خواهد بود. |
13.4. چرخه کامل از WSDL Parser تا Provider
- ورود به ماژول «تفسیرگر WSDL» و ایجاد یک Web Service جدید.
- تکمیل فیلدهای سرویس و ذخیره آن در WSDL Parser.
- تحلیل/Parse شدن Contract سرویس و شناسایی Methodها.
- بازگشت به ماژول «مدیریت منبع داده» و ایجاد Provider جدید.
- انتخاب نوع منبع داده
Wsdl. - انتخاب یکی از سرویس‌های WSDL ثبت‌شده از لیست سرویس‌ها.
- انتخاب Method، بازبینی پارامترها، تعیین خروجی‌ها و ذخیره Provider.
13.5. شروع ساخت Provider از نوع WSDL
بعد از اینکه سرویس WSDL در تفسیرگر WSDL ساخته شد، وارد «مدیریت منبع داده» می‌شوید و
Provider جدید ایجاد می‌کنید. در گام اطلاعات منبع، نوع منبع داده روی Wsdl قرار می‌گیرد.
در همین صفحه، فیلد «لیست سرویس‌ها» فقط سرویس‌هایی را نشان می‌دهد که قبلاً در بخش WSDL Parser ثبت شده‌اند.
بنابراین اگر سرویس مورد نظر قبلاً تعریف نشده باشد، در این لیست چیزی برای انتخاب نخواهید داشت.
پس از انتخاب سرویس مورد نظر از لیست، عنوان منبع داده را وارد می‌کنید و وارد مراحل بعدی Wizard می‌شوید.
در نمونه مستندشده، سرویس با نام wdw انتخاب شده و برای آن یک Provider با عنوان
user 'wdw' WSDL api services ساخته شده است.
13.6. مدیریت WebService و انتخاب Method
در گام «مدیریت WebService»، سامانه Methodهایی را که از سرویس WSDL استخراج کرده است نمایش می‌دهد.
این لیست خروجی مستقیم Parser است و کاربر از بین همان Methodهای شناسایی‌شده انتخاب می‌کند.
در مثال ارائه‌شده دو متد Add و Subtract شناسایی شده‌اند و متد
Add به‌عنوان متد Provider انتخاب شده است.
13.7. لیست پارامترها
بعد از تعیین متد، پارامترهای ورودی همان متد نمایش داده می‌شوند. این پارامترها نیز از Contract سرویس استخراج شده‌اند
و کاربر نام آن‌ها را به‌صورت دستی اختراع نمی‌کند؛ بلکه سامانه آن‌ها را بر اساس WSDL شناخته و در اختیار کاربر قرار می‌دهد.
در نمونه حاضر، متد Add دو پارامتر ورودی a و b دارد.
دکمه «تست وب سرویس» نیز در همین گام در دسترس است تا قبل از ذخیره Provider بتوان سرویس را با ورودی نمونه بررسی کرد و از صحت ارتباط و Contract آن مطمئن شد.
Input Parameters for Add @a @b
13.8. لیست فیلدها / خروجی‌ها
در مرحله «لیست فیلدها» خروجی Provider بر اساس نتیجه متد انتخابی نمایش داده می‌شود.
در مثال حاضر خروجی سرویس در یک فیلد با نام OutResult خلاصه شده است.
این نام به‌عنوان Field خروجی Provider ثبت می‌شود و در استفاده‌های بعدی (مانند فراخوانی از طریق Custom JS یا لایه‌های دیگر)
همان Contract خروجی مورد انتظار خواهد بود.
Output Fields OutResult
13.9. صفحه نهایی جزئیات منبع داده
در صفحه نهایی، تمام اطلاعات مهم Provider از نوع WSDL برای مرور نهایی نمایش داده می‌شود: عنوان منبع داده، نوع منبع داده، Method انتخاب‌شده، فهرست پارامترهای ورودی و فهرست فیلدهای خروجی. این مرحله قبل از ذخیره نهایی است و کمک می‌کند مطمئن شوید Provider دقیقاً بر اساس سرویس WSDL مورد انتظار شما ساخته شده است.
13.10. رفتار وابستگی Provider به WSDL Parser
- Provider نوع WSDL به سرویسی وابسته است که قبلاً در WSDL Parser ثبت شده باشد.
- اگر Contract سرویس مقصد تغییر کند، باید در WSDL Parser ساختار سرویس را بروزرسانی کرده و سپس Provider را بازبینی کنید.
- Methodها، پارامترها و خروجی‌های نمایش‌داده‌شده در Wizard ساخت Provider مستقیماً از تحلیل سرویس WSDL به‌دست می‌آیند.
- بدون تعریف اولیه سرویس در WSDL Parser، لیست سرویس‌ها در ساخت Provider منبعی برای انتخاب نخواهد داشت.
- به‌صورت مفهومی، WSDL Parser لایه ثبت و تحلیل سرویس است و Provider لایه مصرف ساختار تحلیل‌شده سرویس.
13.11. تصاویر کامل مسیر WSDL
Wsdl را می‌سازید. سرویس‌های قابل انتخاب در این Provider
همان سرویس‌هایی هستند که قبلاً در WSDL Parser ایجاد کرده‌اید. سپس Method، پارامترها و خروجی‌ها بر اساس Contract همان سرویس
در Wizard بارگذاری می‌شوند.