DropdownUtils

robo_appian.utils.components.DropdownUtils

DropdownUtils

Utility class for interacting with dropdown components in Appian UI.

Usage Example:

# Select a value from a dropdown
from robo_appian.utils.components.DropdownUtils import DropdownUtils
DropdownUtils.selectDropdownValue(wait, "Status", "Approved")

# Select a value from a search dropdown
from robo_appian.utils.components.DropdownUtils import DropdownUtils
DropdownUtils.selectSearchDropdownValue(wait, "Category", "Finance")

findDropdownEnabled(wait, dropdown_label) staticmethod

Finds a dropdown component that is enabled and has the specified label.

Parameters:

Name	Type	Description	Default
wait	WebDriverWait	Selenium WebDriverWait instance.	required
dropdown_label	str	The visible text label of the dropdown component.	required

Returns:

Type	Description
	The Selenium WebElement for the dropdown component.

Example

DropdownUtils.findDropdownEnabled(wait, "Status")

selectDropdownValue(wait, label, value) staticmethod

Selects a value from a dropdown component identified by its label.

Parameters:

Name	Type	Description	Default
wait	WebDriverWait	Selenium WebDriverWait instance.	required
label	str	The visible text label of the dropdown component.	required
value	str	The value to select from the dropdown.	required

Example

DropdownUtils.selectDropdownValue(wait, "Status", "Approved")

selectSearchDropdownValue(wait, dropdown_label, value) staticmethod

Selects a value from a search-enabled dropdown component identified by its label.

Parameters:

Name	Type	Description	Default
wait	WebDriverWait	Selenium WebDriverWait instance.	required
dropdown_label	str	The visible text label of the search dropdown component.	required
value	str	The value to select from the dropdown.	required

Example

DropdownUtils.selectSearchDropdownValue(wait, "Category", "Finance")

selectValueUsingComponent(wait, combobox, value) staticmethod

Selects a value from a dropdown component using the provided combobox element.

Parameters:

Name	Type	Description	Default
wait	WebDriverWait	Selenium WebDriverWait instance.	required
combobox	WebElement	The Selenium WebElement for the combobox.	required
value	str	The value to select from the dropdown.	required

Example

DropdownUtils.selectValueUsingComponent(wait, combobox, "Approved")

InputUtils

Utility class for interacting with input components in Appian UI.

Usage Example:

# Set a value in an input field
from robo_appian.utils.components.InputUtils import InputUtils
InputUtils.setInputValue(wait, "Username", "test_user")

findComponent(wait, label) staticmethod

Finds an input component by its label.

Parameters:

Name	Type	Description	Default
wait	WebDriverWait	Selenium WebDriverWait instance.	required
label	str	The visible text label of the input component.	required

Returns:

Type	Description
	The Selenium WebElement for the input component.

Example

InputUtils.findComponent(wait, "Username")

setInputValue(wait, label, value) staticmethod

Sets a value in an input component identified by its label.

Parameters:

Name	Type	Description	Default
wait	WebDriverWait	Selenium WebDriverWait instance.	required
label	str	The visible text label of the input component.	required
value	str	The value to set in the input field.	required

Returns:

Type	Description
	The Selenium WebElement for the input component after setting the value.

Example

InputUtils.setInputValue(wait, "Username", "test_user")

setSearchInputValue(wait, label, value) staticmethod

Sets a value in a search-enabled input component identified by its label.

Parameters:

Name	Type	Description	Default
wait	WebDriverWait	Selenium WebDriverWait instance.	required
label	str	The visible text label of the search input component.	required
value	str	The value to set in the search input field.	required

Returns:

Type	Description
	None

Example: InputUtils.setSearchInputValue(wait, "Search", "Appian")

setValueAndSubmit(wait, label, value) staticmethod

Sets a value in an input component identified by its label and submits it.

Parameters:

Name	Type	Description	Default
wait	WebDriverWait	Selenium WebDriverWait instance.	required
label	str	The visible text label of the input component.	required
value	str	The value to set in the input field.	required

Returns:

Type	Description
	The Selenium WebElement for the input component after setting the value and submitting.

Example

InputUtils.setValueAndSubmit(wait, "Username", "test_user")

setValueAndSubmitUsingComponent(component, value) staticmethod

Sets a value in an input component and submits it using the provided component element.

Parameters:

Name	Type	Description	Default
component	WebElement	The Selenium WebElement for the input component.	required
value	str	The value to set in the input field.	required

Returns:

Type	Description
	The Selenium WebElement for the input component after setting the value and submitting.

Example

InputUtils.setValueAndSubmitUsingComponent(component, "test_user")

setValueUsingComponent(component, value) staticmethod

Sets a value in an input component using the provided component element.

Parameters:

Name	Type	Description	Default
component	WebElement	The Selenium WebElement for the input component.	required
value	str	The value to set in the input field.	required

Returns:

Type	Description
	The Selenium WebElement for the input component after setting the value.

Example

InputUtils.setValueUsingComponent(component, "test_user")