بلاگ

آخرین خبر ها و آپدیت ها

نمایش عنوان به جای شناسه در کامپوننت کمبو در صفحات

مشکل
تمام افرادی که فرم‌های شامل فیلد لیست مقادیر(LOV) در صفحات وب ایجاد کرده اند با این مساله روبرو بوده‌اند که کامپوننت کمبو استفاده شده برای این‌گونه فیلدها شناسه را به جای یک عنوان نشان می‌دهد.راه حل
در این مقاله راه‌حلی ارائه می‌گردد تا عنوان به جای شناسه انتخاب شده از لیست مقادیر نشان داده شود. به طور کلی از یک فیلد کمکی دیگر که به صورت موقت (transient) تعریف شده است استفاده می‌کنیم. مقدار این فیلد را درفرم در اختیار قرار می‌دهیم تا آن را تغییر دهد و با تغییر آن در پس زمینه مقدار فیلد اصلی تغییر داد می‌شود.

توضیح راه حل
برای ارائه این راه حل از مثال معروف کارمند و دپارتمان استفاده می‌نماییم. در این مثال فیلد انتخاب دپارتمان در فرم کارمند را با استفاده از این روش درست می‌نماییم تا عنوان دپارتمان به جای شناسه آن در فرم کارمند نمایش داده شود.
http://blogs.oracle.com/adf/resource/adf-faces/Combo_LOV.png

در ابتدا یک فیلد موقت(transient) به ویو کارمند اضافه نمایید.

http://blogs.oracle.com/adf/resource/adf-faces/Transient_Dname_Attr.png

یک لیست مقادیر کمبو بر اساس هر دو فیلد اسم دپارتمان و شناسه آن ایجاد کنید. استفاده از شناسه دپارتمان به ما برای مقداردهی کردن فیلد اصلی شناسه دپارتمان در رکورد کارمند کمک می‌کند.
برای لیست دیتا سورس از یک عنوان خوب و خوانا استفاده کنید و آنرا به خاطر بسپارید. به عنوان مثال DeptViewAccessor همانند تصویر زیر

در پایان عبارت groovy داخل تصویر را به عنوان مقدار پیش فرض فیلد موقت ایجاد شده در مراحل قبل قرار دهید.

افرادی که دوست ندارند از groovy استفاده نمایند می‌توانند کلاس جاوای آنرا پیاده‌سازی و کد بالا را در متد set فیلد موقت قرار دهند

حال دیگر باید پس از اجرا عنوان دپارتمان را به جای شناسه آن ملاحظه نمایید و با تغییر آن دپارتمان نیز به صورت خودکار برای کارمند تغییر نماید.

منبع

فایل پیوست:
ComboLOV.zip
خواندن بیشتر
royal visionنمایش عنوان به جای شناسه در کامپوننت کمبو در صفحات

نحوه نمایش یک task flow

در این مقاله قصد دارم نحوه نمایش یک task flow را به صورت دیالوگ در صفحه به شما آموزش بدم. برای این کار نیاز به یک صفحه و یک task flow داریم. در صفحه دکمه‌ای قرار می‌دهیم تا task flow را به صورت دیالوگ باز نماید.
ابتدا صفحه ای با نام main ایجاد می‌نماییم.
http://hamgam.persiangig.com/image/prs/createPage.pngسپس یک دکمه با action برابر asDialog در صفحه قرار می‌دهیم و سایر ويژگی‌های دکمه را همانند تصویر زیر تنظیم ‌می‌نماییمhttp://hamgam.persiangig.com/image/prs/setButtonProperty.pngدر مرحله بعد یک task flow ایجاد می‌نماییم که شامل یک صفحه خواهد بود. صفحه مذکور شامل یک دکمه بازگشت می‌باشد که action آن برابر با Return قرار گرفته شده است. Task flow را همانند تصویر زیر آماده نماییدhttp://hamgam.persiangig.com/image/prs/taskflow.png

حال صفحه main و task flow ساخته شده را در adfc-config قرار دهید.

سپس task flow قرار گرفته در adfc-config را انتخاب نمایید و ویژگی‌های آن را  تنظیم نمایید.

حال صفحه main را اجرا نمایید و نتیجه را ملاحظه نماییدhttp://hamgam.persiangig.com/image/prs/result.png

فایل پیوست:
دانلود پیوستذانلود
خواندن بیشتر
royal visionنحوه نمایش یک task flow

