DocumentazioneAEM GuidesDocumentazione di AEM Guides

Carica contenuto DITA esistente id176FF000JUI

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Esperto
  • Amministratore

Probabilmente si dispone di un archivio di contenuti DITA esistenti che si desidera utilizzare con AEM Guides. Per tali contenuti esistenti, puoi utilizzare uno dei seguenti approcci per caricare in blocco i contenuti nell’archivio AEM.

Utilizzare uno strumento WebDAV

Se si creano argomenti e mappe in qualsiasi altro editor DITA, è possibile utilizzare qualsiasi strumento WebDAV per caricare i file. La procedura descritta in questa sezione utilizza WinSCP come strumento WebDAV per caricare contenuti.

Per utilizzare WinSCP per caricare i file, effettuare le seguenti operazioni:

  1. Scarica e installa WinSCP sul computer.

  2. Avvia l'app WinSCP.

    Viene visualizzata la finestra di dialogo Login (Accesso).

  3. Nella finestra di dialogo Accesso specificare un'impostazione Nuovo sito scegliendo WebDAV come File Protocol e fornendo altri dettagli di connessione, ad esempio:

    • l’URL in cui è ospitato il server AEM,

    • il numero di porta (il valore predefinito è 4502) e

    • il nome utente e la password per accedere al server AEM.

  4. Fai clic su Accedi.

    Una volta stabilita la connessione, nell'interfaccia utente WinSCP verranno visualizzati i contenuti di AEM Assets. È possibile sfogliare, creare, aggiornare o eliminare facilmente il contenuto utilizzando Esplora file WinSCP.

Usa FrameMaker

Adobe FrameMaker viene fornito con un potente connettore AEM che consente di caricare facilmente in AEM i documenti DITA e di altro FrameMaker esistenti (.book e .fm). Puoi utilizzare varie funzionalità di caricamento dei file, ad esempio il caricamento di un singolo file e di una cartella completa con o senza dipendenze (come riferimenti a contenuti, riferimenti incrociati e elementi grafici).

Per utilizzare il connettore AEM del FrameMaker per caricare il contenuto, effettua le seguenti operazioni:

  1. Avvia FrameMaker.

  2. Aprire la finestra di dialogo Connection Manager.

    {width="550"}

  3. Immettere i dettagli seguenti per connettersi all'archivio AEM:

    • Nome: immettere un nome descrittivo per identificare la connessione al server AEM.

    • Server: immettere l'URL e il numero di porta del server AEM.

    • Nome utente/Password: immettere il nome utente e la password per accedere al server AEM.

  4. Fai clic su Connetti.

    Una volta stabilita la connessione, Assets dall’archivio AEM viene visualizzato nella finestra Gestione archivio.

    {width="550"}

    Facendo clic con il pulsante destro del mouse su un file o una cartella è possibile eseguire operazioni correlate. Ad esempio, se fai clic con il pulsante destro del mouse su una cartella, ottieni le opzioni per caricare un file, caricare un file con dipendenze, caricare un’intera cartella e così via.

Configura pattern nome file UUID

Quando importi il contenuto, non è necessario che i nomi dei file siano basati sull’UUID. In un sistema che utilizza nomi di file basati su UUID, è obbligatorio fare riferimento a tutti i file utilizzando i loro UUID anziché i nomi di file originali. Se un file importato non ha nomi di file basati su UUID, potete configurare il sistema per aggiungere un UUID alle proprietà del file. Questo UUID viene quindi utilizzato per fare riferimento a tali file dove UUID non viene utilizzato per la denominazione dei file.

Effettua le seguenti operazioni per controllare i nomi dei file in base a un pattern UUID e assegnare UUID ai file a cui non è stato assegnato un UUID:

  1. Aprire la pagina Configurazione della console Web Adobe Experience Manager.

    L'URL predefinito per accedere alla pagina di configurazione è:

    code language-http 
    http://<server name>:<port>/system/console/configMgr

  2. Cerca e fai clic sul bundle com.adobe.fmdita.config.ConfigManager.

  3. Nella proprietà UUID Filename Patterns, specifica un pattern per verificare i nomi del file importato.

    Se un file non segue il pattern specificato, viene aggiunto un UUID alla proprietà del file e tutti i riferimenti al file vengono aggiornati con l’UUID assegnato al file.

  4. Fai clic su Salva.

Caricare contenuti con UUID utilizzando uno strumento WebDav id201MI0I04Y4

Per caricare il contenuto con UUID, puoi utilizzare uno dei seguenti metodi:

  • Trascinare i contenuti dal sistema locale.
  • Utilizza il flusso di lavoro Crea > File dall'interfaccia utente Assets dell'AEM.
  • Utilizza uno strumento come WinSCP.

