Information de référence : définition et initialisation des docu (Bibliothèque R/3

Information de référence : définition et initialisation des documents logiques

Environnement d'exécution

Pour initialiser la communication entre le document HTML et le système R/3, le document doit être enregistré au moment de l'exécution. Pour ce faire, vous pouvez intégrer le code JavaScript suivant dans la balise d'en-tête du document HTML :

L'environnement d'exécution réserve automatiquement les gestionnaires d'événements JavaScript suivants. Vous ne pouvez pas utiliser ces événements pour vos propres fonctions.

Objet	Événement
Window	onload, onunload
window.document	onhelp, oncontextmenu, onkeypress, onclick

Initialisation du document logique

Chaque fiche d'instructions et chaque cockpit peut être constitué de plusieurs documents HTML imbriqués selon une hiérarchie. De plus, une fiche d'instructions peut appeler un ou plusieurs cockpits, qui peuvent, à leur tour, utiliser plusieurs autres cockpits et par conséquent, documents HTML. Au moment de l'exécution, le système R/3 doit être capable de déterminer lesquels de ces documents HTML il doit utiliser en tant que documents principaux ainsi que le document logique auquel ils correspondent.

Un document logique peut être identifié par les attributs suivants de la balise META du document HTML :

DÉSIGNATION="_bfw_document_"
CONTENU="valeur de l'attribut 'ID' du document XML"

L'ID de document est identique au numéro de la fiche d'instructions ou à la désignation du cockpit. Le document XML généré fournit cette ID de document en tant qu'attribut de la balise DOCUMENT. Dans le document HTML, l'ID de document doit être déclarée par une balise méta inscrite avant l'include JavaScript SAPR3-WR-BFW_INC_TOP.JS.

Vous pouvez inclure le commentaire suivant, pour une balise META, dans la balise DOCUMENT de la feuille de style XSL, par exemple :

Exemple de définition XSL

Document XML	Document XSL	Document HTML
... <DOCUMENT id="10000000000004711"> .... </DOCUMENT> ...	... <META NAME="_bfw_document_"> <xsl:attribute name="CONTENT"> <xsl:value-of select="/@id"/> </xsl:attribute></META> <SCRIPT LANGUAGE="JavaScript" SRC="SAPR3-WR-BFW_INC_TOP.JS"> </SCRIPT> …	... <META NAME="_bfw_document_" CONTENT="100000000000004711">. <SCRIPT LANGUAGE="JavaScript" SRC="SAPR3-WR-BFW_INC_TOP.JS"> </SCRIPT> …

Explication de la définition XSL :

L'attribut NAME="_bfw_document_" de la balise méta indique que le document contenant l'ID de document à ajouter doit être identifié en tant que document logique.
La balise <xsl:attribute name=«CONTENT«> indique qu'un attribut comportant la désignation "CONTENT" doit être ajoutée à la balise méta du document HTML.
La balise <xsl:value-of select="/id"/> indique que la valeur de l'attribut "ID" doit être sélectionnée dans le document XML et insérée telle quelle en tant que valeur de l'attribut "CONTENT" dans le document HTML.

Les documents HTML qui ne contiennent pas de déclaration de document logique sont affectés au document logique supérieur. Ainsi, le système effectue une recherche pyramidale de la hiérarchie du cadre du navigateur. Vous pouvez utiliser ce système, par exemple, pour lier des documents HTML supplémentaires à des IFRAMES pouvant contenir des hyperliens vers des fichiers du système R/3 ou des boutons pour les fonctions de menu (voir Information de référence : définition des commandes). L'environnement d'exécution ne peut accéder qu'à des documents HTML chargés à partir du système R/3.

Au moment de l'exécution, l'ID de document doit être la même pour tous les documents chargés. L'environnement d'exécution garantit le respect de ces conditions. En cas d'erreur, le système crée un message correspondant dans le protocole de messages. Si la même ID de document est utilisée plusieurs fois, seule la première instance est initialisée.