FP_HTTP_GET_DATA_FORMAT

Générer une chaîne de caractères du format des données pour le protocole HTTP

Cette instruction FP génère une chaîne de caractères spécifiant le format des données (adresse FP et longueur). Elle écrit la chaîne de caractères dans la variable de sortie sDataFormat qui est adaptée à l’entrée sPLCDataFormat de l’instruction FP_HTTP_SET_MODE.

Paramètres

Entrée

Var (STRING): Chaîne de caractères contenant des données ASCII
nNumberOfCharacters (WORD, INT, UINT): Taille des données en mots ou pour des chaînes de caractères en octets.

Sortie

sDataFormat (STRING): Chaîne de caractères spécifiant le format des données pour l’entrée sPLCDataFormat de FP_HTTP_SET_MODE

Remarques

Avant d’exécuter l’instruction, les paramètres de transfert doivent être entrés à l’aide de FP_HTTP_SET_MODE ou de la boîte de dialogue de paramétrage du client HTTP.
Avant d’exécuter l’instruction, vérifiez que sys_bIsEthernetInitializing est FALSE. sys_bIsEthernetInitializing passe à TRUE lorsque l’instruction est exécutée. Lorsque l’instruction est exécutée alors que sys_bIsEthernetInitializing est TRUE, une erreur apparaît.
L’instruction ne peut être exécutée que lorsque le drapeau de requête de transfert pour la configuration de transfert spécifiée est "FALSE : Pas de requête de transfert". Lorsque le drapeau de requête de transfert est "TRUE : Requête de transfert", une erreur d’opération apparaît.
Lorsque l’instruction a été exécutée avec succès, les variables système sys_bIsCarry et sys_iEthernetConnectionErrorCode sont réinitialisées.
Les données de configuration Ethernet enregistrées dans l’automate sont remplacées temporairement par les données de l’instruction. Lorsque l’automate est rallumé, les données de configuration Ethernet sauvegardées dans l’automate sont réutilisées.
Les données ne sont envoyées ou lues que lorsque les paramètres de transfert du client HTTP ont été configurés et lorsque l’instruction FP_HTTP_TRANSFER_REQUEST est exécutée.
Lorsqu’une erreur apparaît, utilisez la variable système sys_iEthernetConnectionErrorCode pour connaître le numéro de code d’erreur.

Drapeaux d’erreur

sys_bIsOperationErrorHold (passe à TRUE et reste TRUE)

Si le temps d’attente de connexion est dépassé.
Si une adresse IP est invalide.

sys_bIsOperationErrorNonHold (passe à TRUE pendant un cycle)

Si le temps d’attente de connexion est dépassé.
Si une adresse IP est invalide.

sys_bIsCarry (passe à TRUE pendant un cycle)

Si l’instruction est exécutée pendant l’initialisation d’Ethernet, sys_iEthernetConnectionErrorCode est définie sur "11 : initialisation Ethernet en cours".

Thèmes apparentés

FP_HTTP_SET_MODE

FP_FTP_SET_CONNECTION

FP_FTP_TRANSFER_REQUEST

sys_iEthernetConnectionErrorCode

Exemple

En-tête du POU

Toutes les variables d’entrée et de sortie utilisées pour programmer cette fonction ont été déclarées dans l’en-tête du POU. Le même en-tête de POU est utilisé pour tous les langages de programmation.

	VAR
		sStringData: STRING[31767]:='';
		iID5: INT:=5;
		bSetModeStringData: BOOL:=FALSE;
		bErrorModeStringData: BOOL:=FALSE;
	END_VAR

Corps du POU

Lorsque bSetModeStringData passe de FALSE à TRUE et lorsque sys_bIsEthernetInitializing est FALSE, l’instruction est exécutée.

Corps en LD

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 7 ;
        NETWORK_BODY
B(B_VARIN,,iID5,39,2,41,4,);
B(B_VARIN,,'SV0~UPLOAD;POST',39,3,41,5,);
B(B_CONTACT,,bSetModeStringData,5,1,7,3,R);
B(B_VARIN,,'/PLC?ment',39,5,41,7,);
B(B_VAROUT,,bErrorModeStringData,52,2,54,4,);
B(B_VARIN,,sStringData,8,4,10,6,);
B(B_CONTACT,,sys_bIsEthernetInitializing,16,1,18,3,N);
B(B_F,LEN!,,11,4,16,7,,?DIN?C);
B(B_F,FP_HTTP_GET_DATA_FORMAT!,,16,3,31,7,,?D@'Var'?DnNumberOfCharacters?CsDataFormat);
B(B_F,FP_HTTP_SET_MODE!,,41,0,52,7,,?DEN?DnTransferID?DsOperation?DsPLCDataFormat?DsHTTPServerURL?AENO?CbError);
L(1,2,5,2);
L(7,2,16,2);
L(11,5,11,6);
L(18,2,41,2);
L(10,5,16,5);
L(31,5,41,5);
L(1,0,1,7);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

Corps en ST

If DF(bSetModeStringData) AND not sys_bIsEthernetInitializing Then
    FP_HTTP_SET_MODE(nTransferID := iID5,
                     sOperation := 'SV0,UPLOAD;POST',
                     sPLCDataFormat := FP_HTTP_GET_DATA_FORMAT(sStringData,
                                                               LEN(sStringData)), 
                     sHTTPServerURL := '/PLC?ment',
                     bError => bErrorModeStringData);
End_if;