لیست درختی — TreeList

فیلد لیست درختی (TreeList) در Form Builder GraphBPMS برای نمایش داده‌های یک Provider به‌صورت سلسله‌مراتبی استفاده می‌شود. طراح فرم می‌تواند منبع داده، ستون شناسه و والد، مدل نمایش، ستون‌های قابل نمایش، صفحه‌بندی، نحوه انتخاب، جستجو و در صورت نیاز عملیات درج، ویرایش و حذف را تنظیم کند. مدل نمایش نیز می‌تواند به‌صورت جدول داخل فرم یا به شکل SelectBox با جدول در Popup باشد.

اتصال داده و شکل نمایش TreeList

در بخش تنظیمات اتصال داده، Provider مربوط به TreeList تعیین می‌شود تا داده‌های مورد نیاز از آن خوانده و نمایش داده شوند.

پس از انتخاب Provider، چند گزینه برای ساخت رابطه درختی و کنترل اجرای منبع داده نمایش داده می‌شود:

• تنظیم شرط اجرا: شرطی اختیاری برای اجرای Provider است. اگر شرط تعریف شود، Provider فقط زمانی اجرا می‌شود که شرط برقرار باشد. اگر هیچ شرطی تنظیم نشود، Provider اجرا خواهد شد.
• انتخاب ستون شناسه: یکی از ستون‌های Provider به‌عنوان شناسه هر آیتم انتخاب می‌شود.
• انتخاب ستون والد: ستونی انتخاب می‌شود که شناسه پدر هر آیتم را نگه می‌دارد تا آیتم‌ها به‌صورت زیرمجموعه‌ای نمایش داده شوند.

انتخاب مدل نمایشی

مدل نمایشی TreeList دو حالت دارد:

↑ بازگشت به فهرست آموزش

ساخت ستون‌های قابل نمایش

بخش تنظیمات ستون‌ها فقط زمانی نمایش داده می‌شود که Provider مورد نظر انتخاب شده باشد. فهرست ستون‌ها در قالب Accordion نمایش داده می‌شود و هر ستون تنظیمات مستقل خود را دارد.

• عنوان ستون: عنوانی که برای ستون در TreeList نمایش داده می‌شود.
• ستون منبع داده: ستونی از Provider که داده آن در این ستون جدول نمایش داده می‌شود.
• اندازه ستون: یک مقدار عددی برای عرض ستون. واحد اندازه‌گیری در فیلد بعدی انتخاب می‌شود. مقدار 0 به معنی Auto است.
• قابلیت HTML Render: اگر فعال باشد، محتوای ستون به‌صورت HTML رندر می‌شود؛ در حالت غیرفعال، HTML Render انجام نمی‌شود.

↑ بازگشت به فهرست آموزش

کنترل صفحه‌بندی و نحوه نمایش لیست

صفحه‌بندی جدول

• صفحه‌بندی: مشخص می‌کند صفحه‌بندی جدول نمایشی فعال باشد یا خیر.
• تعداد در صفحه: تعداد آیتم‌هایی را تعیین می‌کند که در هر صفحه نمایش داده می‌شوند. این گزینه فقط زمانی نمایش داده می‌شود که صفحه‌بندی فعال باشد.

ارتفاع، باز بودن آیتم‌ها و جستجو

• ارتفاع: یک مقدار عددی برای ارتفاع TreeList است. مقدار 0 به معنی Auto است.
• آیتم‌ها به طور پیش‌فرض باز باشند: به‌طور پیش‌فرض همه آیتم‌های لیست درختی بسته‌اند. با فعال کردن این گزینه، همه آیتم‌ها باز نمایش داده می‌شوند.
• امکان جستجو در گرید: با فعال کردن این گزینه، یک Search Box در TreeList نمایش داده می‌شود تا کاربر بتواند در لیست جستجو کند.

↑ بازگشت به فهرست آموزش

انتخاب آیتم و واکنش به تغییر مقدار

