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

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
GER01
M. Habenicht
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
1
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.
1
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.
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8
  • Page 9 9
  • Page 10 10
  • Page 11 11
  • Page 12 12
  • Page 13 13
  • Page 14 14
  • Page 15 15
  • Page 16 16
  • Page 17 17
  • Page 18 18
  • Page 19 19
  • Page 20 20
  • Page 21 21
  • Page 22 22
  • Page 23 23
  • Page 24 24
  • Page 25 25
  • Page 26 26
  • Page 27 27
  • Page 28 28
  • Page 29 29
  • Page 30 30
  • Page 31 31
  • Page 32 32

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

Typ
Bedienungsanleitung