excelListSheets
Version 24.2.9039
Version 24.2.9039
excelListSheets
Lists the worksheets in a specified Excel workbook.
Optional Parameters
- version: The Excel version of the target workbook. The allowed values are
AUTO
,95
,97-2003
,2007
. The default isAUTO
. - file: The full path on disk, including the filename, of the Excel workbook. You must specify either the
file
orhandle
parameter. - handle: A readable handle reference to the Excel data created by excelOpen. If you specify the
file
parameter,handle
is not required.
Output Attributes
- sheet: The name of the current sheet in the target workbook.
- ishidden: A boolean (true/false) indicating whether the current sheet is hidden in the workbook.
Example
In this example, the sheets of the target Excel workbook are listed and added to a file which is then pushed as output of the script.
<!-- Initializing the output item of the script -->
<arc:set attr="output.data" />
<!-- Creating the input item for the operation and passing it in -->
<arc:set attr="excel.file" value="C:\Temp\movies.xlsx" />
<arc:set attr="excel.version" value="2007" />
<arc:call op="excelListSheets" in="excel" out="sheets">
<!-- Creating some output data and file from the sheet names in the workbook -->
<arc:set attr="output.data" value="[output.data]\nSheet = [sheets.sheet] | Hidden = [sheets.ishidden]" />
<arc:set attr="output.filename" value="results.txt" />
</arc:call>
<!-- Push the output item out as a file -->
<arc:push item="output" />
The output of this script looks like this:
Sheet = music | Hidden = false
Sheet = tvshows | Hidden = true
Sheet = film | Hidden = false