Signature Returns impersonateex Method

Description of Services and Methods in Oracle BI EE Web Services 3-27

3.8.5.2 Returns

This method returns the AuthResult structure containing the session ID, and also sets an HTTP session cookie. The session ID is used in other methods to identify the Oracle Business Intelligence Presentation Services session. For more information, see Section 2.5, AuthResult Structure .

3.8.6 keepAlive Method

Use this method to instruct Oracle BI EE Presentation Services not to end particular Web user sessions due to inactivity. The effect of this method on session lifetime is the same as if those users performed an activity in the browser such as clicking an analysis, or invoking a method.

3.8.6.1 Signature

void keepAliveString[] sessionID;

3.8.7 logoff Method

Use this method to log off the user from Oracle BI EE Presentation Services.

3.8.7.1 Signature

void logoffString sessionID;

3.8.8 logon Method

Use this method to authenticate the user. If authentication fails, an exception is thrown.

3.8.8.1 Signature

String logonString name, String password; Arguments Description String name Specifies the user name to log on and authenticate. String password Specifies the password for the user. If there is no password for the user, leave this field empty void. String impersonateID Specifies the user name to impersonate the authenticated user. SAWSessionParameters ses sionparams Optional. Specifies the session parameters to use, supplied in the SAWSessionParameters structure. For information about the SAWSessionParameters structure, see Section 2.23, SAWSessionParameters Structure . Argument Description String[] sessionID Specifies the session IDs to remain logged on. Argument Description String sessionID Specifies the session ID, which is usually returned by the logon method. If the SOAP client engine can handle HTTP cookies, you can omit the session ID or set it to null. 3-28 Oracle Fusion Middleware Integrators Guide for Oracle Business Intelligence Enterprise Edition

3.8.8.2 Returns

This method returns the session ID and sets an HTTP session cookie. The session ID is used in other methods to identify the Oracle BI EE Presentation Services session.

3.8.9 logonex Method

Use this method to authenticate the user. Logonex to the logon method, but logonex can specify optional session parameters. If authentication fails, an exception is thrown.

3.8.9.1 Signature

AuthResult logonexString name, String password, SAWSessionParameters sessionparams;

3.8.9.2 Returns

This method returns the AuthResult structure containing the session ID, and also sets an HTTP session cookie. The session ID is used in other methods to identify the Oracle Business Intelligence Presentation Services session.

3.9 SecurityService Service

Use this service to provide methods for identifying accounts and privileges. Table 3–15 shows the supported methods. Arguments Description String name Specifies the user name to authenticate. String password Specifies the password for the user. If there is no password, leave this field empty void. Arguments Description String name Specifies the user name to authenticate. String password Specifies the password for the user. If there is no password, leave this field empty void. SAWSessionParameters ses sionparams Optional. Specifies the sessionparams to use, supplied in the SAWSessionParameters structure. For information about the SAWSessionParameters structure, see Section 2.23, SAWSessionParameters Structure . Table 3–15 SecurityService Methods Method Names Description Section 3.9.1, forgetAccounts Method Removes an Oracle BI EE Presentation Services internal ID to account name mapping. Section 3.9.2, getAccounts Method Searches for Oracle BI EE user accounts Section 3.9.3, getGlobalPrivilegeACL Method Gets the Access Control List for global privileges. Section 3.9.4, getGlobalPrivileges Method Gets the list of all global privileges. Section 3.9.5, getGroups Method Gets a list of catalog groups that are members of the account for example, user or group