Se si utilizza uno strumento come WinSCP, è possibile definire l'azione da eseguire su un file duplicato impostando l'opzione Sposta il file precedente con lo stesso UUID in una nuova cartella in configMgr. Questa opzione definisce l’azione eseguita su un file disponibile in un’altra posizione nell’archivio AEM. Questa impostazione è disponibile nel bundle com.adobe.fmdita.config.ConfigManager in configMgr.

Per impostazione predefinita, l'opzione Sposta il vecchio file con lo stesso UUID in una nuova cartella è attivata. Ciò implica che quando il file che viene caricato è presente in un’altra cartella nell’archivio, il file esistente viene spostato nella posizione corrente e sovrascritto con il file che viene caricato. Se non si seleziona questa opzione, il file viene sovrascritto nella posizione esistente.

Note aggiuntive sull'utilizzo dei file basati su UUID:

Durante lo spostamento o la copia di contenuti all’interno dell’archivio AEM devono essere considerati i seguenti punti:

  • Quando si copiano uno o più file da una posizione a un’altra, viene generato un nuovo UUID per i file privi di UUID. Questo UUID viene aggiunto nei metadati del file.

  • Se un file presenta un conflitto o un duplicato, viene generato un nome di file univoco per il nuovo file da copiare o spostare.

  • Non ci sono due file con lo stesso UUID. A tutti i nuovi file viene assegnato un UUID univoco.

Durante lo spostamento o la copia dei contenuti dal sistema locale all’archivio AEM, è necessario tenere in considerazione i seguenti punti:

  • Se un file viene caricato contemporaneamente da due utenti diversi, il file elaborato successivamente sovrascrive quello precedente. Tuttavia, tale pratica è rara e deve essere evitata.

  • Quando estrai il contenuto dall’archivio AEM e apporti modifiche sul sistema locale, assicurati che il nome del file non venga modificato al momento del caricamento.

Usa comandi curl

Puoi anche utilizzare i comandi curl per creare una cartella in DAM, caricare file e aggiungere metadati al contenuto caricato.

Crea una cartella

Esegui il comando seguente per creare una cartella nell’archivio AEM:

curl --user <username>:<password> --data jcr:primaryType=sling:Folder "<server folder path>"

Specifica i seguenti parametri per creare una cartella:

  • <username>:<passowrd>: specificare il nome utente e la password per accedere all'archivio AEM. Questo utente deve disporre dei privilegi per la creazione della cartella.

  • jcr:primaryType=sling:Folder: specificare il parametro in quanto è per creare una risorsa di tipo cartella.

  • <server folder path>: percorso completo della cartella, incluso il nome della nuova cartella che si desidera creare nell'archivio AEM. Ad esempio, se si specifica il percorso come http://192.168.1.1:4502/content/dam/projects/AEM-Guides, la cartella AEM-Guides viene creata all'interno della cartella projects in DAM.

Carica un file

Esegui il comando seguente per caricare un file nell’archivio AEM:

curl --user <username>:<password> -T "<local file path>" "<server folder path>"

Specifica i seguenti parametri per caricare un file:

  • <username>:<passowrd>: specificare il nome utente e la password per accedere all'archivio AEM. Questo utente deve disporre dei privilegi di scrittura su server folder path.

  • local file path: percorso completo del file nel sistema locale da caricare.

  • <server folder path>: percorso completo della cartella sul server AEM in cui si desidera caricare il file.

Aggiungi metadati

Esegui il comando seguente per aggiungere metadati a un file:

curl --user <username>:<password> -F<attribute name>=<value> <metadata node path>

Specifica i seguenti parametri per aggiungere informazioni sui metadati:

  • <username>:<passowrd>: specificare il nome utente e la password per accedere all'archivio AEM. Questo utente deve disporre dei privilegi di scrittura su metadata node path.

  • -F<attribute name>=<value>: <attribute name> è il nome dell'attributo di metadati, ad esempio audience, e <value> potrebbe essere internal. È possibile specificare più coppie nome-valore di attributo separate da uno spazio.

  • <metadata node path>: percorso completo della cartella, incluso il nome del file e il relativo nodo di metadati. Ad esempio, se si specifica il percorso come http://192.168.1.1:4502/content/dam/projects/AEM-Guides/intro.xml/jcr:content/metadata, le informazioni sui metadati specificate vengono impostate sul file intro.xml.

Argomento padre: ​ Esegui migrazione contenuto esistente

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178