commands

Soom RPA provides a comprehensive library of automation commands to handle virtually any automation scenario. This reference guide covers all available commands organized by category.

Command Categories

Flow Control Commands

Control the flow and logic of your automations:

• Conditionals - Implement conditional logic and branching
• Loops - Create loops and iterations
• Waits - Add timing and wait conditions

Element Interaction Commands

Interact with UI elements across different platforms:

• Similar Elements - Work with similar UI elements
• Web Automation - Automate web browsers and applications
• Software Automation - Automate desktop applications

Input Commands

Handle user input and interactions:

• Mouse & Keyboard - Simulate mouse and keyboard input

Data Commands

Process and manipulate data:

• Data Table - Work with data tables and datasets
• Excel - Automate Excel operations
• Data Processing - Process and transform data

System Commands

Interact with the operating system and external systems:

• OS - Operating system operations
• Flow - Flow control and management
• Network - Network operations and communications
• Dialogs - Handle system dialogs and pop-ups

Utility Commands

Additional utility and helper commands:

• Others - Miscellaneous utility commands

Command Structure

Command Properties

Each command has the following properties:

• Name: The command name and identifier
• Description: What the command does
• Parameters: Input parameters and configuration options
• Output: What the command returns or produces
• Examples: Usage examples and best practices

Parameter Types

Commands accept various parameter types:

• Text: String values and text input
• Numbers: Numeric values and calculations
• Boolean: True/false values
• Lists: Collections of values
• Objects: Complex data structures
• Elements: UI element references

Usage Patterns

Basic Command Usage

// Example: Click an element
Click Element (Web)
  Element: [Element Reference]
  Wait for Element: True

Command Chaining

// Example: Chain multiple commands
Open Webpage
  URL: "https://example.com"

Wait For Element (Web)
  Element: [Login Button]
  Timeout: 10 seconds

Click Element (Web)
  Element: [Login Button]

Conditional Commands

// Example: Conditional execution
If
  Condition: Element Exists
  Element: [Success Message]

Then:
  Extract Data
    Element: [Success Message]

Else:
  Take Screenshot
    File Name: "error.png"

Best Practices

Command Selection

Choose the right command for your needs:

• Use Specific Commands: Choose the most specific command available
• Consider Performance: Use efficient commands for better performance
• Handle Errors: Always include error handling commands
• Test Thoroughly: Test commands in different scenarios

Parameter Configuration

Configure parameters effectively:

• Use Variables: Use variables for dynamic values
• Set Timeouts: Configure appropriate timeouts
• Handle Edge Cases: Consider edge cases and error conditions
• Document Parameters: Document complex parameter configurations

Error Handling

Implement robust error handling:

• Try-Catch Blocks: Use try-catch for error handling
• Fallback Commands: Provide fallback options
• Error Logging: Log errors for debugging
• User Notifications: Notify users of errors when appropriate

Command Examples

Web Automation Example

// Complete web automation workflow
Open Webpage
  URL: "https://example.com"

Wait For Element (Web)
  Element: [Search Box]
  Timeout: 10 seconds

Fill Text Field (Web)
  Element: [Search Box]
  Text: "automation"

Click Element (Web)
  Element: [Search Button]

Wait For Element (Web)
  Element: [Results]
  Timeout: 15 seconds

Extract Data
  Element: [Results]
  Output: SearchResults

Data Processing Example

// Data processing workflow
Read Data Table
  File: "input.csv"
  Output: InputData

Loop Through Data Table
  Data: InputData

For Each Row:
  Process Data
    Input: CurrentRow
    Output: ProcessedRow

  Write To Data Table
    Data: ProcessedRow
    File: "output.csv"

Next Steps

Explore specific command categories:

• Conditionals - Learn about conditional logic
• Web Automation - Master web automation
• Data Table - Work with data tables
• Use Cases - See commands in real-world scenarios