Excelファイルの相互作用

SenseTalkを使用すると、Microsoft Excel形式で保存されたデータにアクセスできます。 このセクションの関数を使用して、SenseTalkは個々のセルの値から直接データを読み取ります。

Excelのスプレッドシートファイルに値を更新して書き戻すことができ、セル内のプロパティ（テキストの色やフォントサイズなど）を更新できます。 例えば、SenseTalkを設定してスプレッドシートからデータを読み取り、このデータを使用してテストを実行し、その結果をスプレッドシートに書き戻すことができます。

SenseTalkでExcelファイルを扱う

これらのオブジェクトは Excel ワークブック ファイルのそれぞれの部分への参照として機能するため、これらのオブジェクトのいずれかのプロパティまたはセルの値を変更すると、ワークブック自体の対応する側面が変更されます。これらのオブジェクトのいずれかをパラメーターとしてコマンドまたは関数に渡すとき、呼び出されたハンドラーからワークブックにアクセスする場合は、オブジェクトを参照によって明示的に渡す必要があります。それ以外の場合、SenseTalk はオブジェクトのコピーを作成し、呼び出されたハンドラーによって受信された値はワークブックへの接続を失います。

重要

ここで説明する機能は、SenseTalkのデータベース機能とは異なります。スプレッドシートの内容にデータベースとしてアクセスするには、"Excel をデータベースとして使用する"を参照してください。

ノート

ファイル参照
ベスト プラクティスとして、SenseTalk スクリプト内で参照されるファイルはすべて、スイート ウィンドウのリソース ペインから Eggplant Functional に追加する必要があります。このメソッドは、指定されたスイートのスイート ディレクトリ内の Resources ディレクトリにファイルを保存します。 SenseTalk はローカル ファイル システム上の別の場所に保存されているファイルにアクセスできますが、Resources ディレクトリを使用すると追加機能が提供されます。詳細については、リソース ペイン を参照してください。

Excel ファイルへの複数の接続の作成
Eggplant Functional では Excel ファイルへの接続を複数作成できますが、そうすると問題やエラーが発生する可能性があります。たとえば、workbook (このページで説明) と database (ここで説明) の両方として Excel ファイルに接続すると、Eggplant Functional は"InternalWorkbookError - データ ソースが必要ですが、ワークブックの値がありません"のようなエラー メッセージを返す可能性があります。このエラーは、接続の 1 つを閉じることで修正できます。

ファイルから直接データを読み取るか、またはデータをファイルに書き込むには、次の関数とプロパティを使用します：

Workbook Function はワークブック ファイルを識別し、他の関数を使用してそのファイルにアクセスするための開始点を提供します。

Workbook() Functionはワークブックファイルを識別し、他の関数を使用してそれにアクセスするための起点を提供します。

Cell Functionはワークシート内の特定のセルの値とプロパティへのアクセスを提供します。

CellRange Functionは、ワークシートの行、列、または矩形領域の範囲内の複数のセルに素早くアクセスできるようにします。

Workbook 関数

Behavior： Workbook 関数は、Excelスプレッドシートへの直接アクセスの開始点です。この関数はパラメータとしてExcelファイルへのパス名を受け取り、.xlsx ファイル拡張子を持つExcelファイルを参照し、Workbook 参照を返します。

Parameters: Excelファイルへのパス名。

構文：
Workbook( ExcelFileName )

例:

set MyExcelFile to Workbook(ResourcePath("TestCases.xlsx")) //MyExcelFile を TestCases.xlsx Excel ファイルの参照変数として設定します

例:

set MyExcelFile to Workbook("TestCases.xlsx") // TestCases.xlsx Excelファイルへの参照変数としてMyExcelFileを設定する。workbook() 関数はデフォルトのスイートディレクトリ内のTestCases.xlsx Excelファイルを探します

先端

この Workbook 関数参照を Worksheet、Cell、または CellRange 関数と一緒に使用して、Excelファイルの内容にアクセスするか、またはワークブックについての他の情報を取得します。

