Version d’octobre 2023 d’Adobe Experience Manager Guides as a Cloud Service
Cette note de mise à jour couvre les instructions de mise à niveau, la matrice de compatibilité et les problèmes résolus dans la version d’octobre 2023 d’Adobe Experience Manager Guides (plus tard appelée AEM Guides as a Cloud Service).
Pour plus d’informations sur les nouvelles fonctionnalités et améliorations, voir Nouveautés de la version d’octobre 2023 d’AEM Guides as a Cloud Service.
Mise à niveau vers la version d’octobre 2023
Mettez à niveau votre configuration AEM Guides as a Cloud Service actuelle en procédant comme suit :
- Consultez le code Git des services cloud et passez à la branche configurée dans le pipeline des services cloud correspondant à l’environnement à mettre à niveau.
- Mettez à jour
<dox.version>propriété dans/dox/dox.installer/pom.xmlfichier de votre code Git Cloud Services sur 2023.10.0.373. - Validez les modifications et exécutez le pipeline Cloud Services pour effectuer la mise à niveau vers la version d’octobre 2023 d’AEM Guides as a Cloud Service.
Procédure d’activation du déclenchement d’un script via une servlet
(Uniquement si vous utilisez une version antérieure à la version de juin 2023 d’AEM Guides as a Cloud Service)
Une fois l’installation terminée, vous pouvez choisir d’APPUYER sur le déclencheur pour démarrer la tâche de traduction :
PUBLICATION :
http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade
Réponse :
{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}
Dans la réponse précédente JSON, la clé lockNodePath contient le chemin d’accès au nœud créé dans le référentiel pointant vers la tâche envoyée. Elle sera automatiquement supprimée une fois le traitement terminé. En attendant, vous pouvez vous référer à ce nœud pour connaître le statut actuel du traitement.
Patientez jusqu’à ce que ce traitement soit terminé avant de passer aux étapes suivantes.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json
Étapes de post-traitement du contenu existant pour utiliser le rapport de lien rompu
(Uniquement si vous utilisez une version antérieure à la version de juin 2023 d’AEM Guides as a Cloud Service)
Effectuez les étapes suivantes pour post-traiter le contenu existant et utiliser le nouveau rapport de lien rompu :
-
(Facultatif) Si le système contient plus de 100 000 fichiers DITA, mettez à jour le
queryLimitReadssousorg.apache.jackrabbit.oak.query.QueryEngineSettingsServiceavec une valeur plus élevée (toute valeur supérieure au nombre de ressources présentes, par exemple 200 000), puis redéployez.-
Suivez les instructions de la section Remplacements de configuration dans Installation et configuration d’Adobe Experience Manager Guides as a Cloud Service pour créer le fichier de configuration.
-
Dans le fichier de configuration, fournissez les détails (propriété) suivants pour configurer l’option queryLimitReads :
table 0-row-3 1-row-3 PID Clé de la propriété Valeur de la propriété org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valeur : 200000 Valeur par défaut : 100000
-
-
Exécutez une requête POST au serveur (avec l’authentification correcte) -
http://<server:port>//bin/guides/reports/upgrade. -
L’API renvoie un jobId. Pour vérifier le statut de la tâche, vous pouvez envoyer une requête GET avec l’ID de tâche au même point d’entrée :
http://<server:port>/bin/guides/reports/upgrade?jobId= {jobId}
(Par exemple :http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
Une fois le traitement terminé, la requête GET précédente répond avec succès. Si la tâche échoue pour une raison quelconque, l’échec est visible dans les journaux du serveur.
-
Revenez à la valeur par défaut ou à la valeur existante précédente de
queryLimitReadssi vous l’avez modifiée à l’étape 1.
Procédure à suivre pour indexer le contenu existant afin d’utiliser la nouvelle liste de recherche et de remplacement et de rubriques sous l’onglet Rapports :
(Uniquement si vous utilisez une version antérieure à la version de juin 2023 d’AEM Guides as a Cloud Service)
Effectuez les étapes suivantes pour indexer le contenu existant et utiliser le nouveau texte rechercher et remplacer au niveau du mappage et de la liste de rubriques sous l’onglet rapports :
-
Exécutez une requête POST au serveur (avec l’authentification correcte) -
http://<server:port\>/bin/guides/map-find/indexing. (Facultatif : vous pouvez transmettre des chemins spécifiques des mappages pour les indexer. Par défaut, tous les mappages sont indexés || Par exemple :https://<Server:port\>/bin/guides/map-find/indexing?paths=<map\_path\_in\_repository\>) -
Vous pouvez également transmettre un dossier racine pour indexer les plans DITA d'un dossier spécifique (et de ses sous-dossiers). Par exemple,
http://<server:port\>/bin/guides/map-find/indexing?root=/content/dam/test. Notez que si le paramètre de chemins d’accès et le paramètre racine sont transmis, seul le paramètre de chemins d’accès est pris en compte. -
L’API renvoie un jobId. Pour vérifier le statut de la tâche, vous pouvez envoyer une requête GET avec l’ID de tâche au même point d’entrée :
http://<server:port\>/bin/guides/map-find/indexing?jobId=\{jobId\}(par exemple :http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42). -
Une fois la tâche terminée, la requête GET précédente répond avec succès et mentionne si des mappages ont échoué. Les mappages indexés avec succès peuvent être confirmés à partir des journaux du serveur.
Matrice de compatibilité
Cette section répertorie la matrice de compatibilité pour les applications logicielles prises en charge par la version d’octobre 2023 d’AEM Guides as a Cloud Service.
FrameMaker et FrameMaker Publishing Server
Connecteur D'Oxygène
Version du modèle de la base de connaissances
Problèmes résolus
Les bogues corrigés dans différentes zones sont répertoriés ci-dessous :
Création
- Les heures de l'après-midi ne sont pas définies dans la Date pour la création des lignes de base. (12712)
- Impossible de coller le code JSON dans l’élément
<codeblock>de l’éditeur web. (12326) - Les modifications de version non enregistrées et les indicateurs correspondants ne s’affichent pas pour les fichiers volumineux. (11784)
- Lors de la modification en coréen, le premier caractère est remplacé par la valeur par défaut. (10049)
Publication
- PDF natif | L’ordre des rubriques n’est pas corrigé lors de la génération de la sortie PDF. (13157)
- PDF native| Aucune balise de style par défaut n’est disponible pour l’élément
<p>. (12559) - PDF natif | Les styles intégrés appliqués à la zone de contenu ne sont pas appliqués aux rubriques du sujet principal et du sujet arrière. (13510)
- L’attribut
DeliveryTargetn’est pas propagé lors de la génération de la sortie du site AEM. (13132) - Le workflow Publication est bloqué lors de la génération de la sortie du site AEM pour le contenu présentant certaines erreurs. (12000)
Gestion
- L’historique des versions ne s’affiche pas même si la propriété
dc:formatn’est pas présente pour une ressource. (10463)
Révision
- La révision d'un sujet affiche des commentaires incorrects. (13453)
Traduction
-
La ligne de base exportée à partir du tableau de bord Traduction échoue et ne s’ouvre pas dans la langue cible. (13466)
-
De nouveaux projets de traduction sont créés au lieu d’ajouter de nouvelles tâches aux projets de traduction existants sélectionnés. (10214)
Problème connu
Adobe a identifié le problème connu suivant pour la version d’octobre 2023.
- La republication du fragment de contenu échoue.