A gegevensbron is een systeem waarin u de gegevens voor uw organisatie opslaat en beheert. Dit zijn uw systemen van verslag zoals JIRA, SQL Gegevensbestanden, PIM, of PLM. AEM de Gidsen verstrekt de eigenschap om met uw gegevensbron te verbinden en de gegevens van hen te gebruiken.
U kunt ook verbinding maken met JSON-gegevensbestanden via een bestandsconnector. Upload het JSON-bestand van uw computer of blader erdoor vanaf de Adobe Experience Manager-elementen. Creëer vervolgens inhoudsfragmenten of -onderwerpen met behulp van de generatoren.
Deelvenster Gegevensbronnen
Selecteren Gegevensbronnen in het linkerpaneel om de verbonden gegevensbronnen te bekijken. Het paneel van Gegevensbronnen opent en toont alle verbonden gegevensbronnen.
Gebaseerd op uw opstelling kan uw beheerder een gegevensbronschakelaar vormen:
Leer hoe u de release van juli 2023 of september 2023 gebruikt configureren van gegevensbronaansluiting in de Installatie- en configuratiehandleiding van Cloud Servicen.
U zult de gegevensbronnen zien waarvoor uw beheerder de schakelaar heeft gevormd.
Lijstweergave of Tegelweergave tonen
U kunt schakelen tussen de Lijstweergave of de Tegelweergave om de verschillende gegevensbronnen weer te geven in de vorm van een lijst of als tegels.
Selecteer een gegevensbron om de generators van het inhoudsfragment en de onderwerpgenerators te bekijken beschikbaar voor de geselecteerde gegevensbron.
Lijstweergave
{width="300"}
Lijst met verbonden gegevensbronnen.
Tegelweergave
{width="300"}
De verbonden gegevensbronnen weergeven als tegels.
U kunt de gegevens van gegevensbronnen op twee manieren gebruiken:
Een inhoudsfragment invoegen
Een onderwerp maken
Een inhoudsfragment uit uw gegevensbron invoegen
AEM Hulplijnen bieden de functie om verbinding te maken met uw gegevensbron. U kunt uw gegevens ophalen, het opnemen in uw onderwerpen, en het uitgeven. U kunt een inhoudsfragment gemakkelijk tot stand brengen gebruikend de inhoudsfragmentgenerator en het binnen uw onderwerpen opnieuw gebruiken.
Voer de volgende stappen uit om een inhoudsfragment tot stand te brengen gebruikend de generator van het inhoudsfragment en neem het in uw onderwerp op:
Selecteren Gegevensbronnen in het linkerpaneel om de verbonden gegevensbronnen te bekijken.
Selecteer een gegevensbron om de inhoudsfragmentgenerators te bekijken beschikbaar voor de geselecteerde gegevensbron.
{width="300"}
In het deelvenster Gegevensbronnen worden de beschikbare generatoren voor inhoudsfragmenten weergegeven.
Selecteren Toevoegen om een nieuwe inhoudsfragmentgenerator toe te voegen. De Generator voor inhoudsfragmenten toevoegen wordt geopend.
Voer de query in het dialoogvenster Gegevensquery tekstvak. Selecteren Voorbeeldquery kopiëren om snel een gegevensvraag te kopiëren. In plaats van de query handmatig te maken, kunt u de voorbeeldquery kopiëren en plakken in de Gegevensquery tekstvak. Dan, geef eenvoudig de vraag volgens uw gegevensvereisten uit.
note note
NOTE
Experience Manager verstrekt verschillende steekproefvragen voor alle middelen in de diverse gegevensbronnen. Deze kaart aan de gegevensbron waarvan u de gegevens haalt.
Als u een bestandsconnector gebruikt, kunt u het JSON-bestand vanaf uw computer uploaden of door een JSON-bestand bladeren vanuit Adobe Experience Manager-middelen.
note note
NOTE
Als u een bestandsconnector gebruikt, kunt u de opties voor het uploaden naar bestanden bekijken of door bestanden bladeren in plaats van een gegevensquery.
Selecteer in het menu van het palet Gegevenstoewijzingssjabloon vervolgkeuzelijst. De out-of-the-box malplaatjes voor de geselecteerde gegevensbron worden getoond in drop-down. Bijvoorbeeld, kunt u het "sql-lijst"malplaatje voor datasource bekijken genoemd "PostSQL"gegevensbron.
note note
NOTE
Als uw beheerder aangepaste sjablonen heeft geconfigureerd, worden deze sjablonen ook weergegeven in de vervolgkeuzelijst (op basis van de sjabloonpadconfiguraties die de beheerder heeft uitgevoerd).
De Bron het keuzemenu wordt weergegeven voor bepaalde connectors, zoals REST Client, Salsify, Akeneo en Microsoft ADO. Selecteer om het even welk middel van dropdown en verbind met het om een inhoudsfragment of een onderwerp tot stand te brengen gebruikend de generator voor het.
note note
NOTE
Uw beheerder kan standaardmiddelen vormen of middelen voor veelvoudige URLs toevoegen terwijl het vormen van de gegevensbronschakelaars.
Klikken Ophalen om de gegevens van de gegevensbron te halen en het malplaatje op de gegevens toe te passen die uit de SQL vraag voortvloeien.
U kunt de gegevens weergeven in de voorvertoning of in de DITA-bronweergave.
In het voorbeeld ziet u hoe de gegevens worden weergegeven wanneer ze in de inhoud worden ingevoegd. In de voorvertoning wordt een klein deel van de gegevens weergegeven in de indeling van de geselecteerde sjabloon. Bijvoorbeeld:
Als u de sjabloon voor de sql-tabel hebt geselecteerd, kunt u de SQL-gegevens weergeven in een tabelindeling.
Als u de sjabloon voor jira-geordende lijsten hebt geselecteerd, kunt u een geordende lijst weergeven voor de Jira-problemen.
De bronweergave toont de gegevens in de DITA-bronweergave.
{width="800"} *Voeg een inhoudsfragmentgenerator toe. Gegevens weergeven in bron- of voorvertoningsmodus.*
Om de resultaten van de vraag te bewaren, ga de naam van de generator in en klik dan ADD. Er wordt een nieuwe inhoudsfragmentgenerator toegevoegd aan de lijst.
note note
NOTE
U moet de naamgevingsconventie voor bestanden volgen voor de naam van de nieuwe inhoudsgenerator. U kunt geen ruimte hebben in de naam van de inhoudsfragmentgenerator. U kunt ook geen nieuwe inhoudsgenerator opslaan met de naam van een bestaande inhoudsgenerator. Er treedt een fout op.
Opties voor een inhoudsfragmentgenerator
Klik met de rechtermuisknop op een inhoudsfragmentgenerator om de opties te openen. Met de opties kunt u de volgende bewerkingen uitvoeren:
Voorvertoning: Gebruik deze optie om een venster te openen en een klein deel van de weergave van de gegevens in de uitvoer weer te geven.
Invoegen: Gebruik deze optie om het geselecteerde inhoudsfragment in te voegen in het onderwerp dat voor het uitgeven in de Redacteur van het Web wordt geopend. Aangezien het gegeven als fragment wordt opgenomen, kunt u de gegevens binnen uw onderwerp in de Redacteur van het Web ook uitgeven.
note note
NOTE
De optie Invoegen wordt alleen weergegeven als u een onderwerp bewerkt.
Bewerken: Gebruik deze optie om wijzigingen aan te brengen in de inhoudsfragmentgenerator en deze op te slaan.
Verwijderen: Gebruik deze optie om de geselecteerde inhoudsfragmentgenerator te verwijderen.
Dupliceren: Gebruik deze optie om een duplicaat of kopie van de geselecteerde inhoudsfragmentgenerator te maken. Het duplicaat wordt standaard gemaakt met een achtervoegsel (zoals generator_1).
Een queryfragment invoegen
U kunt ook de opdracht Zoekfragment invoegen van de belangrijkste toolbar om het gegevensfragment in de onderwerpen op te nemen. U kunt een generator van dropdown selecteren, uw vraag uitgeven, of het malplaatje veranderen en de gegevens in uw onderwerp opnemen.
{width="800"}
Een gegevensfragment bewerken en invoegen.
Creeer een onderwerp gebruikend de onderwerpgenerator
Een onderwerpgenerator helpt u onderwerpen tot stand brengen die gegevens van uw bronnen bevatten. U kunt snel een onderwerpgenerator tot stand brengen en dan de onderwerpen produceren gebruikend de generator. Elk onderwerp kan gegevens in diverse formaten, zoals lijsten, lijsten, en paragrafen bevatten. In een onderwerp kunt u bijvoorbeeld een tabel toevoegen met de details van alle nieuwe producten en een lijst met alle producten die worden afgezet voor verkoop.
De onderwerpgenerator kan de onderwerpen tot stand brengen die de gegevens en een kaart DITA voor alle onderwerpen bevatten. U kunt ook <conref> Deze onderwerpen in uw inhoud. Zo kunt u uw gegevens synchroon houden met de gegevensbron en deze eenvoudig bijwerken.
Een onderwerp maken
Voer de volgende stappen uit om een onderwerp tot stand te brengen gebruikend de onderwerpgenerator:
Selecteer een gegevensbron om de generators van het inhoudsfragment en de onderwerpgenerators te bekijken beschikbaar voor de geselecteerde gegevensbron.
{width="300"}
Voeg een onderwerpgenerator voor een verbonden gegevensbron toe.
Selecteren Toevoegen en selecteert u Topgenerator van dropdown om een nieuwe onderwerpgenerator toe te voegen. De Onderwerpgenerator toevoegen wordt geopend.
Voer de waarden in de velden in onder de volgende drie tabbladen van het dialoogvenster Onderwerpgenerator toevoegen paneel:
Ophaalconfiguratie
{width="300"}
Voeg de Vraag van Gegevens, het kaartmalplaatje van Gegevens, en de details van de wortelknoop voor de onderwerpgenerator toe en geef het een unieke naam in het paneel van de Configuratie van de Ophalen.
Voer de query in het dialoogvenster Gegevensquery tekstvak. Selecteren Voorbeeldquery kopiëren om snel een gegevensvraag te kopiëren. In plaats van de query handmatig te maken, kunt u de voorbeeldquery kopiëren en plakken in de Gegevensquery tekstvak. Dan, geef eenvoudig de vraag volgens uw gegevensvereisten uit.
note note
NOTE
Experience Manager verstrekt verschillende steekproefvragen voor alle middelen in de diverse gegevensbronnen. Deze kaart aan de gegevensbron waarvan u de gegevens haalt.
Als u een bestandsconnector gebruikt, kunt u het JSON-bestand vanaf uw computer uploaden of door een JSON-bestand bladeren vanuit Adobe Experience Manager-middelen.
note note
NOTE
Als u een bestandsconnector gebruikt, kunt u de opties voor het uploaden naar bestanden bekijken of door bestanden bladeren in plaats van een gegevensquery.
Selecteer in het menu van het palet Gegevenstoewijzingssjabloon vervolgkeuzelijst.
note note
NOTE
Als uw beheerder aangepaste malplaatjes heeft gevormd, dan wordt u ook getoond die malplaatjes in de drop-down lijst (die op de configuraties van de malplaatjeweg door uw beheerder wordt gebaseerd). U kunt bijvoorbeeld een onderwerpsjabloon maken met een geordende lijst, tabellen, alinea's of andere DITA-elementen.
Voer de Basisknooppunt. Dit is de knoop waarbij u tot uw gegevens wilt toegang hebben. De onderwerpgenerator leidt dan tot elk onderwerp op het niveau dat in de wortelknoop wordt bepaald. U kunt bijvoorbeeld "issues" toevoegen als het hoofdknooppunt in Jira. Zo, als een vraag 13 kwesties terugkeert, zult u 13 onderwerpen, één onderwerp voor elke kwestie krijgen.
Klikken Ophalen om de gegevens van de gegevensbron te halen en het malplaatje op de gegevens toe te passen die uit de SQL vraag voortvloeien. In de voorvertoning wordt een klein gedeelte weergegeven van de manier waarop het onderwerp wordt weergegeven in de indeling van de geselecteerde sjabloon. U kunt bijvoorbeeld één Jira-uitgave weergeven met alle velden die het resultaat zijn van de query.
Ga de naam van de onderwerpgenerator in.
note note
NOTE
U moet de dossier noemende overeenkomst voor de naam van de nieuwe onderwerpgenerator volgen. U kunt geen ruimte in de naam van de onderwerpgenerator hebben. Ook, kunt u geen nieuwe onderwerpgenerator met de naam van een bestaande onderwerpgenerator bewaren. Er treedt een fout op.
Uitvoerconfiguratie
{width="300"}
Voer in het deelvenster Uitvoerconfiguratie de details in van de naamgevingsconventie voor Uitvoer en Onderwerp. Genereer een DITA-kaart en noem deze.
Voer de Uitvoerpad details waar u uw onderwerpen wilt bewaren.
In de Naamgevingsconventie voor onderwerpen kunt u een waarde of een variabele met snelheidstags invoeren. De nieuwe onderwerpen volgen de conventie. U kunt bijvoorbeeld het dialoogvenster $key om onderwerpen te maken op basis van Jira-sleutels.
De optie inschakelen Een kaart genereren als u een kaart wilt creëren die alle geproduceerde onderwerpen bevat.
Ga de naam van de nieuwe kaart DITA in.
note note
NOTE
De generator van het Onderwerp produceert de kaart DITA op de zelfde outputweg zoals de onderwerpen.
Metagegevens
Selecteer de eigenschappen van meta-gegevens van drop-down om tot de onderwerpen over te gaan. Naam in het vervolgkeuzemenu worden zowel de aangepaste als de standaardeigenschappen weergegeven.
In de volgende schermafbeelding bijvoorbeeld: dc:description, dc:language, dc:title, en docstate Dit zijn de standaardeigenschappen waarvoor u de waarden kunt definiëren. U kunt een aangepaste eigenschap maken, zoals een auteur, en de waarde ervan definiëren.
{width="300"}
Voeg de eigenschappen van meta-gegevens in het paneel van Meta-gegevens toe om tot de onderwerpen over te gaan.
Voer de naam van de generator in en klik op Opslaan om de queryresultaten op te slaan. Een nieuwe onderwerpgenerator wordt toegevoegd aan de lijst.
Klikken Opslaan en genereren om de onderwerpgenerator te bewaren en nieuwe onderwerpen van de onderwerpgenerator te produceren.
{width="650"}
Produceer nieuwe onderwerpen van een bestaande onderwerpgenerator.
note note
NOTE
Als de onderwerpen reeds bestaan, dan werkt de generator de gegevens in de bestaande onderwerpen bij.
Opties voor een onderwerpgenerator
Klik met de rechtermuisknop op een onderwerpgenerator om de Opties. Met de opties kunt u de volgende bewerkingen uitvoeren:
Genereren: Deze optie produceert de onderwerpen voor de geselecteerde onderwerpgenerator. U kunt deze optie ook gebruiken om de bestaande onderwerpen bij te werken. Het verbindt met de gegevensbron en haalt de bijgewerkte gegevens. Tijdens het genereren van de inhoud is deze optie uitgeschakeld en kunt u een lader weergeven.
note note
NOTE
Als uw onderwerp reeds bestaat, kunt u of de gegevens in het onderwerp overschrijven of het opslaan als nieuwe versie.
Genereer een onderwerp en sla het op als een nieuwe versie of overschrijf het bestand als het al bestaat.
Logboek weergeven: Selecteer deze optie om het logbestand voor het genereren van inhoud weer te geven. Het logbestand wordt op een nieuw tabblad geopend. U kunt de fouten, waarschuwingen, informatieberichten, en uitzonderingen in het logboekdossier bekijken. Deze optie wordt toegelaten als u de inhoud voor de geselecteerde onderwerpgenerator hebt geproduceerd.
Voorvertoning: Gebruik deze optie om een venster te openen en een klein deel van de weergave van de gegevens in de uitvoer weer te geven.
Bewerken: Gebruik deze optie om de onderwerpgenerator te veranderen en te bewaren. Deze optie is uitgeschakeld wanneer u de inhoud genereert.
Verwijderen: Gebruik deze optie om de geselecteerde onderwerpgenerator te schrappen. Deze optie is uitgeschakeld wanneer u de inhoud genereert.
Dupliceren: Met deze optie maakt u een kopie of kopie van de geselecteerde onderwerpgenerator. Het duplicaat wordt gemaakt met een achtervoegsel (zoals topic-sample_1) standaard.
De hulpmiddelen van de Snelheid van het gebruik in de gegevensbronmalplaatjes use-velocity-tools
Experience Manager sjablonen ondersteunen ook de snelheidsgereedschappen (versie 2.0). Met deze gereedschappen kunt u verschillende functies toepassen op de gegevens die u ophaalt van de gegevensbronnen. Meer informatie over het gebruik van de Snelheidsgereedschappen en de functies die u kunt toepassen.
Voer de volgende stappen uit om een hulpmiddel van de Snelheid in een malplaatje te gebruiken:
Bewerk een snelheidssjabloon in de webeditor.
Een gereedschap en de functie ervan toevoegen in het dialoogvenster <tool.function> gebruiken. Bijvoorbeeld:
Als u een willekeurig getal wilt genereren met het gereedschap Wiskunde, gebruikt u $mathTool.random.
Als u de som getallen wilt genereren met het gereedschap Wiskunde, gebruikt u $mathTool.add(num1, num2).
Gebruik de sjabloon om een inhoudsfragment of onderwerp te maken.
Nadat u het malplaatje op de gegevens toepast, kunt u de gegevens in de voorproef of de DITA bronmening bekijken.
U kunt de volgende hulpmiddelen binnen de malplaatjes van de Snelheid gebruiken om diverse functies op de gegevens toe te passen u van de schakelaar haalt: -$alternatorTool