ブックのプロパティ

以下の読み取り専用プロパティが Workbook 関数で利用可能です：

プロパティ	定義
colorMode	Excel の RGB モードでブックを操作するには、デフォルトは"RGB"ですが、"RGB" または "パレット"に設定できます。パレット モードでは、色のない要素に "NoColor"値を指定できます。 注意 最も一般的な使用法は、"c​​olorMode"を "RGB" に設定したままにすることです。パレット モードに切り替える主な目的は、RGB モードでは使用できない色をテストするか、"NoColor" に設定することです。パレット モードでは、サポートされる色の数が限られているため、色を設定すると若干異なる色になる可能性があります。
worksheetCount	ワークブックに含まれるワークシートの数。
worksheetNames	ワークブック内のすべてのワークシートの名前のリスト。

worksheetCount and worksheetNamesを示す例:

put workbook(excelFilePath) into myWorkbook
put myWorkbook is a workbook --> True   (myWorkbook is a workbook object)
put myWorkbook's worksheetCount --> 3
put the worksheetNames of myWorkbook --> ["People","Departments","Facilities"]

関連:

• Worksheet 関数: この関数を使用してワークブック内の特定のワークシートにアクセスします。
• Cell 関数: この関数を使用して、個々のセルの値またはプロパティにアクセスします。
• CellRange 関数: この関数を使用して、セル、行、または列の範囲にアクセスします。

Worksheet 関数

Behavior： この関数は、ワークブック内の特定のワークシートへのアクセスを提供します。この関数は Worksheet 参照を返します。

Parameters: ブック参照とシート識別子。ブック参照は、最初のパラメーターとして関数に渡すか (以下の最初の構文)、Worksheet 関数をブック オブジェクトの関数として呼び出すことができます (以下の 2 番目と 3 番目の構文)。シート識別子は、シートの名前またはその番号 (ブックの最初のシートの場合は 1、2 番目のシートの場合は 2 など) のいずれかです。

構文:
worksheet( workbook, sheetIdentifier )
worksheet( sheetIdentifier ) of workbook
workbook .worksheet( sheetIdentifier )

例:

set worksheet2 to Worksheet(MyExcelFile, 2) // Excelファイルの2番目のワークシートを参照するようにworksheet2を設定します

例:

set custBudget to MyExcelFile.Worksheet("Customer Budget") // "Customer Budget" という名前のワークシートを参照するように custBudget を設定します

ブックのプロパティ

以下のプロパティは Worksheet() 関数で利用可能です：

プロパティ	定義
name	ワークブック内のシートの名前。このプロパティを設定すると、ワークシートの名前を変更できます。
workbook	シートが属するブック (Workbook オブジェクト)。読み取り専用です。
sequenceNumber	各ワークシートには、ワークブック内のシーケンスを示す sequenceNumber プロパティがあります。最初のワークシートの sequenceNumber は 1 です。"sequenceNumber"を別の値に設定すると、ワークシートをワークブック内の別の順序の位置に移動できます。
hidden	put the cellType of Cell("A3") of worksheet1— ワークシートの指定されたセルから cellType プロパティ値を表示
tabColor	ワークシートの tabColor プロパティは、そのシートのタブの色を指定します。
ハイパーリンク	ワークシートの hyperlinks プロパティは、ワークシート内のすべてのハイパーリンクのリストを返す読み取り専用プロパティです。各ハイパーリンクは、プロパティ hyperlinks 、row,、およびcolumn を含むプロパティ リストとして返されます。これらの値は、リンク URL、セルの行番号と列番号です。 関連: セルのハイパーリンク プロパティ

例：

put worksheet(1) of myWorkbook into mySheet //ワークブックの最初のワークシートにアクセスする
put mySheet is a worksheet --> True   (mySheet is a worksheet object)
put mySheet's name --> "People"
put "Special" before mySheet's name
put the worksheetNames of myWorkbook --> ["People","Departments","Facilities"]

"workbook"プロパティの例:

