• سرویس نویسی در زی فریم
  • تست وب سرویس با SoapUI

برای نوشتن یک سرویس در زی فریم مراحل زیر را به ترتیب انجام دهید.
ابتدا وارد برنامه زی فریم شوید.

 

کاربرد وب سرویس

 

در نوار ابزار بالا بر روی گزینه REST API List کلیک کنید تا وارد Web Api Manager شوید.

 

کاربرد وب سرویس

 

در این پنجره لیست تمام وب سرویس های نوشته شده در اپلیکیشن شما نمایش داده می­ شود. برای مثال در تصویر زیر یک وب سرویس با نام getallcourse نوشته شده است.

 

کاربرد وب سرویس

 

در پنجره باز شده (Web Api Manager) دکمه هایی برای مدیریت وب سرویس ها وجود دارد.

 

کاربرد وب سرویس

 

New Function: با استفاده از این دکمه می­ توان یک وب سرویس جدید ایجاد کرد.

Refresh: با استفاده از این دکمه می­توان لیست وب سرویس های موجود را بروزرسانی نمود تا اخرین تغییرات اعمال شده نمایش داده شود.

Test Api: با استفاده از این دکمه می­توان وب سرویس ها را مورد ازمایش و بررسی قرار داد.

Request Header: با استفاده از این دکمه می توان به Request Header های سرویس دسترسی داشت. به علاوه میتوان Request Header ها را ذخیره و یا بارگذاری کرد.

برای درک بهتر نحوه ایجاد و تست یک وب سرویس فرض کنید می خواهیم اطلاعاتی را با استفاده از یک سرویس به یکی از جداول موجود در دیتابیس وارد کنیم. در مرحله اول از قسمت نوار ابزار برنامه زی فریم گزینه Table Data را باز کنید.

 

کاربرد وب سرویس

 

سپس جدول مورد نظر خود را از پنجره DataBase Explorer انتخاب کنید تا اطلاعات مربوط به آن درون پنجره Table Data نشان داده شود. در این پنجره یک کوئری INSERT و UPDATE برای جدول انتخاب شده نوشته شده است.

 

کاربرد وب سرویس

 

کوئری INSERT را انتخاب کرده و آن را کپی کنید.

 

کاربرد وب سرویس

 

حال وارد پنجره Web Api Manager شده و بر روی دکمه New Function کلیک کنید تا پنجرهREST Function باز شود.

 

کاربرد وب سرویس

 

(در این پنجره گزینه ها و ابزارهای مختلفی برای مدیریت وب سرویس ها وجود دارد. برای آشنایی بیشتر با این ابزارها به مقاله معرفی ابزارهای REST Function مراجعه کنید.) در قسمت Function Name نام وب سرویس مورد نظر و در قسمت Base Url Address آدرس دلخواه برای آن را وارد کنید (در این مثال نام وب سرویس را Add و آدرس آن را در فولدر Person در نظر گرفتیم.)

 

کاربرد وب سرویس

 

سپس متد POST را در قسمت Call Method انتخاب کرده و کوئری INSERT که کپی کرده بودید را در قسمت Query قرار دهید.

 

کاربرد وب سرویس

 
برای درک علت انتخاب متد POST در بخش Call method و آشنایی با انواع متدها، مقاله انواع متد های مورد استفاده در وب سرویس را مطالعه کنید.

حال بر روی گزینه Apply کلیک کنید تا تغییرات اعمال شود.

 
بعد از تعریف وب سرویس و یا اعمال تغییرات حتما از Clear Cache استفاده کنید تا سرویس اجرا شده و خروجی لازم هنگام تست سرویس نمایش داده شود.
 
اگر وب سرویس شما دارای پارامتر است، حتما یکبار بر روی دکمه Parameter کلیک کنید تا از وجود پارامتر های وب سرویس اطمینان حاصل کنید.

در پنجره Web Api Manager وب سرویس ساخته شده را انتخاب کنید. سپس در پنجره باز شده (REST Function) بر روی Test Api کلیک کنید تا پنجره Test Rest Api نمایش داده شود.صفحه دانلود زی

 

در این پنجره مقدار Url Address را کپی کنید.

 

صفحه دانلود زی

حال وارد برنامه SoapUI شده و در نوار ابزار بالا بر روی گزینه REST کلیک کنید. با اینکار یک سرویس REST جدید ایجاد می شود.

صفحه دانلود زی

آدرس کپی شده را در پنجره باز شده و در قسمت URL جایگذاری کرده و بر روی دکمه ok کلیک کنید.

صفحه دانلود زی

 

بعد از این کار، پنجره Request 1 نمایش داده می شود. توجه کنید که متد موجود در برنامه SoapUI و متد انتخاب شده در وب سرویس زی فریم باید یکسان باشند. بنابراین در این قسمت نیز همانند وب سرویس ساخته شده در زی فریم، متد Post را انتخاب کنید.

صفحه دانلود زی

 

در این مرحله نیاز به کد مناسبی برای وارد نمودن اطلاعات داریم. برای به دست اوردن این کد، وارد زی فریم شده و در پنجره Test Rest Api متن داخل قسمت Function Input را کپی کنید.

