並べ替え範囲 (プレビュー)

範囲を並べ替え (ワークブック) 範囲内のデータを 1 つ以上の列で並べ替えるアクティビティ。

UiPath.Excel.Activities.SortRange

説明

範囲内のデータを 1 つ以上の列で並べ替えます。これは、Windows の [範囲を並べ替え ] アクティビティと同等のクロスプラットフォーム アクティビティです。

注:

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

プロジェクトの対応 OS

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

プロパティ

共通

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

入力

• ファイル - リソースのブックのフル パスです。ローカル パスに切り替えるには、プラス記号のアイコンを選択し、[ローカル ファイルを使用] を選択します。現在のフィールドが [ファイル (ローカル パス)] に変更され、ブックのフル パスを指定できます。
• シート名 - ブックのシートの名前です。
• 範囲 - 並べ替える範囲です ( A1:B10 形式)。このフィールドは必須です。
• 列を並べ替え - 並べ替えの基準にする列です。リスト、配列、または任意のシーケンスを使用できます。このフィールドは必須です。各エントリには、次のメンバーがあります。
  • ColumnName - 並べ替えの基準にする列です。[ 先頭行をヘッダーとする ] が選択されている場合はヘッダー名を入力し、選択されていない場合は文字を入力します (例: "B")。
  • Order - 並べ替えの方向です ( Ascending または Descendingです。既定値は Ascendingです。

オプション

• 先頭行をヘッダーとする - 範囲の先頭行をヘッダー行として扱い、並べ替えから除外するには、このオプションを選択します。既定では、このオプションは選択されています。
• パスワード - ブックのパスワードです (必要な場合)。

ブックを使用する

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

備考

• [ 先頭行をヘッダーとする ] を選択した場合、 ColumnName ヘッダーと完全に一致する必要があります。その場合、列の文字として読み取られることはありません。[ 先頭行をヘッダーとする ] が選択されていない場合、 ColumnName 範囲内の列文字である必要があります。
• ヘッダー行はそのまま残り、並べ替えられません。
• A:Cなどの列全体または行全体の範囲は、シートで使用される範囲に制限されます。
• 範囲は [シート名] のシートを参照する必要があります。Sheet2!A1:C10などのシート名を含む範囲はサポートされていないため、エラーが発生します。
• 次の場合、アクティビティはエラーで失敗します。
  • [範囲] または [列を並べ替え] が空です。
  • [列を並べ替え] に、空のエントリ、または ColumnNameのないエントリが含まれています。
  • [先頭行をヘッダーとする] が選択されており、ColumnNameがどのヘッダーとも一致しない
  • [先頭行をヘッダーとする] は選択されておらず、ColumnName範囲外の列文字です。