Aufruf von HTML-Referenzen

HTML-Referenzen können entweder über einen Link mit festen, oder variablen Parametern über ein HTML-Formular abgerufen werden. Der Aufruf von WinCC OA HTML-Referenzen erfolgt immer über die Abfrageseite "/PVSS?ref=[HTML-Ref.]"

z.B.

http://localhost/wincc_oa?ref=refs/examples/link.htmlRef

"ref"

Der feste Parameter "ref" gibt dabei den Dateinamen der HTML-Referenz mit oder ohne die Endung "ref" an.(z.B. ref=diagnostics/diagnostics.html).

Alle weiteren evtl. zu übergebenden Parameter werden mit "&" getrennt und folgen der Syntax "[Parameter1]=[Wert1]". Leerzeichen sind dabei gegen "+"-Zeichen zu ersetzen.

Beispiel

Die Basis-Referenz "baseSample.htmlRef" soll mit den $-Parametern $dpe1 und $dpe2 fest aufgerufen werden.

Dazu wird mit PVSS? die Anfrage gestartet. Der Link hierzu, der in einer Datei gespeichert werden soll, sieht wie folgt aus:

<a href="/PVSS?ref=refs/examples/baseSample.htmlRef&dpe1=ExampleDP_Arg1.&dpe2=ExampleDP_Arg2." target="result">Fester Aufruf der Basis-Referenz</a>

Rufen Sie den Link wie folgt auf (in dem Beispiel ist der Name der Datei link.htmlRef):

http://localhost/PVSS?ref=refs/examples/link.htmlRef

Hinweis

Dieser Aufruf kann zu Testzwecken auch direkt im Browser unter Angabe des HTTP-Servers (z.B. 193.81.17.85 odereiwnt160/PVSS?ref=refs/examples/baseSample.htmlRef&dpe1=ExampleDP_Arg1 &dpe2=ExampleDP_Arg2) erfolgen, bzw. auch eiwnt160/PVSS?ref=refs/examples/baseSample.html &dpe1=ExampleDP_Arg1 &dpe2=ExampleDP_Arg2.

HTML-Formular

Ein Aufruf kann auch ein HTML Formular mit Eingabemöglichkeit der Parameter enthalten. Ein HTML-Formular übermittelt die angegeben Daten automatisch mit der Methode (method="GET") nach obiger Syntax. Hier sind lediglich noch zusätzlich feste Parameter wie z.B. das HTML-Referenz-File als feste Werte (type="hidden") im Formular vorzugeben. Das Beispiel für HTML Referenzen wäre ein solches Eingabeformular.

Hierbei repräsentiert der Name des Input-Feldes (name="feld1") immer den Namen des $-Parameters und der Wert (value="wert1") stellt den Vorgabewert des Parameters dar (siehe Beispiel).

Die Übertragung der Abfragedaten an den HTTP-Server geschieht über einen Button vom Typ Submit (type="submit")

Beispiel

Die Basis-Referenz "baseSample.htmlRef" soll nach Eingabe der $-Parameter $dpe1 und $dpe2 aufgerufen werden. Das HTML-Formular könnte dann wie folgt aufgebaut werden:

</form>

Dabei ist target="result" der Zielframe und input type = "hidden" ist ein "Pseudoeingabefeld", das zum Übergeben der aufzurufenden Seite dient. Erst mit type = "submit" erfolgt die Übertragung der Daten tatsächlich.

Hinweis

Diese Formulare können auch mit einem HTML-Editor (z.B. mit MS-Frontpage) erstellt werden.