ExploraBI Automation Reference — Complete Guide to Core Features

Core Features Reference

This document provides comprehensive technical documentation for all triggers, actions, and conditions available in the ExploraBI Automation system.

Table of Contents

  1. Triggers
  2. Actions
  3. Conditions
  4. Dynamic Values & Placeholders
  5. Advanced Configuration

Triggers

Triggers define when your automations execute. Every automation requires exactly one trigger.

Sheet Change Trigger 📝

Responds to modifications in your spreadsheet in real-time.

Configuration Fields:

FieldDescriptionOptions/Examples
Sheet NameTarget sheet to monitorLeave empty for current sheet, or select specific sheet
Cell RangeSpecific range to monitorA:A, B2:D10, A1:Z100, or leave empty for entire sheet
Change TypeTypes of changes to detectAny change, Cell edited, Row/column inserted

Range Specifications:

  • Full Column: A:A monitors entire column A
  • Full Row: 1:1 monitors entire row 1
  • Specific Range: A1:C10 monitors only that rectangular area
  • Multiple Columns: A:D monitors columns A through D
  • Empty Field: Monitors the entire sheet

When to Use:

  • Monitor form submissions or data entry
  • Track status changes in specific columns
  • Respond to data updates in real-time
  • Validate or process new information

Schedule Trigger ⏰

Executes automations on a time-based schedule.

Configuration Fields:

FieldDescriptionOptions
FrequencyHow often to runEvery Hour, Daily, Weekly, Monthly
TimeHour of day to execute12:00 AM through 11:00 PM (hourly shown)
Day of WeekFor weekly frequencyMonday through Sunday
Day of MonthFor monthly frequency1st through 28th of month

Frequency Details:

  • Every Hour: Runs every hour on the hour
  • Daily: Runs once per day at specified time
  • Weekly: Runs once per week on specified day and time
  • Monthly: Runs once per month on specified day and time

Time Zone: All times are in your Google account’s time zone.

When to Use:

  • Generate daily, weekly, or monthly reports
  • Clean up old data periodically
  • Send scheduled notifications
  • Perform regular data backups

Actions

Actions define what happens when a trigger fires. Automations can have multiple actions that execute in sequence.

Update Cell ✏️

Modifies the value of a specific cell.

Configuration Fields:

FieldDescriptionExamples
Sheet NameTarget sheetSelect from dropdown or leave empty for current sheet
Cell ReferenceTarget cell locationA1, B{{row_number}}, C5
New ValueValue to insertStatic text, formulas, or dynamic placeholders

Cell Reference Options:

  • Static: A1 always targets that exact cell
  • Dynamic: B{{row_number}} targets column B in the edited row
  • Cross-sheet: Works when sheet name is specified

Value Types:

  • Static Text: Any text like “Completed” or “High Priority”
  • Formulas: Spreadsheet formulas like =TODAY() or =SUM(A1:A10)
  • Dynamic Values: Placeholders like {{NOW}} or {{EDITED_VALUE}}
  • Combined: Mixed content like “Updated on {{NOW}} by {{editing_user}}”

Common Use Cases:

  • Add timestamps when data is entered
  • Update status fields automatically
  • Calculate derived values
  • Cross-reference data between sheets

Add Row ➕

Inserts a new row with specified data into a target sheet.

Configuration Fields:

FieldDescriptionDetails
Sheet NameDestination sheetSelect target sheet from dropdown
Row DataValues for new rowComma-separated values for each column
PositionWhere to insertEnd of sheet or After header row

Row Data Format:

  • Comma-separated values: Value1, Value2, Value3
  • Mixed content: Combine static text, formulas, and placeholders
  • Empty cells: Leave blank between commas for empty cells

Insert Positions:

  • End of sheet: Appends to the last row with data
  • After header row: Inserts at row 2, pushing existing data down

Common Use Cases:

  • Log activities and changes
  • Archive completed items
  • Create audit trails
  • Generate summary reports

Copy Data 📋

Copies data from one range to another location.

Configuration Fields:

FieldDescriptionExamples
Source RangeRange to copy fromA1:C10, A{{row_number}}:D{{row_number}}
Source SheetSource sheet nameLeave empty for current sheet
Destination RangeWhere to pasteA1, A:D, or range specification
Destination SheetTarget sheetSelect destination sheet

