|
iPlanet BillerXpert 4.6 B2C Edition Release Notes
|
Release Notes for iPlanet BillerXpert B2C Edition
Version 4.6
Updated December 2, 2002
These release notes contain important information available at the time of the release of iPlanet BillerXpert 4.6 B2C Edition. New features and enhancements, installation notes, known problems, and other late-breaking issues are addressed here. Read this document before you begin using iPlanet BillerXpert 4.6 B2C Edition.
An electronic version of these release notes can be found at the iPlanet documentation web site: http://docs.sun.com/. Check the web site prior to installing and setting up your software and then periodically thereafter to view the most up-to-date release notes and manuals.
These release notes contain the following sections:
What's New in BillerXpert B2C Edition, Version 4.6
New Technical Features
iPlanet BillerXpert Version 4.6 is the next version of iPlanet BillerXpert. Built on the iPlanet E-Commerce-Ready Infrastructure, iPlanet BillerXpert 4.6 B2C Edition provides high performance, scalability, high availability, and integration with expertise applications and systems.
The new technical features for iPlanet BillerXpert 4.6 B2C Edition are:
- Certified to iPlanet Application Server (iAS) version 6.5
- Certified to iPlanet Web Server (iWS) version 6.0
- Certified to LDAP version 5.0
- Certified to Oracle 8.1.7, Enterprise and Standard editions
- Certified to Oracle 9i, Enterprise and Standard editions. See Limitations section for additional information.
- Conversion of all AppLogic classes into Java Servlets using a one-to-one mapping of AppLogic classes to Servlets
- Conversion of all HTML templates to JSP pages using a one-to-one mapping of HTML templates to JSP pages
- JavaBean components have been written to carry dynamic data from the Servlets to the JSPs. These replace the TemplateData and TemplateDataMap classes.
Implementation
All servlets will extend from the following Base Class: BXBaseServlet. This class will provide the following methods as described in Table 1:
Table 1    BXBaseServlet Base Class Methods
public void init(ServletConfig cfg)
|
Servlet initialization method. This will be called by iAS when the servlet is loaded for the first time. This method simply stores a reference to the ServletContext in an instance variable called context
|
|
protected void init(HttpServletRequest request, HttpServletResponse response)
|
This method will be called by Servlets that require to use any of the XXXContext objects. Many ejbs require the context objects to be passed as parameters for their constructors. The whichContext variable may contain one of the following constants:
|
|
|
BXBaseServlet.BILLING_CONTEXT
|
new BXBillingContext is instantiated
|
|
BXBaseServlet.MEMBERSHIP_CONTEXT
|
new BXMembershipContext is instantiated
|
|
BXBaseServlet.PAYMENT_CONTEXT
|
new BXPaymentContext is instantiated
|
|
BXBaseServlet.CONFIG_CONTEXT
|
new BXConfigContext is instantiated
|
|
BXBaseServlet.ALL_CONTEXT
|
All of the above are instantiated
|
protected void releaseBXDBContext()
|
Releases all of the above contexts, if they have been instantiated
|
|
protected BXSession getSessionProxy()
|
Returns reference to the BXSession object that stores session data. The BXSession object itself is stored in the HttpSession. This method creates the session if it does not already exist (by calling the getSession() method)
|
|
protected BXSession getBXSession()
|
Extracts the BXSession object from the HttpSession and stores it in an instance variable. It creates the session if it does not already exist (by calling the createBXSession(String onlineName) method)
|
|
protected BXSession createBXSession(String OnlineName)
|
Creates a new BXSession object and places it in the HttpSession
|
|
public boolean verifyUserSession(HttpServletRequest req)
|
Checks if the HttpSession and BXSession are valid. Returns true if valid and false if not. To be called at the beginning of every servlet request, except for signon.
|
|
public void displayTemplate(String template)
|
Forwards the current request to the JSP page named by the "template" parameter
|
|
protected void displayErrorMsg(String templateFile)
|
Forwards the current request to the JSP page. Also processes error messages present in the BXStatus object, so that they appear in the output page.
|
|
public boolean logActivity(String act, String billerID,String userID)
|
Logs an activity in the audit trail. Called by servlets that need to make an entry into the activity log.
|
|
public int checkACL(String perm)
|
Checks access permissions of the user
|
|
JavaBean objects will be used to carry dynamic data from the Servlets to the JSP pages. These Beans will be populated by the servlet and saved as a request attribute. The request will then be forwarded to the JSP. The JSP can retrieve the Bean from the request attribute, and format it for display.
All JavaBeans will extend the base class BXBaseBean, which provides convenience methods for formatting data for the user's locale.
The Table 2 lists existing applogics and the corresponding servlet:
Table 2    Applogic to Servlet Conversion
Existing applogics
|
Corresponding Servlet
|
BXAccountCenterServlet.java
|
BXAccountCenterAL.java
|
BXBillDocSearchServlet.java
|
BXBillDocSearchAL.java
|
BXBillDocServlet.java
|
BXBillDocAL.java
|
BXBillingCenterServlet.java
|
BXBillingCenterAL.java
|
BXClickThroughServlet.java
|
BXClickThroughAL.java
|
BXPayHistoryServlet.java
|
BXPayHistoryAL.java
|
BXPaymentServlet.java
|
BXPaymentAL.java
|
BXPurgingServlet.java*
|
BXPurgingAL.java*
|
BXSignOnCSRServlet.java
|
BXSignOnCSR.java
|
BXSignOnServlet.java
|
BXSignOnAL.java
|
BXSignOutServlet.java
|
BXSignOutAL.java
|
BXSignUpServlet.java
|
BXSignUpAL.java
|
BXUserCenterServlet.java
|
BXUserCenterAL.java
|
BXUserPaymentServlet.java
|
BXUserPaymentAL.java
|
BXUserProfileServlet.java
|
BXUserProfileAL.java
|
BXAPDateCalculateServlet.java
|
BXAPDateCalculateAL.java
|
BXAutoPayServlet.java
|
BXAutoPayAL.java
|
Table 3 lists the existing HTML templates and the corresponding new file names:
Table 3    HTML Template to JSP Page Conversion
Existing HTMLTemplate
|
Corresponding New File Names
|
AutoPayAdd.html
|
AutoPayAdd.jsp
|
AutoPayChange.html
|
AutoPayChange.jsp
|
account_center_error.html
|
account_center_error.jsp
|
account_center_new_line_error.html
|
account_center_new_line_error.jsp
|
add_payment_method.html
|
add_payment_method.jsp
|
additional_info.html
|
additional_info.html
|
auth_summary.html
|
auth_summary.jsp
|
billing_center.htm
|
billing_center.jsp
|
billing_center_current_statement.htm
|
billing_center_current_statement.jsp
|
blank.html
|
blank.html
|
change_profile_confirm.html
|
change_profile_confirm.jsp
|
change_profile_error.html
|
change_profile_error.jsp
|
contact_us.htm
|
contact_us.htm
|
csr.html
|
csr.jsp
|
email_demo-login.html
|
email_demo-login.html
|
email_demo-request.html
|
email_demo-request.html
|
email_demo.html
|
email_demo.html
|
email_send-demo.html
|
email_send-demo.html
|
entrance.html
|
entrance.html
|
error_msg.html
|
error_msg.jsp
|
generic_services.html
|
generic_services.html
|
index.html
|
index.html
|
index.jsp
|
index.jsp
|
inquiry-cancel.html
|
inquiry-cancel.html
|
inquiry-closed.html
|
inquiry-closed.html
|
inquiry-comment.html
|
inquiry-comment.html
|
inquiry-new-1.html
|
inquiry-new-1.html
|
inquiry-new-2.html
|
inquiry-new-2.html
|
inquiry_center-confirm.html
|
inquiry_center-confirm.html
|
inquiry_center.html
|
inquiry_center.html
|
logout_msg.html
|
logout_msg.jsp
|
new_customer-additional_info.html
|
new_customer-additional_info.html
|
new_customer-addresses.html
|
new_customer-addresses.html
|
new_customer-confirmation.html
|
new_customer-confirmation.html
|
new_customer-contacts.html
|
new_customer-contacts.html
|
new_customer-online_info.html
|
new_customer-online_info.html
|
new_customer-payment_info.html
|
new_customer-payment_info.html
|
new_customer-service_info.html
|
new_customer-service_info.html
|
new_member-additional_info.html
|
new_member-additional_info.jsp
|
new_member-address.html
|
new_member-address.jsp
|
new_member-authenticate.html
|
new_member-authenticate.jsp
|
new_member-contacts.html
|
new_member-contacts.jsp
|
new_member-online_info.html
|
new_member-online_info.jsp
|
new_member-payment_info.html
|
new_member-payment_info.jsp
|
pay_account-balance.html
|
pay_account-balance.jsp
|
pay_account-balance_paid.html
|
pay_account-balance_paid.jsp
|
pay_confirm.html
|
pay_confirm.jsp
|
pay_error_msg.html
|
pay_error_msg.jsp
|
pay_history_error.html
|
pay_history_error.jsp
|
payment_cancel.html
|
payment_cancel.jsp
|
payment_cancel_confirm.html
|
payment_cancel_confirm.jsp
|
payments.html
|
payments.jsp
|
products_services.htm
|
products_services.htm
|
purging.html
|
purging.html*
|
schedules.html
|
schedules.html
|
search.htm
|
search.htm
|
search_error.html
|
search_error.jsp
|
session_msg.jsp
|
|
service-1234.html
|
service-1234.html
|
service-3450.html
|
service-3450.html
|
service-add.html
|
service-add.html
|
service-change.html
|
service-change.html
|
service-enter_line.html
|
service-enter_line.jsp
|
service-remove_number_confirm.html
|
service-remove_number_confirm.jsp
|
service-remove_service_confirm.html
|
service-remove_service_confirm.html
|
service_center.html
|
service_center.jsp
|
services.html
|
services.html
|
signon_msg.html
|
signon_msg.jsp
|
signup_error.html
|
signup_error.jsp
|
signup_submit_done.html
|
signup_submit_done.jsp
|
signup_submit_error.html
|
signup_submit_error.jsp
|
statement_current.html
|
statement_current.html
|
statement_search-power.html
|
statement_search-power.jsp
|
statement_search-results-simple.html
|
statement_search-results-simple.jsp
|
statement_search-results.html
|
statement_search-results.jsp
|
statement_search-simple.htm
|
statement_search-simple.htm
|
statement_search.html
|
statement_search.jsp
|
user_center-add_payment_method.html
|
user_center-add_payment_method.jsp
|
user_center-change_payment_bankaccount.html
|
user_center-change_payment_bankaccount.jsp
|
user_center-change_payment_cc.html
|
user_center-change_payment_cc.jsp
|
user_center-change_payment_method2.html
|
user_center-change_payment_method2.jsp
|
user_center-delete_payment_method_confirm.html
|
user_center-delete_payment_method_confirm.jsp
|
user_center-editor-address.html
|
user_center-editor-address.jsp
|
user_center-editor-adinfo.html
|
user_center-editor-adinfo.jsp
|
user_center-editor-autopay.html
|
user_center-editor-autopay.html
|
user_center-editor-contact.html
|
user_center-editor-contact.jsp
|
user_center-editor-contacts.html
|
user_center-editor-contacts.jsp
|
user_center-editor-notify.html
|
user_center-editor-notify.jsp
|
user_center-editor-password.html
|
user_center-editor-password.jsp
|
user_center-editor-payment.html
|
user_center-editor-payment.jsp
|
user_center-editor-prefs.html
|
user_center-editor-prefs.jsp
|
user_center.html
|
user_center.jsp
|
usercenter_services.html
|
usercenter_services.jsp
|
version.html
|
version.html
|
xbillerx.wml
|
xbillerx.wml
|
Bug Fixes
In this release of BillerXpert B2C Edition, Version 4.6, the following bug fixes have been implemented:
- 554188 - Process Instance Threads are not immediately executed with multiple kjs.
- 547825 - Credit Card Payments are not being converted from status of "Pending" to "Completed".
- 546837 - Loading an xml file through the Admin front end stalls the system.
- 547544 - Biller field `State' should not be required for the international product.
- 560180 - java.lang.NullPointerException or java.lang.NoClassDefFoundError errors.
- 556575 - The currency displayed in line item search results page needs to be specified.
- 556574 - Summary info in approval inbox has no currency indicator.
- 554215 - BXEventQueue table is written based on TimeZone Environment Variable.
- 550792 - `Cancel Payment' is not tracked.
- 550376 - Payment Account can be added without payment account rules.
- 546818 - Performance characteristics degrade quickly as the number of invoices in the system increase.
- 547193 - BXLoaderDone creates an exception in a distributed installation scenario.
- 559901 - The number of records is greater than the number of users at the v$openn_cursor view.
- 4524289 - The use of the ampersand (`&') symbol in a company name causes the company creation process to fail.
Known Problems and Limitations
iPlanet BillerXpert B2C Edition includes the following limitations and considerations:
Additional Requirements for Oracle 9i:
When using Oracle 9i as the database server, the following parameters must be added in the /etc/system file. The parameters are:
- seminfo_semmls=1024
- seminfo_semopm=100
- seminfo_semvmx=32767
Problem (#4679028)
New biller creation through Admin Console invalidates other billers. For example: After a new biller or billers have been created using the Admin Console, the cache becomes outdated and subsequently, Admin tasks cannot be completed. Note: The Add Biller Process using the ezPostInstall script operates without errors and therefore is not included in this problem report.
[Workaround]
After creating a biller or billers using the Admin Console, you must restart iAS in order to refresh/maintain the cache data.
Problem (#4524371)
When Web Server option "Require client certificates" is "On", the Event Server Manager cannot start for BillerXpert B2B edition, resulting in the following error message appearing in the kjs log file: "EventServerHttpInvocation > java.io.FileNotFoundException..."
How to Report Problems
If you have problems with iPlanet BillerXpert, contact iPlanet customer support using one of the following mechanisms:
So that we can best assist you in resolving problems, please have the following information available when you contact support:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps
For More Information
Useful iPlanet information can be found at the following Internet locations: