Query و Paging

6. Provider از نوع Query

Query Provider برای واکشی اطلاعات استفاده می‌شود و این نوع Provider برای Queryهای SELECT است؛ دستورات INSERT، UPDATE و DELETE برای این نوع در نظر گرفته نشده‌اند.

برای عملیات تغییردهنده داده، از روش مناسب‌تری مانند StoredProcedure یا ویرایشگر پیشرفته استفاده شود.

6.1. ساخت Query

در مرحله مدیریت Query، QueryBuilder گرافیکی نمایش داده می‌شود. در UI جاری می‌توان Database و Table/View را انتخاب کرد، Fieldها را به Query اضافه کرد، Filter و Sort تعریف کرد، Query تولیدشده را مشاهده و آن را تست کرد.

6.2. پارامتر Query

اگر Query حاوی پارامتر باشد، سیستم پارامترها را استخراج کرده و در مرحله «لیست پارامترها» نمایش می‌دهد.

مثال:

SELECT
    Id,
    CityName
FROM Abfa_City
WHERE StateId = @StateId;

پارامتر:

StateId

هنگام Test باید مقدار آزمایشی مناسب وارد شود.

6.3. فیلدهای خروجی

پس از تست موفق، GraphBPMS Schema خروجی را استخراج می‌کند و فیلدهای Provider ثبت می‌شوند.

مثال:

Id
CityName
StateId

7. Paging در Query Provider

تصاویر Query Builder، Paging و خروجی Query

در UI جاری Query Provider تنظیمات اصلی زیر دیده می‌شوند:

• فعال‌سازی Paging
• Page Size پیش‌فرض
• نام ستون کلید
• استفاده از پارامترها برای Paging
• پارامتر Page Number
• پارامتر Page Size
• پارامتر Global Filter
• پارامترهای فیلتر ستونی
• پارامترهای Sort

7.1. Paging بدون پارامترهای Query

در این حالت Provider از Paging داخلی استفاده می‌کند و Key Column لازم است.

Paging Enabled: true
Default Page Size: 10
Key Column: Id

7.2. Paging مبتنی بر پارامتر

در این حالت Query خودش پارامترهای Paging را دریافت می‌کند.

@PageNumber
@PageSize
@GlobalFilter
@FilterColumn
@SortColumn1
@SortValue1

نمونه SQL Server:

SELECT
    Id,
    CityName,
    StateId
FROM Abfa_City
WHERE
    (
        @GlobalFilter IS NULL
        OR CityName LIKE N'%' + @GlobalFilter + N'%'
    )
ORDER BY Id
OFFSET ((@PageNumber - 1) * @PageSize) ROWS
FETCH NEXT @PageSize ROWS ONLY;