put the worksheetNames of mySheet's workbook --> ["SpecialPeople","Departments","Facilities"]

sequenceNumber プロパティの例:

// ワークシートをワークブックの先頭に 1 つ近い位置に移動します
if myWorksheet’s sequenceNumber > 1 then subtract 1 from the sequenceNumber of myWorksheet

hidden プロパティの例:

turn off the hidden of worksheet(2) of myWorkbook // 隠した2番目のワークシートを再表示

tabColor プロパティの例:

set the tabColor of myWorksheet to yellow

ハイパーリンク プロパティの例:

put the hyperlinks of myWorksheet

関連：

• Workbook Function: この関数を使用して、Excelワークブックファイルにアクセスします。
• Cell 関数: この関数を使用して、個々のセルの値またはプロパティにアクセスします。
• CellRange 関数: この関数を使用して、セル、行、または列の範囲にアクセスします。

Cell 関数

例: セル識別子をパラメータとして、ワークシートの関数として Cell 関数を呼び出します：

Cell 関数によって返される値は、Cell オブジェクト (worksheeet 内の特定のセルへの参照) であり、その値はセルの内容です。セルオブジェクトの値は、スプレッドシートのセルに保存されている内容に応じて、文字列、数値、ブール値、または日付になります。セルオブジェクトもコンテナであり、変数のように値を変更できます。さらに、セルオブジェクトには、アクセス可能なプロパティが多数あります。

Parameters: 以下のいずれかのアプローチを使用してパラメータを渡します：

• ワークシート参照とセル識別子を渡します。
• セル識別子をパラメータとして、ワークシートの関数として Cell 関数を呼び出します。

構文:
cell( worksheetReference, cellIdentifier )
cell( cellIdentifier ) of worksheetReference
worksheetReference .cell( cellIdentifier )

例: ワークシート参照とセル識別子を渡します：

put Cell(worksheet1, "A3") into cellValue1

例: セル識別子をパラメータとしてワークシートの関数として Cell を使用してセル値にアクセスする

put worksheet1.Cell(4,7) into workingBalance

Example: セルオブジェクトをコンテナとして使用してセル値を更新する

add 1 to worksheet1's Cell("E3") // 更新 worksheet1 のセル E3

**例:**他のセルプロパティへのアクセス:

put the date into Cell(worksheet1, [3,5]) //日付を worksheet1 の行 3、列 5 に格納します。

テキストプロパティ

Cell オブジェクトでは次のプロパティを使用できます。

