Eksportér og opdatér tagværdier

Eksportér de værdier, tags havde på et bestemt tidspunkt, og skriv værdier tilbage til mange tags fra en CSV-fil.

Import og eksport af tags flytter et projekts konfiguration. Denne side handler om at flytte værdierne: at tage et øjebliksbillede af, hvad tags viste på et valgt tidspunkt, og at skrive værdier tilbage til mange tags på én gang fra en fil.

Tilsammen er de den praktiske måde at gemme og gendanne en velfungerende opsætning på: eksportér de værdier, et anlæg havde, mens det var korrekt indreguleret, og skriv dem tilbage, efter at en controller er blevet udskiftet, eller et sæt sætpunkter har flyttet sig.

Eksportér tagværdier

Eksporten laver en CSV-fil med det, hvert tag viste på et tidspunkt, du vælger, ikke lige nu. Værdien for hvert tag er dets senest registrerede værdi på eller før det tidspunkt, hentet fra taggets historik.

Start en eksport

Fra visningen Tags:

For en hel mappe: åbn den, og vælg Mere → Eksportér → Tagværdier. Alt under den mappe medtages.
For en del af den: markér de tags, enheder eller mapper, du vil have med, og vælg derefter Eksportér → Tagværdier blandt handlingerne for markeringen.

Vælg tidspunktet

Eksportdialogen beder om en Dato og en Tid, og tidspunktet skal ligge i fortiden. Under Tags vælger du omfanget:

Alle: alle tags i markeringen.
Kun skrivbare: kun de skrivbare. Brug dette, når formålet med eksporten er at skrive værdierne tilbage senere: et skrivebeskyttet tag kan ikke gendannes, så hvis det medtages, tilføjer det kun rækker, der bliver afvist ved indlæsningen.

Historik tilgængelig viser derefter, hvor mange af disse tags der faktisk har en værdi på det tidspunkt, som N af M. Fold Mere info ud for at se dem opdelt under Ingen værdi og Har værdi, så du kan se, om det drejer sig om et enkelt tag eller halvdelen af anlægget, før du lægger dig fast på tidspunktet.

Ufuldstændige data

Hvis nogle tags ikke har nogen registreret værdi på det valgte tidspunkt, giver eksporten advarslen Ufuldstændige data med en liste over præcis hvilke, og du får et valg: gå tilbage med dialogens tilbagepil og vælg et andet tidspunkt, eller eksportér alligevel. Hvis du eksporterer alligevel, skrives disse tags ud med værdien null.

Der kan være gode grunde til, at et tag mangler en værdi: det fandtes ikke endnu, dets historik var slået fra, eller anlægget var nede. Som regel er det bedst at vælge et tidspunkt, hvor systemet kørte normalt.

Filen

Du får en CSV-fil, der er opkaldt efter projektet, med to kolonner:

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

Det er samme format, som værdiopdateringen nedenfor forventer, så en eksport kan indlæses direkte igen.

Opdatér tagværdier fra en CSV-fil

Dette skriver værdier til tags. Det ændrer, hvad anlægget gør, og ikke kun, hvad THMI registrerer.

Start en opdatering

Markér de tags, du vil opdatere, og vælg derefter Opdatér værdier → Importér CSV blandt handlingerne for markeringen. Fra roden af Tags kan du også bruge Mere → Opdatér værdier → Importér CSV til at ramme alt i projektet. Det tilbydes ikke i en undermappe. Markér i stedet taggene dér.

Markeringen er afgørende: kun de tags, du har markeret, opdateres. Rækker i filen for alt andet ignoreres. Det er sikkerhedsnettet: du kan få en fil, der dækker et helt anlæg, og stadig bruge den til kun at opdatere ét ventilationsaggregat.

Filen

En .csv-fil med to kolonner, Tag Path og Tag Value:

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

Overskriftsrækken er valgfri, og en fil, der begynder direkte med data, virker også. Hvis du medtager en, skal den lyde Tag Path og Tag Value, men store og små bogstaver og omgivende mellemrum er underordnede. En første linje, der ligner noget andet, afvises ikke. Den behandles som en datarække og matcher så blot intet tag. Selve tagstierne matches præcist mod stierne for de markerede tags.

En fil afvises helt, hvis den ikke er en .csv, hvis den er tom eller kun indeholder en overskrift, hvis den indeholder samme tagsti to gange, eller hvis ingen af dens rækker matcher noget, du har markeret. Fejlen om dublerede stier nævner ikke de pågældende stier, så hvis du får den, kan du sortere filen efter sti og kigge efter gentagelsen.

Hvad der sker

Upload filen, og vælg Importér. THMI matcher rækkerne mod din markering, validerer hver værdi og begynder at skrive. Hver værdi skal godkendes for sig:

tagget skal være skrivbart;
værdien skal passe til taggets datatype: et tal for et numerisk tag, en boolesk værdi for et boolesk tag og et heltal for et heltalstag;
den skal ligge inden for datatypens interval og taggets skrivegrænser.

Værdier, der ikke godkendes, rapporteres i stedet for at blive skrevet. Resten gennemføres. Hvis intet i filen er gyldigt for markeringen, får du besked om, at der ikke er noget at opdatere, og der skrives ingenting.

Skrivningen kører i baggrunden, og du modtager resultaterne via e-mail, når den er færdig. Dialogen bekræfter, at opdateringen er modtaget, og derefter kan du lukke den. Du behøver ikke at vente, og det annullerer ikke skrivningen at lukke den.