Read Cell (Excel)

Reads the value and the displayed text of one cell.

Behaviour

Risk: None · Idempotent: Yes · Safe to retry: Yes · Recovery: Replayed after a crash

Package Excel activities Velophex.Excel.Activities 0.7.1-rc.7 · Supported (Core profile) · type id velophex.excel.readCell

Properties#

Input#

Sheet#

Sheet · String · Required · Default: Sheet1

The name of the sheet, for example Sheet1.

Cell#

Cell · String · Required · Default: Not specified in package metadata

The cell address in A1 notation, for example B7.

Workbook#

Workbook · ExcelWorkbookReference · Optional · Default: Not specified in package metadata

The Excel file to use. Empty uses the innermost enclosing Use Excel File; set it to the Reference As name of a Use Excel File to use that one.

Output#

Value#

Value · Object · Output

The cell's value (text, number, boolean, date or time), or null when the cell is blank.

Text#

Text · String · Output

The value as Excel displays it, using the cell's number format.

Rules#

• Must be inside Use Excel File.

Retry and risk#

This activity is safe to retry: running it again after a transient failure does not repeat a side effect. If a run is interrupted and the outcome of a step is unknown, the step is never retried automatically (what to do). How activities declare this: characteristics, retries and risk.

Every activity also has the engine's common properties: Timeout and Continue On Error.

Related activities#

• Append Range (Excel)
• Auto Fill
• Auto Fit Range
• Clear Range
• Copy Paste Range
• Copy Sheet
• Create Sheet
• Create Table

Generated from Velophex.Excel.Activities 0.7.1-rc.7. Category: Excel. Keywords: excel, workbook, xlsx, spreadsheet, cell, read, value, get.

Properties

Input

Output

Rules

Retry and risk

Related activities