プロパティ	定義
borderColor	セルの BorderColor プロパティは、セルの境界線 (存在する場合) の色を定義します。 BorderStyle プロパティを使用して、境界線のスタイルを設定します。
borderStyle	セルの borderStyle プロパティは、セルの境界線の描画に使用されるスタイルの名前です。境界線を表示するには、セルの borderColor プロパティも設定する必要があります。 "borderStyle"は、"DashDot"、"DashDotDot"、"Dashed"、"Dotted"、"Double"、"Hair"、"Medium"、"MediumDashDot"、"MediumDashDotDot"、"MediumDashed"、"None"、"SlantDashDot"、"Thick"、"Thin"のいずれかに設定できます。名前内のスペースと大文字は無視されるため、borderStyle を"medium DashDot Dot"などに設定することは有効です。
cellType	CellType プロパティは、Number, String, Date, Boolean, Blank, Empty の値、または以下のエラー文字列をサポートします: #NULL!, #DIV/0!, #VALUE!, #REF!, #NAME?, #NUM!, #N/A
columnHidden	セルを含む列が非表示かどうかを示す真偽値（真または偽）。
columnWidth	セルの columnWidth プロパティは、そのセルを含む列の幅 (ピクセル単位) です。セルの columnWidth を変更すると、列全体の幅が変更されます。
fillPattern	セルの fillPattern プロパティは、セルの背景で使用される塗りつぶしパターンの名前です。パターンを表示するには、セルの patternForegroundColor プロパティまたは patternBackgroundColor プロパティの一方または両方を設定する必要もあります。 "DiagonalCrosshatch", "DiagonalStripe", "Gray12.5", "Gray25v, "Gray50", "Gray6.25", "Gray75", "HorizontalStripe", "None", "ReverseDiagonalStripe", "Solid", "ThickDiagonalCrosshatch", "ThinDiagonalCrosshatch", "ThinDiagonalStripe", "ThinHorizontalCrosshatch", "ThinHorizontalStripe", "ThinReverseDiagonalStripe", "ThinVerticalStripe"、または"VerticalStripe". 名前内のスペースと大文字は無視されるため、fillPattern を"細い斜めのクロスハッチ"のようなものに設定することは有効です。
fontColor	セル内のテキストの色。
fontName	セル内に表示されるテキストのフォント名。
fontSize	セル内に表示されるテキストのフォントサイズ。
formula	セルに存在する式（セルが式を含む場合）。
horizontalAlignment	セルの horizo​​ntalAlignment プロパティは、セルのテキスト内容をセル内で水平方向 (左から右) に配置する方法を指定します。 "horizo​​ntalAlignment"は、Center", "Distributed", "Fill", "General", "Justify", "Left", "Merge", "Right"のいずれかに設定できます。名前内のスペースと大文字は無視されるため、"horizo​​ntalAlignment"を" disTRIButed "などに設定することは有効です。
ハイパーリンク	セルのハイパーリンク プロパティには、セルがリンクする URL が表示されます。この値を設定して、ハイパーリンクを変更または追加できます。 関連: ワークシートのハイパーリンク プロパティ: ワークシート内のすべてのハイパーリンクのリストを返す読み取り専用プロパティ。
mergeRange	セルの MergeRange プロパティは、セルが含まれる結合セルの範囲全体 (ある場合) を識別します。セルが結合範囲内にある場合、mergeRange プロパティの値は、2 組のセル座標のリストになります (それぞれ [行番号、列番号] 形式)。たとえば、セル "A1" がセル A1 からセル D2 まで広がる結合範囲内にある場合、mergeRange プロパティの値は [[1,1], [2,4]] になります。セルが結合範囲の一部でない場合、その mergeRange は空になります。 セルの mergeRange を設定する場合、範囲を単一の値または値のペアとして指定できます。これは、CellRange 関数で許可されているとおりです。mergeRange を空に設定すると、セルに関連付けられた結合範囲が削除されます。
patternForegroundColor, patternBackgroundColor	セルの patternForegroundColor プロパティと patternBackgroundColor プロパティは、セルの fillPattern (存在する場合) の前景色と背景色を定義します。多くの場合、パターンの前景色のみが設定され、背景色は未設定 (白) のままになります。
rowHeight	セルの rowHeight プロパティは、そのセルを含む行の高さをピクセル単位で表したものです。セルの rowHeight を変更すると、行全体の高さが変更されます。
rowHidden	セルを含む行が非表示かどうかを示す真偽値（真または偽）。
worksheet	シートが属するブック (Workbook オブジェクト)。読み取り専用です。
verticalAlignment	セルの verticalAlignment プロパティは、セル内のテキスト コンテンツをセル内で垂直方向 (上から下) に配置する方法を指定します。verticalAlignment は、Bottom", "Center", "Distributed", "Justify", または "Top"のいずれかに設定できます。名前内のスペースと大文字は無視されるため、verticalAlignment を"CENTER"などに設定しても問題ありません。

例: Cellオブジェクトをコンテナとして使用して、セルの値を設定します。

set the borderColor of cell(“A2”) of statusSheet to orange 

**例:**セルの CellType の決定:

put "PartNum" into cell("D1") of myWorksheet
put the CellType of cell("D1") of myWorksheet --> "String"
put 50519 into cell("D2") of myWorksheet
put the CellType of cell("D1") of myWorksheet --> "String"

例: fontColor にアクセスする

Excelの色関数はインデックス色とRGB色のみをサポートしています。 このセクションに表示されている関数がサポートされていないフォント色を読み取り処理すると、色値`0,0,1`が返されます。

