GETSITE
Syntax :
GETSITE(Webseite,Port,Zielvariable)
Mit dieser Anweisung können beliebige Webseiten von einem Webserver aus dem lokalen Netzwerk oder aus dem Internet eingelesen werden indem ein http-Request erzeugt wird.
Als erster Parameter wird die aufzurufende Seite angegeben, falls ein anderer als der Standardport (80 bei http, 443 bei https) verwendet wird, kann dieser mit einem Doppelpunkt hinter der Adresse oder als zweiter Parameter der Anweisung angegeben werden. Falls der Port mit einem Doppelunkt hinter Adresse angegeben wird, wird der zweite Parameter ignoriert.
Falls https-Seiten aufgerufen werden muss der Seitenname mit den Zeichen "https://" beginnen.
Als zweiter Parameter wird der Port angegeben, wenn die Standardports verwendet werden kann hier 0 eingesetzt werden, es wird dann automatisch der richtige Port benutzt.
Wenn der Port mit einem Doppelunkt hinter dem Servernamen angegeben wird, wird der zweite Parameter ignoriert.
Als dritter Parameter wird die Variable oder das Objekt angegeben, in dem der Seitenquelltext empfangen wird. Diese Variable bzw. das Objekt muss vom Typ Zeichen sein.
Bitte beachten Sie, dass die einzulesenden Daten der Webseite eventuell sehr gross sein können. Die Ausführung des Befehls kann daher länger dauern und einiges an Ressourcen brauchen. Achten Sie daher darauf, dass die Seiten, die aufgerufen werden möglichst nicht zu gross sind. Die maximale Grösse, die in der Zielvariablen gespeichert wird ist abhängig von der verwendeten Hardware.
Die Ausführung dieses Befehls kann je nach Grösse der Seite einige Sekunden dauern. Die Ausführung dieser Anweisung wird im Hintergrund durchgeführt. Während das passiert werden andere Makros weiter ausgeführt. Nachdem die Seite in der angegebenen Variablen gespeichert wurde wird die Ausführung des aktuellen Makros fortgesetzt.
Beispiele:
GetSite("www.meine.seite.de/html/CCUSeite.html",0,Webseitentext)
GetSite("www.meine.seite.de/html/CCUSeite.html",8081,Webseitentext)
GetSite("www.meine.seite.de:8081/html/CCUSeite.html",0,Webseitentext)
GetSite("https://meine.spezielleseite.de/html/Seite1.html",0,Webseitentext)
Auf vielfachen Wunsch gibt es noch eine spezielle Option dieser Anweisung zur Ansteuerung spezieller Geräte über http-Requests. Bei dieser Option wird nur die http-Anfrage gesendet und unmittelbar danach die Netzwerkverbindung zum Server geschlossen - ohne auf eine Antwort zu warten.
Diese Option entspricht nicht den Spezifikationen zur Kommunikation mit einem Webserver und kann beim Server zu Fehlfunktionen führen !!
Diese Option ist nur als Ausnahme zum Ansprechen spezieller Geräte ohne (richtig funktionierenden) Webserver gedacht und sollte auch nur in diesen speziellen Ausnahmefällen verwendet werden. Im Normalfall führt die Verwendung dieser Option zu Fehlfunktionen beim Server.
Um eine solche spezielle http-Anfrage abzusetzen wird einfach der Parameter "Zielvariable" weggelassen.
Bei dieser Option muss der Port als Parameter 2 angegeben werden, die Angabe des Ports mit Doppelpunkt hinter dem Servernamen funktioniert hier nicht.
Die Option kann nur mit einfachen http://-Abfragen verwendet werden - https-Abfragen sind nicht möglich.
Beispiel:
GetSite("MeinSpeziellesGeraet/Pfad/Seite?Parameter",81)