Information de référence pour la définition des feuilles de styl (Bibliothèque R/3

Information de référence pour la définition des feuilles de style

Cette section et les sections subordonnées présentent une synthèse du mode d'utilisation des feuilles de style XSL et des feuilles de style en cascade (CSS) pour définir votre propre structure pour les fiches d'instructions basées navigateur et les cockpits de production en process.

Le système crée deux documents XML pour chaque recette de contrôle à envoyer ou chaque cockpit activé : un document pour la définition de la structure et un autre contenant les données de la recette de contrôle. Le dernier de ces fichiers est converti en document HTML directement dans le navigateur, via une feuille de style XSL. Le système utilise les fichiers suivants :

Document XML

Le système génère automatiquement deux documents XML lorsqu'une recette de contrôle est envoyée ou un cockpit activé. Ces documents sont enregistrés dans le Business Document Service.

data.xml

Ce fichier contient toutes les informations relatives à la structure contenues dans la recette de contrôle ou la définition de cockpit. Il comprend donc toutes les informations des instructions de process requises lors de la création de la structure. Les balises XML et les attributs, lorsqu'ils existent, sont utilisés pour décrire des métadonnées, des phases, des instructions de process, des zones d'édition et de saisie (y compris les textes descriptifs), des zones de calcul, des appels de fonction ainsi que des signatures et des signatures numériques demandées dans le document XML.

layout.xml

Ce fichier contient la définition de la structure enregistrée dans le texte descriptif de la caractéristique PPPI_LAYOUT. Si vous n'avez spécifié ici aucune définition de structure, le système utilise la structure standard appropriée.

Définition du type de document (DTD)

La définition du type de document détermine les règles de définition des éléments XML individuels, des attributs et autres données ainsi que les règles de représentation de ces éléments dans une liaison logique dans un document XML. Les documents XML générés dans PP-PI suivent une définition du type de document enregistrée sous l'ID d'objet "PMC_DTD_DATA.DTD" dans le SAP Web Repository.

Feuille de style XSL

Une feuille de style XSL pour les fiches d'instructions ou les cockpits permet de définir le mode de conversion du document XML (data.xml) en un document (X)HTML avant qu'il ne soit affiché. La conversion est effectuée directement dans le navigateur (Microsoft Internet Explorer 5 ou version supérieure).

Les feuilles de style XSL contiennent généralement les références à des feuilles de style en cascade (CSS), des images et autres fichiers. Ces derniers sont ensuite liés au document (X)HTML lors de son chargement. Il est impossible d'accéder aux fichiers chargés à partir du système R/3 via le système de fichiers du serveur du mandant.

Une feuille de style XSL peut être utilisée pour un nombre illimité de fiches d'instructions ou de cockpits avec des contenus radicalement différents.

Si vous ne définissez pas votre propre structure en fonction de votre propre feuille de style XSL, ou si vous ne déclarez pas vos propres feuilles de style XSL correctement dans la définition de structure, le système utilise automatiquement les feuilles de style standard livrées avec la composante PP-PI. Le Business Document Service contient les copies suivantes des feuilles de style standard que vous pouvez utiliser en tant que modèles pour développer vos propres solutions :

"PMC_STY_C_DEFAULTX.XSL" pour les cockpits
"PMC_STY_DEFAULTX.XSL" pour les fiches d'instructions
"PMC_STY_A_DEFAULTX.XSL" pour archiver les fiches d'instructions

Pour plus d'informations sur les sujets suivants :

gestion des documents des fiches d'instructions dans le système R/3,
voir Gestion des documents pour les définitions de structure

dossiers à utiliser en tant que modèles pour définir vos propres feuilles de style XSL,
voir Dossiers standard utilisés en tant que modèles pour les définitions de structure

Structure du dossier DTD "PMC_DTD_DATA.DTD",
voir Définition du type de document pour les documents XML générés

Communication entre le navigateur et le système R/3

Pour vous assurer que le document HTML affiché au moment de l'exécution supporte toutes les fonctions d'une fiche d'instructions ou d'un cockpit et pour garantir la communication avec le système R/3, vous devez définir la feuille de style XSL de sorte que certains types d'information soient intégrés correctement au document HTML.

La première étape permettant la communication entre le document HTML et le système R/3 consiste à insérer un JavaScript. De plus, certains éléments du document HTML (par exemple, les boutons de commande, zones de saisie, etc…) déclenchent certaines transactions dans le système R/3 et en modifient donc le statut. Pour initialiser cette communication, vous utilisez des ID d'éléments et des attributs supplémentaires définis par SAP.

Vous devez prendre en compte les points suivants lors de la définition des feuilles de style :

Il peut exister plusieurs documents HTML imbriqués pour chaque fiche d'instructions et chaque cockpit. Au moment de l'exécution, le système R/3 doit être capable de savoir lesquels de ces documents sont les documents principaux d'une fiche d'instructions ou d'un cockpit de production. Le document logique est initialisé via l'ID de document qui est identique au numéro de la fiche d'instructions ou au nom du cockpit.

Pour plus d'informations, voir Information de référence : définition et initialisation des documents logiques.

Les fiches d'instructions et les cockpits contiennent différents éléments qui communiquent avec le système R/3 (par exemple, zones de saisie, boutons de commande, etc.). Un composant HTML approprié doit être créé pour chacun de ces éléments dans le document HTML. Dans la feuille de style XSL, vous devez également noter que l'environnement d'exécution du document HTML nécessite des informations supplémentaires pour chaque composant.

Pour plus d'informations, voir Information de référence : définition des composants actifs R/3.

Les menus contextuels des fiches d'instructions et des cockpits contiennent des fonctions qui font référence à la totalité du document ou aux zones individuelles de ce document. Vous pouvez utiliser la feuille de style XSL pour déterminer les fonctions de menu qui doivent également être disponibles en tant que commandes (bouton de commande).

Pour plus d'informations, voir Information de référence : définition des commandes.

Vous pouvez définir des hyperliens qui font référence à des documents du système R/3 (par exemple, instructions) dans les fiches d'instructions et les cockpits. Dans la feuille de style XSL, vous pouvez indiquer que ces documents ne doivent être fournis par le système R/3 que lorsqu'ils sont réellement appelés, et non avant d'être appelés Dans le cas contraire, tous les documents R/3 appartenant à un document PI sont chargés directement lors du chargement de la fiche d'instructions ou du cockpit.

Pour plus d'informations, voir Information de référence : définition des hyperliens vers les fichiers dans le système R/3.

Certains textes des fiches d'instructions et des cockpits doivent être disponibles dans plusieurs langues différentes (par exemple, fonctions de menu). Ainsi, lorsque vous vous connectez au système SAP dans une autre langue, ces textes doivent s'afficher dans la langue demandée. Dans la feuille de style XSL, vous pouvez utiliser les symboles de texte créés dans un programme ABAP pour ces textes multilingues. Ces symboles de texte peuvent ensuite être convertis via les outils de conversion R/3.

Pour plus d'informations, voir Information de référence : utilisation des symboles de texte.