updateTransaction Oracle Adaptive Access Manager APIs

4-8 Oracle Fusion Middleware Developers Guide for Oracle Adaptive Access Manager

4.5.4 handleTransactionLog

handleTransactionLog captures transaction details. public VCryptResponse handleTransactionLogString requestId, Map[] contextMap; public VCryptResponse handleTransactionLogString requestId, Date requestTime, Map[] contextMap; public VCryptResponse handleTransactionLogString requestId, Date requestTime,Integer status, Map[] contextMap; Table 4–3 updateTransaction Parameter and Returned Value Parameter Description TransactionUpdateRequestData The object to update a transaction; a handle to the transaction to be updated is either the transaction ID returned by the method createTransaction, or the external transaction ID passed to the method createTransaction. it throws the exception BharosaException if it fails validation. The structure of this object is as follows: ■ requestId, identifies the user session; required ■ requestTime, the time of the request; can be null; if null, the server uses the current time ■ transactionId ID, the ID returned by a previous call to createTransaction ■ status, the transaction status ■ analyzePatterns, Boolean to indicate if pattern processing should be performed. When the value is passed in as true, the pattern processing is performed for the transaction if the resultStatus value is success. ■ externalTransactionId is used to correlate the application transaction with the corresponding OAAM Transaction. It can also be used to update the transaction. ■ contextMap is a map of key-value pairs. Keys of this map should exactly match the Internal ID of the related Source Data of the Transaction Definition. The value should be always a java String value. If the value is a Date value then it should be in the format yyyy-MM-ddTHH:mm:ss.SSSz. VCryptResponse The response object; make sure to check isSuccess before obtaining the transaction ID with the method getTransactionResponse Note: Deprecated as of 10.1.4.5.1; instead, use the method createTransaction . Table 4–4 handleTransactionLog Parameters Parameter Description requestId The login session ID; this is the ID that should be used in all API calls for the login session requestTime The time at which the request was made contextMap An array of contextMaps; multiple transactions can be created with a single call; it expects to find a transactionType key in each context map of the array status The transaction status Integrating Native Java Applications 4-9

4.5.5 updateTransactionStatus

updateTransactionStatus updates a transaction status and, if appropriate, triggers the data pattern processing. public VCryptResponse updateTransactionStatusString requestId, long transactionId, int status; public VCryptResponse updateTransactionStatusString requestId, Date requestTime, long transactionId, int status; public VCryptResponse updateTransactionStatusString requestId, long transactionId, int status, Map[] contextMap; public VCryptResponse updateTransactionStatusString requestId, Date requestTime, long transactionId, int status, Map[] contextMap; public VCryptResponse updateTransactionStatusString requestId, long transactionId, int status, boolean analyzePatterns; public VCryptResponse updateTransactionStatusString requestId, Date requestTime, long transactionId, int status, Map[] contextMap, boolean analyzePatterns;

4.5.6 updateLog

updateLog updates the user log and, if required, creates a CookieSet. public CookieSet updateLogString requestId, String remoteIPAddr, String remoteHost, String secureCookie, String digitalCookie, String groupId, String userId, String loginId, boolean isSecure, int result, int clientType, Note: Deprecated as of 10.1.4.5.1; instead, use the method updateTransaction . Table 4–5 updateTransactionStatus Parameters Parameter Description requestId The login session ID; this is the ID that should be used in all API calls for the login session requestTime The time at which the request was made contextMap An array of contextMaps; multiple transactions can be created with a single call; it expects to find a transactionType key in each context map of the array Status The transaction status transactionId The ID of the transaction with status to update; if null, it uses the last transaction in the given session analyzePatterns Boolean to indicate if pattern processing should be performed. When the value is passed in as true, the pattern processing is performed for the transaction if the resultStatus value is success.