صفحه دانلود زی

 

مقادیر کپی شده را مانند شکل زیر در برنامه SoapUI قرار دهید.

 

صفحه دانلود زی

 

سپس اطلاعاتی که می خواهید به عنوان ورودی به سرویس دهید تا وارد جدول دیتابیس شوند را درون دابل کوتیشن ها (به جای علامت سوال) قرار دهید.

 

صفحه دانلود زی

زمان اجرای وب سرویس است.

برای این کار بر روی دکمه که همان Submit request to specified endpoint URL است، کلیک کنید. بعد از اجرا شدن وب سرویس، اگر JSON را در نوار اجرا کننده انتخاب کنید، با پیام زیر مواجه خواهید شد.

"EXECUTE_UPDATE_INSERT_SUCCESS"

 

که به معنای آن است که درخواست با موفقیت اجرا شده است.

 

صفحه دانلود زی

 

حال به دیتابیس مراجعه کنید، مشاهده خواهید کرد که اطلاعات وارد شده، در دیتابیس با موفقیت قرار گرفته اند.

صفحه دانلود زی

استفاده از سرویس در فرم های ساخته شده توسط زی فریم

برای استفاده از وب سرویس ساخته شده (در مثال ذکر شده: وب سرویس ADD)، در فرم های زی فریم به صورت زیر عمل می کنیم.
در فرم PERSON یک دکمه قرار می دهیم تا با کلیک بر روی آن، اطلاعات وارد شده در فرم PERSON با استفاده از وب سرویس در جدول PERSON درون دیتابیس ذخیره شود (دقیقا همان کاری که درون Soap UI انجام دادیم، این بار با فرم های زی فریم انجام خواهد شد).
ابتدا با ایجاد یک ClientButton، یک دکمه به فرم ساخته شده توسط زی فریم اضافه کنید (برای یادگیری نحوه ایجاد یک کنترل جدید به آموزش روش ساخت و مدیریت کنترل ها در زی فریم مراجعه شود.) و در قسمت caption نام آن را "ذخیره" (و یا هر نام دلخواه دیگر) قرار دهید.

صفحه دانلود زی

پس از ساخت یک دکمه جدید، به پنجره Web Api Manager باز گشته و سرویس ساخته شده (در این مثال add) را باز کنید.
سپس در پنجره REST Function بر روی دکمه JScript Code کلیک کنید تا پنجرهJava Script Call Function For REST API باز شود.

صفحه دانلود زی

در این پنجره، وب سرویس به صورت یک کد جاوا اسکریپتی به کاربر ارائه می شود.


این کد را کپی کنید.
وارد بخشJava Script Code فرم مورد نظر خود (در این مثال فرم PERSON) شوید.

صفحه دانلود زی

 

کد کپی شده را در این قسمت قرار دهید.

صفحه دانلود زی

 

حالا کد جاوا اسکریپت زیر را به این قسمت اضافه کنید.

 

 
async function FillParamAndSave () {
var C_FirstName = GetControlByName("FirstName");
var C_LastName = GetControlByName("LastName");
var C_Is_Active = GetControlByName("Is_Active");
var C_BDate = GetControlByName("BDate");
var C_National_Code = GetControlByName("National_Code");
var C_Postal_Code = GetControlByName("Postal_Code");
let rt = await call_add (C_FirstName.value ,C_LastName.value ,C_Is_Active.value , C_BDate.value, C_National_Code.value, C_Postal_Code.value) }

 

صفحه دانلود زی

 

بر روی دکمه Save کلیک کنید تا کدهای جاوااسکریپت درون این فرم ذخیره شود.
در کنترل فرم PERSON بر روی دکمه ای که ساخته بودید کلیک راست کرده و از گزینه های نمایش داده شده Java Script Call Function را انتخاب کنید تا پنجره Java Script Events باز شود.

صفحه دانلود زی

 

در قسمت Control Event List بر روی ایونت onclick دابل کلیک کرده تا کد onclick = “ ” در قسمت Java Script Function Call قرار گیرد. بین دابل کوتیشن نام تابع نوشته شده در جاوا اسکریپت (در این مثال FillParamAndSave) را نوشته و بر روی دکمه ok کلیک کنید.

صفحه دانلود زی

 

حالا در خروجی نرم افزار، اطلاعات جدیدی در فرم "اشخاص" قرار داده و بر روی دکمه "ذخیره" کلیک کنید.

صفحه دانلود زی

 

در صورتی که اطلاعات وارد شده در فرم، درون جدول PERSON موجود در دیتابیس قابل مشاهده باشند، دکمه و وب سرویس مربوط به آن به درستی ساخته شده اند.

صفحه دانلود زی

 

همانطور که توسط یک وب سرویس توانستیم اطلاعات یک فرم را درون دیتابیس ذخیره کنیم، می توان اطلاعات موجود در دیتابیس را نیز با استفاده از یک وب سرویس دریافت کرد (برای یادگیری دریافت اطلاعات با استفاده از وب سرویس به آموزش دریافت داده به صورت JSON با استفاده از وب سرویس مراجعه شود).

best tracker