Ayraç kuralları - QCR Scanner Docs

Uzun bir listeyi düz bir değer yığını olarak bırakmak yerine, içine başlıklar serpiştirerek bölümlere ayırabilirsiniz. QCR Scanner’da bunu ayraç (separator) kuralları yapar: belirli bir desene uyan bir değer (örneğin bir tarih ya da bir bölüm başlığı) listeye normal bir kayıt yerine genişletilebilir bir bölüm başlığı olarak girer. Altına eklenen her değer o bölüme toplanır; başlığa dokunarak bölümü açıp kapatabilirsiniz.

Bu sayfa ayracın ne işe yaradığını, bir ayraç kuralının nasıl eklendiğini, listede genişletilebilir bölümlerin nasıl davrandığını ve ayraçların doğrulama kurallarından farkını anlatır.

Ayraç nedir, ne işe yarar?

Sahada veri toplarken kayıtlar genelde gruplar hâlinde gelir: bir günün okumaları, bir rafın seri numaraları, bir partinin kodları. Hepsini tek bir uzun listede tutmak işe yarar ama gözle takip etmek zorlaşır. Ayraçlar bu noktada devreye girer.

Bir ayraç, taranan veya sesle girilen bir değeri kayıt yerine bölüm başlığı hâline getirir. Tipik kullanımları:

Tarih başlıkları — her yeni günün başında taranan tarih, o güne ait kayıtları kendi bölümünde toplar.
Bölüm/grup başlıkları — bir raf adı, bir oda numarası ya da bir parti kodu, altındaki kayıtları mantıksal bir grup hâline getirir.
Görsel ayırıcılar — uzun bir listede nereden nereye kadar hangi grubun olduğunu bir bakışta görmenizi sağlar.

Ayraç olarak işaretlenen bir değer yine listenizde durur ve dışa aktarmaya dâhil olur; farkı, listede genişletilebilir bir başlık gibi görünmesi ve altına gelen kayıtları kendi bölümüne almasıdır.

İpucu: Ayraçlar veriyi silmez ya da değiştirmez; yalnızca listede nasıl gruplandığını belirler. Bir değeri ayraç yapmak, onu kayıt olmaktan çıkarmaz — yalnızca o kaydı bir bölüm başlığı rolüne taşır.

Ayraç kuralı ekleme

Ayraç kuralları da, doğrulama kuralları gibi regex (düzenli ifade) tabanlıdır. Bir değer girilmeye çalışıldığında, tanımladığınız ayraç desenine uyup uymadığı kontrol edilir; uyuyorsa o değer normal bir kayıt yerine bir bölüm başlığı olarak eklenir.

Tipik bir akış şöyledir:

Ayarlardan ayraç kuralları bölümünü açın.
Yeni bir kural ekleyip o kuralın eşleşeceği deseni regex olarak yazın.
Kuralı kaydedin; bundan sonra bu desene uyan her değer ayraç olarak işlenir.

Örneğin gün başlıklarını yakalamak için gg.aa.yyyy biçimindeki tarihleri eşleyen bir desen kullanabilirsiniz:

^\d{2}\.\d{2}\.\d{4}$

Bu desene uyan bir değer (örneğin 21.06.2026) tarandığında ya da sesle girildiğinde, listeye düz bir kayıt olarak değil, altına yeni kayıtların toplanacağı bir bölüm başlığı olarak eklenir.

Not: Regex desenleri büyük bir esneklik sağlar ama dikkatli yazılmaları gerekir. QCR Scanner, aşırı uzun ya da kendini katlayan desenlere ve girdilere karşı ReDoS koruması uygular; bu tür desenler reddedilir. Kuralınızı dar tutun (örneğin başına ^ ve sonuna $ ekleyerek tam değeri hedefleyin), böylece istemediğiniz değerleri yanlışlıkla ayraç yapmazsınız.

Regex yazmakta zorlanırsanız deseni elle kurmak zorunda değilsiniz: doğal dilden kural üretmek için yapay zeka ile kural üreteci sayfasına bakabilirsiniz.

