Définir les entités XML

www.altova.com Imprimer cette rubrique Page précédente Un niveau supérieur Page suivante

Accueil >  Manuel de l'utilisateur et référence > Commandes de menu  > Authentic Menu >

Définir les entités XML

Vous pouvez définir des entités à utiliser dans Authentic View, que votre document soit basé sur une DTD ou sur un Schéma XML. Une fois définies, ces entités sont affichées dans l'Assistant à la saisie Entités et dans le sous-menu Insérer entité du menu contextuel. Lorsque vous double-cliquez sur une entité dans l'Assistant à la saisie Entité, cette entité est insérée au niveau de l'insertion du curseur.

 

Une entité est utile si vous comptez utiliser un string de texte, un fragment XML, ou une autre ressource externe dans plusieurs endroits de votre document. Vous définissez l'entité, qui, en principe consiste en un nom bref qui représente les données requises, dans le dialogue Définir entités. Une fois avoir défini une entité, vous pouvez l'utiliser dans plusieurs endroits de votre document. Cela vous aide à économiser du temps et améliore l'entretien considérablement.

 

Il existe deux types généraux d'entités que vous pouvez utiliser dans votre document: une entité parsée, qui est une donnée XML (soit un string de texte soit un fragment d'un document XML), ou une entité non-parsée, qui est une donnée non-XML comme un fichier binaire (généralement un graphique, un son, ou un objet multimédia). Chaque entité possède un nom et une valeur. Dans le cas des entités parsées, l'entité est un espace réservé pour les données XML. La valeur de l'entité est soit la donnée XML elle-même, soit une URI qui pointe vers un fichier .xml qui contient les données XML. Dans le cas des entités non-parsées, la valeur de l'entité est une URI qui pointe vers le fichier de données non-XML.

 

Pour définir une entité :

 

1.Cliquer sur Authentic | Définir les entités XML.... Cela permet d'ouvrir le dialogue Définir les entités.

 

dlg_define_entities

 

2.Saisir le nom de votre entité dans le champ Nom. Il s'agit du nom qui apparaîtra dans l'Assistant à la saisie Entité.
3.Saisir le type d'entité à partir de la liste déroulante dans le champ Type. Trois types sont possibles. Une entité Interne est une entité pour laquelle le texte à utiliser est stocké dans le document XML lui-même. Le fait de choisir PUBLIC ou SYSTEM spécifie que la ressource est située en-dehors du fichier XML, et qu'elle sera localisée avec un identifiant public ou un identifiant de système, respectivement. Un identifiant de système est une URI qui donne l'emplacement de la ressource. Un identifiant public est un identifiant indépendant de tout endroit, qui permet à certains processeurs d'identifier la ressource. Si vous spécifiez aussi bien un identifiant public et de système, l'identifiant public résoudra à l'identifiant de système et l'identifiant de système sera utilisé.
4.Si vous avez sélectionné PUBLIC en tant que le Type, saisir l'identifiant public de votre ressource dans le champ PUBLIC. Si vous avez sélectionné Internal ou SYSTEM en tant que votre Type, le champ PUBLIC sera désactivé.
5.Dans le champ Valeur/Chemin, vous pouvez saisir un des types suivants :

 

Si le type d'entité est Internal, saisir la chaîne de texte que vous souhaitez en tant que la valeur de votre entité. Ne pas ajouter de guillemets pour délimiter l'entrée. Tous les guillemets que vous saisissez seront traités en tant que partie intégrante de la chaîne de texte.
Si le type d'entité est SYSTEM, saisir l'URI de la ressource ou sélectionner une ressource sur votre réseau local en utilisant la touche Chercher. Si la ressource contient des données parsées, il doit s'agir d'un fichier XML (le fichier doit avoir une extension .xml). En alternative, la ressource peut être un fichier binaire, comme un fichier GIF.
Si le type d'entité est PUBLIC, vous devrez ajouter en plus un identifiant de système dans ce champ.

 

6.L'entrée NDATA indique au processeur que cette entité ne doit pas être parsée mais doit être envoyée au processeur pertinent. Le champ NDATA doit donc être utilisé uniquement avec des entités parsées.

 

Fonctions de dialogue

Vous pouvez apposer, insérer et supprimer des entités en cliquant sur les touches appropriées. Vous pouvez aussi trier les entités par la valeur alphabétique de n'importe quelle colonne en cliquant sur l'en-tête de colonne ; cliquer une fois pour un tri dans l'ordre alphabétique ascendant, cliquer deux fois pour un tri dans l'ordre alphabétique descendant. Vous pouvez aussi redimensionner la fenêtre de dialogue et la largeur des colonnes.

 

Une fois qu'une entité a été utilisée dans le document XML, elle est verrouillée et ne peut pas être éditée dans le dialogue Définir les entités. Les entités verrouillées sont indiquées par un symbole de cadenas dans la première colonne. En verrouillant une entité, vous vous assurez que le document XML reste valide par rapport aux entités. (Le document serait invalide si une entité est référencée mais pas définie.)

 

Les entités doubles sont marquées.

 

Limitations

 

Une entité contenue dans une autre entité n'est pas résolue, ni dans le dialogue, Authentic View, ni dans la sortie XSLT, et le caractère "&" d'une telle entité est affiché dans sa forme échappée, par ex. &.
Les entités externes ne sont pas résolues dans Authentic View, sauf dans le cas où une entité est un fichier d'image et qu'elle est saisie en tant que la valeur d'un attribut qui a été défini dans le schéma comme étant de type ENTITY ou ENTITIES. Ce genre d'entités est résolu lorsque le document est traité avec un XSLT généré depuis la SPS.

 


© 2018 Altova GmbH