فراخوانی وب سرویس در Nintex

shape
shape
shape
shape
shape
shape
shape
shape

استفاده API در فرآیند ساز Nintex

در این مطلب قصد داریم در مورد فراخوانی وب سرویس در Nintex توضیح دهیم

اکشن Call Web Service به فرآیند امکان فراخوانی یک متد وب سرویس از نوع (SOAP(Simple Object Access Protocol میدهد که به کمک آن می توانید وب سرویس های سفارشی یا وب سرویس های شیرپوینت را فراخوانی کنید.

این مبحث به پیاده سازی فراخوانی وب سرویس ساده و چگونگی مشاهده نتایج آن و چگونگی استفاده آن در کنار سایر اکشنهای NINTEX WORKFLOW می پردازد.

پیش نیازها
این فرآیند بر روی یک لیست با سه ستون اجرا میشود: عنوان (Title) و Data1 از نوع متن تک خطی و Data2 از نوع عدد.

آیتمهای نمونه استفاده شده در اینجا دارای داده های زیر می باشند:

طراحی فرآیند
فرآیند کامل شده در زیر نمایش داده شده است:

ایجاد فرآیند
۱٫ قدم اول ایجاد مقادیر یا variables است که بعدا از آنها استفاده می شود. مقادیر را مانند شکل زیر ایجاد کنید:

 

۲٫ اولین اکشن فرآیند را Call Web Service اضافه کنید و آن را با اطلاعاتی که در ادامه بیان میشود تنظیم کنید.

URL:ابتدا یک مرجع و ارتباط به url وب(Web URL) وارد کنید و سپس این متن را وارد کنید : vti_bin/Lists.asmx_/

این مقدار بسته به متد وب سرویسی که از آن استفاده میکنید تغییر میکند. در این مورد ما از متد Lists.GetListItems استفاده میکنیم.

Username & Password:اینها را با اکانتی که مجوزهای مربوطه برای فعالیتهای Web Service را دارد تنظیم کنید. بطور مثال اگر فقط شما میتوانید لیست را بخوانید پس فقط یک اکانت با مجوز خواندن لازم است. اگرچه شما در حال اضافه کردن آیتم های جدید به یک لیست هستید شما به دسترسی مشارکتی و بقیه موارد نیاز دارید.

۳٫ زمانی که اطلاعات وارد شد بر روی دکمه refresh کلیک کرده و سپس ok کنید. هم اکنون شما باید قادر باشید تا یک متد وب را از نوار Dropdown انتخاب کنید.

۴٫ GetListItems را از لیست Dropdown متدهای وب انتخاب کنید و سپس SOAP Editor را مانند editor mode یا حالت ویرایشگر انتخاب کنید. شما باید یک پنجره ویرایشگر همانطور که در زیر مشاهده میکنید ، ببینید.

۵٫ متن زیر را در پنجره ویرایشگر SOAP وارد کنید.

۶٫ فیلد ‘Store result in’ را با variable ایجاد کرده از قبل getlistitems_result تنظیم کنید. فرمت نتیجه را Xml ست کنید. حالا که web service action تنظیم شده است ، save را کلیک کنید.

توجه: اکشن بعدی در فرآیند بصورت انتخابی است اما مناسب است چون راه خوبی برای مشاهده نتایج web service call در فرمت Xml است. این دید میتواند در مواقع تعیین نام فیلدها و مشاهده اینکه آیا خروجی صحیح است قبل از اجرای بقیه اکشن ها بر روی این نتایج استفاده شود.

۷٫ یک اکشن Send Notification اضافه کنید ، پس ایمیل به مرجع مورد نظر ارسال میشود. خط Subject را با GetListItems Result پر کنید. در بدنه ایمیل مرجعی را به getlistitems_result وارد کرده و قالب آن را به متن خالی plain text ست کنید. این مهم است زیرا بدون آن ایمیل خالی به نظر می رسد. پیکر بندی تنظیمات مانند زیر مشاهده میشود:

۸٫ مرحله بعدی تبدیل خروجی Xml وب سرویس به داده ای که در اکشن های دیگر (مانند مقادیر متنی فرآیند) می باشد. برای انجام این کار ما از اکشن Query XML استفاده میکنیم. دو Query XML استفاده شده است. یکی برای هر مقداری (variable) که میخواهیم ست کنیم.

ما این اطلاعات را توسط Xpath processing میگیریم. اولین اکشن Query XML را مانند زیر تنظیم کنید:

در اینجا فیلد ows_Data1 از وب سرویس برگشت داده میشود و در resultPart1 ذخیره میشود.

۹٫ دومین اکشن Query XML را عینا مثل قبل تنظیم کنید منتها بجای ows_Data1 از ows_Data2 استفاده کنید و بجای resutPart1 از resultPart2 استفاده کنید. اکشن را همانند شکل زیر پیکر بندی کنید:

۱۰٫ اکنون ما می توانیم از این مقادیر variable ها با logging کردن آنها در لیست تاریخچه استفاده کنیم. یک اکشن Log in History List بعنوان مرحله نهایی اضافه کنید. اکشن را مانند شکل زیر پیکر بندی کنید:

منبع

پاسخی بگذارید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *