SBC Saia PCD® Supervisor V3.0 - Station Templates Bedienungsanleitung

Marke: SBC

Modell: Saia PCD® Supervisor V3.0 - Station Templates

Typ: Bedienungsanleitung

Saia Burgess Controls

| 1

27-670 GER04 – Software Handbuch – AddOn FindSymbolsAndMacros

Supervisor Device Template

für Saia PCD

Supervisor

Software Handbuch

0 Inhalt

Seite

0 Inhalt ....................................................................................................................................1

1. Dokumentversion ...............................................................................................................2

2. Beschreibung .....................................................................................................................2

3. Systemvoraussetzungen ...................................................................................................2

4. Installation ..........................................................................................................................3

4.1 Neues Projekt mit dem Device Template erstellen ............................................................3

4.2 Device Template in ein bestehendes Projekt einbinden ....................................................5

5. Konguration ......................................................................................................................7

5.1 Kongurationsdateien ........................................................................................................7

5.2 Menü User Nav-File ...........................................................................................................8

5.2.1. BearbeitenderEinträgeinderNAV-Datei ...................................................................10

5.3 System Nav-File ................................................................................................................12

5.3.1 Header .........................................................................................................................13

5.3.2 Quickmenu ..................................................................................................................13

5.3.3 Alarmlist .......................................................................................................................14

5.3.4 Datapoints ....................................................................................................................15

6. Besonderheiten auf PX Seiten ..........................................................................................16

6.1. VerwendenvonButtonsinVerbindungmitdemDeviceTemplate ....................................16

7. Übersetzung der Standardtexte ........................................................................................18

8. Ändern der Bilder ...............................................................................................................19

9. Anbindung einer Wetterstation .........................................................................................20

9.1. ZuordnungderSchlüsselwörterzuZahlenwerten: ............................................................21

9.2. ZuordnungderSchlüsselwörteranBilder .........................................................................22

9.3. ZuordnungderSchlüsselwörteraneinenSprachabhängigenText ...................................23

10 Spezielle Anpassungen am Menü .....................................................................................23

11. Spezielle Anpassungen an Farben oder am Style...........................................................24

11.1.ÄnderungenMarkieren ......................................................................................................26

12. Debugging ...........................................................................................................................27

13. Update des DeviceTemplate von älterer Version ............................................................29

13.1.UpdatevonVersionv0.9.6undälter .................................................................................29

13.2.UpdatevonVersionv0.9.7bisv1.0.8aufv1.1.0oderhöher .............................................30

13.3.UpdatevonVersionv1.0.9aufv1.1.0oderhöher .............................................................31

Saia Burgess Controls

2 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

2. Beschreibung

BeimDeviceTemplatehandeltessichumeineHTML-VorlagewelcheeineStartseitemitfreikongurier-

baremMenüdarstellt,inwelcherallemöglichenViewssowiePXSeiten,HTMLSeitenvomSupervisor/

Niagaraeingebundenwerden.AußerdemkönnenAlarmenachPrioritätendargestelltwerden.

DasMenüunterstützteineSchachtelungaufbiszu4Ebenen.DerAnsatzist,dassfürjeden„User“in-

nerhalbdesSupervisorseinseparatesNavigationsmenüerstelltwerdenkann.

HierzusindbereitsAlarmlistenalsBeispieledeniert

AußerdemwurdenbereitsbeispielhaftmehrereBenutzerangelegtmitjeweilsindividuellenRollen,Rech-

tenundSprachen,sowieeigenerindividuellerAnsichtenderMenüstruktur.

3. Systemvoraussetzungen

AuistungdervorausgesetztenSoftwareversionen:

• AbTemplateVersion1.0.21|Supervisor2.1&3.0|Niagara4.8&4.9

• Browser:

◦ GoogleChromeVersion79oderneuer

◦ FirefoxVersion71.0oderneuer

◦ EDGE 88 oder nuer

• Windows 10

1. Dokumentversion

Datum Version Von Beschreibung

2020-01-07 0.1 M.Egner ErsteVersion

2020-01-08 0.2 M.Egner AnpassunganV0.9.3

2020-01-20 0.3 M.Egner AnpassunganV0.9.6

2020-01-23 0.4 M.Egner Anpassunganv0.9.7

2020-03-03 0.5 M.Egner Anpassunganv1.0.0undFehlerbehebung

2020-03-03 0.6 M.Egner Anpassunganv1.0.1undFehlerbehebung

2020-03-10 0.7 M.Egner Anpassunganv1.0.2undFehlerbehebung

2020-03-19

2020-04-07

GER01

M. Habenicht

Übernahme durch SBC-TechDoc

KleineTextverbesserungen

2020-05-14 GER02 M.E.&M.H. Neue Hinweise in Kapitel 5.2

2021-03-04 GER03 M.Egner AnpassungenundSupportfürN4.8&N4.9

2021-03-12 GER04 M.Egner NeueHinweiseinKapitel13hinzugefügt

Saia Burgess Controls

| 3

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

4. Installation

Esgibt2WegedasTemplatezuverwenden.Diesesindhiernachfolgendaufgeführt.

4.1 Neues Projekt mit dem Device Template erstellen

DieVorlageistdirekteinvorgefertigtesProjektundkannsomitauchganzeinfachdirektverwendetwer-

den.

Umesverwendenzukönnen,kopierenSiedenOrdner„sbcDeviceTemplate21vX_X_X“ausderZip-Da-

teiindasVerzeichnis(UserHome):„C:\Users\MyUserName\Niagara4.8\SBC\stations“fürSupervisor2.1

oder„C:\Users\MyUserName\Niagara4.9\SBC\stations“fürSupervisor3.0.

StartenSiedenSupervisorundönenSiediePlattform

DanngehenSieinden„StationCopier“:

Im„StationCopier“wählenSiedasProjektausundkopierenesaufdiePlattform.

Saia Burgess Controls

4 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

GebenSiealserstesdiePassphrase„SaiaPCD@1978“einundklickenSiedannaufweiter.

ImdarauolgendenFensterkönnenSiedieStationauchdirektumbenennen.

DerNamekannfreigewähltwerden.

Klicken Sie danach auf weiter

WählenSiedaraufhindiegezeigteOption,damitalleskopiertwird.

Klicken Sie danach auf weiter

Saia Burgess Controls

| 5

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

StellenSiedieStart-Optionensoein,wieSieesbenötigen.

KlickenSiedanachaufweiterunddanachaufFertig

4.2 Device Template in ein bestehendes Projekt einbinden

DasganzeTemplatekannauchdirektineinelaufendeStationübernommenwerden.

KopierenSiedenOrdner„sbcDevice“ausdemOrdner„..\sbcDeviceTemplate21vX_X_X\shared\“inden

SystemPfadIhrerStation:„C:\ProgramData\Niagara4.8\SBC\stations\IhreStation\shared\“fürSupervisor

2.1oder„C:\ProgramData\Niagara4.9\SBC\stations\IhreStation\shared\“fürSupervisor3.0

DanachndenSieinderStationunterFilesdenOrdner„sbcDevice“(ggf.aktualisieren):

Saia Burgess Controls

6 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

DamitdasGanzegenutztwerdenkann,mussim„UserService“fürjedenBenutzerdiemain.nav-File,die

SpracheunddasZeitformatangegebenwerden:

AußerdemkannhierdasDatumsformatangegebenwerden,welchesimTemplatespäterdieDarstellung

derUhrzeitunddesDatumsdeniert.

Durchdiemain.navwirddieindex.htmlmitentsprechenderViewzurStartseite:

Saia Burgess Controls

| 7

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

5. Konguration

5.1 Kongurationsdateien

FürjedenBenutzermusseinnav-FileimOrdner„users“und„system“angelegtwerden.

DieBenennungmussdemBenutzernamen(mitGroß&Kleinschreibung)entsprechen!

SokannfürjedenNutzerindividuellundbeiBedarfauchinanderenSprachendasganzeTemplatean-

gepasstwerden.

AlsVorlagekanndiedefault.navverwendetwerden.

! Fehlt das benutzerspezische NAV-File, dann wird das File default.nav verwendet !

