فیلد فایل — File
فیلد File در Form Builder GraphBPMS برای دریافت و مدیریت فایل‌های پیوست در فرم استفاده می‌شود. این فیلد علاوه بر تعیین محل ذخیره‌سازی و شیوه نمایش فایل‌ها، تنظیمات اختصاصی برای آپلود همزمان یا تکه‌ای، Thumbnail، گرید فایل‌ها، ذخیره آفلاین، محدودیت نوع و تعداد فایل و پارامترهای مسیر ذخیره‌سازی دارد.
جایگاه فیلد File در Form Builder
فیلد File برای دریافت و نگهداری فایل‌های پیوست در فرم استفاده می‌شود. در Form Builder، این فیلد در گروه فیلدهای پیشرفته دیده می‌شود و پس از قرار گرفتن روی فرم، تنظیمات اختصاصی آن از پنل تنظیمات اختصاصی در دسترس است.
تنظیمات اختصاصی این فیلد، محل ذخیره‌سازی، شکل نمایش فایل‌ها، رفتار آپلود، محدودیت‌های تعداد و نوع فایل، Thumbnail، گرید فایل‌ها و سناریوی ذخیره آفلاین را کنترل می‌کنند.
↑ بازگشت به فهرست آموزشکنترل محل ذخیره‌سازی و نحوه نمایش فایل‌ها
ابتدا محل آرشیو فایل و شکل نمایش فایل‌های انتخاب‌شده در فیلد مشخص می‌شود.
- مسیر ذخیره‌سازی: محل آرشیو فایل‌های این فیلد را تعیین می‌کند.
- مدل نمایشی: دو حالت افقی و عمودی دارد. در حالت افقی، فایل‌های آپلودشده کنار دکمه آپلود نمایش داده می‌شوند و ارتفاع فیلد فایل تغییر نمی‌کند. در حالت عمودی، فایل‌های انتخاب‌شده به‌صورت فهرست زیر هم قرار می‌گیرند؛ با افزایش تعداد فایل‌ها، ارتفاع فیلد بیشتر می‌شود و چیدمان فیلدهای مجاور می‌تواند تغییر کند.
رفتار آپلود، تغییر مقدار و تعداد کل فایل‌ها
این گروه از تنظیمات مشخص می‌کند فایل‌ها با چه الگویی ارسال شوند و پس از تغییر مقدار فیلد چه وابستگی‌هایی دوباره اجرا شوند.
- فراخوانی رخداد بعد از تغییر مقدار: پس از تغییر مقدار فیلد، از جمله آپلود فایل یا حذف فایل، فیلدها و رخدادهای انتخاب‌شده در این بخش دوباره اجرا می‌شوند.
- آپلود فایل‌ها به‌صورت همزمان: اگر فعال باشد، فایل‌ها همزمان به سرور ارسال می‌شوند. اگر غیرفعال باشد، فایل‌ها به‌ترتیب ارسال می‌شوند و آپلود فایل بعدی پس از پایان آپلود فایل قبلی شروع می‌شود.
- حداقل تعداد فایل کلی: کمترین تعداد فایل لازم را تعیین می‌کند. مقدار 0 یعنی حداقل تعداد اعمال نمی‌شود.
- حداکثر تعداد فایل کلی: بیشترین تعداد فایل را تعیین می‌کند. مقدار 0 یعنی محدودیت تعداد اعمال نمی‌شود.
بارگذاری فایل‌های حجیم به‌صورت تکه‌ای
برای فایل‌های حجیم می‌توان ارسال فایل را به حالت تکه‌تکه فعال کرد تا فایل در چند بخش ارسال شود.
- فعال‌سازی: به‌صورت پیش‌فرض ارسال فایل تکه‌تکه انجام نمی‌شود. با فعال کردن این گزینه، ارسال فایل به‌صورت تکه‌ای انجام می‌شود و دو گزینه دیگر نمایش داده می‌شوند.
- واحد اندازه‌گیری: واحد فیلد حجم هر تکه را مشخص می‌کند. واحد می‌تواند بایت، کیلوبایت یا مگابایت باشد.
- حجم مورد نظر: حجم هر تکه را تعیین می‌کند. حداقل مقدار 1KB و حداکثر مقدار 100000KB است.
انتخاب روش ساخت Thumbnail
در بخش ThumbNail گزینه‌ای وجود دارد که تعیین می‌کند Thumbnail فایل بر اساس کدام تنظیم ساخته شود.
با انتخاب گزینه موردنظر، Thumbnail بر اساس همان انتخاب ساخته می‌شود. فهرست نمایش‌داده‌شده شامل Thumbnail پیش‌فرض (128×128)، Thumbnail 3 (100×100) و Thumbnail 5 (200×200) است.
↑ بازگشت به فهرست آموزشمرتبسازی و ستون‌های گرید فایل‌ها
در خروجی فیلد فایل، دکمه‌ای وجود دارد که با آن می‌توان فایل‌های آپلودشده را در قالب Data Grid مشاهده کرد. تنظیمات این بخش ترتیب ردیف‌ها و ستون‌های قابل نمایش را کنترل می‌کنند.
کنترل ترتیب نمایش فایل‌ها
مرتب‌سازی به‌صورت پیش‌فرض غیرفعال است. در این حالت، فایل‌ها به ترتیب آپلود نمایش داده می‌شوند. با فعال‌سازی مرتب‌سازی، دو فیلد در دسترس قرار می‌گیرد:
- نوع مرتب‌سازی: می‌تواند صعودی یا نزولی باشد.
- مرتب‌سازی بر اساس: مبنای مرتب‌سازی را از بین شناسه، نام فایل و اندازه (حجم) فایل تعیین می‌کند.
انتخاب ستون‌های قابل نمایش
هر یک از ستون‌های زیر به‌صورت مستقل قابل نمایش یا مخفی‌کردن است:
- نمایش ستون نام فایل: در حالت فعال، ستون نام فایل نمایش داده می‌شود و در حالت غیرفعال نمایش داده نمی‌شود.
- نمایش ستون آرشیو کد: در حالت فعال، ستون آرشیو کد نمایش داده می‌شود و در حالت غیرفعال نمایش داده نمی‌شود.
- نمایش ستون تگ‌ها: در حالت فعال، ستون تگ‌ها نمایش داده می‌شود و در حالت غیرفعال نمایش داده نمی‌شود.
- نمایش ستون Thumbnail: در حالت فعال، ستون Thumbnail نمایش داده می‌شود و در حالت غیرفعال نمایش داده نمی‌شود.
- نمایش ستون حجم فایل: در حالت فعال، ستون حجم فایل نمایش داده می‌شود و در حالت غیرفعال نمایش داده نمی‌شود.
ذخیره آفلاین فایل در Task
ذخیره آفلاین برای زمانی است که کاربر فرم را در قالب Task باز کرده و دسترسی به اینترنت ندارد، در حالی که حالت آفلاین Task فعال است.
- با فعال بودن ذخیره آفلاین و نبود دسترسی به اینترنت، فایل به‌صورت Local روی دستگاه کاربر ذخیره می‌شود.
- پس از دسترسی دوباره به اینترنت، زمانی که کاربر رکورد ثبت‌شده را به سرور ارسال می‌کند، فایل نیز در همان زمان آپلود می‌شود.
تعریف فایل‌های مجاز و کنترل تعداد فایل‌ها
در بخش تعریف فایل‌های مجاز مشخص می‌شود چه نوع فایل‌هایی اجازه آپلود دارند و برای هر نوع چه محدودیت‌هایی اعمال شود.
- نوع فایل: یکی از گزینه‌های Image، Video، Audio یا File است.
- تعداد حداقل مجاز: کمترین تعداد لازم برای همان نوع فایل را تعیین می‌کند. مقدار 0 یعنی حداقل اعمال نمی‌شود.
- تعداد حداکثر مجاز: بیشترین تعداد مجاز برای همان نوع فایل را تعیین می‌کند. مقدار 0 یعنی حداکثر اعمال نمی‌شود.
- پسوندهای مجاز: پسوندهایی را تعیین می‌کند که کاربر اجازه آپلود آن‌ها را دارد. فهرست پسوندها بر اساس نوع فایل انتخاب‌شده نمایش داده می‌شود.
- حجم فایل: حداکثر حجم هر فایل را بر حسب کیلوبایت تعیین می‌کند. اگر این مقدار خالی باشد، محدودیت حجم اعمال نمی‌شود.
نمونه تعریف ثبت‌شده برای Image
- پسوندهای مجاز نمونه Image:
gif،png،jpeg،jpg،nef،cr2،bmp،tif،raw وdng. - گالری: خیر.
- دوربین: خیر.
- حداقل تعداد: نامحدود.
- حداکثر تعداد: نامحدود.
- حداکثر حجم مجاز هر فایل: نامحدود.
- عرض رزولوشن: مقادیر 1024 و 0 در تعریف ثبت‌شده نمایش داده می‌شوند.
- ارتفاع رزولوشن: مقادیر 768 و 0 در تعریف ثبت‌شده نمایش داده می‌شوند.
- دوربین جلو: خیر.
- دوربین عقب: خیر.
رفتار فیلد اجباری
اگر فیلد فایل اجباری باشد، باید حداقل یک فایل در فیلد وجود داشته باشد.
↑ بازگشت به فهرست آموزشارسال پارامتر به مسیر ذخیره‌سازی
بعضی مسیرهای ذخیره‌سازی به پارامتر نیاز دارند. در این حالت، بخش مربوط به پارامترهای مسیر ذخیره‌سازی نمایش داده می‌شود.
کاربر می‌تواند با Formula Builder فرمول موردنیاز را بسازد و مقدار حاصل را به مسیر ذخیره‌سازی ارسال کند. در نمونه رابط کاربری، پارامتر DynamicFilePath در بخش تنظیمات ذخیره‌سازی دیده می‌شود.