نحوه فعال سازی ADF Security

در این مقاله در چند گام ساده نحوه فعال سازی ADF Security در برنامه‌های تحت وب ADF را تشریح می‌نمایم. مثال استفاده شده برای این مقاله به این شرح می‌باشد که یک task flow ساده که شامل یک صفحه می‌باشد را ایجاد نموده و پس از آن یک role به نام myRole در ADF Security ایجاد نموده و task flow را برای افرادی که این role را دارند مجاز می‌نماییم. سپس یک کاربر به نام usr برای ورود ایجاد می‌نماییم و به آن مجوز myRole را اختصاص می‌دهیم تا بتواند task flow را اجرا نماید.

شرح
۱. ابتدا پروژه را ایجاد و task flow با نام secureTF ایجاد می‌نماییم. دقت فرمایید که این task flow از نوع bounded task flow می‌باشد. سپس یک صفحه نیز با نام main ایجاد می‌نماییم و درون secureTF قرار می‌دهیم.

۲. حال نوبت آن شده تا ADF Security را فعال نماییم. برای این منظور همانند تصویر زیر از application menu گزینه Secure منوی Configure ADF Security را کلیک نمایید تا ویزارد مخصوص برای فعال‌سازی ADF Security اجرا گردد

ویزارد فعال سازی ADF Security

۳. در مرحله اول گزینه پیش فرض آن را بدون تغییر باقی گذاشته و دکمه Next را میزنیم. در مرحله بعد برنامه تحت وبی را که می‌خواهیم برای آن ورود و خروج قرار دهیم را باید انتخاب نموده و پس از آن نوع مکانیسم اعتبارسنجی مورد استفاده را مشخص نماییم. در نوع اعتبارسنجی همانند تصویر زیر گزینه Form-Based Authentication را انتخاب می‌نماییم و گزینه Generate Default Pages را در حالت انتخاب قرار می‌دهیم. این گزینه باعث می‌شود تا فرم ورود و فرم خطا در ورود پیش فرض به صورت خودکار ساخته شود. سپس دکمه Next را کلیک می‌نماییم.

۴. این مرحله این امکان را می‌دهد تا به صورت خودکار بتوان به تمام صفحات و task flowهای موجود در برنامه مجوزدهی کرد که ما انتخاب اول آن را تغییر نداده تا خودمان به صورت دستی این مجوزدهی را با توجه به نیازمان انجام دهیم. دکمه Next را برای رفتن به مرحله بعد کلیک نمایید.

۵. در این مرحله می‌توان تنظیم کرد که پس از ورود موفق کاربر، او را به یک صفحه خاص مثلا صفحه اصلی برنامه فرستاد. ما این قسمت را به صورت پیش فرض رها کرده و این امکان را فعال نخواهیم کرد تا مکانیسم پیش‌فرض ADF پس از ورود موفق کاربر را بر هم نزنیم. ADF به صورت پیش فرض کاربر را مجددا به همان صفحه‌ای که از آنجا برای ورود به صفحه ورود هدایت شده، باز می‌گرداند.کلیک دکمه Next برای ورود به مرحله بعد تنها کاریست که باید انجام دهید.

۶. در این مرحله خلاصه‌ای از اتفاقاتی که قرار است با زدن دکمه Finish رخ دهد را برای شما به نمایش می‌گذارد. دکمه finish را کلیک نمایید تا تغییرات نهایی و ADF Security فعال گردد.

۷. پس از فعال‌سازی ADF Security نوبت به تنظیم آن با توجه به نیازمان می‌باشد. در ابتدا باید یک role با نام myRole ایجاد نماییم. برای این کار از منوی application menu داخل گزینه Secure منوی Application Roles را کلیک نمایید تا صفحه مربوطه باز گردد.

۸. با زدن دکمه مثبت سبز رنگ (‌شماره یک در تصویر) یک role جدید ایجاد نموده و عنوان ( شماره دو در تصویر)آن‌را به myRole و یا هرچیز دیگری که مایل هستید تغییر دهید و یا مقدار آنرا بدون تغییر رها کنید.

۹. برای ورود به برنامه نیاز به یک نام کاربری و رمز عبور داریم که برای ایجاد آن باید از Application Menu در گزینه Secure منوی Users را کلیک نماییم تا صفحه مربوطه باز شود.