Range Specifications:

  • Static Range: A1:C10 copies that exact area
  • Dynamic Range: A{{row_number}}:C{{row_number}} copies the edited row
  • Full Columns: A:C copies entire columns
  • Single Cell: A1 as destination will paste starting there

Common Use Cases:

  • Archive completed tasks to another sheet
  • Create data backups
  • Consolidate information
  • Duplicate important records

Delete Row 🗑️

Removes rows based on specified criteria with safety controls.

Configuration Fields:

FieldDescriptionOptions
Sheet NameTarget sheetSelect sheet to delete from
Delete ModeHow to select rowsSpecific row number, Rows matching condition
Row NumberSpecific row to deleteEnter row number (for specific mode)
Condition ColumnColumn to evaluateColumn letter (A, B, C, etc.)
OperatorComparison typeEquals, Not equals, Contains, Is empty
ValueValue to matchText to compare against

Delete Modes:

  • Specific row number: Deletes exactly one numbered row
  • Rows matching condition: Deletes all rows where condition is true

Safety Features:

  • Limited to 100 rows maximum per execution
  • Requires confirmation for bulk operations
  • Cannot be undone - deleted data is permanently lost

⚠️ Important: Always test deletion automations with sample data first.

Common Use Cases:

  • Clean up old completed tasks
  • Remove archived records
  • Data maintenance and cleanup
  • Automated housekeeping

Hide Row 👁️

Hides or unhides rows based on conditions while preserving the data.

Configuration Fields:

FieldDescriptionOptions
Sheet NameTarget sheetSelect sheet to modify
Hide ModeRow selection methodSpecific row number, Rows matching condition
ActionHide or unhideHide rows, Unhide rows
Row NumberSpecific rowEnter row number (for specific mode)
Condition ColumnColumn to evaluateColumn letter (A, B, C, etc.)
OperatorComparison typeEquals, Not equals, Contains, Is empty
ValueValue to matchText to compare against

Actions:

  • Hide rows: Makes rows invisible but preserves data
  • Unhide rows: Makes hidden rows visible again

Common Use Cases:

  • Hide completed tasks while keeping records
  • Organize data presentation
  • Create filtered views
  • Manage data visibility

Sort Sheet 🔽

Sorts data in ascending or descending order with multi-level sorting.

Configuration Fields:

FieldDescriptionOptions
Sheet NameTarget sheetSelect sheet to sort
Sort RangeRange to sortLeave empty for entire sheet or specify range
Primary Sort ColumnMain sort columnColumn letter (A, B, C, etc.)
Primary Sort OrderPrimary directionAscending (A-Z, 0-9), Descending (Z-A, 9-1)
Secondary Sort ColumnSecondary columnOptional column for tie-breaking
Secondary Sort OrderSecondary directionAscending or Descending
Tertiary Sort ColumnThird-level columnOptional additional sort level
Tertiary Sort OrderTertiary directionAscending or Descending

Sort Orders:

  • Ascending: A-Z, 0-9, earliest dates first
  • Descending: Z-A, 9-0, latest dates first

Multi-Level Sorting: Primary sort is applied first, secondary handles ties, tertiary handles remaining ties.

Common Use Cases:

  • Maintain leaderboards automatically
  • Sort by priority or status
  • Organize by date or time
  • Alphabetical organization

Conditional Formatting 🎨

Applies visual formatting based on cell values and conditions.

Configuration Fields:

FieldDescriptionOptions
Sheet NameTarget sheetSelect sheet to format
Format RangeRange to formatSpecific range like A1:D10
Condition TypeHow to evaluateValue equals, Greater than, Less than, Contains, etc.
Condition ValueValue to compareText or number to match
Background ColorCell backgroundColor picker for background
Text ColorText colorColor picker for text
BoldBold textCheckbox to enable
ItalicItalic textCheckbox to enable
Font SizeText sizeNumber (leave empty for default)

Condition Types:

  • Value equals: Exact match
  • Value greater than: Numeric comparison (>)
  • Value less than: Numeric comparison (<)
  • Value contains: Text contains substring
  • Value is empty: Cell has no content
  • Value is not empty: Cell has content
  • Custom formula: Advanced formula-based conditions

Common Use Cases:

  • Highlight high-priority items in red
  • Color-code status values
  • Format overdue dates
  • Visual data organization

Send Email 📧

Sends automated email notifications with dynamic content.

Configuration Fields:

