İçeriğe geç
Proxus 2.0.1 2.0 geçişinden sonra lisans ve giriş düzeltmeleri Sürüm notları

Başvuru · Geliştiriciler, Sistem yöneticileri için

i3X API

Bir Proxus hub'ının tesis modelini, canlı değerlerini ve geçmişini CESMII i3X 1.0 arayüzüyle okuyun; i3X istemcileri özel kod yazmadan çalışır.

Hub, tesisi CESMII i3X 1.0 (Industrial Information Interoperability eXchange) arayüzüyle sunar; üretim verisi için üreticiden bağımsız bir REST arayüzüdür. Bir i3X istemcisi tesis ağacını, makine tiplerini, her cihazı tipinin biçiminde, son değerleri ve geçmişlerini okur. Arayüz yalnızca okumak içindir. CESMII i3X uyumluluk test paketi onu 1.0 Compatible olarak değerlendirir: zorunlu davranışların hepsi ve akış geçer; isteğe bağlı olan değer yazma sunulmaz.

Temel adres https://<hub>/api/i3x/v1'dir. GET /info oturum açmadan cevap verir; diğer bütün çağrılar REST API ile aynı erişim anahtarını Authorization: Bearer başlığında ister. Çağıran yalnızca rolünün görebildiklerini görür.

İstemcinin bulduğu

i3XProxus'ta
Ad alanlarıurn:proxus:i3x (tesis seviyeleri, değer tipleri, ilişkiler) ve urn:proxus:machinetypes (makine tipleri).
Nesne tipleriHer makine tipi bir JSON Schema olarak: alanları veri türü, birimi (x-unit) ve sınırlarıyla; üzerine kurulduğu tipin alanları ve bileşenleri açılmış halde. Tesis seviyeleri ve değer tipleri (number, integer, boolean, string) kendi tiplerine sahiptir.
Kök nesnelerTesis ağacının tepesi (kuruluş ya da tesis). Her yerin altında, altındaki yerler ve cihazlar vardır (HasParent / HasChildren).
CihazlarHer cihaz, makine tipiyle tiplenmiş bir nesnedir (tipi yoksa UnknownType). Bileşenleri ve eşlenmiş alanları onu oluşturan çocuklarıdır (HasComponent / ComponentOf).
DeğerlerBir alanın değeri, eşlendiği veri noktasının son değeridir; kalitesi ve zamanıyla. Bir cihazın değeri, alanlarından oluşan nesnedir; maxDepth 0 ya da 2 bileşenlerini de getirir.
GeçmişPOST /objects/history bir alanın aralıktaki değerlerini saklanan okumalardan getirir.
AboneliklerSync: her /subscriptions/sync çağrısı bir öncekinden beri değişenleri, onaylanacak sıra numaralarıyla getirir. Akış: /subscriptions/stream Server-Sent Events açar ve her değişikliği görüldüğü anda gönderir (son değerler saniyede bir okunur); yeni bir akış açık olanı kapatır, akış açıkken sync beklenir.

Öğe kimlikleri değişmez: place:<id>, device:<id> ve bir alan için device:<id>/<alan> (bir bileşen alanı için device:4/Main/Speed). Hesaplanan alanlar henüz sunulmuyor.

Deneyin

TOKEN=$(curl -s -X POST http://localhost:8080/api/Authentication/Authenticate \
  -H "Content-Type: application/json" -d '{"userName":"Admin","password":""}')
curl -s http://localhost:8080/api/i3x/v1/objects?root=true -H "Authorization: Bearer $TOKEN"
curl -s -X POST http://localhost:8080/api/i3x/v1/objects/value -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" -d '{"elementIds":["device:5"],"maxDepth":0}'

Sonraki adımlar

Bu sayfa işinize yaradı mı?

Proxus'u değerlendiriyor musunuz? 30 dakikalık teknik görüşmede kendi makinelerinizle görün.