Yerel Veri İstemcisi (Local Data Client)

1. Genel bakış

Konu

Açıklama

Özellik adı (TR)

Yerel Veri

Özellik adı (EN)

Local Data

Pencere başlığı (TR)

Yerel Veri

Pencere başlığı (EN)

Local Data

Uygulama

PAW Resource

Amaç

Resource makinesindeki yerel veritabanındaki tabloları görüntüleme, düzenleme, SQL ile sorgulama ve paket olarak aktarma

Depolama

Bu bilgisayara ve Windows kullanıcısına özgü şifreli SQLite veritabanı

Lisans

Şirketin lisansında Local Data eklentisi bulunmalıdır

Yerel Veri, iş akışlarında ara sonuçları harici bir veritabanı sunucusuna ihtiyaç duymadan Resource makinesinde saklamak için kullanılır. Yerel Veri penceresi ise bu veriyi etkileşimli olarak incelemenizi ve yönetmenizi sağlar.

Not: Yerel Veri, workflow aktiviteleri (DataTable To Local Data, Local Data To DataTable vb.) ile aynı veritabanını kullanır. Yerel Veri penceresi bu tablolara PAW Kaynak üzerinden elle erişim sağlar.


2. Kimler kullanabilir?

Koşul

Açıklama

Uygulama girişi

PAW Resource’a geliştirici modunda giriş yapılmış olmalı. Robot kullanıcısıyla (Api Kullanıcısı, Canlı makine) yapılan girişte, yani üretim modunda, düğme görünmez (bkz. PAW Kaynak).

Lisans

Şirketin lisansında Local Data eklentisi bulunmalı. Lisans girişte denetlenir; lisans değişirse yeniden giriş yapın.

Lisans yoksa

Başlık bandındaki Yerel Veri düğmesi görünmez

Windows kullanıcısı

Veritabanı Windows kullanıcısının %AppData% klasöründedir. Robotun yazdığı tabloları görmek için robotun çalıştığı bilgisayarda, aynı Windows hesabıyla geliştirici modunda giriş yapın.


3. Ne zaman kullanılır?

Senaryo

Açıklama

Hata ayıklama

Workflow’un yazdığı tabloları satır satır kontrol etme

Operasyon

Robot makinesinde biriken veriyi inceleme veya temizleme (robotun Windows hesabıyla, geliştirici modunda giriş yaparak)

Şema yönetimi

Tablo / sütun ekleme, yeniden adlandırma, silme

SQL analizi

Özel sorgularla filtreleme, birleştirme, özet alma

Ortamlar arası aktarım

Veriyi .pawld paketiyle başka bir Resource makinesine taşıma


4. Açma ve kapatma

4.1. Açma

  1. PAW Resource’a geliştirici modunda giriş yapın.

  2. Başlık bandında, dil ve tema düğmelerinin yanındaki veritabanı simgesine tıklayın (ipucu: Yerel Veri istemcisini açar). Düğmenin metni yoktur.

  3. Yerel Veri penceresi açılır ve veritabanına bağlanır; boş bir sorgu sekmesi hazırdır.

  4. Durum çubuğunda yüklenen tablo sayısı görünür.

Pencere tek örnektir: zaten açıksa yeniden oluşturulmaz, öne getirilir; simge durumundaysa geri yüklenir. Bağımsız bir penceredir ve görev çubuğunda görünür.

4.2. Kapatma davranışı

Eylem

Sonuç

Pencerenin X düğmesi (ya da Alt+F4)

Pencere gizlenir; açık sekmeler ve yazdığınız SQL korunur. Yeniden açınca tablo listesi kendiliğinden yenilenmez; Tabloları Yenile'yi kullanın.

Çıkış Yap, giriş ekranına dönüş ya da uygulamadan çıkış

Yerel Veri penceresi kapanır. Sekmeler, SQL'ler ve uygulanmamış Gözat düzenlemeleri kaybolur; veritabanındaki veriler kalır.


5. Arayüz yapısı

Yerel Veri penceresi

Yerel Veri penceresi

Bölüm

İçerik

Sol panel: Tablolar

Tablo ve sütun ağacı (Adı ve Type sütunları) ve Filtre kutusu. Filtre kutusunun yanında ⋮ (İşlemler: Dışa Aktar / İçe Aktar / Tümünü Sil) ve Tabloları Yenile simgeleri vardır. Panel otomatik gizlenebilir.

