Eksport i aktualizacja wartości tagów

Eksportuj wartości, jakie tagi miały w danym momencie, i zapisuj wartości do wielu tagów z pliku CSV.

Import i eksport tagów przenosi konfigurację projektu. Ta strona dotyczy przenoszenia wartości, czyli wykonywania migawki tego, co tagi odczytywały w wybranym momencie, oraz zapisywania wartości do wielu tagów jednocześnie z pliku.

Razem stanowią praktyczny sposób na zachowanie i przywrócenie działającej konfiguracji: wyeksportuj wartości, jakie instalacja miała, gdy była poprawnie wyregulowana, i zapisz je z powrotem po wymianie sterownika albo gdy zestaw wartości zadanych się rozjechał.

Eksportowanie wartości tagów

Eksport tworzy plik CSV z wartościami, jakie każdy tag odczytywał w wybranym przez Ciebie momencie, a nie w tej chwili. Wartością każdego tagu jest jego ostatnia zarejestrowana wartość w tym momencie lub przed nim, pobrana z historii tagu.

Rozpoczynanie eksportu

W widoku Tagi:

  • Dla całego folderu: otwórz go i wybierz Więcej → Eksportuj → Wartości tagów. Uwzględniona zostanie cała zawartość tego folderu.
  • Dla jego części: zaznacz odpowiednie tagi, urządzenia lub foldery, a następnie wybierz Eksportuj → Wartości tagów z akcji dla zaznaczenia.

Wybór momentu

Okno eksportu zawiera pola Data i Czas. Wybrany moment musi przypadać w przeszłości. W sekcji Tagi wybierasz zakres:

  • Wszystko: każdy tag w zaznaczeniu.
  • Tylko zapisywalne: tylko tagi zapisywalne. Użyj tej opcji, gdy eksportujesz wartości po to, aby później zapisać je z powrotem. Tagu tylko do odczytu nie da się przywrócić, więc jego uwzględnienie dodaje jedynie wiersze, które zostaną odrzucone przy aktualizacji.

Historia dostępna pokazuje następnie, ile z tych tagów faktycznie ma wartość w tym momencie, w postaci N z M. Rozwiń Więcej informacji, aby zobaczyć je na listach Brak wartości i Ma wartość. Dzięki temu przed zatwierdzeniem czasu wiesz, czy chodzi o jeden zabłąkany tag, czy o połowę instalacji.

Niekompletne dane

Jeśli niektóre tagi nie mają zarejestrowanej wartości w wybranym czasie, eksport wyświetla ostrzeżenie Niekompletne dane z dokładną listą tych tagów i daje wybór: wróć strzałką wstecz w oknie dialogowym i wybierz inny czas albo mimo to wykonaj eksport. W takim przypadku te tagi zostaną zapisane z wartością null.

Tag może nie mieć wartości z uzasadnionych powodów: jeszcze nie istniał, jego historia była wyłączona albo instalacja nie pracowała. Zwykle najlepiej wybrać czas, w którym system działał normalnie.

Plik

Otrzymujesz plik CSV nazwany od projektu, z dwiema kolumnami:

Tag Path,Tag Value
Building A/AHU01/SF01/PV,21.4
Building A/AHU01/SF01/SP,22

Ma on ten sam format, jakiego oczekuje opisana niżej aktualizacja wartości, więc wyeksportowany plik można od razu wczytać z powrotem.

Aktualizacja wartości tagów z pliku CSV

Ta operacja zapisuje wartości do tagów. Zmienia to, co robi instalacja, a nie tylko to, co rejestruje THMI.

Rozpoczynanie aktualizacji

Zaznacz tagi, które chcesz zaktualizować, a następnie wybierz Aktualizuj wartości → Importuj CSV z akcji dla zaznaczenia. Na najwyższym poziomie widoku Tagi możesz też użyć Więcej → Aktualizuj wartości → Importuj CSV, aby objąć cały projekt. Ta opcja nie jest dostępna w podfolderze. Zaznacz tam tagi bezpośrednio.

Zaznaczenie ma znaczenie: aktualizowane są tylko zaznaczone tagi. Wiersze pliku dotyczące innych tagów są ignorowane. To zabezpieczenie: możesz przekazać plik obejmujący całą instalację i mimo to zaktualizować za jego pomocą tylko jedną centralę wentylacyjną.

Plik

Plik .csv z dwiema kolumnami, Tag Path i Tag Value:

Tag Path,Tag Value
Building A/AHU01/SF01/SP,22
Building A/AHU01/RF01/SP,21

Wiersz nagłówka jest opcjonalny. Plik, który od razu zaczyna się od danych, też działa. Jeśli dodasz nagłówek, musi on brzmieć Tag Path i Tag Value, przy czym wielkość liter i otaczające spacje nie mają znaczenia. Pierwszy wiersz o innej treści nie jest odrzucany. Jest traktowany jako wiersz danych i po prostu nie pasuje do żadnego tagu. Same ścieżki tagów są dopasowywane dokładnie do ścieżek zaznaczonych tagów.

Plik jest od razu odrzucany, jeśli nie jest plikiem .csv, jeśli jest pusty lub zawiera tylko nagłówek, jeśli ta sama ścieżka tagu występuje dwa razy albo jeśli żaden z jego wierszy nie pasuje do zaznaczonych elementów. Błąd zduplikowanej ścieżki nie wskazuje, których ścieżek dotyczy, więc jeśli go zobaczysz, posortuj plik według ścieżki i poszukaj powtórzenia.

Co się dzieje

Prześlij plik i wybierz Importuj. THMI dopasowuje wiersze do Twojego zaznaczenia, weryfikuje każdą wartość i rozpoczyna zapis. Każda wartość musi samodzielnie spełnić warunki:

  • tag musi być zapisywalny;
  • wartość musi pasować do typu danych tagu: liczba dla tagu liczbowego, wartość logiczna dla tagu logicznego, liczba całkowita dla typu całkowitego;
  • musi mieścić się w zakresie typu danych tagu i w jego ograniczeniach zapisu.

Wartości, które nie przejdą weryfikacji, są raportowane zamiast zapisywane. Pozostałe zostają zapisane. Jeśli w pliku nie ma żadnej wartości prawidłowej dla zaznaczenia, otrzymasz informację, że nie ma czego aktualizować, i nic nie zostanie zapisane.

Zapis odbywa się w tle, a po jego zakończeniu otrzymasz wyniki e-mailem. Okno dialogowe potwierdza przyjęcie zadania, po czym możesz je zamknąć. Nie musisz czekać, a zamknięcie okna nie anuluje zapisu.