Saia Burgess Controls

8 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

5.2 Menü User Nav-File

Indemnav-Fileunter„Users“deniertsichdasgesamteMenü,alsdaswasderUsersehensoll

DasUser-Nav-FileistvollanpassbarinIhrerStrukturunddessenBenennung.

DerersteEintragistfestalsStartseiteimMenüdeniertundhatkeineUntermenüs.

DieEinträgeunter„Start“deniereninIhremAufbauHierarchischdenAufbaudesdarunterliegenden

Menüs.

Eskannbiszu4Ebenengeben!

1. mainMenu

2. subMenu

3. subSubMenu

   4.Pages

Saia Burgess Controls

| 9

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

WiebeijedemNAV-FileinNiagaraüblich,kannhierallesverlinktwerden!

LinkskönnenaucheinezusätzlicheAngabeder„view“enthalten(z.b.|view:alarm:DatabaseMaintenance)

AbVersion1.0.4 ORD‘sinderUser-Nav-File,könnenjetzt„?stationName“ enthalten,

welchedurchdenStationname(sbcDeviceTemplateXXvX_X_X)ersetzt

werden.Z.B.history:„/?stationName/AuditHistory“

Achtung,bei

Versionenvor1.0.4

LinksfürAuditHistoryoderLogHistorymüssenbeiUmbenennungdes

Devicesangepasstwerden,dasiedenDeviceNamenenthalten!

AbVersion0.8.4 Imnav-Filekannzusätzlich„|view:?fullScreen=false“ oder „?full-

screen=false“angegebenwerden,dadurchwirdderNav-Treesichtbar!

Saia Burgess Controls

10 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

5.2.1. Bearbeiten der Einträge in der NAV-Datei

WirdeinEintragselektiert,kanndiesermitdenSchaltächenanderunterenLeisteeditiert(2),verscho-

ben(4und5)odergelöscht(3)werden.

ZumEditierenkönnenSieaucheinenDoppelklickaufeinenEintragmachen.

Gleichesgehtauch,wennSieperrechtsklickdasKontextmenü,aneinemPunktönen.

AußerdemhabenSiehierauchdieMöglichkeitPunktezukopierenoderzuvervielfältigen(8).

DesWeiterenkönnenSiedieAnsichtderEbenenEin-undAusklappen(9).

EinenneuenEintragzuerstellenkönnenSiedieSchaltächeNeu(1)verwenden.

Saia Burgess Controls

| 11

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

Daraufhin bekommen Sie dieses Popup Fenster.

ImerstenFeldkanndemElementeinenNamengegebenwerden,welcherdannspäterimMenühierfür

angezeigtwird.ImzweitenFeldkönnenSieeinenOrdvonirgendeinerKomponenteoderDateihinterle-

genbeziehungsweiseauswählen.

Hierbeiistzubeachten,dasseinneuerEintragimmerunterhalbdesElementserstelltwird,welchesSie

selektiert haben.

Saia Burgess Controls

12 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

5.3 System Nav-File

InderSystemlewerdenalleanderenPunktedesTemplatesdeniert.

DieStrukturbzw.derAufbau,darfnichtverändertwerden,sonstfunktioniertdasTemplatenichtmehr.

Ab Version

0.9.6

Im System-Nav-File fehlt der Eintrag für „header/User“ und für „navigation“.

Keine Kompatiblität zu ≤ 0.9.5; muss bei Bedarf angepasst(gelöscht) werden!

FüreinigespezielleÄnderungenmussmanindenTextEditorgehen,dadasAuswahlfensterdesNavFile

EditorsnichtalleEingabenannimmt.

Saia Burgess Controls

| 13

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

ErklärungdesAufbaus:

5.3.1 Header

1. Überschrift des Templates

2. LogoaufderRechtenSeite

3. LogoaufderLinkenSeite

AlsBilderkönnenzumBeispielSVG,PNG,GIFoderJPEGverwendetwerden.

BeiPixelfestenBildernwiePNG,GIFoderJPEGsolltedieHöhebei50Pixelliegen.