**例:**セル内のテキストのサイズを大きくする:

add 4 to the fontSize of Cell("A3") of worksheet1 // fontSize を 4 増やします

例: borderStyle プロパティの設定

set the borderStyle of salesSheet.cell(“A6”) to “slant DashDot”

例:columnWidth を拡張する

add 10 to the columnWidth of cell(“D1”) of myWorksheet

例:: fillPattern の設定

set the fillPattern of salesSheet.cell(“D4”) to “gray 12.5”

例: 水平方向の配置を設定する

set the horizontalAlignment of salesSheet.cell(“A6”) to “center”

ベストプラクティスとして、SenseTalkスクリプト内で参照されるファイルは、スイートウィンドウのリソースペインを通じてEggplant Functionalに追加する必要があります。 この方法では、ファイルが指定されたスイートのスイートディレクトリ内のリソースディレクトリに保存されます。 SenseTalkはローカルファイルシステム上の他の場所に保存されたファイルにアクセスできますが、リソースディレクトリを使用すると追加の機能が提供されます。 詳細については、リソースペインをご覧ください。

 set the hyperlink of cell(3,5) of myWorksheet to “https://www.keysight.com”

例: mergeRange プロパティの使用

set the mergeRange of cell(“A2”) of sales to “A2:F2”
put the mergeRange of cell(“A2”) of sales —> [[2,1], [2,6]]
delete mySheet’s cell(5,9).mergeRange

例: patternForegroundColor プロパティの設定

set the patternForegroundColor of cell(“A2”) of statusSheet to darkGreen

例: rowHeight プロパティへのアクセス

put rowHeight of cell(5,1) of salesSheet into row5ht

例: verticalAlignmentプロパティの設定

set the verticalAlignment of salesSheet.cell(“A6”) to “Bottom”

注記

• Workbook 関数: この関数を使用してExcelのワークブックファイルにアクセスします。
• Worksheet Function: この関数を使用して、ワークブック内の特定のワークシートにアクセスします。
• CellRange Function: この関数を使用して、セル、行、または列の範囲にアクセスします。

CellRange 関数

Behavior:CellRange 関数は、ワークシート セルの矩形範囲にアクセスするために使用されます。これは、1 つ、2 つ、または 3 つのパラメーター (ワークシート参照と 0、1、または 2 つのセル/行/列識別子) を渡すか、識別子をパラメーターとしてワークシートまたはブックの関数として呼び出すことによって呼び出すことができます。

cellRange 関数 __ は、範囲にセルが 1 つしか含まれていない場合でも、常にリストのリストを返します。外側のリストの各項目は、範囲内の 1 つの行の値を保持します。内側のリストの各項目は、その行内の列ごとに 1 つずつ、Cell オブジェクト (Cell 関数で説明) です。

Parameters: 以下で説明するように、ワークシート オブジェクト (または最初のワークシートにアクセスする場合は workbook オブジェクト) と、最大 2 つのセル、行、または列の識別子。

構文:
cellRange( worksheet, firstIdentifier, secondIdentifier )
cellRange( worksheet {, singleIdentifier } )
cellRange( worksheet, firstIdentifier, secondIdentifier )
worksheet .cellRange( { singleIdentifier } )

セルの範囲は、さまざまな方法で指定できます。識別子が指定されていない場合、cellRange は、定義された値を含むワークシートのすべての行と列を含む範囲を返します。

2 つの識別子を指定する場合、オプションには次のものが含まれます。

• firstIdentifier と _secondIdentifier は_どちらも、"C6" と "E8"、または [6,3] と [8,5``] などの特定のセルを識別します。返されるセルには、これら 2 つのセルを反対側の角とする四角形の範囲のセルが含まれます。
• firstIdentifier と _secondIdentifier は_どちらも "B" や "D" などの列文字を指定します。返される範囲には、その範囲の列のすべてのセルが含まれます (たとえば、この例では列 B、C、D のすべてのセル)。
• firstIdentifier と _secondIdentifier は_どちらも 9 や 12 などの行番号を指定します。返される範囲には、その行範囲のすべてのセルが含まれます (たとえば、この例では行 9、10、11、12 のすべてのセル)。

