configuration

1. List Page Configuration(alternate layout)
==========================
a. normal_entity.jsp: for listPage.
b. alternate_entity.jsp for alternate listPage.
c. set alternateList = 1 in list_entity.jsp to change to alternate

2. Normal List Page Configuration, page name is normal_entity.jsp
=================================================================

a. Show / Hide a column by setting (show${columnName} at the top of the page)0 or 1.

b. Enable / Disable Pagination by setting PaginationRequired = 0/1.

c. Enable / Disable Scrollable Table by setting scrollableTable = 0/1.

d. Setting pageSize by pageSize = 0/1

e. Pagination type is by default mpire pagination. Enable the google pagination by uncommenting
//pagination.setFormat(pagination.GOOGLE);
//pagination.setWindow(pageSize);

f. Enable / Disable the add,delete,search,child button by setting corresponding flags to 1/0.

g. Setting table height for tableHeight by 0/1.

3. Other changes
================

a. custom SQL example - ext-impl/classes/custom-sql/defalult.xml,entityName.xml

b. get the sql_id from the entity.xml by using CustomSQLUtil.get(sql_id) in class;

this the sample code for getting and process the id through custom-sql.

try {
//open a new session
session = HibernateUtil.openSession();

//pull out our query from MessageBoards.xml, make sure you have added an entry in the default.xml file
String sql = CustomSQLUtil.get(FIND_BY_GROUP_ID);

//create a SQLQuery object
SQLQuery q = session.createSQLQuery(sql);

q.setCacheable(false);

//replace the "MBMessage" in the query string with the fully qualified java class.. this has to be the hibernate table name
q.addEntity("MBMessage", MBMessageImpl.class);

QueryPos qPos = QueryPos.getInstance(q);

//fill in the "?" value of the custom query
qPos.add(groupId);

//execute the query and return a list from the db
return QueryUtil.list(q, HibernateUtil.getDialect(), begin, end);
}
catch (Exception e) {
throw new SystemException(e);
}
finally {
//must have this to close the hibernate session.. if you fail to do this.. you will have alot of open session..
HibernateUtil.closeSession(session);
}

c. showing links based on roles, some example methods.
package com.mpower.util.CommonUtil

methods - isOperator(user),isAdmin(User user),isUser(User user),isUserInRole(User user, String role)

d. Image file as thumbnail - file taglib display="pagination", in xml thumbnail="yes".

e. For client side validation, set (serverValidation = 0) in ${portlet}.jsp