Utilizzare dati dall’origine dati
Un'origine dati è un sistema in cui vengono archiviati e gestiti i dati per l'organizzazione. Si tratta di sistemi di record come JIRA, SQL Databases, PIM o PLM. AEM Guides offre la funzione di connettersi all’origine dati e utilizzare i dati da essa provenienti.
Puoi anche connetterti a file di dati JSON utilizzando un connettore per file. Carica il file JSON dal computer o sfoglia le risorse Adobe Experience Manager. Quindi, crea snippet di contenuto o argomenti utilizzando i generatori.
Pannello Origini dati
Seleziona Origini dati nel pannello a sinistra per visualizzare le origini dati connesse. Viene visualizzato il pannello Origini dati (Data Sources), in cui sono visualizzate tutte le origini dati collegate.
In base alla configurazione, l’amministratore può configurare un connettore dell’origine dati:
-
Se utilizzi la versione di ottobre 2023 o successiva, scopri come configurare un connettore dell'origine dati dall'interfaccia utente nella Guida all'installazione e alla configurazione dei Cloud Service.
-
Se utilizzi la versione di luglio 2023 o di settembre 2023, scopri come configurare un connettore dell'origine dati nella Guida all'installazione e alla configurazione dei Cloud Service.
-
Se utilizzi la versione 4.3.1 o successiva, scopri come configurare un connettore dell'origine dati dall'interfaccia utente nella Guida all'installazione e alla configurazione on-premise.
-
Se utilizzi la versione 4.3, scopri come configurare un connettore dell'origine dati nella Guida all'installazione e alla configurazione on-premise.
Mostra vista elenco o vista affiancata
È possibile passare dalla Vista a elenco alla Vista a riquadri e viceversa per visualizzare le varie origini dati sotto forma di elenco o come riquadri.
Selezionare un'origine dati per visualizzare i generatori di frammenti di contenuto e i generatori di argomenti disponibili per l'origine dati selezionata.
Visualizzazione elenco
{width="300"}
Elenco delle origini dati connesse.
Vista affiancata
{width="300"}
Visualizzare le origini dati connesse come riquadri.
È possibile utilizzare i dati delle origini dati in due modi:
- Inserire uno snippet di contenuto
- Creare un argomento
Inserire uno snippet di contenuto dall'origine dati
AEM Guides offre la funzione di connessione all’origine dati. Puoi recuperare i dati, inserirli negli argomenti e modificarli. Puoi creare facilmente un frammento di contenuto utilizzando il generatore di frammenti di contenuto e riutilizzarlo all’interno degli argomenti.
Per creare uno snippet di contenuto utilizzando il generatore di snippet di contenuto e inserirlo nell’argomento, effettua le seguenti operazioni:
-
Seleziona Origini dati nel pannello a sinistra per visualizzare le origini dati collegate.
-
Selezionare un'origine dati per visualizzare i generatori di frammenti di contenuto disponibili per l'origine dati selezionata.
{width="300"}
Nel pannello Origini dati sono elencati i generatori di frammenti di contenuto disponibili.
-
Seleziona Aggiungi per aggiungere un nuovo generatore di frammenti di contenuto. Viene aperto il pannello Aggiungi generatore frammento di contenuto.
-
Immettere la query nella casella di testo Query dati. Seleziona Copia query di esempio per copiare rapidamente una query di dati. Anziché creare manualmente la query, è possibile copiare e incollare la query di esempio nella casella di testo Query dati. Quindi, è sufficiente modificare la query in base ai requisiti di dati.
note note NOTE In Experience Manager vengono fornite query di esempio diverse per tutte le risorse nelle varie origini dati. Questi vengono mappati all’origine dati da cui stai recuperando i dati. -
Se utilizzi un connettore per file, puoi caricare il file JSON dal computer o sfogliare un file JSON dalle risorse Adobe Experience Manager.
note note NOTE Se utilizzi un connettore file, verranno visualizzate le opzioni per caricare o sfogliare i file al posto di una query di dati. -
Seleziona il modello da mappare con l'origine dati dal menu a discesa Modello di mappatura dati.
I modelli predefiniti per l’origine dati selezionata vengono visualizzati nel menu a discesa. Ad esempio, è possibile visualizzare il modello "sql-table" per l'origine dati denominata "PostgreSQL".note note NOTE Se l’amministratore ha configurato dei modelli personalizzati, questi vengono visualizzati anche nell’elenco a discesa (in base alle configurazioni del percorso del modello eseguite dall’amministratore). Puoi anche utilizzare gli strumenti Velocity nei modelli. Ulteriori informazioni su come utilizzare gli strumenti Velocity. -
Il menu a discesa Risorsa viene visualizzato per alcuni connettori come REST Client, Salsify, Akeneo e Microsoft ADO. Seleziona una risorsa dal menu a discesa e connettiti ad essa per creare uno snippet di contenuto o un argomento utilizzando il relativo generatore.
note note NOTE L’amministratore può configurare le risorse predefinite o aggiungere risorse per più URL durante la configurazione dei connettori dell’origine dati. -
Fare clic su Recupera per recuperare i dati dall'origine dati e applicare il modello ai dati risultanti dalla query SQL.
-
È possibile visualizzare i dati nell'anteprima o nella vista origine DITA.
-
L’anteprima mostra come verranno visualizzati i dati quando vengono inseriti nel contenuto. Nell'anteprima viene visualizzata una piccola frazione di dati nel formato del modello selezionato.
Ad esempio:- Se è stato selezionato il modello di tabella SQL, è possibile visualizzare i dati SQL in formato tabulare.
- Se hai selezionato il modello di elenco jira ordinato, puoi visualizzare un elenco ordinato per i problemi Jira.
-
La vista origine mostra i dati nella vista origine DITA.
{width="800"}
*Aggiungi un generatore di frammenti di contenuto. Visualizza i dati in modalità di origine o anteprima.*
-
-
Per salvare i risultati della query, immettere il nome del generatore, quindi fare clic su AGGIUNGI. All’elenco viene aggiunto un nuovo generatore di frammenti di contenuto.
note note NOTE Devi seguire la convenzione di denominazione dei file per il nome del nuovo generatore di contenuti. Il nome del generatore di frammenti di contenuto non può contenere spazi. Inoltre, non è possibile salvare un nuovo generatore di contenuti con il nome di un generatore di contenuti esistente. Si verifica un errore.
Opzioni per un generatore di frammenti di contenuto
Fai clic con il pulsante destro del mouse su un generatore di frammenti di contenuto per aprire Opzioni. Utilizzando le opzioni, potete effettuare le seguenti operazioni:
-
Anteprima: utilizzare questa opzione per aprire un riquadro e visualizzare una piccola frazione dei dati visualizzati nell'output.
-
Inserisci: utilizzare questa opzione per inserire lo snippet di contenuto selezionato nell'argomento aperto per la modifica nell'editor Web. Poiché i dati vengono inseriti come frammento, è anche possibile modificare i dati all'interno dell'argomento nell'Editor Web.
note note NOTE L'opzione Inserisci viene visualizzata solo durante la modifica di un argomento. -
Modifica: utilizza questa opzione per apportare modifiche al generatore di frammenti di contenuto e salvarlo.
-
Elimina: utilizzare questa opzione per eliminare il generatore di frammenti di contenuto selezionato.
-
Duplica: utilizza questa opzione per creare un duplicato o una copia del generatore di frammenti di contenuto selezionato. Per impostazione predefinita, il duplicato viene creato con un suffisso (come generator_1).
Inserire uno snippet di query
È inoltre possibile utilizzare Inserisci frammento di query dalla barra degli strumenti principale per inserire lo snippet di dati negli argomenti. Puoi selezionare un generatore dal menu a discesa, modificare la query o modificare il modello e inserire i dati nell’argomento.
{width="800"}
Modificare e inserire uno snippet di dati.
Creare un argomento utilizzando il generatore di argomenti
Un generatore di argomenti consente di creare argomenti contenenti dati provenienti dalle origini. È possibile creare rapidamente un generatore di argomenti e quindi generare gli argomenti utilizzando il generatore. Ogni argomento può contenere dati in vari formati, ad esempio tabelle, elenchi e paragrafi. In un argomento, ad esempio, è possibile aggiungere una tabella che include i dettagli di tutti i nuovi prodotti e un elenco di tutti i prodotti che verranno dismessi per la vendita.
Il generatore di argomenti può creare gli argomenti contenenti i dati e una mappa DITA per tutti gli argomenti. È inoltre possibile <conref>
questi argomenti nel contenuto. In questo modo è possibile mantenere i dati sincronizzati con l'origine dati e aggiornarli facilmente.
Creare un argomento
Per creare un argomento utilizzando il generatore di argomenti, effettuare le seguenti operazioni:
-
Selezionare un'origine dati per visualizzare i generatori di frammenti di contenuto e i generatori di argomenti disponibili per l'origine dati selezionata.
{width="300"}
Aggiungere un generatore di argomenti per un'origine dati connessa.
-
Seleziona Aggiungi e seleziona Generatore di argomenti dal menu a discesa per aggiungere un nuovo generatore di argomenti. Viene aperto il pannello Aggiungi generatore di argomenti.
-
Immetti i valori nei campi nelle tre schede seguenti del pannello Aggiungi generatore di argomenti:
Recupera configurazione
{width="300"}
Aggiungere i dettagli della query dati, del modello di mappatura dati e del nodo radice per il generatore di argomenti e assegnare un nome univoco nel pannello Recupera configurazione.
-
Immettere la query nella casella di testo Query dati. Seleziona Copia query di esempio per copiare rapidamente una query di dati. Anziché creare manualmente la query, è possibile copiare e incollare la query di esempio nella casella di testo Query dati. Quindi, è sufficiente modificare la query in base ai requisiti di dati.
note note NOTE In Experience Manager vengono fornite query di esempio diverse per tutte le risorse nelle varie origini dati. Questi vengono mappati all’origine dati da cui stai recuperando i dati. -
Se utilizzi un connettore per file, puoi caricare il file JSON dal computer o sfogliare un file JSON dalle risorse Adobe Experience Manager.
note note NOTE Se utilizzi un connettore file, verranno visualizzate le opzioni per caricare o sfogliare i file al posto di una query di dati. -
Seleziona il modello da mappare con l'origine dati dal menu a discesa Modello di mappatura dati.
note note NOTE Se l’amministratore ha configurato dei modelli personalizzati, questi vengono visualizzati anche nell’elenco a discesa (in base alle configurazioni del percorso del modello eseguite dall’amministratore). È ad esempio possibile creare un modello di argomento contenente un elenco ordinato, tabelle, paragrafi o altri elementi DITA. -
Immettere il nodo principale. Questo è il nodo in cui desideri accedere ai tuoi dati. Il generatore di argomenti crea quindi ogni argomento al livello definito nel nodo principale. Ad esempio, puoi aggiungere "problemi" come nodo principale in Jira. Pertanto, se una query restituisce 13 problemi, riceverai 13 argomenti, uno per ogni problema.
-
Fare clic su Recupera per recuperare i dati dall'origine dati e applicare il modello ai dati risultanti dalla query SQL. L'anteprima mostra una piccola frazione di come l'argomento viene visualizzato nel formato del modello selezionato. Ad esempio, puoi visualizzare un singolo problema Jira con tutti i campi risultanti dalla query.
-
Immettere il nome del generatore di argomenti.
note note NOTE È necessario seguire la convenzione di denominazione dei file per il nome del nuovo generatore di argomenti. Non è possibile inserire uno spazio nel nome del generatore di argomenti. Inoltre, non è possibile salvare un nuovo generatore di argomenti con il nome di un generatore di argomenti esistente. Si verifica un errore.
Configurazione output
{width="300"}
Immettere il percorso di output e i dettagli delle convenzioni di denominazione degli argomenti nel pannello Configurazione di output. Generare una mappa DITA e denominarla.
- Immetti i dettagli del percorso di output in cui desideri salvare gli argomenti.
- Nella Convenzione per la denominazione degli argomenti, puoi immettere un valore o una variabile con i tag di velocità. I nuovi temi seguiranno la Convenzione. Ad esempio, puoi immettere
$key
per creare argomenti in base alle chiavi Jira. - Abilitare l'opzione Genera una mappa se si desidera creare una mappa che contenga tutti gli argomenti generati.
- Immettere il nome della nuova mappa DITA.
note note NOTE Il generatore di argomenti genera la mappa DITA sullo stesso percorso di output degli argomenti. Metadati
Seleziona le proprietà dei metadati dal menu a discesa da passare agli argomenti. Nel menu a discesa Nome sono elencate sia le proprietà personalizzate che quelle predefinite.
Nella schermata seguente, ad esempio,
dc:description
,dc:language
,dc:title
edocstate
sono le proprietà predefinite per le quali è possibile definire i valori. Puoi creare una proprietà personalizzata come Author e definirne il valore.{width="300"}
Aggiungi le proprietà dei metadati nel pannello Metadati per passare agli argomenti.
-
-
Immetti il nome del generatore e fai clic su Salva per salvare i risultati della query. Un nuovo generatore di argomenti viene aggiunto all'elenco.
-
Fare clic su Salva e genera per salvare il generatore di argomenti e generare nuovi argomenti dal generatore di argomenti.
{width="650"}
Genera nuovi argomenti da un generatore di argomenti esistente.
note note NOTE Se gli argomenti esistono già, il generatore aggiorna i dati contenuti negli argomenti esistenti.
Opzioni per un generatore di argomenti
Fai clic con il pulsante destro del mouse su un generatore di argomenti per aprire Opzioni. Utilizzando le opzioni, potete effettuare le seguenti operazioni:
-
Genera: questa opzione genera gli argomenti per il generatore di argomenti selezionato. È inoltre possibile utilizzare questa opzione per aggiornare gli argomenti esistenti. Si connette all’origine dati e recupera i dati aggiornati. Durante la generazione del contenuto, questa opzione è disabilitata e viene visualizzato un caricatore.
note note NOTE Se l'argomento esiste già, è possibile sovrascrivere i dati nell'argomento o salvarli come nuova versione. Generare un argomento e, se il file esiste già, salvarlo come nuova versione o sovrascriverlo.
-
Visualizza registro: selezionare questa opzione per visualizzare il file di registro di generazione del contenuto. Il file di registro viene aperto in una nuova scheda. È possibile visualizzare gli errori, gli avvisi, i messaggi di informazione e le eccezioni nel file di registro. Questa opzione è abilitata se hai generato il contenuto per il generatore di argomenti selezionato.
-
Anteprima: utilizzare questa opzione per aprire un riquadro e visualizzare una piccola frazione dei dati visualizzati nell'output.
-
Modifica: utilizzare questa opzione per modificare e salvare il generatore di argomenti. Questa opzione è disabilitata durante la generazione del contenuto.
-
Elimina: utilizzare questa opzione per eliminare il generatore di argomenti selezionato. Questa opzione è disabilitata durante la generazione del contenuto.
-
Duplicato: questa opzione crea un duplicato o una copia del generatore di argomenti selezionato. Il duplicato viene creato con un suffisso (come
topic-sample_1
) per impostazione predefinita.
Utilizzare gli strumenti Velocity nei modelli di origini dati use-velocity-tools
I modelli di Experience Manager supportano anche gli strumenti Velocity (versione 2.0). Questi strumenti consentono di applicare varie funzioni ai dati recuperati dalle origini dati. Ulteriori informazioni sull'utilizzo degli strumenti Velocity e delle funzioni che è possibile applicare.
Per utilizzare uno strumento Velocity in un modello, effettuate le seguenti operazioni:
-
Modifica un modello Velocity nell’editor web.
-
Aggiungere uno strumento e la relativa funzione nel formato
<tool.function>
. Ad esempio:- Per generare un numero casuale utilizzando lo strumento di matematica, utilizzare
$mathTool.random
. - Per generare la somma dei numeri utilizzando lo strumento matematico, utilizzare
$mathTool.add(num1, num2)
.
- Per generare un numero casuale utilizzando lo strumento di matematica, utilizzare
-
Utilizza il modello per creare uno snippet di contenuto o un argomento.
-
Dopo aver applicato il modello ai dati, è possibile visualizzare i dati nell'anteprima o nella vista origine DITA.
Puoi utilizzare i seguenti strumenti all’interno dei modelli Velocity per applicare varie funzioni ai dati recuperati dal connettore:
-$alternatorTool
$classTool
$contextTool
$conversionTool
$dateTool
$comparisonDateTool
$displayTool
$escapeTool
$fieldTool
$loopTool
$linkTool
$listTool
$mathTool
$numberTool
$renderTool
$resourceTool
$sortTool