識別子が 1 つしか指定されていない場合、オプションには次のものが含まれます。

• singleIdentifier は、"F9" や [2,13] などの特定のセルを識別します。その 1 つのセルが返されます (CellRange は常にリストのリストを返すため、そのセルを含む別のリストを含むリストとして)。
• singleIdentifier は、"G" などの 1 つの列の文字を指定します。その列のすべてのセルが返されます。
• singleIdentifier は、42 などの 1 つの行番号を指定します。その行のすべてのセルが返されます。
• singleIdentifier は、"A:H"、"16:42"、"E3:H7" など、":" 文字で区切られた 2 つの識別子を含む文字列です。その範囲の列、行、またはセル内のすべてのセルが返されます。
• singleIdentifier は、rows: [4,15,9,12] などの行番号のリストを含む rows: listOfRows プロパティを指定するプロパティ リストです。これにより、指定された行のすべての列の値が (指定された順序で) 返されます。これにより、分離した行のリストを指定できます。
• singleIdentifier は、columns: [A,C,Z,T] や columns: [1,5,7,10] などの列番号または文字のリストを含む columns: listOfColumns プロパティを指定するプロパティ リストです。これにより、指定された列のすべての行の値が (指定された順序で) 返されます。これにより、分離した列のリストを指定できます。

例:

put worksheet1.cellRange ("C6", "E8") into columnsBasic // セル範囲のリストを作成します

例:

put worksheet1.cellRange("C","E") into columnsBasic -- 列範囲のリストのリストを作成

例:

put cellRange(2, lastRowNum) of worksheet1 into columnsBasic // 2 から lastRowNum までのすべての行のリストのリストを作成します

例:

put cellRange("C:E") of worksheet1 into columnsBasic -- コロンを使用して、列範囲のリストのリストを作成

例:

put cellRange("6:8") of worksheet1 into columnsBasic -- コロンを使用して、列範囲のリストのリストを作成

例:

put worksheet1's cellRange into allCellList -- allCellList 変数にリストのリストを割り当てる

例:

put cellRange(1) of worksheet1 into firstRow -- 行 1 の値を含むリストのリストを firstRow 変数に割り当てる

例:

put worksheet1.cellRange("A","E") into columnsBasic-- A から E の各行に対してリストのリストを columnsBasic 変数に割り当てる

例：

put cellRange("B3","D5") of worksheet1 into rectRange -- セルによって定義される長方形の範囲内のリストのリストを rectRange 変数に割り当てる

関連:

• Workbook 関数: この関数を使用してExcelワークブックファイルにアクセスします。
• Worksheet 関数: この関数を使用して、ワークブック内の特定のワークシートにアクセスします。
• Cell 関数: この関数を使用して個々のセルの値またはプロパティにアクセスします。

InsertColumns コマンド

Behavior: ワークシートに 1 つ以上の列を挿入します。

コマンド構文: insertColumns worksheet, columnToInsert insertColumns worksheet, columnRangeToInsert insertColumns worksheet, firstColumn , lastColumn

columnToInsert は、挿入される列を示す数字または文字です。列の範囲を挿入するには、範囲 (columnRangeToInsert) を指定するか、最初と最後を示す 2 つの数字または文字をカンマで区切って指定します (firstColumn と lastColumn)。列は数字または文字で参照できます。

例：

insertColumns greenSheet, 2 // 新しい列を挿入します 2

insertColumns customerInfo, 1..3 // 3 つの新しい列 1、2、3 を挿入します。

insertColumns myNewSheet, A,C // 3 つの新しい列 A、B、C を挿入します

DeleteColumns コマンド

動作: ワークシートから 1 つ以上の列を削除します。

