Package com.hp.lft.sdk.sap.gui
Interface GuiSession
- All Superinterfaces:
SupportsNativeObject
,TestObject
,TestObjectDescriber
Represents a SAP GUI for Windows session.
-
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Closes the SAP GUI for Windows session without displaying a warning message.Returns the name of the window in focus.Returns the name of the application server.Returns the client selected on the login screen.long
Returns the code page number in use in this session.long
Returns the number of flushes or passes of data during server communication to the client.getGroup()
Returns the login group information.getId()
Returns the object's unique identifier in text format.long
Returns the time it takes for the client to interpret the information received from the server, in milliseconds.Returns the language the user is working in.Returns the name of the message server.getName()
Returns the name of the object.Returns the name of the SAP source program that is executing.long
The server response time in milliseconds.long
Returns the number of communications between client and server while the client is locked and waiting for data from the server.long
Returns the number of the screen that is displayed.Returns the name of the SAP system.long
Returns the system number.Returns the transaction the user is executing.getType()
Returns the identification of the GUI component type.getUser()
Returns the user name for the current session.void
reset()
Navigates to the session initial screen.void
Navigates to the specified transaction.void
sync()
Suspends execution until the SAP GUI for Windows session is available.void
sync
(long timeOut) Suspends execution until the SAP GUI for Windows session is available or until timed out.Methods inherited from interface com.hp.lft.sdk.SupportsNativeObject
getNativeObject
Methods inherited from interface com.hp.lft.sdk.TestObject
callFTMethod, callFTMethod, exists, exists, findChildren, getDescription, getDisplayName, getParent, getSnapshot, getTextLocations, getTextLocations, getVisibleText, getVisibleText, highlight, highlightMatches, setDescription, setDisplayName, verifyImageExists, verifyImageExists, verifyImageMatch, verifyImageMatch, verifyImageMatch, verifyImageMatch, verifyImageMatch, verifyImageMatch, waitUntilExists, waitUntilExists
Methods inherited from interface com.hp.lft.sdk.TestObjectDescriber
describe
-
Method Details
-
getType
Returns the identification of the GUI component type.- Returns:
- the type.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getId
Returns the object's unique identifier in text format.- Returns:
- the unique identifier.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getName
Returns the name of the object.- Returns:
- the name of the object.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getActiveWindow
Returns the name of the window in focus.- Returns:
- the name of the window.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getApplicationServer
Returns the name of the application server. Applies only when the connection specifies an application server and is not using load balancing.- Returns:
- the name of the application server.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getClient
Returns the client selected on the login screen.- Returns:
- the selected client.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getCodePage
Returns the code page number in use in this session.- Returns:
- the code page.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getFlushes
Returns the number of flushes or passes of data during server communication to the client.- Returns:
- the number of flushes or passes.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getGroup
Returns the login group information. Applies only when connection is using load balancing.- Returns:
- the login group information.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getInterpretationTime
Returns the time it takes for the client to interpret the information received from the server, in milliseconds.- Returns:
- milliseconds.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getLanguage
Returns the language the user is working in.- Returns:
- the language.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getMessageServer
Returns the name of the message server. Applies only when connection is using load balancing.- Returns:
- the name of the message server.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getResponseTime
The server response time in milliseconds.- Returns:
- milliseconds.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getRoundTrips
Returns the number of communications between client and server while the client is locked and waiting for data from the server.- Returns:
- the number of communications.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getSystemName
Returns the name of the SAP system.- Returns:
- the name of the SAP system.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getSystemNumber
Returns the system number. Applies only when connection specifies an application server and is not using load balancing.- Returns:
- the system number.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getUser
Returns the user name for the current session.- Returns:
- the user name.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getTransaction
Returns the transaction the user is executing.- Returns:
- the transaction.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getScreenNumber
Returns the number of the screen that is displayed.- Returns:
- the screen number.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
getProgram
Returns the name of the SAP source program that is executing.- Returns:
- the name of the program.
- Throws:
GeneralLeanFtException
- if error occurs during execution
-
sync
Suspends execution until the SAP GUI for Windows session is available.- Throws:
GeneralLeanFtException
- if error occurs during execution
-
sync
Suspends execution until the SAP GUI for Windows session is available or until timed out.
After time-out, the test run continues regardless of the session status.
You can use this method when invoking a new session from an existing session or when moving from a session that is open on one server to a new session on a different server.- Parameters:
timeOut
- milliseconds.- Throws:
GeneralLeanFtException
- if error occurs during execution
-
close
Closes the SAP GUI for Windows session without displaying a warning message.
You can invoke this method at the end of an action or a test iteration to close sessions that were opened during the test run. This ensures that each iteration begins with the same number of open SAP Gui for Windows sessions.- Throws:
GeneralLeanFtException
- if error occurs during execution
-
reset
Navigates to the session initial screen. We recommend using this method to ensure that tests are rerun from the initial screen of the session.- Throws:
GeneralLeanFtException
- if error occurs during execution
-
reset
Navigates to the specified transaction.- Parameters:
transactionCode
- the transaction.- Throws:
GeneralLeanFtException
- if error occurs during execution
-