FP_HTTP_TRANSFER_REQUEST

HTTP-Übertragungsauftrag

Dieser FP-Befehl sendet eine Anfrage an den HTTP-Client, der in nTransferID angegeben ist, um die Datenübertragung zu starten.

Parameter

Eingang

nTransferID (WORD, INT, UINT)

Einstellen der HTTP-Client-ID

Werte: 0–15

Ausgang

bError (BOOL)

Wird unter den folgenden Bedingungen auf TRUE gesetzt:

wenn eine Zeitüberschreitung der Verbindung überschritten wird,
wenn eine IP-Adresse ungültig ist

Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.

Anmerkungen

Dieser Befehl ist in Interrupt-Programmen nicht verfügbar.
Bevor Sie den Befehl ausführen, müssen Sie die Datenübertragungseinstellungen mit FP_HTTP_SET_MODE oder dem Einstellungsdialog des HTTP-Clients angeben.
Bevor Sie den Befehl ausführen, prüfen Sie, ob die Systemvariable sys_bIsEthernetHTTPClientReady TRUE ist. Wenn sie FALSE ist, wenn der Befehl ausgeführt wird, tritt ein Fehler auf.
Bevor Sie den Befehl ausführen, stellen Sie sicher, dass sys_bIsEthernetInitializing FALSE ist. sys_bIsEthernetInitializing wird auf TRUE gesetzt, wenn der Befehl ausgeführt wird. Wenn Sie den Befehl ausführen, während sys_bIsEthernetInitializing TRUE ist, tritt ein Fehler auf.
Der Befehl kann nur ausgeführt werden, wenn sys_bIsEthernetCableNotConnected FALSE ist.
Der Befehl kann nur ausgeführt werden, wenn der Datenübertragungsmerker für die angegebene Datenübertragungseinstellung "FALSE: Kein Datenübertragungsauftrag“ ist. Wenn der Datenübertragungsmerker "TRUE: Datenübertragung beauftragt“ ist, tritt ein Operationsfehler auf.
Wenn dieser Befehl erfolgreich ausgeführt wurde, werden die Systemvariablen sys_bIsCarry und sys_iEthernetConnectionErrorCode zurückgesetzt.

Wenn Sie versuchen, den Befehl unter einer der folgenden Bedingungen auszuführen, tritt ein Übertragungsfehler auf und der Fehlercode wird gespeichert.

Status	Code
Zielserver ist nicht eingestellt.	1
Datenübertragungseinstellung ist nicht eingestellt.	2
Die Registrierung eines Prozessauftrags ist fehlgeschlagen.	4
Übertragung wurde deaktiviert	5
Datendekomprimierung fehlgeschlagen. (Beim Zugriff auf Daten mit PUT)	8
Datendekomprimierung fehlgeschlagen. (Beim Zugriff auf Daten mit GET)	9

Wenn ein Fehler auftritt, prüfen Sie die Systemvariable sys_iEthernetConnectionErrorCode auf die Fehlercodenummer.

Fehleralarmmerker

sys_bIsOperationErrorHold (wird auf TRUE gesetzt und bleibt TRUE)

wenn der mit dem Index-Modifizierer definierte Bereich größer ist als der zulässige Bereich
wenn ein für einen Parameter angegebener Wert außerhalb des zulässigen Bereichs liegt.
wenn der Befehl in einem Interrupt-Programm ausgeführt wird.
wenn die Systemvariable sys_bIsEthernetHTTPClientReady FALSE ist, wenn der Befehl ausgeführt wird.
wenn der Merker Datenübertragungsauftrag für die angegebene Datenübertragungseinstellung "TRUE: Datenübertragung angefordert" ist, wenn der Befehl ausgeführt wird.
wenn eine Datenübertragungseinstellung angegeben ist, die nicht mit FP_HTTP_SET_MODE oder dem Einstellungsdialog des HTTP-Clients konfiguriert wurde.

sys_bIsOperationErrorNonHold (wird für einen Zyklus auf TRUE gesetzt)

wenn der mit dem Index-Modifizierer definierte Bereich größer ist als der zulässige Bereich
wenn ein für einen Parameter angegebener Wert außerhalb des zulässigen Bereichs liegt.
wenn der Befehl in einem Interrupt-Programm ausgeführt wird.
wenn die Systemvariable sys_bIsEthernetHTTPClientReady FALSE ist, wenn der Befehl ausgeführt wird.
wenn der Merker Datenübertragungsauftrag für die angegebene Datenübertragungseinstellung "TRUE: Datenübertragung angefordert" ist, wenn der Befehl ausgeführt wird.
wenn eine Datenübertragungseinstellung angegeben ist, die nicht mit FP_HTTP_SET_MODE oder dem Einstellungsdialog des HTTP-Clients konfiguriert wurde.

sys_bIsCarry (wird für einen Zyklus auf TRUE gesetzt)

wenn der Befehl ausgeführt wird, während das Ethernet-Kabel nicht angeschlossen ist. sys_iEthernetConnectionErrorCode wird eingestellt auf "10: Ethernet-Kabel getrennt".
wenn der Befehl während der Initialisierung des Ethernets ausgeführt wird, wird sys_iEthernetConnectionErrorCode auf "11: Ethernet wird initialisiert“ gesetzt.

Verwandte Themen

FP_HTTP_SET_CONNECTION

Beispiel

POE-Kopf

Im POE-Kopf werden alle Ein- und Ausgangsvariablen deklariert, die für die Programmierung dieser Funktion verwendet werden. Für alle Programmiersprachen wird der gleiche POE-Kopf verwendet.

	VAR
		iID10: INT:=10;
		bTransferRequestError: BOOL:=FALSE;
		bTransferRequest: BOOL:=FALSE;
	END_VAR

POE-Rumpf

Wenn bTransferRequest von FALSE auf TRUE gesetzt wird und die Systemvariable sys_bIsEthernetHTTPClientReady auf TRUE gesetzt ist, wird der Befehl ausgeführt. Die HTTP-Datenübertragung wird für das Ethernet-Modul 5 beauftragt.

KOP-Rumpf

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_CONTACT,,bTransferRequest,5,1,7,3,R);
B(B_VAROUT,,bTransferRequestError,40,2,42,4,);
B(B_VARIN,,iID5,23,2,25,4,);
B(B_CONTACT,,sys_bIsEthernetHTTPClientReady,16,1,18,3,);
B(B_F,FP_HTTP_TRANSFER_REQUEST!,,25,0,40,4,,?DEN?DnID?AENO?CbError);
L(1,2,5,2);
L(7,2,16,2);
L(18,2,25,2);
L(1,0,1,4);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST-Rumpf

if DF(bTransferRequest) AND sys_bIsEthernetHTTPClientReady then
    FP_HTTP_TRANSFER_REQUEST(nTransferID := iID10,
                            bError => bTransferRequestError);
End_if;