• فراخوانی رخداد بعد از تغییر مقدار: با تغییر مقدار فیلد، فیلدها و رویدادهای انتخاب‌شده در این بخش دوباره اجرا می‌شوند.
• تنظیمات Selection: تعیین می‌کند قابلیت انتخاب آیتم برای ذخیره مقدار فعال باشد یا خیر.
  • غیرفعال: انتخاب آیتم فعال نیست.
  • تکی: کاربر می‌تواند یک آیتم را انتخاب کند.
  • چندتایی: کاربر می‌تواند چند آیتم را انتخاب کند.

↑ بازگشت به فهرست آموزش

مدیریت درج، ویرایش و حذف آیتم‌ها

در بخش تنظیمات افزودن آیتم جدید می‌توان مشخص کرد دکمه‌های درج، ویرایش و حذف برای آیتم‌های TreeList نمایش داده شوند یا خیر.

فعال‌سازی عملیات روی آیتم‌ها

• فعال کردن درج: در هدر TreeList و در هر یک از آیتم‌ها دکمه جدید نمایش داده می‌شود. با کلیک روی آن، فرم انتخاب‌شده باز می‌شود و به محض ثبت فرم، Provider لیست درختی Refresh خواهد شد.
• قابلیت ویرایش آیتم: کنار هر آیتم دکمه ویرایش نمایش داده می‌شود. کاربر با کلیک روی آن، فرم انتخاب‌شده را برای رکورد مورد نظر باز می‌کند و می‌تواند رکورد را ویرایش کند.
• قابلیت حذف آیتم: کنار هر آیتم دکمه حذف نمایش داده می‌شود و کاربر می‌تواند رکورد مورد نظر را حذف کند.

اتصال عملیات به فرم و رکورد

• فرم مورد نظر: فقط زمانی نمایش داده می‌شود که حداقل یکی از گزینه‌های فعال کردن درج، قابلیت ویرایش آیتم یا قابلیت حذف آیتم فعال باشد. در این گزینه، توسعه‌دهنده فرم مربوط به Provider انتخاب‌شده را تعیین می‌کند.
• کلید مورد نظر: ستونی از Provider انتخاب می‌شود که به‌عنوان کلید یا شناسه به فرم بازشده انتصاب داده می‌شود.
• فیلد مورد نظر جهت انتصاب Parent: فیلدی از فرم انتخاب‌شده تعیین می‌شود تا مقدار Parent به آن انتصاب داده شود. این گزینه فقط زمانی نمایش داده می‌شود که قابلیت ویرایش آیتم یا قابلیت حذف آیتم فعال باشد.

حذف زیرمجموعه‌ها به‌صورت Recursive

گزینه حذف به صورت Recursive فقط زمانی نمایش داده می‌شود که قابلیت حذف آیتم فعال باشد. با فعال بودن آن، حذف یک آیتم همراه با حذف همه زیرمجموعه‌های آن تا N لایه انجام می‌شود.

↑ بازگشت به فهرست آموزش

کنترل نحوه نمایش Popup

بخش تنظیمات نمایش Popup فقط زمانی نمایش داده می‌شود که حداقل یکی از گزینه‌های فعال کردن درج، قابلیت ویرایش آیتم یا قابلیت حذف آیتم فعال باشد. در این بخش می‌توان اندازه مدالی را که برای افزودن آیتم جدید یا ویرایش آیتم باز می‌شود تنظیم کرد.

استفاده از اندازه‌های آماده

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

• small
• medium
• large
• xlarge
• vertical
• verticalSmall
• horizontalSmall
• verticalkMeduim

تعریف اندازه سفارشی

اگر اندازه سفارشی فعال باشد، برای عرض و ارتفاع دو مجموعه فیلد نمایش داده می‌شود. در هر مجموعه، مقدار عددی و واحد اندازه‌گیری تعیین می‌شود. واحدها:

• px
• %

↑ بازگشت به فهرست آموزش