Sekme şeridi

Sorgu ve Gözat sekmeleri; sağda + (Yeni Sorgu)

Sorgu sekmesi

Üstte satır numaralı ve sözdizimi renklendirmeli SQL düzenleyici; başlığında Panoya Kopyala ve Çalıştır simgeleri. Altta Sonuçlar bölümü: sorgu sonuçları, değişiklik iletileri ve hatalar burada görünür.

Gözat sekmesi

Düzenlenebilir ızgara; Sonuçlar başlığında Satır Ekle, Satır Sil, Yenile, Değişiklikleri Uygula ve Değişiklikleri İptal Et simgeleri

Durum çubuğu

Yüklenen tablo sayısı ve son işlemin özeti

Penceredeki düğmelerin hepsi metinsiz simgedir; adları ipucunda görünür.


6. Şema paneli (tablolar ve sütunlar)

Sol taraftaki Tablolar ağacı, veritabanındaki kullanıcı tablolarını ve sütunlarını gösterir. Komutlar tabloya ya da sütuna sağ tıklayınca açılan menüdedir.

6.1. Temel işlemler

İşlem

Nasıl

Tabloları yenile

Tabloları Yenile simgesi (ipucu: Tablo listesini veritabanından yeniden yükle.)

Filtrele

Filtre kutusuna yazın; tablo ve sütun adlarında ve sütun tipinde arar, eşleşen tablolar açılır. Filtreyi temizle (×) kutuyu boşaltır.

Tabloya gözat

Tabloya sağ tıklayıp Gözat'ı seçin

Tabloyu yeniden adlandır

Sağ tık → Yeniden Adlandır ya da F2

Tabloyu sil

Sağ tık → Sil ya da Delete. Onay: "X" tablosu silinsin mi? Bu işlem geri alınamaz.

Sütun ekle

Tabloya sağ tık → Sütun Ekle

Sütunu yeniden adlandır

Sütuna sağ tık → Yeniden Adlandır ya da F2

Sütunu sil

Sağ tık → Sil ya da Delete. Onay: "T" tablosundan "C" sütunu silinsin mi? Tek sütunlu bir tablonun sütunu silinemez.

Adı panoya kopyala

Seçili tablo ya da sütunda Ctrl+C; ad [Ad] biçiminde kopyalanır

6.2. Desteklenen sütun tipleri (UI)

Sütun Ekle penceresinde Adı ve Type alanları vardır. Type listesinde şu değerler bu sırayla bulunur; varsayılan Text'tir:

Tip

Açıklama

Text

Metin

Numeric

Sayısal (genel)

Real

Ondalıklı sayı

Integer

Tam sayı


7. Sorgu sekmeleri (SQL)

7.1. Yeni sorgu

  • Sekme şeridinin sağındaki + (Yeni Sorgu) boş bir SQL sekmesi açar.

  • Sekme başlığı varsayılan olarak Sorgu 1, Sorgu 2, … şeklindedir.

  • Yeniden adlandırmak için sekme başlığına çift tıklayın ya da sağ tıklayın; boş ad kabul edilmez.

  • Kapatmak için sekmedeki X'e ya da orta tuşla sekmeye tıklayın. Sekmede SQL varsa Kapatmak istediğinizden emin misiniz? diye sorulur.

  • Sorgu sekmeleri sürüklenerek sıralanabilir. Sekmeler yalnızca bellekte tutulur; PAW Resource yeniden başlayınca kaybolur.

7.2. SQL çalıştırma

Yöntem

Açıklama

Çalıştır simgesi (SQL başlığında)

Aktif sorgu sekmesindeki SQL’i çalıştırır

F5

Aynı işlem; yalnızca sorgu sekmesinde

Ctrl+Space

Otomatik tamamlama: tablo ve sütun adları, takma_ad.sütun ve SQL anahtar kelimeleri

Kural

Açıklama

Seçili metin varsa

Yalnızca seçili SQL çalıştırılır

Seçim yoksa

Sekmedeki tüm SQL çalıştırılır

Birden fazla ifade