コマンド構文:
**deleteColumns ワークシート、columnToDelete_
**deleteColumns ワークシート、削除する列_
deleteColumns worksheet, firstColumn , lastColumn

columnToDelete は、削除する列を示す数字または文字です。列の範囲を削除するには、範囲 (columnRangeToDelete) を指定するか、最初と最後をカンマで区切った 2 つの数字または文字 (firstColumn と lastColumn) を指定します。列は数字または文字で参照できます。

例:

deleteColumns infoFileSheet, F // 列 F を削除します

deleteColumns myTestSheet, 6..9 // 4 つの列 6、7、8、9 を削除します

deleteColumns newSheet, H..J // 3 つの列 H、I、J を削除します

InsertRows コマンド

Behavior: ワークシートに 1 つ以上の行を挿入します。

コマンド構文:
**insertRows ワークシート、rowToInsert_
**insertRows ワークシート、rowRangeToInsert
insertRows worksheet, firstRow , lastRow

rowToInsert は、挿入される行を示す番号です。行の範囲を挿入するには、範囲 (rowRangeToInsert) を指定するか、最初と最後をカンマで区切った 2 つの数値 (firstRow と lastRow) を指定します。行は番号で参照されます。

例:

insertRows customerData, 10 // 行 10 を挿入

insertRows productSheet, 1500,1599 // 1500 から 1599 までに 100 行の新しい行を挿入します

insertRows myTestSheet, 100..103 // 4 つの行 100、101、102、および 103 を挿入します

Delete コマンド

Behavior: ワークシートから 1 つ以上の行を削除します。

コマンド構文:
**deleteRows ワークシート、rowToDelete_
**deleteRows ワークシート、rowRangeToDelete_
deleteRows worksheet, firstRow , lastRow

rowToInsert は、削除する行を示す番号です。行の範囲を削除するには、範囲 (rowRangeToDelete) を指定するか、最初と最後をカンマで区切った 2 つの数値 (firstRow と lastRow) を指定します。行は番号で参照されます。

deleteRows productSheet, 100 // 行 100 を削除します

deleteRows myWorksheet, 1..5 // 1 から 5 までの 5 行を削除します

deleteRows tooLongSheet, 2000,5500 // 行 2000 ～ 5500 を削除します

追加のワークブックアクション

ワークブック内のワークシートにアクセスし、ワークシート内のセルの内容にアクセスして変更するための上記の関数に加えて、ワークブックおよびワークシートに対して次のアクションを実行できます。

Worksheet Functionはワークブック内の特定のワークシートを識別します

Behavior: NewWorksheet 関数は、ワークブック内に新しいワークシートを作成します。この関数は、新しいワークシートを参照する Worksheet オブジェクトを返します。

構文：
newWorksheet( options )
newWorksheet( workbook, sheetNameOrOptions )
workbook . newWorksheet( sheetNameOrOptions )

以下のプロパティは Worksheet() 関数で利用可能です

最初の構文を使用する場合、パラメーター options には、ワークブックを指定するための workbook: プロパティが含まれている必要があります。また、以下の sheetNameOrOptions で説明されているオプションが含まれる場合もあります。

パラメーター sheetNameOrOptions は、新しいワークシートに付ける名前、または次の 1 つ以上のプロパティのいずれかです。

• name: 新しいワークシートの名前。
• sequenceNumber: 新しいワークシートを挿入する連続位置。1 を指定するとワークブックの最初のシートになります。指定しない場合、新しいワークシートはワークブックの最後のワークシートとして追加されます。
• copyFrom: コピーする必要があるワークブック内の既存のワークシート。これを指定した場合、その値はワークシート オブジェクトである必要があり、新しいワークシートは copyFrom ワークシートのすべての値のコピーとして初期化されます。

関連項目:

put newWorksheet(myWorkbook, “Flowers”) into flowerSheet

set myNewSheet to workbook’s newWorksheet(name:”Summary”, sequenceNumber:2, copyFrom: worksheet(1) of workbook)

set anotherSheet to newWorksheet(workbook:myWorkbook, name:“CustomerList”)