Used to activate a cell or range of cells in the active worksheet of a Microsoft Excel document that was previously created using the Create Workbook action or opened using the Open Workbook action. Ideal for selecting a cell or cells in order to perform an action, such as formatting the cells or entering values in them. Be aware that this action works only on the active worksheet. To activate a specific worksheet, use the Activate Worksheet action.
Declaration
<AMEXCELACTIVATECELL SESSION="text" ACTION="text" CELLROW="number" CELLCOLUMN="number" />
Example 1 - Activate a single cell by position.
<AMEXCELACTIVATECELL SESSION="ExcelSess10" ACTION="cellbyposition" CELLROW="2" CELLCOLUMN="3" />
Example 2 - Activate a range of cells by position.
<AMEXCELACTIVATECELL SESSION="ExcelSess10" ACTION="rangebyposition" UPPERLEFTROW="2" UPPERLEFTCOLUMN="3" LOWERRIGHTROW="5" LOWERRIGHTCOLUMN="5" />
See Also: Create Workbook, Open Workbook, Close Workbook, Add Worksheet, Activate Worksheet, Set Cell, Cells to Dataset, Dataset to Cells, Get Active Worksheet, Get Cell
Activates a cell or range of cells within the currently active worksheet in an established Excel session.
|
AWE's Excel actions use Microsoft's Excel automation engine to perform their work. Therefore, Microsoft Excel must be licensed and installed on the system in order for these actions to work. Excel objects run in the context of the user executing them. If EFT is running as a Local System, then the Excel object is executed using the Local System profile. Before using an Excel action in Event Rules, refer to Globalscape Knowledgebase article #11089 for important information. This action is only useful in conjunction with other Excel actions. It is not possible to use AWE's Excel actions on a spreadsheet that was not opened by the Open Workbook action or created by the Create Workbook action. |
Property |
Type |
Required |
Default |
Markup |
Description |
Session Name |
Text |
Yes |
ExcelSess1 |
SESSION="Session7" |
Specifies the session name to identify which document should be acted on. Numerous sessions can exist within a single task allowing several spreadsheets to be open simultaneously. If working with only one document, this can remain at the default name, which is Excelsess1. |
Activate |
Text |
Yes |
Cell By Reference |
ACTION= "rangebyposition" |
Specifies the cell selection method. The available options are:
|
Cell reference |
Text |
Yes if activate method is Cell by Reference |
(Empty) |
CELLREF="B3" |
The reference of the cell to activate. Active only if Cell by reference is the selected Activate parameter. |
Row |
Number |
Yes if activate method is Cell by position |
1 |
CELLROW="3" |
The row of the cell to activate. Active only if Cell by position is the selected Activate parameter. |
Column |
Number |
Yes if activate method is Cell by position |
1 |
CELLCOLUMN="2" |
The row of the cell to activate. Active only if Cell by position is the selected Activate parameter. |
Upper Left Cell |
Text |
Yes if activate method is Cell by reference |
(Empty) |
UPPERLEFTREF="A1" |
The reference of the upper left cell in the range of cells to activate. Active only if Range by reference is the selected Activate parameter. |
Lower Right Cell |
Text |
Yes if activate method is Cell by reference |
(Empty) |
LOWERRIGHTREF="C5" |
Specifies the reference of the lower right cell in the range of cells to activate. Active only if Range of cells by reference is the selected Activate parameter. |
Upper Left Cell Row |
Number |
Yes if activate method is Cell by position |
(Empty) |
UPPERLEFTROW="1" |
Specifies the row of the upper left cell in the range of cells to activate. Active only if Range of cells by position is the selected Activate parameter. |
Upper Left Cell Column |
Number |
Yes if activate method is Cell by position |
(Empty) |
UPPERLEFTCOLUMN="1" |
Specifies the column of the upper left cell in the range of cells to activate. Active only if Range of cells by position is the selected Activate parameter. |
Lower Right Cell Row |
Number |
Yes if activate method is Cell by position |
(Empty) |
LOWERRIGHTROW="14" |
The row of the lower right cell in the range of cells to activate. Active only if Range of cells by position is the selected Activate parameter. |
Lower Right Cell Column |
Number |
Yes if activate method is Cell by position |
(Empty) |
LOWERRIGHTCOLUMN="3" |
The column of the lower right cell in the range of cells to activate. Active only if Range of cells by position is the selected Activate parameter. |