Anpassa DITA-elementmappning med AEM-komponenter id1679J600HEL

Alla DITA-element söks först efter en motsvarande komponentmappning baserat på elementnamnet. Till exempel:

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

I ovanstående exempel återges alla substeps DITA-element med komponenten dita/components/ditaolist.

Om ett DITA-element inte hittar någon matchning baserat på namnet görs en matchning utifrån class. Till exempel:

<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>

Om ingen mappning har definierats för elementet task i ovanstående exempel mappas elementet task till ovanstående komponent eftersom task ärvs från komponenten topic.

När ett element har en motsvarande komponentmappning bestäms vidare bearbetning av dess underordnade element av type. Till exempel:

<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 har följande värden:

• COMPOSITE: Mappningen av element till komponent fortsätter även för underordnade element.

• STANDALONE: underordnade element för det aktuella elementet har inte mappats ytterligare.

Om elementet <title> har några underordnade element mappas de inte till någon annan komponent i ovanstående exempel. Komponenten för elementet <title> ansvarar för återgivningen av alla underordnade element i elementet <title>.

Om det finns flera komponenter som är mappade till ett enskilt DITA-element väljs den bästa matchningen för elementet. För att välja den bästa matchningskomponenten övervägs domän- och strukturexSpecialisering för DITA-element.

Om det finns DITA-element med domänspecialisering och en komponent mappas för domänspecialisering får den komponenten hög prioritet.

Om det finns DITA-element med strukturell specialisering och en komponent mappas för strukturell specialisering får den komponenten hög prioritet.

Du kan använda <attributemap> i elementmappningen för att mappa attributvärden till motsvarande nodegenskaper.

textprop kan användas för att serialisera textinnehållet i ett DITA-element till en nodegenskap. Dessutom kan den användas flera gånger i en elementtagg för att serialisera textinnehållet på flera platser i den publicerade hierarkin. Du kan också anpassa platsen och namnet för målegenskapen. Till exempel:

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

Ovanstående elementmappning anger att textinnehållet i elementet <title> kommer att sparas som värdet för en egenskap med namnet jcr:title på utdatanoden.

xmlprop kan användas för serialisering av hela XML för ett givet element till en nodegenskap. Komponenten kan sedan läsa den här nodegenskapen och göra anpassad återgivning. Till exempel:

<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>

Ovanstående elementmappning anger att hela XML-koden för elementet <svg-container> kommer att sparas som ett värde för egenskapen data på utdatanoden.

Det finns en särskild attributmappning som hanterar sökvägsupplösning i utdatagenereringsprocessen. Till exempel:

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

För ovanstående attributemap mappas attributet href i DITA-elementet till en nodegenskap med namnet fileReference. Eftersom ispath är inställt på true löser utdatagenereringsprocessen den här sökvägen och anger den sedan i nodegenskapen fileReference.

Hur den här upplösningen sker bestäms utifrån värdet för attributet rel i attributmappningen.

• Om rel=source, löses värdet för href med avseende på DITA-källfilen som bearbetas just nu. Värdet för href tolkas och placeras i värdet för egenskapen fileReference.

• Om rel=target tolkas värdet för href med avseende på rotpubliceringsplatsen. Värdet för href tolkas och placeras i värdet för egenskapen fileReference.

Om du inte vill att någon förbearbetning eller upplösning ska ske för sökvägsattribut behöver du inte ange attributet ispath. Värdet kopieras som det är och komponenten kan utföra den önskade upplösningen.