FieldDescriptionDetails
ToRecipient emailsEmail addresses, separated by commas
CCCarbon copyOptional CC recipients
BCCBlind carbon copyOptional BCC recipients
SubjectEmail subject lineText with dynamic placeholders
BodyEmail contentMessage text with dynamic placeholders

Email Address Options:

  • Static addresses: [email protected]
  • Dynamic addresses: Use placeholders like {{column_B}} for cell values
  • Multiple recipients: Separate with commas

Content Features:

  • Dynamic placeholders: Insert real-time data
  • Line breaks: Use line breaks normally in the text area
  • Plain text format: Emails are sent as plain text

Setup Requirements:

  • Email permissions must be configured (one-time setup)
  • First use may require authorization

Common Use Cases:

  • Status change notifications
  • Form submission alerts
  • Daily/weekly reports
  • Task assignment notifications

Send Webhook 🔗

Sends HTTP requests to external systems and services.

Configuration Fields:

FieldDescriptionDetails
Webhook URLTarget endpointFull URL of external webhook
MethodHTTP methodPOST, GET, PUT, DELETE
PayloadRequest dataJSON data to send
HeadersHTTP headersOptional headers for authentication

HTTP Methods:

  • POST: Send data to create or update
  • GET: Retrieve information
  • PUT: Update existing data
  • DELETE: Remove data

Payload Format: JSON format with dynamic placeholders for real-time data

Common Use Cases:

  • Slack notifications
  • External API updates
  • Third-party integrations
  • Real-time data synchronization

HTTP Request 🌐

Makes custom HTTP requests with advanced options and response handling.

Configuration Fields:

FieldDescriptionDetails
URLRequest URLFull URL of API endpoint
MethodHTTP methodGET, POST, PUT, DELETE
HeadersRequest headersJSON format for authentication, etc.
BodyRequest bodyData to send with request
Response CellStore responseOptional cell to store API response

Advanced Features:

  • Response handling: Store API responses in spreadsheet cells
  • Authentication: Support for API keys and tokens
  • Error handling: Graceful handling of failed requests
  • Timeout protection: Automatic timeout for slow requests

Common Use Cases:

  • Retrieve data from external APIs
  • Validate information against external services
  • Fetch real-time data (weather, stock prices, etc.)
  • Integration with business systems

Conditions

Conditions determine whether automation actions should execute. They are optional but provide powerful control over when automations run.

Column Value Condition 📊

Evaluates values in specific spreadsheet columns.

Configuration Fields:

FieldDescriptionOptions
Sheet NameTarget sheetLeave empty for current sheet
ColumnColumn to checkColumn letter (A, B, C, etc.)
OperatorComparison typeSee operators table below
ValueValue to compareText, number, or dynamic placeholder

Available Operators:

OperatorDescriptionExample Use
EqualsExact matchStatus equals “Completed”
Not equalsDoes not matchPriority not equals “Low”
ContainsContains textName contains “Project”
Does not containMissing textDescription does not contain “test”
Starts withText begins withCode starts with “PRJ”
Ends withText ends withFilename ends with “.pdf”
Is emptyCell is blankComments is empty
Is not emptyCell has contentEmail is not empty
Greater thanNumeric comparisonScore greater than 80
Less thanNumeric comparisonAmount less than 1000

Common Use Cases:

  • Check task completion status
  • Validate required fields
  • Filter based on categories
  • Numeric threshold conditions

System Variable Condition 🔧

Evaluates system variables like current user, time, and context.

Configuration Fields:

FieldDescriptionOptions
VariableSystem variableSee variables table below
OperatorComparison typeEquals, Contains, Greater than, Less than
ValueValue to compareText or number to match

Available Variables:

VariableDescriptionExample Values
Editing userEmail of person making changes[email protected]
Current timeCurrent time of day”14:30”, “09:15”
Current dateToday’s date”2024-01-15”
Day of weekCurrent day”Monday”, “Friday”

Common Use Cases:

  • User-specific automations
  • Time-based conditions
  • Day-of-week restrictions
  • Context-aware processing

Checkbox Condition ☑️

Evaluates the state of checkbox cells.

Configuration Fields:

FieldDescriptionOptions
Sheet NameTarget sheetLeave empty for current sheet
ColumnColumn with checkboxColumn letter (A, B, C, etc.)
Expected ValueCheckbox stateChecked or Unchecked

Checkbox States:

  • Checked: Checkbox is marked (TRUE)
  • Unchecked: Checkbox is empty (FALSE)

