Tabloyu Filtrele

Komut: filterTable

Kullanılabilir kaynak: < Standard>

Veri tablolarının değerlerini ve yapısını satırlara ya da istenen değere göre süzer.

Tablo yapısı, satırları, sütunları ve tablo stillerini içerir.

Sözdizimi

filterTable [--indexes(List<Numeric>)] [--where(String)] --dataTable(DataTable) (DataTable)=value (Numeric)=rows (Numeric)=columns

Girişler

Komut dosyası	Tasarımcı	Zorunlu	Kabul edilen tipler	Açıklama
-- dizinler	Dizinler	İsteğe bağlı	Liste < Sayı >, Liste < Text>, Sayı	Süzülebilmek için veri tablosu satırlarına ilişkin dizin. 1. Girilen numaralar 1 ile 2147483647 arasında olmalıdır. Bu değer aralığı aşıyorsa, "Değer aralığın dışında" iletisi döndürülür. 2. Indexes (Dizinler) parametresinin değeri çizelgedeki herhangi bir satırla eşleşmezse, aşağıdaki hata iletisi görüntülenir: Kaynak DataRows içermez.
-- nerede	Konum	İsteğe bağlı	Metin	Veri tablosu hücresinde belirli bir değeri bulmaktan sorumlu metin. 1. Kullanılan sözdizimi " LINQ C #" sorgu dili standartlarını temel alır. Belirli bir sütun verilerine göre süzgeç uygulamak için, örneğin aşağıdaki seçeneği kullanabilirsiniz: Şirket = 'IBM Robotic Process Automation'. Bu değere sahip tüm satırlar kopyalanacak. 2. Bu parametredeki karşılaştırma işleçleri şunlardır: >, < ,> =, < =, < >, OR, AND, LIKE>%, IN, LIKE *, NOT.
--dataTable	Kaynak	Zorunlu	Veri Tablosu	Süzülen veri tablosu.

Komut dosyası

Tasarımcı

Zorunlu

Kabul edilen tipler

Açıklama

-- dizinler

Dizinler

İsteğe bağlı

Liste < Sayı >, Liste < Text>, Sayı

Süzülebilmek için veri tablosu satırlarına ilişkin dizin.

1. Girilen numaralar 1 ile 2147483647 arasında olmalıdır. Bu değer aralığı aşıyorsa, "Değer aralığın dışında" iletisi döndürülür.

2. Indexes (Dizinler) parametresinin değeri çizelgedeki herhangi bir satırla eşleşmezse, aşağıdaki hata iletisi görüntülenir: Kaynak DataRows içermez.

-- nerede

Konum

İsteğe bağlı

Metin

Veri tablosu hücresinde belirli bir değeri bulmaktan sorumlu metin.

1. Kullanılan sözdizimi " LINQ C #" sorgu dili standartlarını temel alır. Belirli bir sütun verilerine göre süzgeç uygulamak için, örneğin aşağıdaki seçeneği kullanabilirsiniz:

Şirket = 'IBM Robotic Process Automation'.

Bu değere sahip tüm satırlar kopyalanacak.

2. Bu parametredeki karşılaştırma işleçleri şunlardır: >, < ,> =, < =, < >, OR, AND, LIKE>%, IN, LIKE *, NOT.

--dataTable

Kaynak

Zorunlu

Veri Tablosu

Süzülen veri tablosu.

Çıkışlar

Komut dosyası	Tasarımcı	Kabul edilen tipler	Açıklama
değer	Çizelge	Veri Tablosu	Süzülen sütun ve satırlarla bir veri tablosu döndürür.
Satırlar	Satırlar	Numara	Süzülen satır sayısını döndürür.
Sütunlar	Sütunlar	Numara	Süzülen sütunların sayısını döndürür.

Örnek

Örnek 1: "excelTable" değişkenine atanan veri tablosunda Süzgeç Tablosu komut süzgeçleri, "Şehir" sütununa ait olan "Sao Paulo" değerine sahip hücreler, bu süzgeci "newExcelTable" adlı yeni bir değişkene atayarak, süzülen satır ve sütunların sayısını döndürür.

defVar --name excelFile --type Excel
defVar --name excelTable --type DataTable
defVar --name newExcelTable --type DataTable
defVar --name rowsQuantity --type Numeric
defVar --name columnsQuantity --type Numeric
// Download the following file to execute the command.
excelOpen --file "tableExcelCompanyCity.xlsx" excelFile=value
excelGetTable --file ${excelFile} --getfirstsheet  --entiretable  --hasheaders  excelTable=value
//
filterTable --where "City = \'Armonk\'" --dataTable ${excelTable} columnsQuantity=columns rowsQuantity=rows newExcelTable=value
logMessage --message "Table with filtered data: ${newExcelTable}\r\nRows Quantity: ${rowsQuantity}\r\nColumns Quantity: ${columnsQuantity}" --type "Info"
// This example returns the following output:
// Table with filtered data:
// IBM Corporation, Armonk
//
// Rows Quantity: 1
// Columns Quantity: 2

Örnek 2: "tableExcel" değişkenine atanan veri tablosındaki süzgeçler, "1" ve "3" dizinlerine sahip satırlardaki değer ve süzgeçten geçirilen satır ve sütunların sayısını döndürür.

defVar --name excelFile --type Excel
defVar --name excelTable --type DataTable
defVar --name newExcelTable --type DataTable
defVar --name rowsQuantity --type Numeric
defVar --name columnsQuantity --type Numeric
defVar --name excelTableIndexList --type List --innertype Numeric --value "[1,3]"
// Faça o download do arquivo a seguir para executar o comando.
excelOpen --file "tableExcelCompanyCity.xlsx" excelFile=value
excelGetTable --file ${excelFile} --getfirstsheet  --entiretable  --hasheaders  excelTable=value
//
filterTable --indexes ${excelTableIndexList} --dataTable ${excelTable} newExcelTable=value rowsQuantity=rows columnsQuantity=columns
logMessage --message "Table with filtered data: ${newExcelTable}\r\nRows Quantity: ${rowsQuantity}\r\nColumns Quantity: ${columnsQuantity}" --type "Info"
// This example returns the following output:
// Table with filtered data:
// IBM Robotic Process Automation, Toronto
// IBM Robotic Process Automation, Armonk
//
// Rows Quantity: 2
// Columns Quantity: 2