Ana içeriğe geç

Excel Offline Veri Kaynağı Ekleme

Bu sayfa, Pirivision Port modülünde Excel Offline veri kaynağı ekleme sürecini anlatır.

Excel Offline veri kaynağı; bir .xlsx dosyasını Pirivision'a yükleyerek Compass'ta dosya içeriğine SQL benzeri sorgular yapmanızı sağlar. Dış bir sunucu veya ağ bağlantısı gerekmez — dosya Pirivision'a yüklendikten sonra çevrimiçi olmadan da sorgulanabilir.

Excel veri kaynağı oluşturulduktan sonra Compass modülünde dosya sayfaları (sheet'ler) üzerinde sorgu yazılabilir. Hazırlanan sorgular daha sonra Cartography tarafında chart / KPI formatına dönüştürülür ve Horizon veya Atlas dashboardlarında kullanılır.

Ön Koşul

Excel Offline veri kaynağı eklemeden önce şunlar hazır olmalıdır:

  • .xlsx formatında bir Excel dosyası (büyük dosyalar için optimize edilmiş)
  • Dosyada sorgulanmak istenen sheet adlarının bilinmesi
  • Sütun başlıklarının ilk satırda yer alması

→ Port — Excel Offline Genel Bakış

Ekleme Öncesi Gerekli Bilgiler

Bilgi Açıklama Örnek
Name Pirivision içinde veri kaynağına verilecek görünen isim Excel
Description Veri kaynağının kullanım amacı Excel for Example
Excel Dosyası Yüklenecek .xlsx formatındaki dosya pirivision_excel_offline_demo.xlsx

Desteklenen Format

Yalnızca .xlsx (Excel 2007 ve üzeri) formatı desteklenir. .xls, .csv veya .ods dosyaları doğrudan yüklenemez.

Dosya İçeriği

Dosyadaki her sheet (sayfa) Compass'ta ayrı bir tablo olarak sorgulanabilir. Sütun başlıkları (header row) Compass'ta alan adı olarak kullanılır.

1. Port Modülüne Girin

Sol menüden Port modülüne tıklayın. Port, Pirivision'da veri kaynaklarının eklendiği, listelendiği, düzenlendiği ve test edildiği modüldür.

Port Root Directory

Eğer daha önce veri kaynağı eklenmediyse ekranda Connect Your Factory Data mesajı görünür.

Bu ekrandan veri kaynağı eklemek için:

  • Add New Data Sources
  • Add Your First Data Source

butonlarından biri kullanılabilir.

2. Yeni Veri Kaynağı Ekleme Akışını Başlatın

Sağ üstteki Add New Data Sources butonuna tıklayın.

Boş liste ekranındaysanız orta bölümdeki Add Your First Data Source butonu da aynı akışı başlatır.

3. Excel Offline Veri Kaynağı Tipini Seçin

Açılan ekranda Select Your Data Source Type başlığı altında veri kaynağı tipleri listelenir.

Excel Offline eklemek için:

  1. Web Services & Files bölümüne gidin.
  2. Excel Offline kartını seçin.
  3. Sağ üstteki Next butonuna tıklayın.

Excel Offline Veri Kaynağı Seçimi

Info

Pirivision'da Excel dosyalarını çevrimdışı analiz etmek için Excel Offline seçeneği kullanılır. REST web servisleri için RestAPI, gerçek zamanlı IoT akışları için MQTT seçilmelidir.

4. Excel Formunu Doldurun

Excel Offline seçildikten sonra Add Excel Source ekranı açılır.

Ekranın alt kısmında şu açıklama yer alır:

Upload and analyze local Excel files offline.

Form üç ana bölümden oluşur:

  1. Display Info
  2. File Source
  3. Location

Excel Offline Veri Kaynağı Ekleme Formu

Bağlantı Ayarı Yok

Excel Offline veri kaynağında SQL bağlantılarındaki gibi Host, Port veya Authentication alanları bulunmaz. Tek yapılandırma gerekliliği dosyanın seçilmesidir.

5. Display Info

Display Info, veri kaynağının Pirivision arayüzünde nasıl görüneceğini belirler.

Alan Zorunlu Açıklama Varsayılan Örnek
Name Evet Veri kaynağını Pirivision içinde tanımak için kullanılan isimdir. — Excel
Description Hayır Veri kaynağının ne işe yaradığını açıklayan kısa nottur. (Maks 280 karakter) — Excel for Example

Name

Bu veri kaynağını panellerde ve listelerde tanımak için kullanılır.

İyi örnekler:

Excel
Üretim_Raporu_Excel
Kapasite_Planlama_Q1
Kalite_Excel_2024

Description

Bu bağlantının ne işe yaradığını açıklayan isteğe bağlı alandır.

Örnek:

2024 yılı aylık üretim raporu verilerini içeren Excel dosyası.

6. File Source

File Source bölümünde yüklenecek Excel dosyası seçilir.

Durum Gösterim
Dosya seçilmedi Dosya seçme alanı (tıklanabilir)
Dosya seçildi Selected File: dosya_adi.xlsx Change

Dosya seçmek için aşağıdakilerden birini kullanabilirsiniz:

  • Dosya seçme alanına tıklayarak sistem dosya tarayıcısını açın.
  • Dosyayı alana sürükleyip bırakın.

Dosya seçildikten sonra alan Selected File: pirivision_excel_offline_demo.xlsx Change şeklinde güncellenir. Change bağlantısına tıklayarak farklı bir dosya seçilebilir.

Dosya Boyutu

Çok büyük Excel dosyaları yükleme süresini uzatabilir. Mümkünse yalnızca gerekli sheet'leri içeren optimize edilmiş bir dosya kullanın.

7. Location

Location, oluşturulan veri kaynağının Pirivision klasör yapısında nerede saklanacağını belirtir.

Alan Açıklama Varsayılan
Target Folder Veri kaynağının kaydedileceği klasör Root Directory

Target Folder alanına tıklandığında klasör seçim diyaloğu açılır:

Location — Target Folder alanı

Örnek klasörleme:

PORT/
├── Tesis 1/
│   ├── Excel Raporları/
│   └── SCADA/
├── Tesis 2/
│   └── Excel/
└── Test Sources/

8. Save ile Bağlantıyı Kaydedin

Tüm zorunlu alanlar doldurulduktan sonra sağ alttaki Save butonuna tıklayın.

Ekranda şu bilgi yer alır:

Connection will be saved automatically

Otomatik Kayıt

Excel Offline veri kaynakları bir ağ bağlantısı test etmediğinden Test & Save yerine doğrudan Save butonu kullanılır. Dosya yükleme başarılı olduğunda veri kaynağı anında listelenir.

Success

Kayıt başarılı olursa Excel veri kaynağı Port ekranında listelenir ve Compass içinde dosya içeriğini sorgulamak için kullanılabilir hale gelir.

Failure

Hata alınması durumunda dosyanın .xlsx formatında olduğunu ve erişilebilir durumda bulunduğunu kontrol edin.

9. Veri Kaynağını Listede Kontrol Edin

Başarılı kayıt işleminden sonra Port ana ekranına dönüldüğünde oluşturulan Excel veri kaynağı listede görünür.

Excel Veri Kaynağı Listede

Liste kartında aşağıdaki bilgiler ve aksiyonlar yer alır:

Alan / Aksiyon Açıklama
Veri kaynağı ikonu Excel veri kaynağı olduğunu gösterir.
Name Veri kaynağı adı.
Description Açıklama metni.
Kullanım durumu In Use veya Not in Use bilgisi.
Edit Dosya ve görünen bilgileri günceller. (Bkz. aşağıdaki Edit Modu bölümü)
More Ek işlemler menüsünü açar.
↳ Move Veri kaynağını farklı bir klasöre taşır. → Veri Kaynağı Taşıma
↳ Duplicate Aynı ayarlarla yeni bir kopya oluşturur. → Veri Kaynağı Çoğaltma
↳ Delete Veri kaynağını kaldırır. → Veri Kaynağı Silme

10. Edit Modu — Excel Dosyasını Güncelleme

Edit butonuna tıklandığında aynı form açılır; ancak bazı önemli farklar bulunur:

Excel Offline — Edit Modu

Özellik Add Modu Edit Modu
Form Başlığı Add Excel Source Add Excel Source
File Source alanı Dosya seçme alanı Mevcut dosya adı + Change bağlantısı
Download as Excel Yok Mevcut dosyayı indirme bağlantısı
Kayıt butonu Save Update

Download as Excel

Edit modunda File Source bölümünde Download as Excel bağlantısı görünür. Bu bağlantıya tıklanarak mevcut yüklü dosya indirilebilir — inceleme veya güncelleme amaçlı kullanışlıdır.

Dosya Değiştirme

Farklı bir Excel dosyasıyla güncellemek için Change bağlantısına tıklanır ve yeni dosya seçilir. Ardından Update butonuna basılır.

11. Sık Karşılaşılan Hatalar

Hata / Belirti Olası Neden Çözüm
Dosya yüklenemiyor Dosya .xlsx formatında değil Dosyayı .xlsx formatında kaydedin.
Dosya boyutu hatası Dosya çok büyük Gereksiz sheet'leri kaldırarak dosyayı küçültün.
Compass'ta sheet görünmüyor Dosyada geçerli sheet yok veya başlık satırı eksik Dosyada en az bir sheet ve başlık satırı olduğundan emin olun.
Veri kaynağı listede görünmüyor Filtre veya arama aktif Port listesindeki filtre ve arama metnini temizleyin.
Edit modunda dosya indirilemiyor Dosya sistemden kaldırılmış Veri kaynağını silin ve dosyayla birlikte yeniden oluşturun.
Compass'ta veri çekmiyor Dosya güncel değil Edit → Change ile güncel dosyayı yükleyin ve Update edin.
Kaydedilmiyor Name alanı boş Name alanının dolu olduğunu kontrol edin.

12. Sonraki Adım

Excel veri kaynağı Port modülünde oluşturulduktan sonra süreç Compass, Cartography, Horizon ve Atlas adımlarıyla devam eder.

flowchart LR
    A["Port<br/>Excel Offline Veri Kaynağı"] --> B["Compass<br/>Sheet Sorgusu"]
    B --> C["Cartography<br/>Chart / KPI"]
    C --> D["Horizon<br/>Sayfa / Board Hazırlama"]
    D --> E["Atlas<br/>Dashboard Görünümü"]

Compass'ta Kullanım

Compass'ta Excel veri kaynağı seçildiğinde dosyanın sheet'leri tablo olarak listelenir. Her sheet üzerinde SQL benzeri sorgular yazılabilir. Sütun adları dosyadaki başlık satırından otomatik alınır.

Özet

Excel Offline veri kaynağı ekleme süreci:

  1. Port modülüne girilir.
  2. Add New Data Sources butonuna tıklanır.
  3. Veri kaynağı tipi olarak Excel Offline seçilir (Web Services & Files bölümü).
  4. Display Info alanları doldurulur.
  5. File Source bölümünde .xlsx dosyası seçilir.
  6. Target Folder seçilir.
  7. Save ile dosya yüklenir ve veri kaynağı kaydedilir.
  8. Veri kaynağı Port listesinde kontrol edilir.
  9. Compass modülünde sheet sorgusu oluşturulur.