راه اندازی


طبق آنچه در قسمت پیشنیازهای نصب زی فریم بیان شد، برنامه هایJDK وNetBeans در کنار زی فریم باید نصب شده باشند. هنگامی که برنامه در زی فریم طراحی شد، باید برنامه NetBeans را اجرا کرد (محیط نرم افزار NetBeans در زیر نشان داده شده است) تا با استفاده از آن بتوان خروجی برنامه را در اکسپلورر مشاهده نمود.

زی فریم




زی فریم


نکته
پیش از نصب NetBeans ابتدا باید JDK بر روی سیستم نصب شده باشد. سپس NetBeans ترجیحا نسخه 8.2 نصب شود.

  
پس از اجرا شدنNetBeans، باید پروژه Workspace (همان پوشه ای که از وبسایت زی فریم دانلود و از حالت فشرده خارج شد) از طریق مسیر File >> Open Project باز شود. در این قسمت ابتدا باید وارد پوشه Workspace شده و سپس از میان دو پوشه ای که مشاهده می شود، پوشهZFAPP انتخاب و Open شود.

زی فریم

پس از باز کردن این پروژه، می توان محتویات داخل این پروژه را در پنجره Projects مشاهده نمود.

زی فریم

در صورت عدم مشاهده این پنجره، می توان آن را از طریق مسیر Windows >> Project فعال و مشاهده کرد.
  
  
اکنون پس از انجام پیکره بندی می توان پروژه را اجرا کرد. به همین منظور، کافیست تا بر روی دکمه RUN در نوار ابزار NetBeans کلیک شود تا پروژه اجرا گردد.

زی فریم

هنگام اجرای پروژه، سه برگه در پنجرهOutput باز می شود که نمایانگر روند اجرای پروژه است.

زی فریم

هنگامی که نرم افزار اجرا شود، داخل پنجره مرورگر، صفحه ای مشابه تصویر زیر قابل مشاهده خواهد بود.

زی فریم

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

کلمه عبور نام کاربری
Admin 123456

اکنون تنها یک مرحله باقی مانده است که باید انجام شود. پس از باز شدن محصول تولید شده در مرورگر، باید آدرس موجود در نوار آدرس این صفحه کپی شود.

زی فریم

سپس باید در نرم افزار ZIDE از طریق مسیر Windows >> Application Management وارد قسمت مدیریت سیستم و اپلیکیشن شد. سپس برنامه نویس باید پس از انتخاب اپلیکیشن مورد نظر (محصولی که در حال تولید آن است)، با زدن دکمه Edit Application وارد صفحه ویرایش اپلیکیشن شود.

زی فریم

در نهایت، آدرس کپی شده از نوار آدرس مرورگر را در قسمتApplication URL وارد کرده و ذخیره کنید.

نکته
آدرس نرم افزار باید بدون هیچ گونه زیر مجموعه ای وارد شود، مانند:

http://localhost:8080/ZFAPP/


نصب و راه اندازی زی فریم به پایان رسید، اکنون می توان از زی فریم برای تولید نرم افزار بهره برد.
  
طبق آنچه در قسمت پیشنیازهای نصب زی فریم بیان شد، برنامه هایJDK وNetBeans در کنار زی فریم باید نصب شده باشند. هنگامی که برنامه در زی فریم طراحی شد، باید برنامه NetBeans را اجرا کرد (محیط نرم افزار NetBeans در زیر نشان داده شده است) تا با استفاده از آن بتوان خروجی برنامه را در اکسپلورر مشاهده نمود.

زی فریم




زی فریم


نکته
پیش از نصب NetBeans ابتدا باید JDK بر روی سیستم نصب شده باشد. سپس NetBeans ترجیحا نسخه 8.2 نصب شود.

پس از اجرا شدنNetBeans، باید پروژه Workspace (همان پوشه ای که از وبسایت زی فریم دانلود و از حالت فشرده خارج شد) از طریق مسیر File >> Open Project باز شود. در این قسمت ابتدا باید وارد پوشه Workspace شده و سپس از میان دو پوشه ای که مشاهده می شود، پوشهZFAPP انتخاب و Open شود.

زی فریم

پس از باز کردن این پروژه، می توان محتویات داخل این پروژه را در پنجره Projects مشاهده نمود.

زی فریم

در صورت عدم مشاهده این پنجره، می توان آن را از طریق مسیر Windows >> Project فعال و مشاهده کرد.
اکنون پس از انجام پیکره بندی می توان پروژه را اجرا کرد. به همین منظور، کافیست تا بر روی دکمه RUN در نوار ابزار NetBeans کلیک شود تا پروژه اجرا گردد.

زی فریم

هنگام اجرای پروژه، سه برگه در پنجرهOutput باز می شود که نمایانگر روند اجرای پروژه است.

زی فریم

