行を挿入 (プレビュー)

[行を挿入]: シートまたは範囲の指定した位置に 1 つ以上の行を挿入するブック アクティビティです。

UiPath.Excel.Activities.InsertRows

説明

シートまたは範囲の指定した位置に 1 つ以上の行を挿入します。これは、Windows の [ 行を挿入 ] アクティビティと同等のクロスプラットフォーム アクティビティです。

注:

このアクティビティでは ファイルの .xls はサポートされていません。

プロジェクトの対応 OS

Windows | クロスプラットフォーム

プロパティ

共通

• 表示名 - デザイナー パネルに表示されるアクティビティの名前です。

入力

• ファイル - リソースのブックのフル パスです。ローカル パスに切り替えるには、プラス記号のアイコンを選択し、[ローカル ファイルを使用] を選択します。現在のフィールドが [ファイル (ローカル パス)] に変更され、ブックのフル パスを指定できます。
• シート名 - ブックのシートの名前です。
• 範囲 - 行の挿入先の範囲です。範囲を指定しない場合は、シートの使用されている範囲が使用されます。
• 行数 - 挿入する行の数です。この値は 0 より大きくする必要があります。既定値は 1です。
• 位置 - 新しい行を挿入する場所を選択します。既定値は [終了] です。以下のオプションから選択できます。
  • 先頭 - 範囲の先頭に行を挿入します。
  • 末尾 - 範囲の最後の行の直後に行を挿入します。
  • 特定のインデックス - [特定の行インデックス] の行インデックスに行を挿入します。
• 特定の行インデックス - 行を挿入する範囲の先頭を基準とした、1 から始まる行インデックスです。このフィールドは必須であり、[位置] が [特定のインデックス] の場合にのみ表示されます。[ 位置] を変数または式にバインドすると、フィールドが常に表示されます。値は 1 以上で、範囲の最後の行を超えないようにする必要があります。そうしないと、アクティビティは失敗し、何も挿入されません。

オプション

• 先頭行をヘッダーとする - 範囲の先頭行がヘッダー行である場合に選択します。ヘッダー行は一番上に表示されるので、先頭に挿入する行はその下に移動します。既定では、このオプションは選択されていません。

  注:

  Windows の [ 行を挿入 ] アクティビティとは異なり、[ 先頭行をヘッダーとする ] は既定で選択されていません。選択されていない場合、[ 開始] は範囲の一番先頭行に行を挿入します。

• パスワード - ブックのパスワードです (必要な場合)。

ブックを使用する

• ブック - ファイル パスの代わりに使用する既存のブックです。

備考

• 挿入ポイントとその下にある既存の行が下にシフトします。
• 範囲を指定しない場合、シートの使用範囲を基準にして、シートの行全体が挿入されます。範囲を指定すると、[Windows] アクティビティの場合と同様に、範囲の列のセルのみが下にシフトします。これらの列の範囲の下にあるセルは下に移動し、他の列は変更されません。
• インデックスの開始 位置と 特定のインデックス 位置は、範囲の最初の行からカウントされます。[ 先頭行をヘッダーとする ] が選択されている場合は、ヘッダー行の下にあります。

既知の制限事項

テーブルへの行の挿入はまだサポートされていません。