Noktalı virgülle ayrılmış ifadeler sırayla çalıştırılır; her ifadenin sonucu ayrı bir Sonuç N sekmesinde gösterilir. Bir ifade hata verirse çalıştırma durur; önceki ifadelerin yaptığı değişiklikler geri alınmaz.

SELECT, WITH, PRAGMA, EXPLAIN

Sonuç ızgarasında satırlar gösterilir

INSERT / UPDATE / DELETE / DDL

Değişiklik ya da durum iletisi Sonuçlar bölümünde gösterilir

CREATE, DROP, ALTER, RENAME

Sol Tablolar ağacı kendiliğinden yenilenir; açık Gözat sekmeleri yenilenmez

7.3. Sonuçlar

Bilgi

Örnek

Dönen satır

Sorgu 120 ms içinde 25 satır döndürdü.

Süre

milisaniye veya saniye cinsinden

INSERT / UPDATE / DELETE sonucu

"T" tablosuna 3 güncelleme uygulandı. (ekleme ve silmede de aynı kalıp)

Diğer ifadeler (CREATE vb.)

Tamamlandı. Etkilenen satır: 0

SQL başlığındaki Panoya Kopyala simgesi sekmedeki SQL metnini kopyalar.


8. Gözat sekmeleri (tablo düzenleme)

Gözat modu, bir tablonun satırlarını ızgara üzerinde doğrudan düzenlemenizi sağlar.

8.1. Açma

  • Tablolar ağacında tabloya sağ tıklayıp Gözat'ı seçin.

  • Sekme başlığı: {TabloAdı} - Gözat

  • Her tablo için tek bir Gözat sekmesi tutulur. Aynı tablo için Gözat'ı yeniden seçmek mevcut sekmeyi öne getirir ve veriyi yeniden yükler; uygulanmamış düzenlemeler kaybolur.

  • Gözat sekmeleri sorgu sekmelerinin önünde, alfabetik sırayla ve mavi renkte gösterilir; sürüklenemez.

8.2. Satır işlemleri

İşlem

Açıklama

Hücre düzenleme

Izgarada değeri değiştirin (henüz veritabanına yazılmaz)

Satır Ekle

Yeni satır ekler

Satır Sil

Seçili satırları silmek üzere işaretler; satıra sağ tıklayınca açılan menüde de vardır

Değişiklikleri Uygula

Bekleyen ekleme / güncelleme / silmeleri onaydan sonra kaydeder

Değişiklikleri İptal Et

Uygulanmamış düzenlemeleri onaydan sonra geri alır

Yenile

Tabloyu veritabanından yeniden yükler; uygulanmamış düzenlemeler kaybolur

8.3. Kaydetme kuralları

Kural

Açıklama

Uygula öncesi

Değişiklikler yalnızca ızgarada bekler

Uygula / İptal Et

Önce onay sorulur: {özet} uygulansın mı? ya da {özet} iptal edilsin mi? (ör. 3 güncelleme, 1 ekleme)

Uygulama

Değişiklikler tek seferde kaydedilir (önce silmeler); biri başarısız olursa hiçbiri kaydedilmez

Düğmelerin durumu

Değişiklikleri Uygula ve Değişiklikleri İptal Et yalnızca bekleyen değişiklik varken etkindir

Sekmeyi kapatma

Kaydedilmemiş değişiklik varsa onay istenir

8.4. Izgara yardımcıları

