Personnaliser le mappage d'éléments DITA avec des composants AEM id1679J600HEL

Chaque élément DITA est d'abord recherché pour un mappage de composant correspondant en fonction du nom de l'élément. Par exemple :

<ditaelement>
   <name>**substeps**</name>
   <class>- topic/ol task/substeps</class>
   <componentpath>dita/components/ditaolist</componentpath>
   <type>COMPOSITE</type>
   <target>para</target>
</ditaelement>

Dans l'exemple ci-dessus, tous les éléments DITA substeps sont rendus à l'aide du composant dita/components/ditaolist.

Si un élément DITA ne trouve pas de correspondance basée sur le nom, une correspondance basée sur le class est effectuée. Par exemple :

<ditaelement>
   <name>topic</name>
   <class>**- topic/topic**</class>
   <componentpath>fmdita/components/dita/topic</componentpath>
   <type>COMPOSITE</type>
   <target>para</target>
   <attributemap>
      <attribute from="id" to="id" />
   </attributemap>
</ditaelement>

Dans l’exemple ci-dessus, si aucun mappage n’est défini pour l’élément task, l’élément task est mappé au composant ci-dessus, car task est hérité du composant topic.

Lorsqu’un élément possède un mappage de composant correspondant, le traitement ultérieur de ses éléments enfants est déterminé par type. Par exemple :

<ditaelement>
   <name>title</name>
   <class>- topic/title</class>
   <componentpath>foundation/components/title</componentpath>
   <type>**STANDALONE**</type>
   <target>para</target>
   <textprop>jcr:title</textprop>
</ditaelement>

type prend les valeurs suivantes :

• COMPOSITE : le mappage élément à composant continue pour les éléments enfants également.

• AUTONOME : les éléments enfants de l’élément actif ne sont plus mappés.

Dans l’exemple ci-dessus, si l’élément <title> comporte des éléments enfants, ils ne seront mappés à aucun autre composant. Le composant de <title>’élément est responsable du rendu de tous les éléments enfants dans l’élément <title>.

S'il existe plusieurs composants mappés à un seul élément DITA, la meilleure correspondance pour l'élément est sélectionnée. Pour sélectionner le composant qui correspond le mieux, une spécialisation de domaine et de structure des éléments DITA est prise en compte.

S’il existe des éléments DITA avec une spécialisation de domaine et qu’un composant est mappé pour la spécialisation de domaine, la priorité élevée est accordée à ce composant.

De même, si des éléments DITA sont dotés d'une spécialisation structurelle et qu'un composant est mappé pour la spécialisation structurelle, la priorité est accordée à ce composant.

Vous pouvez utiliser des <attributemap> dans le mappage d’éléments pour mapper des valeurs d’attribut aux propriétés de nœud correspondantes.

textprop peut être utilisé pour sérialiser le contenu texte d'un élément DITA en une propriété de nœud. En outre, elle peut être utilisée plusieurs fois dans une balise d’élément pour sérialiser le contenu du texte à plusieurs emplacements dans la hiérarchie publiée. Vous pouvez également personnaliser l’emplacement et le nom de la propriété cible. Par exemple :

<ditaelement>
   <name>title</name>
   <componentpath>foundation/components/title</componentpath>
   <type>STANDALONE</type>
   <target>para</target>
    <textprop>**jcr:title**</textprop>
</ditaelement>

Le mappage de l’élément ci-dessus indique que le contenu textuel de <title>’élément sera enregistré en tant que valeur d’une propriété nommée jcr:title sur le nœud de sortie.

xmlprop peut être utilisé pour sérialiser l’intégralité du code XML d’un élément donné en une propriété de nœud. Le composant peut ensuite lire cette propriété de nœud et effectuer un rendu personnalisé. Par exemple :

<ditaelement>
    <name>svg-container</name>
   <class>+ topic/foreign svg-d/svg-container</class>
    <componentpath>fmdita/components/dita/svg</componentpath>
    <type>STANDALONE</type>
    <target>para</target>
   <xmlprop>**data**</xmlprop>
</ditaelement>

Le mappage d’éléments ci-dessus indique que l’intégralité du balisage XML pour l’élément <svg-container> sera enregistrée en tant que valeur d’une propriété nommée data sur le nœud de sortie.

Il existe un mappage d’attributs spécial pour gérer la résolution de chemin dans le processus de génération de sortie. Par exemple :

<attributemap>
   <attribute from="href" to="fileReference" ispath="true" rel="source" />
   <attribute from="height" to="height" />
    <attribute from="width" to="width" />
</attributemap>

Pour l'attributemap ci-dessus, l'attribut href dans votre élément DITA sera mappé à une propriété de nœud nommée fileReference. Maintenant que ispath est défini sur true, le processus de génération de sortie résout ce chemin d’accès, puis le définit dans fileReference propriété de nœud .

Le mode de résolution est déterminé en fonction de la valeur de l’attribut rel dans le mappage des attributs.

• Si rel=source, la valeur de href est résolue par rapport au fichier source DITA en cours de traitement. La valeur de href est résolue et placée dans la valeur de fileReference propriété .

• Si rel=target, la valeur de href est résolue par rapport à l’emplacement de publication racine. La valeur de href est résolue et placée dans la valeur de fileReference propriété .

Si vous ne souhaitez pas qu’un prétraitement ou une résolution se produise sur les attributs de chemin, vous n’avez pas besoin de spécifier l’attribut ispath. La valeur est copiée telle quelle et le composant peut effectuer la résolution requise.