SmartestQADocs
TR EN
DATA-DRIVEN

Datasource

Harici veri kaynaklarını testlerinize bağlayın. API, Excel/CSV ve Database verilerini kullanarak data-driven testler oluşturun.

Genel Bakış

Datasource, testlerinizde kullanacağınız verileri harici kaynaklardan çekmenizi sağlar. Bir datasource tanımlayın, testcase'inizde ${variable} syntax'ı ile kullanın.

Excel / CSV

Spreadsheet dosyalarından veri okuyun

Statik

Database

SQL sorguları ile veritabanından çekin

JDBC

Nasıl Çalışır?

1. Datasource Oluştur

API, Excel veya DB

2. Testcase'e Bağla

Datasource seç

3. Değişken Kullan

${column_name}

4. İterasyon

Her satır için koş

Excel / CSV Datasource

Excel (.xlsx, .xls) veya CSV dosyalarından test verisi yükleyin. Veri odaklı test için ideal.

Sayfa Düzeni

Datasource sayfasına gidin ve Excel/CSV sekmesine tıklayın. Sayfa iki bölümden oluşur:

Sol Panel - Excel Dosyaları Listesi

Daha önce yüklenmiş tüm Excel/CSV dosyalarını gösterir. Detaylarını görüntülemek veya düzenlemek için dosya adına tıklayın.

Excel Files x

login_test_data
user_credentials
form_validation_data
Sağ Panel - Yükleme ve Düzenleme

Excel/CSV dosyalarını yüklediğiniz ve yapılandırdığınız ana içerik alanı.

Excel DataSource

Upload Excel Description

Dosya seçmek için tıklayın

Desteklenen: XLSX, XLS, CSV

File Name
Save Delete

Dosya Nasıl Yüklenir

  1. 1 Datasource sayfasına gidin ve Excel/CSV sekmesine tıklayın
  2. 2 Yükleme alanında "Select File" butonuna tıklayın veya dosyanızı sürükleyip bırakın (XLSX, XLS veya CSV)
  3. 3 Datasource'u tanımlamak için bir File Name girin
  4. 4 Dosyanızın ilk satırı sütun başlıklarını içeriyorsa "Header" onay kutusunu işaretleyin
  5. 5 Dosyayı yüklemek ve kaydetmek için "Save" butonuna tıklayın

Header Seçeneği

Header onay kutusu etkinleştirildiğinde, dosyanın ilk satırı sütun adları olarak kullanılır. Bu sütun adları, testlerinizde ${sütun_adı} sözdizimi ile kullanabileceğiniz değişken adları olur.

Header açık (ilk satır = sütun adları)

username password expected
admin@test.com Admin123! success
user@test.com User456! success

Kullanım: ${username}, ${password}

Header kapalı (otomatik sütun adları)

col_0 col_1 col_2
username password expected
admin@test.com Admin123! success

Kullanım: ${col_0}, ${col_1}

Dosya Yönetimi

Görüntüle / Düzenle

Detaylarını görüntülemek veya güncellemek için sol paneldeki dosya adına tıklayın

Sil

Bir dosya seçin ve kaldırmak için Delete butonuna tıklayın

Desteklenen Formatlar

.xlsx

Excel 2007+

.xls

Excel 97-2003

.csv

Virgülle Ayrılmış

Veritabanı Veri Kaynağı (JDBC)

JDBC ile veritabanınıza bağlantı tanımlayın. Bu bölüm yalnızca bağlantı ayarlarını yapılandırmanızı sağlar; sorgu çalıştırma işlemi testcase içindeki Database (JDBC) step ile yapılır.

Sayfa Yapısı

Üst Sekmeler

Simple DB Excel/CSV

Sol Panel

DB Configurations listesi ve yeni bağlantı ekleme butonu ()

Sağ Panel

Database Connection formu — bağlantı bilgilerini girin

Bağlantı Formu (Database Connection)

Formda aşağıdaki alanları doldurun:

1

Name

Bağlantıya vereceğiniz isim

2

Database Url

JDBC bağlantı URL'i

3

JDBC Driver Class

Veritabanına uygun JDBC sürücü sınıfı

4

Username

Veritabanı kullanıcı adı

5

Password

Veritabanı şifresi

İşlem Butonları

Test Connection

Bağlantıyı test edin

Save

Bağlantıyı kaydedin

Delete

Bağlantıyı silin

Örnek JDBC URL'leri

# PostgreSQL
jdbc:postgresql://localhost:5432/mydb
# MySQL
jdbc:mysql://localhost:3306/mydb
# SQL Server
jdbc:sqlserver://localhost:1433;databaseName=mydb
# Oracle
jdbc:oracle:thin:@localhost:1521:mydb

Not: Bu sayfa yalnızca veritabanı bağlantısı tanımlamak içindir. SQL sorgusu çalıştırmak için testcase içinde Database (JDBC) step kullanın.

Testlerde Kullanım

Datasource'u testcase'e bağladıktan sonra, sütun isimlerini ${column_name} formatında kullanın.

1. Datasource'u Testcase'e Bağlama

Testcase detay sayfasında, sağ panelden Datasource dropdown'unu bulun ve oluşturduğunuz datasource'u seçin.

Datasource:

2. Değişkenleri Kullanma

Type Action - Email alanı

${username}

→ Her iterasyonda farklı email yazılır

Type Action - Şifre alanı

${password}

→ Her iterasyonda farklı şifre yazılır

3. İterasyon Örneği

Test 3 satırlık Excel datasource ile çalıştırıldığında:

İter 1 Type "admin@test.com" → Type "Admin123!" → ✓ success
İter 2 Type "user@test.com" → Type "User456!" → ✓ success
İter 3 Type "invalid@test.com" → Type "wrong" → ✗ error (expected)

Değişken Syntax Referansı

Basit Kullanım

${column_name}

Datasource sütun değerini kullanır

Global Param ile Birlikte

${base_url}/users/${user_id}

Global ve datasource değişkenlerini birleştirir

Assertion'da Kullanım

Beklenen: ${expected_result}

Beklenen değer datasource'dan gelir

API Step'te Kullanım

{"email": "${email}", "name": "${name}"}

JSON body içinde değişken

En İyi Uygulamalar

Anlamlı Sütun İsimleri

a, b, c yerine username, password, expected gibi açıklayıcı isimler kullanın.

Test Verilerini Ayırın

Positive ve negative case'ler için ayrı datasource veya expected_result sütunu kullanın.

Sensitive Data için Environment

Şifre gibi hassas verileri environment variable olarak saklayın, datasource'a koymayın.

Çok Fazla Satır

1000+ satır yerine anlamlı test senaryolarını kapsayan 10-50 satır kullanın.

Production DB'ye Direkt Bağlantı

Production veritabanına bağlanmayın, staging veya test DB kullanın.

Hardcoded Credentials

API token veya DB şifrelerini doğrudan yazmayın, Global Parameters kullanın.