هنگامی که نرم افزار اجرا شود، داخل پنجره مرورگر، صفحه ای مشابه تصویر زیر قابل مشاهده خواهد بود.

زی فریم

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

کلمه عبور نام کاربری
Admin 123456

اکنون تنها یک مرحله باقی مانده است که باید انجام شود. پس از باز شدن محصول تولید شده در مرورگر، باید آدرس موجود در نوار آدرس این صفحه کپی شود.

زی فریم

سپس باید در نرم افزار ZIDE از طریق مسیر Windows >> Application Management وارد قسمت مدیریت سیستم و اپلیکیشن شد. سپس برنامه نویس باید پس از انتخاب اپلیکیشن مورد نظر (محصولی که در حال تولید آن است)، با زدن دکمه Edit Application وارد صفحه ویرایش اپلیکیشن شود.

زی فریم

در نهایت، آدرس کپی شده از نوار آدرس مرورگر را در قسمتApplication URL وارد کرده و ذخیره کنید.

نکته
آدرس نرم افزار باید بدون هیچ گونه زیر مجموعه ای وارد شود، مانند:

http://localhost:8080/ZFAPP/


نصب و راه اندازی زی فریم به پایان رسید، اکنون می توان از زی فریم برای تولید نرم افزار بهره برد.
در زی فریم از بسیاری از فرایندها و رخدادها همچون ذخیره اطلاعات فرم، ویرایش اطلاعات داخل فرم، حذف داده ها و ... به صورت پیشفرض لاگ گرفته شده و در داخل بانک اطلاعاتی مربوط به لاگ ذخیره می شود. با قرار دادن مقدارLogDisable برابر با عدد یک، می توان این قسمت را به طور کل غیر فعال نمود.
موارد ذیل بیانگر خصوصیات مربوط به اتصال بانک اطلاعاتی برای لاگ گرفتن است.
LogDisable = 0
LogConnectionPoolCount = 3
LogDataBaseTypeID = 1
LogDBUserName = sa
LogDBPassword = password
LogProjectConnectionString =jdbc:sqlserver://127.0.0.1:1433;databaseName=ZF_MD
LogMaxStatements = 100
LogMaxStatementsPerConnection = 0

تعداد اتصالات رزرو شده برای موتور اجرایی زی فریم و بانک اطلاعاتی جهت گرفتن لاگ در این قسمت تعریف می گردد. این مقدار به میزان درخواست، تعداد کاربر و همچنین منابع سخت افزاری بستگی دارد.
(پیشنهاد می شود تغییری در این مقدار صورت نگیرد)

FileDatabasePath =D:\myDBFile\

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

zframeotp = 1
csrfservertokenname = XCSRFTOKEN
csrfclienttokenname = CCSRFTOKEN

موارد فوق برای پیکره بندی موارد امنیتی زی فریم استفاده می شود که پیشنهاد می شود تغییری در این مقادیر صورت نگیرد. زیرا برای توصیف هرکدام نیاز به دانش امنیت نرم افزار و موارد دیگر است (در قسمت آموزش پیشرفته به آنها بیشتر پرداخته خواهد شد.)

  
در زی فریم از بسیاری از فرایندها و رخدادها همچون ذخیره اطلاعات فرم، ویرایش اطلاعات داخل فرم، حذف داده ها و ... به صورت پیشفرض لاگ گرفته شده و در داخل بانک اطلاعاتی مربوط به لاگ ذخیره می شود. با قرار دادن مقدارLogDisable برابر با عدد یک، می توان این قسمت را به طور کل غیر فعال نمود.
موارد ذیل بیانگر خصوصیات مربوط به اتصال بانک اطلاعاتی برای لاگ گرفتن است.
LogDisable = 0
LogConnectionPoolCount = 3
LogDataBaseTypeID = 1
LogDBUserName = sa
LogDBPassword = password
LogProjectConnectionString =jdbc:sqlserver://127.0.0.1:1433;databaseName=ZF_MD
LogMaxStatements = 100
LogMaxStatementsPerConnection = 0

تعداد اتصالات رزرو شده برای موتور اجرایی زی فریم و بانک اطلاعاتی جهت گرفتن لاگ در این قسمت تعریف می گردد. این مقدار به میزان درخواست، تعداد کاربر و همچنین منابع سخت افزاری بستگی دارد.
(پیشنهاد می شود تغییری در این مقدار صورت نگیرد)

FileDatabasePath =D:\myDBFile\

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

zframeotp = 1
csrfservertokenname = XCSRFTOKEN
csrfclienttokenname = CCSRFTOKEN

موارد فوق برای پیکره بندی موارد امنیتی زی فریم استفاده می شود که پیشنهاد می شود تغییری در این مقادیر صورت نگیرد. زیرا برای توصیف هرکدام نیاز به دانش امنیت نرم افزار و موارد دیگر است (در قسمت آموزش پیشرفته به آنها بیشتر پرداخته خواهد شد.)

  
×