Common Use Cases:

  • Task completion tracking
  • Approval workflows
  • Feature toggles
  • Boolean conditions

Multiple Conditions Logic

Combine multiple conditions using AND/OR logic for complex decision-making.

Configuration Options:

Logic TypeDescriptionWhen It Triggers
All conditions must be met (AND)Every condition must be trueAll conditions = true
Any condition can be met (OR)At least one condition must be trueOne or more conditions = true

Complex Scenarios: You can create sophisticated logic by combining multiple conditions:

  • High-value expenses AND travel category
  • Urgent priority OR specific user
  • Completed status AND approval checkbox

Best Practices:

  • Start with simple conditions and add complexity gradually
  • Test complex logic with sample data
  • Use descriptive automation names to clarify intent
  • Document complex logic for future reference

Dynamic Values & Placeholders

Dynamic values insert real-time data into your automations. These placeholders are replaced with actual values when the automation executes.

Cell & Range References

PlaceholderDescriptionExample Output
{{column_A}}Value from column A in triggered row”Task Name”
{{column_B}}Value from column B in triggered row”In Progress”
{{row_number}}Row number of the triggered cell”5”
{{range_A1}}Value from specific cell A1”Header Text”
{{range_B2}}Value from specific cell B2”Data Value”

Time & Date Values

PlaceholderDescriptionExample Output
{{NOW}}Current date and time”2024-01-15 14:30:25”
{{TODAY}}Current date only”2024-01-15”
{{TIME}}Current time only”14:30:25”
{{TIMESTAMP}}Unix timestamp”1705329025”

Edit Context (Sheet Change Triggers)

PlaceholderDescriptionExample Output
{{EDITED_CELL}}Cell that was changed”A5”
{{EDITED_VALUE}}New value in changed cell”Completed”
{{OLD_VALUE}}Previous value before change”In Progress”

User & System Information

PlaceholderDescriptionExample Output
{{user_email}}Your Google account email[email protected]
{{editing_user}}Email of person making changes[email protected]
{{spreadsheet_name}}Name of current spreadsheet”Project Tasks”
{{sheet_name}}Name of current sheet”Tasks”
{{sheet_url}}URL to current sheethttps://docs.google.com/…”

Schedule-Specific (Schedule Triggers)

PlaceholderDescriptionExample Output
{{FREQUENCY}}How often automation runs”daily”, “weekly”
{{TRIGGER_TIME}}Scheduled execution time”09:00:00”

Advanced Usage Examples

Email Subject with Context:

Task Update: {{column_A}} - {{TODAY}}

Log Entry with Details:

{{editing_user}} changed {{EDITED_CELL}} from '{{OLD_VALUE}}' to '{{EDITED_VALUE}}' at {{NOW}}

Conditional Cell Updates:

Last updated: {{NOW}} by {{editing_user}}

Cross-Sheet References: Use dynamic placeholders in cell references like B{{row_number}} to target the same row as the trigger.


Advanced Configuration

Condition Logic

AND Logic (All conditions must be met):

  • Every condition must be true for actions to execute
  • More restrictive - fewer executions
  • Good for precise targeting

OR Logic (Any condition can be met):

  • At least one condition must be true
  • More permissive - more executions
  • Good for multiple trigger scenarios

Performance Considerations

Trigger Optimization:

  • Use specific cell ranges instead of monitoring entire sheets
  • Avoid very frequent triggers on large datasets
  • Consider schedule triggers for batch operations

Action Efficiency:

  • Group related actions in single automations
  • Use batch operations when possible
  • Test with sample data before production use

Error Handling

Built-in Safety Features:

  • Automatic retry for failed email sends
  • Timeout protection for HTTP requests
  • Row limits for deletion operations
  • Graceful handling of missing data

Best Practices:

  • Monitor the Logs tab for execution status
  • Test automations with sample data first
  • Use descriptive names for easy troubleshooting
  • Start simple and add complexity gradually

Troubleshooting Common Issues

Automation Not Triggering:

  • Check trigger configuration (sheet name, range)
  • Verify conditions are properly set
  • Ensure automation is active

Email Not Sending:

  • Confirm email permissions are set up
  • Check recipient email addresses
  • Verify dynamic placeholders are correct

Incorrect Data in Actions:

  • Validate dynamic placeholder syntax
  • Check column references match your sheet
  • Test with sample data first