SindkeineBildergewünscht,dannträgtmanstattdessen„null“oder„none“insFeld„ord“ein

5.3.2 Quickmenu

4. BenennungundLinkzurAlarmliste

5. BenennungundLinkzurHistory

6. BenennungundLinkzurBenutzerverwaltung

7. BenennungundLinkzurSuchfunktion

8. BenennungundLinkzurInfo

MöchtemaneinenPunktdesQuickmenunichtverwendenbzw.ausblenden,dannträgtmanstattdessen

„null“oder„none“insFeld„ord“ein.

Anmerkung: Suchfunktion dient zum Suchen von Elementen mithilfe der Tagging-Funktionalität. Wird die Funktion nicht benötigt, kann Sie auch einfach deaktiviert werden.

Saia Burgess Controls

14 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

5.3.3 Alarmlist

Esgibt5vorgefertigteAlarmlisten(obenDargestelltvon9-13).

1. ImerstenoberstenEintragwirdderNamederListesowiedieVerlinkungzurAlarmconsole(Con-

soleRecipient)angegeben.

MöchtemaneineAlarmlistenichtverwendenbzw.ausblenden,dannträgtman„null“oder„none“

insFeld„ord“ein.

Inden3FeldernunterhalbderAlarmlistekannmanzusätzlicheOptionenfestlegen.DerNamehat

dabeikeineRelevanz,nurdasFeld„Ord“.

2. ImerstenUnterfeldwirdderPfadderdazugehörigenAlarmklassedeniert.

3. ImzweitenUnterfeldkanneineZeiteingestelltwerden,inwelchemIntervalldasMakrobeineuen

AlarmenBlinkensoll.Willmandasnicht,dannträgtman„null“oder„none“insFeld„ord“ein.

4. Im3.Feldkanndeniertwerden,welcheFarbedasAlarmfeldbekommt,wenneinAlarmvorhan-

den ist.

DieFarbenkönnennachHTML/CSSStandarddeniertwerden.

Siehehierzu:

https://www.w3schools.com/cssref/css_colors_legal.asp

https://www.w3schools.com/colors/colors_names.asp

DiefolgendenDenitionensinddahermöglich:

- Hexadezimale Farbangabe

EinehexadezimaleFarbewirdangegebenmit:#RRGGBB,wobeidiehexadezimalenGanzzah-

lenRR(rot),GG(grün)undBB(blau)dieKomponentenderFarbeangeben.AlleWertemüssen

zwischen00undFFliegen.

#0000Rot

#0000Grün

#0000Blau

- RGB Farben

EinRGB-FarbwertwirdmitderFunktionrgb()angegeben,diefolgendeSyntaxaufweist:

rgb(red,green,blue)

JederParameter(Rot,GrünundBlau)deniertdieIntensitätderFarbeundkanneineganze

Zahlzwischen0und255odereinProzentwert(von0%bis100%)sein.

BeispielsweisewirdderWertfürrgb(0,0,255)alsblaudargestellt,daderParameterblueauf

denhöchstenWert(255)unddieanderenauf0gesetztsind.

DiefolgendenWertedenierenauchdiegleicheFarbe:rgb(0,0,255)undrgb(0%,0%,100%).

- VordenierteBrowserübergreifendeFarbnamen

https://www.w3schools.com/colors/colors_names.asp

- UVM. Siehe Links

Saia Burgess Controls

| 15

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

5.3.4 Datapoints

FüralleWertegilt:Möchtemandiesenichtanzeigen,dannträgtman„null“oder„none“insFeld„ord“ein.

1. ImFeld„Ord“von„OutTemperature“,kanneinDatenpunktfürdieAußentemperatureingetragen

werden.

2. ImFeld„Ord“von„Outhumidity“,kanneinDatenpunktfürdieAußenfeuchteeingetragenwerden.

3. ImFeld„Ord“von„Weather“,kanneinDatenpunktfürdenWetterstatuseingetragenwerden.

4. ImFeld„Ord“von„Nighttime“,kanneinDatenpunktfürdenStatusvonTagundNacht,derWetter-

anzeigeeingetragenwerden.