۱۰. دکمه مثبت سبز ( شماره یک در تصویر زیر ) را کلیک نمایید تا کاربر جدید ایجاد گردد. نام کاربری(شماره دو در تصویر زیر) usr (دلخواه بوده و هرچیز دیگری می‌تواند باشد) را برای آن وارد نمایید . رمز عبور را نیز وارد نموده و در انتها دکمه مثبت سبز ( شماره سه در تصویر) را کلیک نموده و role که در مرحله قبل ایجاد کردید را برای کاربر انتخاب نمایید.

۱1. در انتها باید منابع برنامه را با توجه به سیاست‌های امنیتی مورد نیاز مجوزدهی نمود . در این برنامه ما تنها یک role و یک task flow داریم و تنها تنظیمی که لازم می‌باشد دادن مجوز اجرای task flow به کسانی که مجوز myRole را دارند. برای این کار از Application Menu و گزینه Secure منوی ADF Policies را کلیک نمایید تا صفحه مربوطه باز شود.

۱۲. درtask flow ساخته شده را در صفحه باز شده ملاحظه خواهید نمود. آن را انتخاب نمایید و دکمه مثبت سبز(شماره یک در تصویر) را کلیک نمایید. لیست تمام roleهای موجود در برنامه چه آنهایی که خودتان ساخته‌اید و یا به صورت پیش فرض وجود دارند نمایش داده می‌شود. myRole را انتخاب نمایید تا task flow توسط کاربرانی که این مجوز را دارند قابل اجرا گردد.

تبریک می‌گویم تمام مراحل را به خوبی به پایان رساندید و حال کافیست برنامه را اجرا نمایید و ملاحظه نمایید که برنامه در ابتدا از شما نام کاربری و رمزعبور میخواهد و سپس صفحه main را به شما نمایش می‌دهد. دقت نمایید که برای اجرا بر روی main درون SecureTF کلیک نموده و اجرا را کلیک نمایید.

برای تست صحت عملکرد myRole را از کاربر خود بگیرد یا به عبارت دیگر آنرا از لیست roleهای کاربر در منوی Users گزینه Secure حذف نمایید و سپس برنامه را اجرا نمایید و با تصویر زیر یا به عبارت دقیق‌تر با خطای زیر روبرو خواهید شد.

نکته آخر اینکه برای حذف ADF Security کافیست همانند مرحله ۲ ویزارد آنرا اجرا نمایید و این بار گزینه آخر Remove ADF Security Configuration را انتخاب نمایید و دکمه Finish را کلیک نمایید تا تمام تنظیمات امنیتی برنامه با چند کلیک ساده حذف گردد.

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

فایل مثال

فایل PDF

با تشکر

فایل پیوست:
خواندن بیشتر
royal visionنحوه فعال سازی ADF Security

نحوه ایجاد لیست مقادیر (LOV)

در برنامه‌های کاربردی همیشه فرم‌هایی وجود دارند که یک فیلد آن لیستی از مقادیر می‌باشد که کاربر باید از بین آنها انتخاب نماید. این لیست مقادیر گاه می‌تواند از یک جدول دیگر در پایگاه داده باشد و گاه می‌تواند یک لیست استاتیک از مقادیر باشد. برای روشن شدن بیشتر موضوع در خلال این مقاله مثالی طرح می‌گردد و گام به گام مراحل مورد نیاز شرح داده می‌شود. برای مثال از جدول کارمندان و دپارتمان‌ها در HR استفاده می‌کنیم و لیست دپارتمان‌ها را به صورت لیست مقادیر در فرم کارمند پیاده‌سازی می‌نماییم.

شرح 
در ابتدا entity و view و ارتباطات بین کارمندان و دپارتمان‌ها را ایجاد کرده. قابل ذکر است که ارتباطات بین کارمند و دپارتمان تاثیری بر ساخت لیست مقادیر فیلد دپارتمان در فرم کارمند ندارد پس نگران اینکه چه ارتباطی لازم است ایجاد گردد نباشید و از ویزارد Jdeveloper کمک گرفته و بگذارید این مورد به صورت خودکار انجام گیرد. برای این مثال من فقط مدل را می‌سازم و با نرم‌افزار تستر نتیجه را به شما نشان خواهم داد.