Listede genişletilebilir bölümlerin davranışı

Bir değer ayraç olarak eklendiğinde liste, o başlıktan itibaren yeni bir bölüm açar. Davranış şöyledir:

Bölüm başlığı olarak görünen ayraç, altına gelen kayıtları kendi başlığı altında toplar.
Yeni bir ayraç tarandığında yeni bir bölüm başlar; bir sonraki ayraca kadar eklenen tüm kayıtlar bu yeni bölüme girer.
Genişletilebilir başlığa dokunarak bölümü açıp kapatabilirsiniz; uzun listelerde ilgilenmediğiniz grupları katlayıp ekranı sade tutmanıza yardımcı olur.

Bu sayede tek bir uzun liste, tarih tarih ya da grup grup okunabilen düzenli bir yapıya dönüşür. Ayraçlar listeyi yalnızca görsel olarak düzenlemekle kalmaz; dışa aktarımda da işaretli kalırlar.

CSV’ye aktardığınızda her kaydın ayraç olup olmadığı bir bayrakla taşınır; aynı bilgi webhook gövdesinde de isSeparator alanıyla gönderilir:

{
  "action": "add",
  "listName": "Saha-21Haziran",
  "item": {
    "value": "21.06.2026",
    "isQR": false,
    "source": "ocr",
    "createdAt": "2026-06-21T09:00:00Z",
    "isSeparator": true
  },
  "timestamp": "2026-06-21T09:00:00Z"
}

Böylece verinizi başka bir sisteme gönderdiğinizde, hangi satırların başlık hangilerinin kayıt olduğu bilgisi korunur. Dışa aktarma ve senkron ayrıntıları için CSV dışa aktarma ve webhook senkronu sayfalarına bakın.

Doğrulama kurallarıyla ilişkisi ve farkı

Ayraç kuralları ve doğrulama kuralları ilk bakışta benzer görünür — her ikisi de regex tabanlıdır ve bir değerin bir desene uyup uymadığına bakar — ama farklı işler yaparlar:

	Doğrulama kuralı	Ayraç kuralı
Amaç	Bir değerin listeye eklenip eklenmeyeceğine karar verir	Eklenen bir değeri bölüm başlığı yapar
Eşleşmediğinde	Değer reddedilir, listeye girmez	Değer normal bir kayıt olarak girer
Eşleştiğinde	Değer geçerli sayılır ve eklenir	Değer bir genişletilebilir bölüm başlığı olur
Listedeki rolü	Kalite filtresi (gürültüyü ayıklar)	Düzenleme/gruplama (bölümler oluşturur)

Kısacası doğrulama kuralları kapıdaki bekçidir: yalnızca tüm etkin kurallara uyan değerler listeye girer. Ayraç kuralları ise listeye giren değerlerin nasıl düzenleneceğini belirler. İkisi birlikte çalışır: önce bir değer doğrulamadan geçer, sonra ayraç desenine uyuyorsa bölüm başlığı olarak yerleşir.

İpucu: Yalnızca temiz tarih ya da başlık değerlerinin ayraç olmasını istiyorsanız, ilgili doğrulama kuralını ve ayraç kuralını birlikte tasarlayın. Böylece hem gürültülü OCR sonuçları elenir hem de geçerli başlıklar otomatik olarak bölümlere dönüşür.

Gürültülü OCR metninden geçerli parçaları otomatik ayıklamak isterseniz, ayraç ve doğrulamayla birlikte çalışan Akıllı Çıkarım özelliğine de göz atın.

Sonraki adımlar

Doğrulama kuralları — hangi değerlerin listeye gireceğini regex ile belirleyin
Listeler — birden fazla liste oluşturun, tetikleyicilerle aralarında otomatik geçiş yapın
Akıllı Çıkarım — gürültülü OCR metninden geçerli değerleri otomatik ayıklayın
CSV dışa aktarma — bölümlü listenizi ayraç bilgisiyle birlikte dışa aktarın

ReviseTouch tarafından geliştirildi.