# Read Range As Database

Bu aktivite, belirtilen Excel dosyasını doğrudan bir veritabanı tablosu gibi okuyarak veri erişimi sağlar. Excel dosyasını açmadan, belirtilen klasör yolu üzerinden veriye erişim mümkündür. Özellikle büyük veri setlerinde daha verimli çalışır. 

**Özellikler** 

* **Display Name:** Aktivitenin süreç içinde ayırt edilmesi için verilen isimdir. Varsayılan olarak "Read Range As Database" 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. 

<figure><img src="/files/M1OD9lrtY9mhEPHrSGF3" alt=""><figcaption></figcaption></figure>

**Input**&#x20;

* **Workbook Name**&#x20;
  * **Veri Tipi:** Text&#x20;
  * **Açıklama:** Okunacak Excel dosyasının tam dosya yolu.&#x20;
* **Worksheet Name**&#x20;
  * **Veri Tipi:** Text&#x20;
  * **Açıklama:** Verinin bulunduğu sayfa adı.&#x20;
* **Range**&#x20;
  * **Veri Tipi:** Text&#x20;
  * **Açıklama:** Belirli bir hücre aralığı (örneğin "A1:C10"). Boş bırakılırsa tüm veri alınır.&#x20;
* **Where Clause**&#x20;
  * **Veri Tipi:** Text&#x20;
  * **Açıklama:** SQL benzeri bir koşul ifadesi (örneğin "WHERE \[Column1] = 'Value'").&#x20;
* **Provider**&#x20;
  * **Veri Tipi:** Text&#x20;
  * **Açıklama:** OLEDB sağlayıcısı. Genellikle "Microsoft.ACE.OLEDB.12.0" olarak kullanılır.&#x20;
* **Excel Version**&#x20;
  * **Veri Tipi:** Text&#x20;
  * **Açıklama:** Excel sürümü. "Excel 12.0" genellikle .xlsx dosyaları için kullanılır.&#x20;
* &#x20;**Add Headers**&#x20;
  * **Veri Tipi:** True/False&#x20;
  * **Açıklama:** İlk satırın başlık (kolon isimleri) olarak kullanılıp kullanılmayacağı.&#x20;

<figure><img src="/files/Zv1eDuMipUveomVHk3RT" alt=""><figcaption></figcaption></figure>

**Outputs**&#x20;

* **Datatable**&#x20;
  * **Veri Tipi:** DataTable&#x20;
  * **Açıklama:** Okunan Excel verilerinin tablo formatındaki çıktısı.&#x20;

<figure><img src="/files/cSRCThu0vJpVGiNKsj79" alt=""><figcaption></figcaption></figure>

**Örnek Kullanım:**&#x20;

* Büyük boyutlu Excel dosyalarının filtrelenerek okunması&#x20;
* SQL benzeri sorgularla veri çekilmesi (WHERE Clause ile)&#x20;
* Excel dosyasını arka planda açmadan veri alınması&#x20;

&#x20;&#x20;

**Not:**&#x20;

* Bu aktivitenin kullanılabilmesi için sistemde "Microsoft Access Database Engine" kurulumu gereklidir.&#x20;
  * **Kurulum bağlantısı:** \
    <http://www.microsoft.com/en-us/download/details.aspx?id=13255>&#x20;
* Kurulum yapılmadıysa aktivite çalışmayacaktır. Ayrıca, Excel dosyasının açık olması gerekmez; sadece dosya yolu yeterlidir.&#x20;

**Kullanım Örneği:**&#x20;

{% embed url="<https://genrpa.com/download/Activities/EXCEL/XML/Excel_ReadRangeAsDatabase.xml>" %}

**Örnek Kullanım İçin Gerekli Dosyalar:**

<https://genrpa.com/download/Activities/EXCEL/ExcelActivities.xlsx>

<https://genrpa.com/download/Activities/EXCEL/ExcelActivitiesCSV.csv>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.genrpa.com/aktiviteler/excel/database/read-range-as-database.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.