Bu komutlar sütun başlığına sağ tıklayınca açılan menüdedir; sorgu sonuç ızgaralarında da vardır. Izgaranın ilk sütunu (#) satır numarasını gösterir.

İşlem

Açıklama

Sütunu Sığdır

Sütunun genişliğini içeriğe göre ayarlar

Tüm Sütunları Sığdır

Tüm sütunları içeriğe göre ayarlar


9. Dışa aktarma, içe aktarma ve toplu silme

Tablolar panelindeki ⋮ simgesinden (ipucu: Dışa aktar, içe aktar veya tümünü sil.) erişilir.

9.1. Dışa Aktar (.pawld)

Adım

Açıklama

1

Dışa Aktar'ı seçin

2

Hedef dosyayı belirleyin; varsayılan ad paw.extension.localdata.export.pawld

3

Paketi şifrelemek için bir parola girin; parola boş olamaz (Parola gerekli.)

4

İşlem tamamlanınca Dışa aktarma tamamlandı. mesajı görünür

Paket içeriği

Açıklama

Veritabanı kopyası

Paket parolasıyla şifrelenmiş kopya

Manifest

Açık sorgu sekmelerinin adı ve SQL'i; Gözat sekmeleri pakete girmez

Ham .db dosyasını başka makineye kopyalamak çalışmaz. Veriyi taşımak için mutlaka Dışa Aktar / İçe Aktar kullanın.

9.2. İçe Aktar

Adım

Açıklama

1

İçe Aktar'ı seçin

2

.pawld dosyasını seçin

3

Onay: Mevcut yerel veri içe aktarılan paketle değiştirilecek. Devam edilsin mi?

4

Paket parolasını girin. Parola yanlışsa pencere açık kalır ve Geçersiz parola. yazar

5

Başarılıysa İçe aktarma tamamlandı.

Uyarı

Açıklama

Mevcut veri

İçe aktarma mevcut yerel veriyi paket içeriğiyle değiştirir

Açık sekmeler

Açık sorgu ve Gözat sekmelerinin hepsi kapanır; yerine paketteki sorgu sekmeleri açılır

Doğrulama

Paket doğrulanamazsa eski veritabanı geri yüklenir

Boş parola

Parola gerekli.

9.3. Tümünü Sil

Adım

Açıklama

1

Tümünü Sil

2

Onay: Tüm tablolar silinsin mi? Bu işlem geri alınamaz.

3

Tüm kullanıcı tabloları tek işlemde silinir ve veritabanı dosyası küçültülür; açık Gözat sekmeleri kapanır, sorgu sonuçları temizlenir

4

Tüm tablolar silindi.


10. Depolama ve güvenlik

Konu

Açıklama

Konum

%AppData%\RPA WORK\PAW Resource\Extension Local Data\ (Windows kullanıcısına özgü)

Dosya adı

paw.extension.localdata.db; yanında -wal ve -shm dosyaları oluşur

Şifreleme

SQLite3 Multiple Ciphers (SQLCipher 4 uyumlu); anahtar bu bilgisayarın makine anahtarından türetilir

Taşınabilirlik

Ham DB dosyası başka PC’de açılamaz; .pawld + parola gerekir

Amaç

Disk üzerindeki yerel tabloları yetkisiz okumaya karşı korumak

Eski veritabanı

Şifresiz eski bir veritabanı ilk açılışta kendiliğinden şifrelenir

Şifreleme anahtarı makine kimliğinden türetilir. Bu nedenle yedekleme / taşıma için yalnızca parola korumalı Dışa Aktar paketlerini kullanın. PAW Kaynak'ta Makina Anahtarını Ayarla kullanılırsa veritabanı okunamaz hale gelir; önce dışa aktarın.


11. Workflow aktiviteleriyle ilişki

Yerel Veri penceresi ile workflow aktiviteleri aynı Resource yerel veritabanını paylaşır. PAW Robot ve UiPath aktiviteleri veritabanına bilgisayardaki PAW Resource üzerinden erişir; başka bir veritabanı yolu yoktur.

Aktivite grubu (örnek)

Ne yapar

DataTable ↔ Local Data, Create Distinct Local Data

Tablo oluşturma / okuma

Complex Local Data …

Serbest SQL ile okuma veya işlem

Get Local Data Names / Get Column Names / Get Row Count

Meta veri

Local Data Exists / Column Exists

Tablonun ya da sütunun varlığını denetleme

Rename Local Data / Rename Column / Add Column / Drop Column

Şema yönetimi

Delete Local Data / Delete All Local Data

Tablo silme

Excel / CSV / MsSql / MySql / Oracle ↔ Local Data

Dış kaynaklarla aktarım (MySql ve Oracle aktivitelerinde To LocalData bitişik yazılır)

Ftp Get Folder Contents

FTP klasörünün içerik listesini Local Data tablosuna yazar

Kullanım ipucu

Açıklama

İsimlendirme

Aktivitede verdiğiniz Local Data adı = Yerel Veri penceresinde görünen tablo adı

Append

Mevcut tabloya eklemede sütun adları büyük/küçük harf dahil birebir aynı olmalıdır; değilse Sütun adları local data ile uyuşmuyor. Append kapalıyken var olan tablo silinip yeniden oluşturulur.

Hata ayıklama sırası

Workflow'u çalıştır → Yerel Veri penceresini aç → Tabloları Yenile → tabloya Gözat veya SQL ile doğrula


12. Sık kullanılan SQL örnekleri

-- Tüm satırları getir
SELECT * FROM "MusteriListesi";

-- Filtre
SELECT * FROM "MusteriListesi" WHERE "Durum" = 'Aktif';

-- Satır sayısı
SELECT COUNT(*) AS Adet FROM "MusteriListesi";

-- Belirli sütunlar
SELECT "MusteriNo", "AdSoyad" FROM "MusteriListesi";

Tablo ve sütun adlarında boşluk, özel karakter ya da SQL anahtar kelimesi varsa adı çift tırnak ya da köşeli parantez içine alın: "Tablo Adı", [Tablo Adı]. Yerel Veri penceresi adları kopyalarken ve otomatik tamamlamada [Ad] biçimini kullanır.


13. İpuçları ve sınırlar

Konu

Açıklama

Lisans

Yerel Veri düğmesi yalnızca geliştirici modunda ve lisansında Local Data eklentisi olan şirketlerde görünür

Makine bağlı şifreleme

.db dosyasını doğrudan kopyalamayın; .pawld kullanın

X ile kapatma

Sekmeler korunur; Çıkış Yap ya da uygulamadan çıkışta kaybolur

Gözat kaydı

Izgara değişiklikleri Uygula edilmeden kalıcı olmaz

İçe aktarma

Mevcut tüm yerel veriyi değiştirir; önce dışa aktarmayı düşünün

Tümünü Sil

Geri alınamaz; kritik ortamda önce yedek alın


14. Sorun giderme

Belirti

Olası neden

Ne yapmalı

Yerel Veri düğmesi yok

Üretim modunda giriş yapılmış ya da şirketin lisansında Local Data yok

Geliştirici modunda giriş yapın; lisansı kontrol edin. Lisans yeni eklendiyse yeniden giriş yapın

Pencere açılmıyor

Beklenmeyen uygulama hatası

Hata PAW Resource penceresinin üstünde gösterilir. Resource’u yeniden başlatın; hâlâ olmazsa destek ekibine bildirin

Pencere açılıyor ama kullanılamıyor

Veritabanı açılamadı (ör. makine anahtarı değişti)

Hata durum çubuğunda görünür. Resource’u yeniden başlatın; hâlâ olmazsa destek ekibine bildirin

Tablolar boş görünüyor

Henüz veri yazılmamış, liste yenilenmemiş ya da farklı bir Windows hesabıyla girilmiş

Tabloları Yenile'yi kullanın; robotun çalıştığı Windows hesabıyla girin; workflow’un Local Data aktivitelerini ve tablo adını doğrulayın

İçe aktarma başarısız

Yanlış parola / bozuk paket

Parolayı kontrol edin; paketi yeniden dışa aktarın

Başka makinede DB açılmıyor

Ham dosya makine anahtarıyla şifreli

.pawld ile dışa/içe aktarın

Gözat değişiklikleri kayboluyor

Uygulanmadan önce Yenile, sekmeyi kapatma, Gözat'ı yeniden açma, tablo ya da sütunu yeniden adlandırma, sütun ekleme ya da silme, Tümünü Sil veya çıkış

Önce Değişiklikleri Uygula


15. Kısa referans — komutlar

Komut / eylem

Açıklama

Tabloları Yenile

Şemayı DB’den yeniden yükler

Yeni Sorgu (+)

Boş SQL sekmesi açar

Çalıştır / F5

SQL çalıştırır (F5 yalnızca sorgu sekmesinde)

Ctrl+Space

Otomatik tamamlama

F2 / Delete / Ctrl+C

Seçili tablo ya da sütunu yeniden adlandırır / siler / adını kopyalar

Gözat

Tabloyu düzenlenebilir ızgarada açar (tabloya sağ tık)

Değişiklikleri Uygula

Gözat düzenlemelerini kaydeder

Değişiklikleri İptal Et

Gözat düzenlemelerini geri alır

Dışa Aktar

.pawld paket üretir

İçe Aktar

.pawld paketiyle mevcut veriyi değiştirir

Tümünü Sil

Tüm tabloları siler