حال باید پس از ایجاد Viewهای مورد نیاز به سراغ مواردی برویم که برای ساخت لیست مقادیر به آن‌ها نیاز داریم. در این مثال View کارمندان را باز کنید. برای ساخت لیست مقادیر در ابتدا باید View Accessors مورد نیاز را ایجاد نمایید. برای این‌کار به قسمت View Accessors در view کارمند بروید.

با زدن دکمه مثبت سبز ( سمت راست بالا) فرم مخصوص برای ایجاد View Accessors باز می‌گردد. در سمت چپ این فرم لیست تمام View موجود نمایش داده می‌شود تا بتوانید از بین آن‌ها Viewهای مورد نیاز خود را پیدا و انتخاب نمایید

در این فرم شما باید Viewهایی که می‌خواهید به صورت یک لیست مقادیر در View اصلی در اختیار کاربر قرار دهید را انتخاب و آن‌ها را به سمت راست و زیر View اصلی ببرید. در این مثال چون قصد داریم لیست دپارتمان‌ها را به صورت لیستی از مقادیر نمایش دهیم در سمت چپ View دپارتمان را انتخاب (۱) و با زدن فلش وسط(۲) به سمت راست برده و در زیر View کارمند(۳) قرار می‌دهیم.
در همین‌جا شما می‌توانید قبل از اینکه آنرا به سمت راست ارسال نمایید اسم دلخواهتان را با استفاده از inputbox زیرین آن(۴) مشخص نمایید. این اسم کمک می‌کند تا خوانایی برنامه‌تان با استفاده از اسامی مناسب و با معنی بالاتر برود.

در برخی از حالات ما نیاز پیدا خواهیم کرد که لیست موجود را فیلتر نماییم. مثلا لیست دپارتمان‌هایی که در یک مکان خاص وجود دارند را نشان داده و همه لیست را در اختیار کاربر قرار ندهیم تا انتخاب محدودتری داشته باشد. برای این منظور باید از امکان View Criteria در ADF استفاده نمود. پس از ارسال View به سمت راست با انتخاب آن در سمت راست دکمه Edit بالای کادر View Accessors فعال می‌گردد. با زدن آن فرمی باز می‌گردد که View Criteriaهای تعریف شده در View را نمایش می‌دهد که شما می‌توانید هر کدام از آنها را که خواستید انتخاب و با زدن فلش به سمت راست ارسال نمایید تا فعال شوند و لیست مقادیر را فیلتر نماید. برای نشان دادن این مورد یک View Criteria بر اساسCounty id در View دپارتمان ایجاد کرده‌ام و لیست مقادیر را برای مکان با شناسه ۱۷۰۰ فیلتر می‌نمایم تا فقط دپارتمان‌های آن مکان نشان داده شود.
* دوستانی که با نحوه ایجاد View Criteria آشنایی ندارند می‌توانند از سایر منابع یا پست‌های بنده برای آشنایی با آن استفاده نمایند.

تا اینجا مرحله اول کار یعنی source داده‌هایی که می‌خواهیم به صورت لیست مقادیر نشان دهیم را ساخته‌ایم. حال باید فقط مشخص کنیم که این لیست مقادیر را برای کدام فیلد می‌خواهیم نمایش دهیم تا کاربر از بین آنها یکی را انتخاب نماید. در View کارمند به قسمت Attributes بروید و فیلد شناسه دپارتمان (DepartmentId) را انتخاب نمایید تا برای این فیلد لیست مقادیر ایجاد نمایید.

حال با زدن دکمه مثبت سبز در قسمت List of Values (همانطور که در تصویر قبل مشخص شده است) فرم مربوط به ساخت لیست مقادیر نشان داده می‌شود. در این فرم دو تب Configuration و UI Hints ملاحظه می‌نمایید که هرکدام را به صورت جداگانه توضیح میدهم.

تب Configuration
در این تب باید دیتا سورس مربوط به لیست مقادیر این فیلد(DepartmentId) را مشخص کرد و همچنین مقادیری که باید این لیست مقادیر به View اصلی باز گرداند که عموما شامل شناسه می‌باشد. با کلیک بر روی قسمت List Data Source نام View Accessors که در مرحله قبل ایجاد کردید را ملاحظه می‌نمایید. آنرا انتخاب نمایید. در قسمتList Attribute باید فیلد مورد نظر برای بازگشت مقدار آن به View کارمند را مشخص نمایید که عموما شناسه می‌باشد. ما فیلد DepartmentId را انتخاب می‌‌نماییم. در اینجا کار ما با این تب به اتمام می‌رسد.

