4D Doc Center : TRAITER BALISES 4D

4D v13.4

TRAITER BALISES 4D


TRAITER BALISES 4D ( donnéesEntrée ; donnéesSortie )

Paramètre	Type	Description
donnéesEntrée	Texte, BLOB	Données contenant des balises HTML à traiter
donnéesSortie	Texte, BLOB	Données traitées

Description

La commande TRAITER BALISES 4D provoque le traitement par 4D des balises HTML 4D contenues dans le paramètre donnéesEntrée (champ ou variable de type Texte ou BLOB) et retourne les données résultantes dans donnéesSortie.

Cette commande permet d’effectuer un traitement sur du code HTML balisé sans qu’il soit nécessaire que le serveur Web envoie une page HTML via une commande du type WEB ENVOYER BLOB ou qu’une page suffixée “.shtml” soit demandée via un URL. Il n’est même pas nécessaire que le serveur Web de 4D soit démarré.

Passez les données contenant les balises à traiter dans le paramètre donnéesEntrée. Ce paramètre peut être un champ ou une variable de type Texte ou BLOB. A noter que si votre base fonctionne en mode compatibilité ASCII, le type BLOB est préférable car il n’est pas limité en nombre de caractères (le type Texte est en revanche limité à 32000 caractères). Si votre base fonctionne en mode standard (Unicode), le type Texte sera généralement suffisant (les paramètres peuvent recevoir jusqu'à 2 Go de texte).

Note de compatibilité : A compter de la version 12 de 4D, lorsque vous utilisez des paramètres de type BLOB, la commande considère automatiquement que le jeu de caractères utilisé pour les BLOBs est MacRoman. Pour plus d’efficacité, il est fortement conseillé d’utiliser des paramètres de type Texte avec lesquels les traitements sont effectués en mode Unicode.

Toutes les balises HTML de 4D sont prises en charge (4DTEXT, 4DHTML, 4DSCRIPT, 4DLOOP, etc.) même si le serveur Web n’est pas lancé.

Note : En cas d’utilisation de la balise 4DINCLUDE hors du cadre du serveur Web (process Web) :

avec 4D en mode local et 4D Server, le dossier par défaut est le dossier contenant le fichier de structure de la base,
avec 4D en mode distant, le dossier par défaut est le dossier contenant l’application 4D.

Après l’exécution de la commande, le paramètre donnéesSortie reçoit les données du paramètre donnéesEntrée ainsi que le résultat du traitement des balises HTML 4D qu’il contenait, le cas échéant. Si donnéesEntrée ne contenait pas de balises HTML 4D, le contenu de donnéesSortie est identique à celui de donnéesEntrée.
Le paramètre donnéesSortie peut être un champ ou une variable, il doit simplement être du même type que le paramètre donnéesEntrée.

Cette commande rend possible le stockage dans la base de valeurs issues d’un traitement de balises HTML avant qu’elles ne soient envoyées.
Elle permet également d’analyser des balises HTML 4D en-dehors de l’utilisation du serveur Web. En particulier, vous pouvez l’employer pour envoyer via 4D Internet Commands des courriels au format HTML contenant des traitements et/ou des références à des données contenues dans la base.

Note de compatibilité : A compter de la version 11 de 4D, cette commande n'appelle plus la Méthode base Sur authentification Web.

Exemple

Cet exemple permet de charger un document de type 'template', de traiter les balises qu'il contient puis de le stocker :

 C_BLOB($Blob_x)

 C_BLOB($blob_out)

 C_TEXTE($inputText_t)

 C_TEXTE($outputText_t)

 

 DOCUMENT VERS BLOB("montemplate.txt";$Blob_x)

 $inputText_t:=BLOB vers texte($Blob_x;UTF8 Texte sans longueur)

 TRAITER BALISES 4D($inputText_t;$outputText_t)

 TEXTE VERS BLOB($outputText_t;$blob_out;UTF8 Texte sans longueur)

 BLOB VERS DOCUMENT($document;$blob_out)