Scan Pharma Code, ilaç ambalajlarındaki Laetus pharmacode'unu (siyah-beyaz dikey çubuk dizisi) canlı kamera veya galeri aracılığıyla okuyup tam sayı koda çeviren bir aksiyondur. Android tarafında paketlenmiş PoC tabanlı bu aksiyon, tıpkı bir barkod okuyucu gibi çalışır: kamera ekranı açılır, üzerinde bir tarama alanı (overlay) gösterilir ve kullanıcı kodu bu alana tuttuğunda canlı okuma gerçekleşerek sonuç PharmaScanResult (One) tipinde döndürülür.

Teknik Özellikler

• Laetus Pharmacode Okuma: İlaç ambalajlarına özgü siyah-beyaz dikey çubuk dizisini tanır ve tam sayı koda çevirir.
• Canlı Kamera Taraması: Aksiyon tetiklendiğinde kamera ekranı açılır ve tarama alanı (overlay) gösterilir; kullanıcı kodu bu alana tuttuğunda okuma otomatik gerçekleşir.
• Galeri Desteği: İsteğe bağlı olarak canlı kamera yerine galeriden seçilen görsel üzerinden de tarama yapılabilir.
• Yapılandırılmış Dönüş: Tarama sonucu PharmaScanResult (One) tipinde döner; dönen yapı içerisinde pharmacode değeri ve binary decoding bilgisi yer almaktadır.
• Mobil Uyumluluk: Yalnızca Android uygulamalarda çalışmaktadır.

Scan Pharma Code Aksiyonu Uygulama Adımları

• Kuika platformuna giriş yapın ve projenizi açın.
• UI Design modülüne geçin.

• Tarama işlemini başlatmak istediğiniz elementi seçin ve onClick eventini açın.
• Properties panelinden + ADD ACTION menüsüne tıklayın.
• Açılan menüden tetikleyici olayı seçin (Initial Actions veya Recurring Actions).
• Orta sütundan Device kategorisini seçin.
• Aksiyon listesinden Scan Pharma Code seçeneğini tıklayın.

Aksiyon Parametreleri

Scan Pharma Code aksiyonunun zorunlu bir girdi parametresi bulunmamaktadır. Aksiyon tetiklendiğinde kamera ekranı otomatik olarak açılır, tarama alanı (overlay) gösterilir ve kullanıcı kodu bu alana tuttuğunda canlı okuma gerçekleşerek sonuç PharmaScanResult (One) tipinde döndürülür.

Opsiyonel Parametreler

+ ADD OPTIONAL PARAMETER butonu ile aşağıdaki ek ayar yapılandırılabilir:

• readFromGallery (Boolean): Etkinleştirildiğinde canlı kamera yerine cihazın fotoğraf galerisinden görsel seçilerek tarama yapılır. Kamera erişiminin mümkün olmadığı senaryolarda veya önceden çekilmiş bir ilaç fotoğrafının işlenmesi gerektiğinde kullanılır.
  
  • False (varsayılan): Parametre eklenmemiş gibi davranır, tarama canlı kamera ile gerçekleştirilir.
  • True: Cihazın fotoğraf galerisi açılır ve kullanıcı bir görsel seçerek tarama işlemini başlatır.

Gelişmiş Ayarlar

• Don't Trigger Validations: Etkinleştirildiğinde aksiyon çalışırken sayfadaki validasyon kuralları tetiklenmez. Tarama işleminin doğrulama sürecinden bağımsız çalışması gereken senaryolarda kullanılır.

Dönüş Değeri

Scan Pharma Code aksiyonu, başarılı bir tarama sonucunda PharmaScanResult (One) tipinde veri döndürür. Dönen yapı aşağıdaki alanları içerir:

• pharmacode: Okunan tam sayı pharmacode değeri.
• binaryDecoding: Çubuk dizisinin binary karşılığı.

Sonraki aksiyonlarda Action Result kaynağı aracılığıyla kullanılabilir; örneğin okunan pharmacode değerini bir veri tabanında sorgulamak veya ekranda görüntülemek için bağlanabilir.

Kullanım Senaryosu: İlaç Ambalajındaki Pharmacode'u Okuyarak Ürün Bilgisi Getirme

Senaryo: Kullanıcı, eczane uygulamasında bir ilacın ambalajındaki Laetus pharmacode'unu tarayarak ürün bilgilerine hızlıca ulaşmak ister.

Yapılandırma:

• Aksiyon: Scan Pharma Code
• readFromGallery: İşaretlenmemiş (canlı kamera ile tarama)
• Tarama sonrası: PharmaScanResult içindeki pharmacode değeri, bir sonraki aksiyonda sorgu parametresi olarak kullanılır ve ilgili ürün detay ekranına yönlendirme yapılır.

Kullanıcı kamerayı tarama alanına (overlay) göre ilaç ambalajına tutar, pharmacode otomatik olarak okunur ve ürün bilgileri ekranda listelenir.

İleri Seviye Özelleştirmeler

• Galeri Entegrasyonu: readFromGallery parametresi ile canlı kamera yerine galeriden görsel işlenebilir; bu sayede daha önce çekilmiş ilaç fotoğrafları da taranabilir.
• Zincirleme Aksiyonlar: PharmaScanResult içindeki pharmacode değeri Action Result üzerinden bir API çağrısına veya veri tabanı sorgusuna bağlanabilir.
• Koşullu Akış: Tarama sonucuna göre Condition aksiyonu ile farklı ekranlara yönlendirme yapılabilir.

Teknik Riskler

• Kamera İzni: Kullanıcı kamera iznini reddetmişse tarama başlatılamaz. Uygulama gerekli izinlerin tanımlı olduğundan emin olmalıdır.
• Düşük Kaliteli Görsel: Bulanık veya hasarlı barkodlarda tarama başarısız olabilir. readFromGallery kullanılıyorsa yüksek çözünürlüklü görsel tercih edilmelidir.
• Desteklenmeyen Format: Aksiyon Laetus pharmacode formatı için optimize edilmiştir; standart dışı barkod türlerinde sonuç dönmeyebilir.

Scan Pharma Code aksiyonu, sağlık ve eczane uygulamalarında ilaç ambalajlarındaki pharmacode bilgilerine hızlı ve hatasız erişim sağlamak için tasarlanmış güçlü bir araçtır. Canlı kamera taraması, yapılandırılmış dönüş ve zincirleme aksiyon uyumluluğu sayesinde ilaç yönetimi süreçlerini dijitalleştirir ve kullanıcı deneyimini iyileştirir.