تب UI Hints
این تب شامل تنظیماتی است که نحوه نمایش این لیست مقادیر در قسمت واسط کاربر(UI) را مشخص می‌نماید. تنظیماتی از قبیل چه کامپوننتی برای نمایش استفاده شود . چه فیلدهایی از View دپارتمان به جای شناسه آن نمایش داده شود و سایر تنظیماتی که تاثیر آن را فقط در واسط کاربر خود خواهید دید. در این تب من فقط DepartmentName را در قسمت Display Attributes انتخاب می‌کنم که آن را به جای شناسه نمایش دهد سایر موارد را به صورت پیش‌فرض خود رها می‌نمایم. در صورت علاقه به دانستن جزییات بیشتر به منابع رسمی مراجعه نمایید.

در نهایت فیلد DepartmentId در View کارمند شما شامل یک LOV از نام دپارتمان‌ها شده است

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

فایل مثال

فایل PDF

امیدوارم که این مطلب برایتان مفید بوده باشد.
با تشکر

qresult datamodel1 - نحوه ایجاد لیست مقادیر (LOV)
shuttle insertdlg - نحوه ایجاد لیست مقادیر (LOV)
tester main userservice - نحوه ایجاد لیست مقادیر (LOV)
transientattr - نحوه ایجاد لیست مقادیر (LOV)
viewcriteria editor - نحوه ایجاد لیست مقادیر (LOV)
خواندن بیشتر
royal visionنحوه ایجاد لیست مقادیر (LOV)

نحوه گرفتن ردیف‌های انتخاب شده در جدول

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

شرح
در ابتدا یک صفحه شامل لیست کارمندان با استفاده از کامپوننت جدول بسازید. پس از ایجاد صفحه ویژگی‌های مشخص شده در تصویر زیر را همانند تصویر تغییر دهید.

*دلیل حذف مقدار SelectedRowKeys این می‌باشد که آخرین ردیف کلیک شده بر روی آن را در ردیف‌های انتخاب شده قرار می‌دهد و به همین دلیل دیگر نمی‌توان سایر ردیف‌هایی که قبلا انتخاب شده‌اند را گرفت. پس مهم است که حتما آنرا حذف نمایید.
پس از آماده سازی صفحه حال یک backing bean با نام RowManipulate ایجاد نمایید. این backing bean دارای یک فیلد به نام employTbl از نوع RichTable می‌باشد. برای این فیلد Accessors های آنرا ایجاد نمایید. یک متد نیز با نام getSelectedRows ایجاد کنید و کد زیر را درون آن قرار دهید.

RowKeySet selectedEmps = getEmployTbl().getSelectedRowKeys();<br />
Iterator selectedEmpIter = selectedEmps.iterator();<br />
DCBindingContainer bindings =<br />
(DCBindingContainer)BindingContext.getCurrent().getCurrentBindingsEntry();<br />
DCIteratorBinding empIter =<br />
bindings.findIteratorBinding("EmployeesView1Iterator");<br />
RowSetIterator empRSIter = empIter.getRowSetIterator();<br />
while(selectedEmpIter.hasNext()){<br />
Key key = (Key)((List)selectedEmpIter.next()).get(0);<br />
Row currentRow = empRSIter.getRow(key);<br />
System.out.println(currentRow.getAttribute("LastName"));<br />
}<br />
return null;

سپس درون صفحه یک دکمه قرار دهید و آنرا به getSelectedRows وصل نمایید تا به محض کلیک متد را فراخوانی نماید.

جدول درون صفحه را به فیلد employTbl درون backing bean وصل نمایید.

* کل عملیات اتفاق افتاده در متد getSelectedRows به این شرح می‌باشد که با استفاده از متد getSelectedRowKeys کلید تمام ردیف‌های انتخاب شده در جدول را گرفته ایم. سپس بر روی View کارمندان با استفاده از کلید ردیف‌های انتخاب شده تک تک آنها را جستجو کرده ایم و در نهایت نام‌ آن‌ها را استخراج و در کنسول چاپ کرده ایم

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

امیدوارم مطلب براتون مفیده بوده
با تشکر

فایل PDF

فایل مثال

فایل پیوست:
خواندن بیشتر
royal visionنحوه گرفتن ردیف‌های انتخاب شده در جدول