Formaty danych API
Pierwszym krokiem jest wybranie jednego z dostępnych formatów danych API. Możliwa jest również edycja wybranego formatu. Dobór linku zależy od konkretnych wymagań projektu. Edytor API Data Formats & Output Targets umożliwia korzystanie z domyślnych definicji formatów API ( DefaultInfo, DefaultLocation, DefaultLocationAndInfo i ALL_ITEMS) jako szablonów do dostosowania do potrzeb projektu. Wyjścia JSON i CSV są dostępne dla wszystkich formatów wyjściowych.
Aby edytować definicje formatu, wykonaj poniższe czynności:
- W stworzonym projekcie na pasku menu u góry otwórz menu Projekt i wybierz Formaty danych API. Spowoduje to otwarcie edytora API Data Formats & Output Targets na karcie Formaty danych API .
- W tabeli definicji formatu UDP/logging/ API wybierz domyślną definicję, którą chcesz edytować. Skopiuj domyślny format, klikając przycisk Clone Format pod tabelą definicji. Spowoduje to otwarcie nowego okna edytora formatu.
- Nadaj nazwę nowemu formatowi i edytuj ciąg formatu zgodnie z potrzebami. Okno pokazuje również przykładowe ciągi wyjściowe w formatach JSON i CSV, dzięki czemu można sprawdzić dane wyjściowe.
- Po wprowadzeniu zmian, kliknij przycisk OK, aby zapisać zmiany. Zamknij edytor UDP/logging/ API.
Driver komunikacyjny
Następnym krokiem jest wprowadzenie danych do drivera w celu odczytywania ich w aplikacji InTouch. Wymagane jest posiadanie pakietu WEBSVC. Przygotuj swój sformatowany link. Przykład formatu danych API:
http://localhost:8080/qpe/getTagData?format=defaultLocation&humanReadable=true&maxAge=5000
W programie Operations Control Management Console (OCMC) wybierz odpowiednio:
Operations Integration Server Manager> Default Group > Local> Admin> Standards- WEBSVC> OI.WEBSVC.1 > Configuration > PORT> REST .
Przejdź przez kolejne kroki w celu uzyskania połączenia:
- Wprowadź sformatowany adres i naciśnij Analyze.
- Przeprowadź próbę połączenia klikając Test. Jeśli wszystkie dane się prawidłowo wyświetliły klikamy Export to Device Items.
- W zakładce Device Items widzimy zaimportowane dane.
Przesyłanie danych do aplikacji InTouch
Otwieramy stworzona aplikacje w programie InTouch Aveva. W zakładce Tools rozszerzamy Configure i wybieramy Access Names. Uzupełniamy odpowiednio jak na zdjęciu:
Przechodzimy do utworzenia przykładowej zmiennej, która przechowuje id taga. Nazywamy zmienna oraz wybieramy jej typ czyli I/O Message. W okienku Item wpisujemy nazwę, która jest dostępna w programie OCMC w okienku REST w zakładce Device Items. Wybieramy odpowiednio wcześniej stworzone Access Name.
W oknie, w którym chcemy wyświetlać daną zmienna tworzymy okienko tekstowe, na które następnie klikamy dwukrotnie. W kategorii Value Display wybieramy String. Następnie wpisujemy nazwę naszej zmiennej ( klikając dwukrotnie a następnie w Select, możliwe jest wybranie zmiennej z dostępnych tagów). Zatwierdzamy klikając Ok.
Możliwe jest sprawdzenie czy dana zmienna wyświetla się poprawnie poprzez otworzenie zakładki Diagnostics a następnie Device Groups w programie OCMC.
