---
description: Microsoft Excel VSTO Add-In
---

# VSTO Excel Add-In

## inSCADA Connector for Excel&#x20;

> "Microsoft VSTO Excel Add-in"

inSCADA Connector for Excel, Excel ile inSCADA platformunu entegre olarak çalışmasını sağlayan bir excel eklentisidir. Bu eklenti sayesinde kullanıcılar ;

* Variable History,
* Alarm History,
* Logs

tablolarına erişebilir ve içerisindeki kayıtları EXCEL sayfalarına dökebilirler.\


![inSCADA Connector Add-In for Excel](https://files.gitbook.com/v0/b/gitbook-legacy-files/o/assets%2F-LLGnZudlzfM63QD-_cp%2F-M77g5l9yd8gpuddZHC7%2F-M77m9smM9CRV5jt_5k5%2Fimage.png?alt=media\&token=c2cc9062-5d3b-4a3c-8263-00e7eb8b2128)

#### inSCADA Platformuna Bağlanma <a href="#inscada-platformuna-baglanma" id="inscada-platformuna-baglanma"></a>

Eklentinin çalışabilmesi için bağlantı kurulacak inSCADA platformunun Rest API bağlantı URL 'sinin girilmesi gereklidir. Bunun inSCADA->Settings-URL seçeneği kullanılır.

### Settings -> URL <a href="#settings-greater-than-url" id="settings-greater-than-url"></a>

Bu menüye tıkladığınızda açılan form ;\


![Settings -> URL](https://files.gitbook.com/v0/b/gitbook-legacy-files/o/assets%2F-LLGnZudlzfM63QD-_cp%2F-M77g5l9yd8gpuddZHC7%2F-M77oG3T5i6frd-UQ72k%2Fimage.png?alt=media\&token=5af603b0-a6a4-4389-8acd-c19de93abef6)



Açılan form üzerinde girilmesi gereken parametreler ;

* Base URL : inSCADA Platformu Rest API Kök URL.
* Token : inSCADA Platformu ile güvenli bağlantı kurmak için gerekli giriş anahtarı (TOKEN)

{% hint style="info" %}
inSCADA Platformu ile entegre uygulamalar hazırlamak ve bağlantı kurabilmek için Rest Servisleri TOKEN oluşturma yönergelerine bakınız.
{% endhint %}

### Historical Data -> Tags

inSCADA 'da değişkenlerin (Variables/Tags) kaydedildiği tablodan geçmişe dönük verileri çekmek için kullanılır. Bu menüye tıkladığınızda açılan form ;\


![Historical Data - > Tags](https://files.gitbook.com/v0/b/gitbook-legacy-files/o/assets%2F-LLGnZudlzfM63QD-_cp%2F-M77pN8Xh_hZK0RLe1eQ%2F-M77urOsNJ9betr9hE5v%2Fimage.png?alt=media\&token=f0b4cbc8-bb93-4941-a1e5-67991947c587)



Açılan form üzerinde girilmesi gereken parametreler ;

* Project : inSCADA Platformunda tanımlı projeler. Kullanıcılar hangi projeden geçmişe dönük verileri almak istiyorsa onu seçmelidir.
* Variables (Tags) : Seçili proje altında tanımlanmış değişkenler.&#x20;
* Selected Variables : Hangi değişkenlere ait geçmişe dönük veriler alınacağının listesi.
* Start : Geçmişe dönük verilerin başlangıç tarih ve saati.
* End : Geçmişe dönük verilerin son tarih ve saati.
* Type : Geçmişe dönük verilerin tipi. Burada kullanıcılara Usual, Hourly ve Daily olmak üzere 3 adet seçenek sunulur. Bunlar ;
  * Usual : Ham değerleri ifade eder. Değişkenlerin hiç bir hesaplama metodundan geçirilmeden veri tabanında tutulan halidir.
  * Hourly : Saatlik değerleri ifade eder. Değişkenlerin saatlik olarak hesaplan Min, Max, First, Last, MaxDiff, Count, Sum, Integral değerlerini getirir.
  * Daily : Günlük değerleri ifade eder. Değişkenlerin günlük olarak hesaplanan Min, Max, First, Last, MaxDiff, Count, Sum, Integral değerlerini getirir.
* Page Size : Tek bir sayfada getirilecek maksimum kayıt sayısı.

{% hint style="info" %}
Variable History tablosunda çok fazla kayıt olabilir. Bunların tek seferde talep edilmesi verimli bir yöntem değildir. Bunun yerine veriler sayfa olarak isimlendirdiğimiz gruplar halinde getirilir. Bu hızlı ve donanımları zorlamayan evrensel bir metot dur. inSCADA Platformuna yapılan her sorgunun cevabı içerisinde gelen kayıtlarla beraber , verinin tamamına ilişkin bilgiler de gelir. Bunları form üzerinde Info kısmında görebilirsiniz. &#x20;
{% endhint %}

* Page No : Verilerin kaçıncı sayfadan getirileceğinin bilgisi.

#### Historical Data -> Tags -> Request Command

* Get Data : Yukarıda açıklaması yapılan parametrelere uygun olarak inSCADA platformundan verileri talep eder.

#### Historical Data -> Tags -> Response Info

* Info -> Page Size : Talep sonucu dönen veri sayfalarının maksimum kayıt miktarı.
* Info -> Page No : Talep sonucu dönen sayfanın numarası.
* Info -> Total Pages : Talep sonucunda verilerin gruplandırıldığı sayfa sayısı.
* Info -> Total Elements : Veritabanındaki talep sonucuna uygun olarak bulunan toplam kayıt sayısı.

#### Historical Data -> Tags -> Imports

* Current Sheet : Getirilen kayıtları Excel de aktif olan sayfaya import eder.
* New Sheet : Getirilen kayıtları Excel' de yeni bir sayfaya import eder.
* All Data : Veri tabanında bulunan talep sonucuna uygun tüm kayıtları toplam sayfa sayısında yeni sayfalar oluşturarak tüm kayıtları import eder.

{% hint style="info" %}
Import -> All Data seçeneği uzun sürebilir. Page Size = 100 ve Total Pages = 590 parametrelerini içeren bir talep 590 adet yeni sayfa ve her sayfada 100 adet kayıt oluşturmak anlamına gelir. Microsoft Excel 'in sınırları buna uygun olsa da bu donanımınız ile ilişkili bir performans ile bu talep gerçekleştirilebilir. Bakınız [Microsoft Excel Özellikler ve Limitleri](https://support.office.com/en-us/article/excel-specifications-and-limits-1672b34d-7043-467e-8e27-269d656771c3)
{% endhint %}

* Close : Formu kapatır.

### Historical Data -> Alarms

inSCADA 'da alarmların kaydedildiği tablodan geçmişe dönük verileri çekmek için kullanılır. Bu menüye tıkladığınızda açılan form ;\


![Historical Data -> Alarms](https://files.gitbook.com/v0/b/gitbook-legacy-files/o/assets%2F-LLGnZudlzfM63QD-_cp%2F-M77pN8Xh_hZK0RLe1eQ%2F-M785JXUNQBIbATPjGHe%2Fimage.png?alt=media\&token=98804bb9-03bd-4c87-82ca-3a3d948ac509)



Açılan form üzerinde girilmesi gereken parametreler ;

* Project : inSCADA Platformunda tanımlı projeler. Kullanıcılar hangi projeden geçmişe dönük verileri almak istiyorsa onu seçmelidir.
* Start : Geçmişe dönük verilerin başlangıç tarih ve saati.
* End : Geçmişe dönük verilerin son tarih ve saati.
* Page Size : Tek bir sayfada getirilecek maksimum kayıt sayısı.

{% hint style="info" %}
Alarm History tablosunda çok fazla kayıt olabilir. Bunların tek seferde talep edilmesi verimli bir yöntem değildir. Bunun yerine veriler sayfa olarak isimlendirdiğimiz gruplar halinde getirilir. Bu hızlı ve donanımları zorlamayan evrensel bir metot dur. inSCADA Platformuna yapılan her sorgunun cevabı içerisinde gelen kayıtlarla beraber , verinin tamamına ilişkin bilgiler de gelir. Bunları form üzerinde Info kısmında görebilirsiniz.&#x20;
{% endhint %}

* Page No : Verilerin kaçıncı sayfadan getirileceğinin bilgisi.

#### Historical Data -> Alarms -> Request Command

* Get Data : Yukarıda açıklaması yapılan parametrelere uygun olarak inSCADA platformundan verileri talep eder.

#### Historical Data -> Alarms -> Response Info

* Info -> Page Size : Talep sonucu dönen veri sayfalarının maksimum kayıt miktarı.
* Info -> Page No : Talep sonucu dönen sayfanın numarası.
* Info -> Total Pages : Talep sonucunda verilerin gruplandırıldığı sayfa sayısı.
* Info -> Total Elements : Veritabanındaki talep sonucuna uygun olarak bulunan toplam kayıt sayısı.

#### Historical Data -> Alarms -> Imports

* Current Sheet : Getirilen kayıtları Excel de aktif olan sayfaya import eder.
* New Sheet : Getirilen kayıtları Excel' de yeni bir sayfaya import eder.
* All Data : Veri tabanında bulunan talep sonucuna uygun tüm kayıtları toplam sayfa sayısında yeni sayfalar oluşturarak tüm kayıtları import eder.

{% hint style="info" %}
Import -> All Data seçeneği uzun sürebilir. Page Size = 100 ve Total Pages = 590 parametrelerini içeren bir talep 590 adet yeni sayfa ve her sayfada 100 adet kayıt oluşturmak anlamına gelir. Microsoft Excel 'in sınırları buna uygun olsa da bu donanımınız ile ilişkili bir performans ile bu talep gerçekleştirilebilir. Bakınız [Microsoft Excel Özellikler ve Limitleri](https://support.office.com/en-us/article/excel-specifications-and-limits-1672b34d-7043-467e-8e27-269d656771c3)
{% endhint %}

### Historical Data -> Logs

inSCADA 'da logların kaydedildiği tablodan geçmişe dönük verileri çekmek için kullanılır. Bu menüye tıkladığınızda açılan form ;\


![Historical Data -> Logs](https://files.gitbook.com/v0/b/gitbook-legacy-files/o/assets%2F-LLGnZudlzfM63QD-_cp%2F-M77pN8Xh_hZK0RLe1eQ%2F-M78CsgwFtJDLzNEyegK%2Fimage.png?alt=media\&token=96d4a59c-a597-4bb9-ae57-3b5179fc0abb)



Açılan form üzerinde girilmesi gereken parametreler ;

* Project : inSCADA Platformunda tanımlı projeler. Kullanıcılar hangi projeden geçmişe dönük verileri almak istiyorsa onu seçmelidir.
* Start : Geçmişe dönük verilerin başlangıç tarih ve saati.
* End : Geçmişe dönük verilerin son tarih ve saati.
* Page Size : Tek bir sayfada getirilecek maksimum kayıt sayısı.

{% hint style="info" %}
Log tablosunda çok fazla kayıt olabilir. Bunların tek seferde talep edilmesi verimli bir yöntem değildir. Bunun yerine veriler sayfa olarak isimlendirdiğimiz gruplar halinde getirilir. Bu hızlı ve donanımları zorlamayan evrensel bir metot dur. inSCADA Platformuna yapılan her sorgunun cevabı içerisinde gelen kayıtlarla beraber , verinin tamamına ilişkin bilgiler de gelir. Bunları form üzerinde Info kısmında görebilirsiniz. &#x20;
{% endhint %}

* Page No : Verilerin kaçıncı sayfadan getirileceğinin bilgisi.

#### Historical Data -> Logs -> Request Command

* Get Data : Yukarıda açıklaması yapılan parametrelere uygun olarak inSCADA platformundan verileri talep eder.

#### Historical Data -> Logs -> Response Info

* Info -> Page Size : Talep sonucu dönen veri sayfalarının maksimum kayıt miktarı.
* Info -> Page No : Talep sonucu dönen sayfanın numarası.
* Info -> Total Pages : Talep sonucunda verilerin gruplandırıldığı sayfa sayısı.
* Info -> Total Elements : Veritabanındaki talep sonucuna uygun olarak bulunan toplam kayıt sayısı.

#### Historical Data -> Logs -> Imports

* Current Sheet : Getirilen kayıtları Excel de aktif olan sayfaya import eder.
* New Sheet : Getirilen kayıtları Excel' de yeni bir sayfaya import eder.
* All Data : Veri tabanında bulunan talep sonucuna uygun tüm kayıtları toplam sayfa sayısında yeni sayfalar oluşturarak tüm kayıtları import eder.

{% hint style="info" %}
Import -> All Data seçeneği uzun sürebilir. Page Size = 100 ve Total Pages = 590 parametrelerini içeren bir talep 590 adet yeni sayfa ve her sayfada 100 adet kayıt oluşturmak anlamına gelir. Microsoft Excel 'in sınırları buna uygun olsa da bu donanımınız ile ilişkili bir performans ile bu talep gerçekleştirilebilir. Bakınız [Microsoft Excel Özellikler ve Limitleri](https://support.office.com/en-us/article/excel-specifications-and-limits-1672b34d-7043-467e-8e27-269d656771c3)
{% endhint %}

### Downloads

[Buradan](https://yadi.sk/d/NJemSOMMorfLbA) indirebilirsiniz
