Exposé : ajouter des métadonnées

Définition

Des données sur les données
D ifférenciation difficile à réaliser quand on travaille avec des documents XML structurés
- ```
<step>Serrer la culasse en utilisant <outilRef id="cléDynamométrique"/> 
et en serrant respectivement …
```
  Permet de savoir qu’il faut une clé dynamométrique pour cette procédure : information utilisable en tant que métadonnées
- Mais nécessité de lever les ambiguïtés
```
<fiche nature="fievre" ><premierChoix ><dci ref = "ibuprofene" /> à utiliser en premier choix 
(les patients confondent souvent avec <dci ref = "aspirine"/>…
```
  ici, ibuprofène est un premier choix mais pas aspirine : le contexte ne permet pas de le comprendre.
Utilisées par des processus et donc souvent peu visibles
- Avec des structures XML métier, ceci dépend de l’étape du processus

Métadonnés DITA

Les principaux types d’informations
- Standard
  - Auteur
  - Copyright
  - Dates de suivis critiques
  - Autorisations d’utilisation et de gestion du contenu
  - Identificateur de ressources pour être utilisé, par exemple dans un système d’aide embarqué à l'objet documenté
  - audience, keywords, prodinfo
- Customisable
  - Par nature (props)
  - Par spécialisation (othermeta et props)
En pratique
- Peut être rédigé dans le topic, appliqué depuis une map, ou généré depuis le CMS
- Structure XML
  - <prolog> pour les topics
  - <topicmeta> pour les maps

Utilisation de DITA maps pour appliquer des métadonnées

Les maps utilisent les mêmes métadonnées que celles d’un prolog de topic
Les métadonnées des maps s’appliquent aux topics
- Les métadonnées communes à la racine de la map seront appliquées à tous les topics référencés dans la map
- Les métadonnées posées au moment de l’appel d’un topic s’appliquent :
  - En addition, si plusieurs valeurs possibles
  - En remplacement, sinon
- Les métadonnées peuvent inclure des mots-clés et entrées d’index, permettant de maintenir l’index en dehors des topics
Le résultat de l’application des métadonnées d’une map est géré par le processus de publication

Utilisation d’ontologies et de taxonomies

Objectif : pouvoir contraindre les valeurs d’attribut totalement laissées libres par le standard
- Exemple : décider de trois niveaux d’expertise pour @audience : débutant, confirmé et expert
Mécanisme
- Dans une map de type <subjectScheme>
  - Déclaration de valeurs d’attribut <subjectdef>
  - Attribution des valeurs à un attribut <enumerationdef>
    - Standard ou spécialisé dans un contexte particulier
Nature des valeurs
- Listes
- Hiérarchies

Exemple

<subjectScheme>
    <title>Clés audience</title>
    <subjectdef keys="audienceDefinition">
        <subjectdef keys="débutant">
            <topicmeta>
                <navtitle>Débutant</navtitle>
            </topicmeta>
            <subjectdef keys="confirmé">
                <topicmeta>
                    <navtitle>Confirmé</navtitle>
                </topicmeta>
            </subjectdef>
            <subjectdef keys="expert">
                <topicmeta>
                    <navtitle>Expert</navtitle>
                </topicmeta>
            </subjectdef>
        </subjectdef>
    </subjectdef>
    <enumerationdef>
        <attributedef name="audience"/>
        <subjectdef keyref="audienceDefinition"/>
    </enumerationdef>
</subjectScheme>