This topic provides information related to the backward compatibility of custom applications built using the 3.5.x Web Application Toolkit. If you have already modified your 3.5.x applications to run in a 4.0.x environment, there are no additional modifications needed to run your applications in a 4.5 environment.
When using JAAS container-managed authentication, Workplace does not have access to full user credentials and therefore, does not generate user tokens since it has nothing to encrypt as the basis for the token. As a result, in situations where Workplace might expose an action that invokes some piece of UI hosted by, for example, IBM FileNet Records Manager (RM), and container-managed authentication is in use, the user will be presented with a second sign-in page when launching the RM-based action. To avoid the second sign-in page, the site must install and configure an SSO solution that offers JAAS support, such as CA/Netegrity SiteMinder.
NOTE As of IBM FileNet P8 4.0, an Application Integration client cannot participate in a JAAS-integrated SSO deployment. The client does not support integration to leverage SSO-authenticated user credentials in this type of deployment.
The following procedure shows you how to upgrade 3.5.x Toolkit-based applications to access workflows stored and processed on a 4.x Content Engine and Process Engine. The procedure does not require modification of custom code, and it applies to Workplace as well as custom Toolkit-based applications.
NOTE The 3.5.x Process applets, for example, Administrator and Designer, are not supported in the 4.x IBM FileNet P8 environment.
The procedure assumes that:
The APIs listed below, which were deprecated prior to release 4.0, are obsolete.
doMapParameters(WorkflowPolicy workflowPolicy, FormData formData)
; use
doMapParametersList
method instead.getRealmGroups(java.lang.String realmId, boolean refresh)
getRealmUsers(java.lang.String realmId, boolean refresh)
CREATE_WINDOW_ID
FIRST_WINDOWID_KEY
HOME_KEY
POPUP_KEY
PROPOGATE_WINDOW_ID
WINDOW_SIGNED_IN_KEY
windowIdParams
configurePage(javax.servlet.ServletContext applicationValue,
javax.servlet.http.HttpServletRequest request, boolean windowIdRequired)
configurePage(javax.servlet.ServletContext applicationValue,
javax.servlet.http.HttpServletRequest request, int windowIdMode)
configurePage(javax.servlet.ServletContext applicationValue,
javax.servlet.http.HttpServletRequest request, int windowIdMode, java.lang.String[]
windowIdParams)
getHomeURLKey(java.lang.String windowId)
getWindowIdFromReferer(java.util.Map popups, java.lang.String referer)
isNewWindowIdRequired(javax.servlet.http.HttpServletRequest request)
setAutoFixWindowId(boolean value)
getCredentialsRequestURL(WcmDataStore ds, java.lang.String remoteHost, boolean
wasBugFix, java.lang.String originScheme, java.lang.String originIP, java.lang.String
originPort, java.lang.String originSessionId, java.lang.String encodedSessionId,java.lang.String userId, java.lang.String password, java.util.Map extraParameters)
convertDateToW3CDate(java.util.Date date, boolean bDateOnly)
doEvaluateExpression(java.lang.String subscriptionName, java.lang.String expression,
java.lang.String objectStoreId, java.lang.String objectId, java.lang.String verSerId, int
objectType)
findGroups(java.lang.String searchPattern, int searchType, int sortType, int maxBufferSize)
findUsers(java.lang.String searchPattern, int searchType, int sortType, int maxBufferSize)
loadResource(java.io.InputStream in)
loadResource(java.util.Map m)
handleExternalDocument(com.filenet.wcm.api.Document doc,
javax.servlet.http.HttpServletResponse response, WcmDataStore ds)
load(java.lang.String sFilePath)
getClassPropertyKeys()
getModulePropertyKeys()
checkForChoiceLists(org.w3c.dom.Document searchDefinition)
checkForUserListProperties(org.w3c.dom.Document searchDefinition)
getAllObjectStores(boolean refresh)
getChoiceList(java.lang.String objectStoreName, java.lang.String searchID)
getSearchRequest(java.util.Set selectProperties, java.util.Map propertyItems, java.util.Map
verityItems, java.util.Set excludedClasses, int maxRecords)
getSessionToken(WcmDataStore ds, java.lang.String appId, java.lang.String user,
java.lang.String password, java.lang.String domain)
getUserDomain()
createServerCredentials(WcmDataStore ds, java.lang.String appId, java.lang.String user,
java.lang.String password, java.lang.String domain)
getEncodedSessionId()
getLoginRoutingInfo()
getLoginRoutingInfo()
getSslHost()
getSslHostDecoded()
loadResource(java.io.InputStream in)
loadResource(java.util.Map m)
encode(java.lang.String str)
load(java.lang.String path, java.lang.String name, java.lang.Class resourceClass)
addLegacyPRB(boolean exception, java.io.InputStream in)
addLegacyPRB(boolean exception, java.util.Map m)
setXSLParameter(java.lang.String key, org.w3c.dom.Node node)
setXSLParameter(java.lang.String key, java.lang.String value)
setXSLParameter(java.lang.String key, org.w3c.dom.NodeList nodes)