Versione di settembre 2023 di Adobe Experience Manager Guides as a Cloud Service
Questa nota sulla versione descrive le istruzioni per l’aggiornamento, la matrice di compatibilità e i problemi risolti nella versione di settembre 2023 di Adobe Experience Manager Guides (in seguito denominata AEM Guides as a Cloud Service).
Per ulteriori informazioni sulle nuove funzionalità e sui miglioramenti, consulta Novità della versione di settembre 2023 di AEM Guides as a Cloud Service.
Aggiornamento alla versione di settembre 2023
Aggiorna la configurazione corrente di AEM Guides as a Cloud Service eseguendo i seguenti passaggi:
- Consulta il codice Git del Cloud Service e passa al ramo configurato nella pipeline dei Cloud Service corrispondente all’ambiente da aggiornare.
- Aggiorna la proprietà
<dox.version>
nel file/dox/dox.installer/pom.xml
del codice Git dei tuoi Cloud Service a 2023.9.0.359. - Apporta le modifiche ed esegui la pipeline dei Cloud Service per l’aggiornamento alla versione di settembre 2023 di AEM Guides as a Cloud Service.
Passaggi per abilitare l’attivazione di uno script tramite un servlet
(Solo se utilizzi una versione precedente al rilascio di AEM Guides as a Cloud Service di giugno 2023)
Dopo aver completato l’installazione, puoi scegliere di premere il trigger per avviare il processo di traduzione:
POST:
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
Risposta:
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
Nella risposta precedente JSON, la chiave lockNodePath
contiene il percorso del nodo creato nell'archivio che punta al processo inviato. Verrà eliminato automaticamente una volta completato il processo; fino ad allora, puoi fare riferimento a questo nodo per lo stato corrente del processo.
Attendere il completamento del processo prima di procedere ai passaggi successivi.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Passaggi per pubblicare ed elaborare il contenuto esistente per utilizzare il rapporto sui collegamenti interrotti
(Solo se utilizzi una versione precedente al rilascio di AEM Guides as a Cloud Service di giugno 2023)
Effettua le seguenti operazioni per la post-elaborazione del contenuto esistente e l’utilizzo del nuovo rapporto sui collegamenti interrotti:
-
(Facoltativo) Se nel sistema sono presenti più di 100.000 file dita, aggiornare
queryLimitReads
inorg.apache.jackrabbit.oak.query.QueryEngineSettingsService
a un valore maggiore (qualsiasi valore maggiore del numero di risorse presenti, ad esempio 200.000) e quindi ridistribuire.-
Utilizza le istruzioni fornite nella sezione Override della configurazione in Installare e configurare Adobe Experience Manager Guides
as a Cloud Service, per creare il file di configurazione. -
Nel file di configurazione, fornisci i seguenti dettagli (proprietà) per configurare l’opzione queryLimitReads:
table 0-row-3 1-row-3 PID Chiave proprietà Valore proprietà org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valore: 200000 Valore predefinito: 100000
-
-
Eseguire una richiesta POST al server (con autenticazione corretta) -
http://<server:port>//bin/guides/reports/upgrade
. -
L’API restituirà un jobId. Per verificare lo stato del processo, è possibile inviare una richiesta GET con ID processo allo stesso endpoint -
http://<server:port>/bin/guides/reports/upgrade?jobId= {jobId}
(ad esempio:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678
) -
Una volta completato il processo, la richiesta di GET precedente risponderà con successo. Se il processo non riesce per qualche motivo, l’errore può essere visualizzato dai registri del server.
-
Ripristinare il valore predefinito o esistente precedente di
queryLimitReads
se è stato modificato nel passaggio 1.
Passaggi per indicizzare il contenuto esistente per utilizzare il nuovo elenco Trova e sostituisci e Argomento nella scheda Rapporti:
(Solo se utilizzi una versione precedente al rilascio di AEM Guides as a Cloud Service di giugno 2023)
Effettua i seguenti passaggi per indicizzare il contenuto esistente e utilizza il nuovo testo Trova e sostituisci a livello di mappa e l’elenco degli argomenti nella scheda Rapporti:
-
Esegui una richiesta POST al server (con autenticazione corretta) -
http://<server:port\>/bin/guides/map-find/indexing
. (Facoltativo: Puoi passare percorsi specifici delle mappe per indicizzarle; per impostazione predefinita, tutte le mappe saranno indicizzate || Esempio:https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>
) -
È inoltre possibile passare una cartella principale per indicizzare le mappe DITA di una cartella specifica (e delle relative sottocartelle). Ad esempio,
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test
. Si noti che se vengono passati sia il parametro paths che il parametro root, viene considerato solo il parametro paths. -
L’API restituirà un jobId. Per verificare lo stato del processo, è possibile inviare una richiesta di GET con ID processo allo stesso endpoint:
http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}
\ (ad esempio:http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42
) -
Una volta completato il processo, la richiesta di GET precedente risponderà con successo e menzionerà se eventuali mappe non sono riuscite. Le mappe indicizzate correttamente possono essere confermate dai registri del server.
Matrice di compatibilità
In questa sezione è elencata la matrice di compatibilità per le applicazioni software supportate dalla versione di settembre 2023 di AEM Guides as a Cloud Service.
FRAMEMAKER e FRAMEMAKER PUBLISHING SERVER
Connettore ossigeno
Versione modello della Knowledge Base
Problemi risolti
Di seguito sono elencati i bug risolti in varie aree:
Authoring
-
Il file dell'argomento non viene sbloccato nell'editor Web, anche se sono selezionate le opzioni Sblocca il file e Non salvare. (12558)
-
Impossibile estrarre un file nell'editor Web, nonostante sia stata selezionata l'opzione NO per ignorare le modifiche prima dell'archiviazione. (12557)
-
Le descrizioni comandi per le icone Blocca e sblocca file nella barra degli strumenti principale dell'editor Web non sono coerenti con le icone visualizzate nella vista Archivio.(12555)
-
L'opzione Annulla estrazione e sblocca viene visualizzata per un file nell'editor Web non ancora estratto in visualizzazione Mappa. (12556)
-
Impossibile selezionare le risorse PDF nei collegamenti "topicref" esistenti. (12477).
-
Nella Vista archivio, gli argomenti o le immagini non possono essere trascinati dopo aver utilizzato la funzionalità Ricerca/Filtro. (12396)
-
I risultati della ricerca vengono disattivati nel pannello Trova e sostituisci dopo l’apertura di un file cercato. (12142)
-
Il tasto numerico "8" sulla tastiera laterale non funziona nell’editor di AEM Guides. (12106)
-
Il prefisso viene duplicato nella modalità di anteprima dell’editor web. (13133)
-
Choicetable
righe non visualizzate o non selezionabili. (12616) -
L’editor web genera errori di convalida in scenari specifici durante la creazione di un argomento utilizzando uno schema personalizzato. (12576)
-
I riferimenti al modello di argomento ditaval non creano una copia nella cartella dei contenuti durante la creazione di una mappa dal modello di mappa. (12150)
-
La casella di ricerca nelle mappe DITA non dispone di un pulsante di chiusura. (11867)
-
Quando si salvano file lunghi nell'editor Web,
DirtyChecker
genera un'eccezione con una traccia dello stack lunga e riempie i file di log. (11860) -
La creazione di argomenti DITA richiede l'autorizzazione Elimina sul nodo di cartella corrispondente, anche se la mappa può essere creata con l'autorizzazione di scrittura. (11706)
-
L’editor web mostra un titolo errato quando è presente una barra. (10949)
Gestione
- Il campo "title" nelle proprietà dei metadati della mappa DITA viene sovrascritto dall'elemento
<title>
per la mappa. (10702) - Il riferimento al contenuto è interrotto per copiare e incollare file DITA quando l'ID argomento non corrisponde a GUID. (12614)
- Nelle baseline dinamiche, l'elenco delle etichette non viene estratto dai riferimenti diretti della copia di lavoro di una mappa DITA. (11917)
Pubblicazione
-
La pubblicazione non riesce quando si rinomina un predefinito di PDF nativo. (12564)
-
La duplicazione di un modello di PDF nativo viene duplicata nel percorso predefinito del modello invece che nel percorso personalizzato fornito. (12563)
-
Native PDF | L'inclusione di più xrefs estende il testo oltre la larghezza della colonna. (13004)
-
Native PDF | Quando l’argomento e il titolo hanno lo stesso ID, si verifica un errore nella generazione dell’output PDF. (12644)
-
Native PDF | Quando si aggiunge una classe di output a un elemento padre
<topicref>
in una mappa DITA e si applica uno stile personalizzato alla classe di output, lo stile viene applicato agli elementi all'interno del corpo dell'argomento, inclusi i titoli di sezione.(12166) -
La pubblicazione incrementale non funziona se una mappa DITA contiene più ditavalref. (12117)
-
Sito AEM | Quando si crea una mappa con keydef che punta a un argomento come variabile e si aggiunge processing-role=resource-only, vengono create alcune pagine impreviste. (12099)
-
Se vengono utilizzate risorse di DAM dell'AEM in un output diverso dal sito AEM, i metadati "jcr:createdBy" non riflettono il nome dell'editore o dell'utente che ha modificato per ultimo la mappa o l'argomento DITA. (12090)
-
AEM Sites | La mappa DITA con l’intestazione dell’oggetto nel titolo della navigazione (con caratteri non supportati) causa la presenza di URL di pagina non validi. (11978)
-
Native PDF | Si verificano problemi a supporto di topichead / topicmeta / navtitle in Frontmatter e Backmatter. (11969)
-
Native PDF | La generazione di PDF per documenti di grandi dimensioni richiede molto tempo. (11955)
-
Native PDF | La ridenominazione di un predefinito genera un’eccezione NullPointerException durante la generazione di un output PDF. (11889)
-
Il contenuto di
<conref>
non è visualizzato nell'output di PDF. (11131) -
All'interno degli elementi
<div>
viene aggiunto uno spazio aggiuntivo quando si passa dalla visualizzazione Autore a quella Source nell'editor di layout di pagina. (10750) -
Il contenuto replicato in AEM Cloud Manager non è visibile nell’istanza di Publish. (9564)
Traduzione
- Il processo di esportazione di una baseline rinominata per una traduzione non riesce. (12993)
- Il titolo del file tradotto viene visualizzato al posto del titolo del file sorgente. (11630)