Lookup Range

Bu aktivite, belirtilen Excel çalışma sayfasında belirli bir hücre aralığında (range) istenilen değeri aramayı sağlar. Arama işlemi, tam hücre içeriğiyle veya büyük/küçük harf duyarlılığıyla yapılabilir.

Özellikler

• Display Name:Aktivitenin süreç içinde ayırt edilmesi için verilen isimdir. Varsayılan olarak "Lookup Range" olarak ayarlanır.

• Description : Aktivitenin işlevini açıklayan isteğe bağlı bir not alanıdır. Sürecin bakımını kolaylaştırmak için kullanılır.

• Delay Before : Aktivite başlamadan önce geçen bekleme süresini (saniye cinsinden) belirtir.

  • Varsayılan Değer: 0 (Bekleme olmadan çalışır).

  • Örnek Kullanım: Aktivitenin çalıştırılmasından önce belirli bir süre beklemek gerekiyorsa, bu süre burada belirtilir. Örneğin, 2 yazılırsa aktivite başlamadan önce 2 saniye bekler.

• Delay After: Aktivite tamamlandıktan sonra geçen bekleme süresini (saniye cinsinden) belirtir.

  • Varsayılan Değer: 0 (Bekleme olmadan bir sonraki aktiviteye geçer).

  • Örnek Kullanım: İşlem tamamlandıktan sonra sistemde gecikmeler yaşanıyorsa ya da sonraki adımın başlaması için bir süre verilmesi gerekiyorsa, bu alanda belirtilir.

• Continue On Error: Aktivite sırasında bir hata oluştuğunda sürecin devam edip etmeyeceğini kontrol eden özelliktir.

  • True: Aktivite hata aldığında bile süreç çalışmaya devam eder.

  • False: Aktivite hata alırsa süreç durur.

  • Varsayılan Değer: False (Varsayılan olarak süreç hata alırsa durur).

  • Örnek Kullanım: Kritik olmayan işlemlerde hata olsa bile sürecin devam etmesi isteniyorsa bu seçenek True olarak ayarlanır. Örneğin, bir dosyanın varlığını kontrol eden bir aktivitede hata alınırsa ve süreç bu hataya rağmen devam etmeliyse bu seçenek aktif edilir.

Inputs

• Workbook Name

  • Veri Tipi: Text

  • Açıklama: Değerin aranacağı Excel çalışma kitabının adını belirtir.

• Worksheet Name

  • Veri Tipi: Text

  • Açıklama: Değerin aranacağı çalışma sayfasının adını belirtir.

• Range

  • Veri Tipi: Text

  • Açıklama: Aramanın yapılacağı hücre aralığını belirti

  • Örnek:

    • Boş bırakılması durumunda sayfada kullanılan alan alınacaktır.

    • Belirli bir hücre için arama yapılması istendiğinde "A2" gibi spesifik bir hücre girilir.

    • Belirli bir aralık için arama yapılması istendiğinde "A1:C13" gibi spesifik bir aralık girilir.

• Value

  • Veri Tipi: Text

  • Açıklama: Aranacak değeri belirtir.

• Match Case

  • Veri Tipi: True/False

  • Açıklama: Büyük/küçük harf duyarlılığını etkinleştirir.

  • Varsayılan Değer: True

  • Kullanım Örneği:

    • True: Büyük/küçük harf duyarlılığı aktifleştirilir.

    • False: Büyük/küçük harf duyarlılığı kaldırılır.

• Is Match Entire Cell Contents

  • Veri Tipi: True/False

  • Açıklama: Hücre içeriğinin tamamen eşleşip eşleşmediğini kontrol eder.

  • Varsayılan Değer: False

  • Örnek:

    • True: Arama yapılan değerin, hücre içeriği ile bire bir aynı olması koşulu ile değer bulunur. Örneğin; A2 hücresinde "İşlem başarılı." yazıyorsa ve arama yapılan değer "başarılı" ise bu değer tüm hücre içeriği ile eşleşmediği için bulunmaz. Arama yapılan değer "İşlem başarılı." ise değer bulunur.

    • False: Arama yapılan değerin, hücre içeriğinde bulunması koşulu ile değer bulunur. Örneğin; A2 hücresinde "İşlem başarılı." yazıyorsa ve arama yapılan değer "başarılı" ise bu değer hücre içeriğinde mevcut olduğu için bulunur.

• Is Color Founded Values

  • Veri Tipi: True/False

  • Açıklama: Bulunan hücrelerin arka plan renklerini alıp almayacağını belirtir.

  • Varsayılan Değer: False

  • Örnek:

    • True: Arama yapılan değer bulunduğunda, bulunulan hücredeki yazı tipi rengi belirtilen renk ile değiştirilir.

    • False: Arama yapılan değer bulunsa da bulunmasa da herhangi bir hücredeki yazı tipi rengi değiştirilmez.

• Color Hex Value

  • Veri Tipi:Text

  • Açıklama: Eğer Is Color Founded Values True olarak ayarlanmışsa, bulunan hücrelerin renk kodları döndürülür.

  • Örnek:

    • Arama yapılan değerin bulunduğu hücredeki yazı tipi rengini mavi bir renkle değiştirmek için "#89CFF0" değeri girilir.

Outputs

• Result

  • Veri Tipi: Collection

  • Açıklama: Aranan değerin bulunduğu hücrelerin adreslerini ve varsa renk kodlarını içeren bir koleksiyon döndürür. Sütun olarak Column, Rown ve AddressLocal değerlerini içinde barındırır.

Örnek Kullanım:

• Belirtilen hücre aralığında belirli bir değeri aramak.

• Büyük/küçük harf duyarlılığına göre eşleşen değerleri bulmak.

• Hücrelerin yalnızca belirli bir renk koduna sahip olup olmadığını kontrol etmek.

• Veri doğrulama süreçlerinde, belirli bir hücrede istenilen değerin olup olmadığını tespit etmek.

Örnek Kullanım:

https://genrpa.com/download/Activities/EXCEL/XML/Excel_LookopRange.xmlgenrpa.com

Örnek Kullanım İçin Gerekli Dosyalar:

https://genrpa.com/download/Activities/EXCEL/Worksheet.xlsx

Not:

• Aktivitenin çalışabilmesi için belirtilen Excel dosyasının açık olması gerekmektedir.

• Eğer hücre aralığı belirtilmezse, tüm sayfa içinde arama yapılabilir.

• Birden fazla eşleşme bulunursa, tüm eşleşmeler koleksiyon içinde saklanır.

• Eğer yalnızca belirli bir renk koduna sahip hücreleri bulmak isteniyorsa, Is Color Founded Values parametresi True olarak ayarlanmalıdır.