[Ook van toepassing op v8]{class="badge positive" title="Ook van toepassing op campagne v8"}

Inhoud verrijken enriching-content

Met aggregators kunt u de inhoud verrijken met externe gegevens. Dit gegeven komt uit generische vragen of verbonden lijsten.

Algemene vragen generic-queries

De vragen worden gevormd via het publicatiesjabloon in Aggregator tab.

De opgehaalde gegevens verrijken het XML-uitvoerdocument via het hoofdelement.

Voorbeeld van het resultaat van een query op het ontvangende schema (nms:ontvanger):

<book name="Content Management">
  ...
  <collection-recipient>
    <recipient lastName="Doe" firstName="John" email="john.doe@aolf.com">
    ...
  </collection-recipient>
</book>

De <collection-recipient> element vertegenwoordigt het inputelement van het document resulterend uit een vraag. De opgehaalde gegevens worden onder dit element geretourneerd. In ons voorbeeld is dit een lijst met ontvangers.

Een query toevoegen adding-a-query

De queryparameters worden bewerkt met een wizard.

Gekoppelde tabellen linked-tables

Met koppelingen kunt u externe gegevens ophalen die zijn gekoppeld aan de inhoud.

Er zijn twee typen gekoppelde gegevens:

Koppeling maken naar een inhoudsschema link-to-a-content-schema

Een inhoudskoppeling wordt als volgt gedeclareerd in het gegevensschema:

<element expandSchemaTarget="cus:chapter" label="Main chapter" name="mainChapter" type="string"/>

De definitie van de koppeling wordt ingevuld op een string-type <element> en de expandSchemaTarget kenmerkverwijzingen het doelschema ("focus:hoofdstuk" in ons voorbeeld). Het schema waarnaar wordt verwezen, moet een inhoudsschema zijn.

De inhoud van het doelelement verrijkt het koppelingselement, dat wil zeggen de <chapter> element in ons voorbeeldschema:

<mainChapter computeString="Introduction" id="7011" title="Introduction" xtkschema="cus:chapter">
  <page>Introduction to input <STRONG>forms</STRONG>.</page>
</mainChapter>

In het invoerformulier wordt het bewerkingsbeheer van de koppeling als volgt gedeclareerd:

<input type="articleEdit" xpath="mainChapter"/>

De Magnifier kunt u het bewerkingsformulier van het gekoppelde element openen.

Verzameling koppelen link-collection

Als u een verzameling koppelingen wilt vullen, voegt u de opdracht unbound="true" attribuut aan de definitie van het verbindingselement in het gegevensschema:

<element expandSchemaTarget="cus:chapter" label="List of chapters" name="chapter"  ordered="true" unbound="true"/>

De inhoud van het doelelement verrijkt elk verzamelingselement:

<chapter computeString="Introduction" id="7011" title="Introduction" xtkschema="cus:chapter">
  <page>Introduction to input <STRONG>forms</STRONG>.</page>
</chapter>

In het invoerformulier wordt het besturingselement voor de lijst als volgt gedeclareerd:

<input editable="false" nolabel="true" toolbarCaption="List of chapters" type="articleList" xpath="chapter" zoom="true"/>

Er wordt een standaardkolom weergegeven om de Rekenreeks van de beoogde elementen.

Koppelingen naar externe tabellen links-to-external-tables

Een koppeling naar een externe tabel wordt als volgt gedeclareerd in het gegevensschema:

<element label="Main contact" name="mainContact" target="nms:recipient" type="link"/>

De definitie van de koppeling wordt ingevuld op een link-type <element> en de target kenmerkverwijzingen het doelschema ("nms:ontvanger" in ons voorbeeld).

Door overeenkomst, moeten de verbindingen van het belangrijkste element van het gegevensschema worden verklaard.

De Rekenreeks en de sleutel van het doelelement verrijkt het <name>-id en <name>-cs kenmerken op het hoofdelement.

In ons voorbeeld wordt de koppeling gevuld in het schema "cus:book". De inhoud van de koppelingsgegevens bevindt zich in de kenmerken "mainContact-id" en "mainContact-cs":

<book computeString="Content management" date="2006/06/08" id="6106" language="en" mainContact-cs="John Doe (john.doe@adobe.com)" mainContact-id="3012" name="Content management" xtkschema="cus:book">

Besturingselement voor bewerken van koppeling wordt als volgt gedeclareerd:

<input xpath="mainContact"/>

U kunt de keuze van doelelementen beperken door de optie <sysfilter> element via de koppelingsdefinitie in het invoerformulier:

<input xpath="mainContact">
  <!-- Filter the selection of the link on the Adobe domain -->
  <sysFilter>
    <condition expr="@domain =  'adobe.com '"/>
  </sysFilter>
</input>

Verzameling koppelen link-collection-1

De definitie van de verzameling is identiek aan de definitie van een lijst met verzamelingselementen:

<element label="List of contacts" name="contact" unbound="true">
  <element label="Recipient" name="recipient" target="nms:recipient" type="link"/>
</element>

In het invoerformulier wordt het besturingselement voor de lijst als volgt gedeclareerd:

<input nolabel="true" toolbarCaption="List of contacts" type="list" xpath="contact">
  <input xpath="recipient"/>
</input>

De inhoud van het doelelement verrijkt elk verzamelingselement in het uitvoerdocument:

<contact id="11504978621" recipient-cs="Doe John (john.doe@adobe.com)" recipient-id="3012"/>
<contact id="11504982510" recipient-cs="Martinez Peter (peter.martinez@adobe.com)" recipient-id="3013"/>

Linkaggregatie link-aggregation

De inhoud van elke koppeling waarnaar wordt verwezen, is beperkt tot de interne sleutel en de Rekenreeks van het doelelement.

Een JavaScript-script wordt gebruikt om de inhoud van de koppelingen te verrijken via SOAP-query's.

Voorbeeld: Voeg de naam van de ontvanger toe aan de koppeling "mainContact" en de koppelingen voor de verzameling "contact":

// Update <mainContact> link
var mainContactId = content.@['mainContact-id']
var query = xtk.queryDef.create(
    <queryDef schema="nms:recipient" operation="get">
      <select>
        <node expr="@lastName"/>
      </select>
      <where>
        <condition expr={"@id="+mainContactId}/>
      </where>
    </queryDef>)

var recipient = query.ExecuteQuery()
content.mainContact.@lastName = recipient.@lastName

// Update <contact> link collection
for each(var contact in content.contact)
{
  var contactId = contact.@['recipient-id']
  var query = xtk.queryDef.create(
    <queryDef schema="nms:recipient" operation="get">
      <select>
        <node expr="@lastName"/>
      </select>
      <where>
        <condition expr={"@id="+contactId}/>
      </where>
    </queryDef>
  )

  var recipient = query.ExecuteQuery()
  contact.@lastName = recipient.@lastName
}

Het resultaat dat na de uitvoering van het script wordt bereikt:

<mainContact lastName="Doe"/>

<contact id="11504978621" lastName="Doe" recipient-cs="Doe John (john.doe@adobe.com)" recipient-id="3012"/>
<contact id="11504982510" lastName="Martinez" recipient-cs="Martinez Peter (peter.martinez@adobe.com)" recipient-id="3013"/>

De inhoud van de JavaScript-code wordt toegevoegd via de Administration > Configuration > Content management > JavaScript Codes en moet voor elke transformatie worden ingevuld in de publicatiesjabloon.