ساخت فرم جدید و آشنایی با Studio
در GraphBPMS، پس از ایجاد فرم وارد Studio فرم‌ساز می‌شوید؛ محیطی برای تعریف هویت فرم، ظاهر نمایش، زبان، رفتار داده، رخدادهای عمومی و نحوه ارائه داده‌ها به کاربر نهایی. Studioهای GraphBPMS برای کار در محیط Desktop طراحی شده‌اند و با توجه به ماهیت طراحی و پیکربندی، برای Mobile View مناسب نیستند.
ورود به Studio و شناخت محیط طراحی
پس از کلیک روی ایجاد فرم، Studio فرم‌ساز باز می‌شود. Studioها در GraphBPMS دارای پنل‌های جانبی در سمت راست و چپ هستند و این الگوی پنل‌ها در Studio فرم‌ساز، گزارش‌ساز و فرایندساز نیز وجود دارد.
پنل‌ها قابلیت Pin / Unpin دارند. با Pin کردن، پنل در محل خود ثابت می‌ماند و در حالت Unpin می‌توان فضای کاری را آزادتر کرد. عرض پنل نیز قابل تغییر است؛ با جابه‌جایی مرز پنل می‌توانید آن را عریض‌تر یا باریک‌تر کنید.
تب‌های اصلی Studio فرم‌ساز
در پنل سمت راست، تب‌های تنظیمات فرم، ابزارها، ارتباطات فیلدها، تنظیمات سفارشی و تنظیمات موبایل در دسترس‌اند. تنظیمات عمومی خود فرم در همین Article توضیح داده می‌شود و جزئیات تب‌های تخصصی در Articleهای مستقل همان بخش‌ها قرار می‌گیرد.
در بالای فضای اصلی طراحی نیز دو تب طراحی و پیش‌نمایش قرار دارند. از طراحی برای ساخت و ویرایش فرم و از پیش‌نمایش برای مشاهده نتیجه استفاده می‌شود.
تعریف هویت و سازمان‌دهی فرم
در تب تنظیمات فرم، نام فنی، عنوان نمایشی، گروه فرم و سایر تنظیمات عمومی فرم تعریف می‌شوند.
نام‌گذاری فرم
نام لاتین: نام لاتین فرم را بدون فاصله، بدون کاراکترهای غیرمجاز و بدون حروف فارسی وارد کنید. اگر برای فرم جدول پایگاه داده ایجاد شود، نام این جدول از همین مقدار گرفته می‌شود؛ بنابراین قواعد نام‌گذاری باید رعایت شوند.
عنوان: عنوان نمایشی فرم می‌تواند فارسی یا انگلیسی باشد و محدودیت‌های نام لاتین را ندارد، زیرا این مقدار صرفاً عنوان فرم است.
گروه‌بندی برای حفظ نظم فرم‌ها
گروه: با افزایش تعداد فرم‌ها در زیرسیستم‌های مختلف، گروه‌بندی به منظم ماندن ساختار فرم‌ها کمک می‌کند. تعریف و مدیریت گروه‌ها در Article گروه‌بندی ماژول‌ها توضیح داده می‌شود.
کنترل ظاهر فرم و فیلدها
انتخاب لایه نمایش فرم
از بخش لایه‌ها، نحوه نمایش فرم و Form View را مشخص کنید.
| شماره | گزینه |
|---|---|
| 1 | پیش‌فرض (Default) |
| 2 | بدون پوسته (No template) |
| 3 | Flat (With header) |
| 4 | Card view (Header less) |
چهار تصویر زیر تفاوت ظاهری این لایه‌ها را نشان می‌دهند. محتوای داخلی فرم در نمونه‌ها به‌صورت محدود محو شده است تا متن فرم خوانده نشود و ساختار نمایش لایه‌ها قابل مقایسه بماند.
انتخاب مدل نمایش فیلدها
مدل نمایش شکل ظاهری فیلدهای فرم را تعیین می‌کند. در حالت پیش‌فرض سیستم، گزینه حاشیه‌دار انتخاب شده است.
| شماره | حالت | نحوه نمایش |
|---|---|---|
| 1 | حاشیه‌دار | حالت پیش‌فرض سیستم؛ فیلد با حاشیه کامل نمایش داده می‌شود. |
| 2 | زیرخط‌دار | حاشیه‌ها حذف می‌شوند و فقط خط زیرین فیلد باقی می‌ماند. |
| 3 | پرشده | فیلد با پس‌زمینه خاکستری نمایش داده می‌شود. |
مدیریت زبان و توضیحات فرم
تعیین زبان پیش‌فرض فرم
اگر زبان‌های جدید در هسته و موتور GraphBPMS تعریف شده باشند، زبان فرم نیز می‌تواند مستقل از زبان پیش‌فرض موتور تعریف شود. اگر یک فرم چند زبان داشته باشد، از زبان فرم برای تعیین زبان پیش‌فرض همان فرم استفاده کنید. در تصویر نمونه، مقدار فارسی انتخاب شده است.
ثبت توضیح برای شناخت بهتر فرم
در توضیحات، خلاصه‌ای از عملکرد و هدف فرم را بنویسید. این توضیح برای توسعه‌دهندگان یا طراحانی که بعداً فرم و ساختار آن را بررسی می‌کنند، مشخص می‌کند فرم چه ماهیتی دارد و برای چه منظوری ایجاد شده است.
کنترل اعتبارسنجی، تاریخچه و رفتار داده
این گروه از Switchها نحوه اعتبارسنجی، نگهداری تاریخچه، امضای داده، چندزبانه بودن و رابطه فرم با جدول پایگاه داده را کنترل می‌کند.
| شماره | تنظیم | رفتار |
|---|---|---|
| 1 | اعتبارسنجی سمت سرور | اگر برای فیلدهای فرم Validation فعال باشد، بررسی به‌صورت پیش‌فرض در سمت کلاینت انجام می‌شود. با فعال کردن این گزینه، Validationهای فیلدهای فرم در سمت سرور نیز بررسی می‌شوند تا کنترل داده با امنیت بالاتری انجام شود. |
| 2 | تاریخچه تغییرات داده‌های فرم | تمام تغییرات داده رکورد ثبت می‌شود. برای مثال، اگر فرم شامل «نام» و «کد ملی» باشد و یکی از این مقادیر در یک رکورد تغییر کند، سابقه مقدارهای تغییرکرده نگهداری می‌شود و مشخص می‌شود تغییر توسط چه کاربر و چه نقشی انجام شده است. به این ترتیب تاریخچه کامل مقادیر تغییرکرده هر رکورد قابل نگهداری است. |
| 3 | امضای دیجیتال | اگر از فیلد امضا در فرم استفاده شده باشد، با فعال کردن این گزینه امضا فقط نمایشی نیست؛ مقادیر رکورد فرم با کلیدهای عمومی و خصوصی مرتبط با امضا فریز می‌شوند و امکان تغییر داده‌های آن رکورد وجود نخواهد داشت. |
| 4 | چندزبانه | فرم می‌تواند مستقل از زبان پیش‌فرض موتور چند زبان داشته باشد؛ برای مثال، زبان موتور فارسی باشد اما فرم از فارسی، انگلیسی و عربی پشتیبانی کند. با فعال شدن این گزینه، دو تنظیم وابسته نمایش داده می‌شوند. |
| 4.1 | وابسته به زبان سیستم | با تغییر زبان موتور، زبان فرم نیز تغییر می‌کند؛ به شرط آنکه ترجمه آن زبان برای همان فرم انجام شده باشد. |
| 4.2 | امکان تغییر زبان توسط کاربر نهایی | کاربری که فرم را باز می‌کند می‌تواند زبان فرم را تغییر دهد. |
| 5 | فقط خواندنی | فرم امکان درج داده ندارد و فقط به‌صورت ReadOnly نمایش داده می‌شود. یکی از کاربردهای این حالت، فرم‌های بدون جدول است. |
| 6 | بدون جدول | در حالت معمول، برای هر فرم یک جدول متناظر در پایگاه داده ایجاد می‌شود. با فعال کردن این گزینه، فرم جدول پایگاه داده ندارد و صرفاً می‌تواند برای Interface، Landing Page و موارد مشابه استفاده شود. |
ورود ترجمه برای بخش‌های فرم
وقتی چندزبانه فعال باشد، برای زبان‌هایی که در موتور اصلی GraphBPMS تعریف شده‌اند، در بخش‌های قابل ترجمه Studio نشان زبان نمایش داده می‌شود تا معادل همان بخش برای هر زبان وارد شود. در تصویر نمونه نشان FA کنار چند فیلد دیده می‌شود.
ترجمه متن‌های داخلی کامپوننت‌ها
در فرم‌های چندزبانه، بعضی ابزارها و کامپوننت‌ها متن‌هایی دارند که Label یا Input معمولی فرم نیستند و باید جداگانه ترجمه شوند. این متن‌ها از ترجمه تنظیمات فرم برای همان فرم یک‌بار تنظیم می‌شوند.
پس از باز کردن این بخش، گروه‌های تنظیمات قابل ترجمه نمایش داده می‌شوند؛ از جمله گروه‌های مربوط به فیلد تاریخ، زمان، فایل، نقشه و فیلد تودرتو.
برای نمونه، فیلد تاریخ و تقویم متن‌هایی مانند ماه قبل، ماه بعد، انتخاب ماه و رفتن به امروز دارد. این متن‌ها در این بخش برای زبان‌های فرم مقداردهی می‌شوند.
در فیلد فایل نیز متن‌هایی مانند تعداد فایل‌های بارگذاری‌شده، فایل انتخاب‌شده، مشاهده فایل‌ها و وضعیت ارسال باید برای زبان‌های مورد استفاده فرم ترجمه شوند.
کنترل نحوه نمایش Popup
وقتی فرم به‌صورت Popup فراخوانی می‌شود، از تنظیمات نمایش Popup می‌توانید اندازه پیش‌فرض Popup فرم را مشخص کنید. در تصویر نمونه، اندازه آماده large انتخاب شده است.
با فعال کردن اندازه سفارشی، عرض و ارتفاع Popup به‌صورت اختصاصی تعیین می‌شوند. واحد اندازه‌گیری می‌تواند px یا % باشد.
اتصال رخدادها به چرخه فرم
اگر در فرم رخدادی تعریف شده باشد، بخش تنظیمات فراخوانی رویداد امکان اتصال آن رخداد را به چهار نقطه عمومی چرخه فرم فراهم می‌کند.
| شماره | رویداد | زمان فراخوانی |
|---|---|---|
| 1 | onLoad | هنگام لود شدن فرم. |
| 2 | onReady | پس از لود و هنگام آماده شدن فرم. |
| 3 | beforeSubmit | پیش از ارسال داده‌های فرم. |
| 4 | onSubmitSuccess | پس از ارسال موفق داده‌های فرم در سمت کلاینت. |
تعریف و مدیریت خود رخدادها در Article دکمه / رویداد — Button / Event توضیح داده می‌شود.
↑ بازگشت به فهرست آموزشپیکربندی فیلتر، جدول و لیست داده‌های فرم
شناخت ستون‌های سیستمی جدول فرم
وقتی گزینه بدون جدول فعال نیست، برای فرم یک جدول متناظر در پایگاه داده ایجاد می‌شود. علاوه بر فیلدهای خود فرم، ستون‌های سیستمی زیر نیز در جدول وجود دارند.
| ستون | کاربرد |
|---|---|
| Id | شناسه یکتای رکورد؛ کلید سیستمی است و مقدار آن در پایگاه داده به‌صورت افزایشی تنظیم می‌شود. |
| RegDate | تاریخ و زمان ثبت رکورد. |
| FK_UserId | شناسه کاربر ثبت‌کننده رکورد. |
| FK_OrganizationId | شناسه سازمان ثبت‌کننده رکورد؛ اگر نسخه چندسازمانی نباشد مقدار 1 درج می‌شود. |
| LastModifiedFK_OrganizationId | شناسه سازمان ویرایش‌کننده رکورد؛ اگر نسخه چندسازمانی نباشد مقدار 1 درج می‌شود. |
| FK_RoleId | شناسه نقش ثبت‌کننده رکورد. |
| LastModifiedDate | تاریخ آخرین ویرایش رکورد. |
| LastModifiedFK_UserId | شناسه کاربری که آخرین تغییر را انجام داده است. |
| LastModifiedFK_RoleId | شناسه نقش کاربری که آخرین تغییر را انجام داده است. |
تعیین فیلدهای سیستمی در فیلتر جستجو
در تنظیمات فیلترهای جستجو داده مشخص می‌کنید کدام اطلاعات سیستمی در فیلتر «لیست داده‌های فرم» برای کاربر یا نقش نهایی نمایش داده شوند.
| شماره | گزینه |
|---|---|
| 1 | نمایش تاریخ ثبت |
| 2 | نمایش کاربر ثبت‌کننده |
| 3 | نمایش نقش کاربر ثبت‌کننده |
| 4 | نمایش آخرین تاریخ ویرایش |
| 5 | نمایش آخرین کاربر ویرایش‌کننده |
| 6 | نمایش آخرین نقش کاربر ویرایش‌کننده |
تعیین ستون‌های سیستمی در جدول داده
تنظیمات جدول جستجو داده از نظر گزینه‌ها مشابه بخش فیلتر جستجو است، با این تفاوت که این Switchها نمایش همان اطلاعات را در جدول نمایش داده‌های فرم کنترل می‌کنند، نه در فیلتر جستجو.
تعیین تعداد رکوردهای اولیه لیست داده
در تنظیمات لیست داده‌های فرم مشخص می‌کنید وقتی فرم به کاربر یا نقش نهایی رونوشت شده و لیست داده‌ها باز می‌شود، به‌صورت پیش‌فرض چند رکورد آخر دریافت و نمایش داده شوند. در تصویر نمونه این مقدار 50 است.