NähereDetailsSieheKapitel9„AnbindungeinerWetterstation(BETA)“.

Saia Burgess Controls

16 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

6. Besonderheiten auf PX Seiten

6.1. VerwendenvonButtonsinVerbindungmitdemDeviceTemplate

UmaufeinerPXSeiteinVerbindungmitdemDeviceTemplatezunavigieren,müssenNavigations-But-

tonseinezusätzlicheOptionaufweisen:„|view:?fullScreen=true“oder„?fullScreen=true“.

1.AlserstesziehtmansicheinenHyperlinkButtonausderkitPxPaletteaufdiePXSeite.

2.IndenPropertiesmüssenwireinenhyperlinkdenierenaufdieZielseite:

Saia Burgess Controls

| 17

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

3.ÖnenSiedie„hyperlink“Option:

4.DanndenierenwirSiedenOrdwieüblich(1).

DanachklickenSieaufdiezweiPfeile(2):

5.ImdarauolgendenFestertragenwirnuninsFeldKey„fullScreen“undinsFeldValue„true“:

6.DasFensterkannnunmit“OK”bestätigtwerden

DaraufhinkönnenSiedieÄnderunghiersehen.BestätigenSiewiedermit“OK”.

ImFeld„Hyperlink“sehenSiedieÄnderungnunauch.

Saia Burgess Controls

18 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

7. Übersetzung der Standardtexte

ImOrdner„system“ndetmaneineDateilang.xml indieserkönnenzusätzlicheSprachenbeiBedarf

deniertwerden.

EinfachdenText-Tag(<text…>)kopierenundunter“lang“dieSprachedenierenundunter„translation“

denTextinderjeweiligenSprachedenieren.

HierzugibtesbereitsinBeispielDeutsch,Englisch,FranzösischundItalienisch.

IsteineSprachenichtdeniert,dannwirdautomatisch,dassEnglischeOriginalverwendet.

Saia Burgess Controls

| 19

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

8. Ändern der Bilder

!ErstabVersion1.0.11möglich!

ZumÄndernderBildergibteseineDateiunter„Scripts\theme.js“

DortndensichallePfadezudenverwendetenBildern.

Diesekönnenindividuellangepasstwerden.

Saia Burgess Controls

20 |

27-670 GER04 – Software Handbuch – Saia PCD Supervisor - Device-Template

9. Anbindung einer Wetterstation

!Erstabv1.0.21möglich!

IndenNAV-DateienimSystemPfadgibtesunterDatapointszweineueDatenpunkte.

EinenfürdenaktuellenWetterstatusundeinenFürTagundNacht.

DiesekönnenfolgendermaßenaneineWetterfunktionangebundenwerden:

IstkeineWetterFunktiongewünscht,dannkannderDatenpunktinderNAVFilemit„none“oder„null“

beschrieben werden.

DerersteDatenpunktdeniertdenWetterstatusinFormeinesEnumWritable.

DieWetterstatissindamBeispieldesWetterServicevonNiagaraentstanden.

TheoretischkannjederWetterdienstangebundenwerden,wichtigistnur,dassderStatusübereinen

Zahlenwertübertragenwird.

ÜberdenZahlenwert,wirdderWetterstatusaneinSchlüsselwortgebunden.

DiesesSchlüsselwortdientdannzumAnbindenaneineWetterSymbolundaneinenSprachabhängigen

Text(NäheressieheweitereKapitel).

IstdieZuordnungdesWetterstatuszudenvordeniertenZahlenwertennichtidentisch,dannkanndiese

angepasstodererweitertwerden.

HierführgibtesnachfolgendmehrerePunktewelchebeachtetwerdenmüssen.

Seite laden ...

SBC Saia PCD® Supervisor V3.0 - Station Templates Bedienungsanleitung

Marke: SBC

Modell: Saia PCD® Supervisor V3.0 - Station Templates

Typ: Bedienungsanleitung

PDF Herunterladen

Bericht

SBC Saia PCD® Supervisor V3.0 - Station Templates Bedienungsanleitung

SBC Saia PCD® Supervisor V3.0 - Station Templates Bedienungsanleitung

Verwandte Papiere