Version de décembre 2023 de Adobe Experience Manager Guides as a Cloud Service
Cette note de mise à jour traite des instructions de mise à niveau, de la matrice de compatibilité et des problèmes résolus dans la version de décembre 2023 des Guides Adobe Experience Manager as a Cloud Service (plus tard appelée Guides du Experience Manager as a Cloud Service).
Pour plus d’informations sur les nouvelles fonctionnalités et améliorations, voir Nouveautés de la version de décembre 2023 des Guides Experience Manager as a Cloud Service.
Mise à niveau vers la version de décembre 2023
Mettez à niveau votre configuration as a Cloud Service actuelle des guides de Experience Manager en procédant comme suit :
- Extrayez le code Git des Cloud Service et passez à la branche configurée dans le pipeline Cloud Service correspondant à l’environnement que vous souhaitez mettre à niveau.
- Mettre à jour
<dox.version>dans/dox/dox.installer/pom.xmldu code Git Cloud Service vers la version 2023.12.0.16. - Validez les modifications et exécutez le pipeline Cloud Service pour effectuer la mise à niveau vers la version de décembre 2023 des Guides Experience Manager as a Cloud Service.
Procédure d’activation du déclencheur d’un script via un servlet
(Uniquement si vous utilisez une version antérieure à la version de juin 2023 de Guides de Experience Manager as a Cloud Service)
Une fois l’installation terminée, vous pouvez choisir d’ACCÉDER au déclencheur pour lancer la tâche de traduction :
POST :
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 noeud créé dans le référentiel pointant vers la tâche envoyée. Il sera automatiquement supprimé une fois la tâche terminée. Vous pouvez alors vous référer à ce noeud pour connaître le statut de la tâche.
Patientez jusqu’à ce que cette tâche soit terminée 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 de Guides de Experience Manager 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 la variable
queryLimitReadsetqueryLimitInMemoryunderorg.apache.jackrabbit.oak.query.QueryEngineSettingsServiceà 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 la section Installation et configuration de 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 la variable
queryLimitReadsetqueryLimitInMemoryoption :table 0-row-3 1-row-3 2-row-3 PID Clé de propriété Valeur de la propriété org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Valeur : 200000 Valeur par défaut : 100000 org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Valeur : 200000 Valeur par défaut : 100000
-
-
Exécutez une requête de POST sur le serveur (avec l’authentification correcte) -
http://<server>//bin/guides/reports/upgrade. -
L’API renvoie un jobId. Pour vérifier l’état de la tâche, vous pouvez envoyer une demande de GET avec l’ID de la tâche au même point de terminaison :
http://<server>/bin/guides/reports/upgrade?jobId= {jobId}
(Par exemple :http://localhost:8080/bin/guides/reports/upgrade?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678) -
Une fois la tâche terminée, la requête de GET précédente répond avec succès. Si la tâche échoue pour une raison quelconque, l’échec est visible à partir des journaux du serveur.
-
Revenir à la valeur par défaut ou à la valeur existante précédente de
queryLimitReadssi vous l’avez modifié à l’étape 1.
Étapes pour indexer le contenu existant afin d’utiliser la nouvelle liste de rubrique et de recherche sous l’onglet Rapports :
(Uniquement si vous utilisez une version antérieure à la version de juin 2023 de Guides de Experience Manager as a Cloud Service)
Effectuez les étapes suivantes pour indexer le contenu existant et utilisez le nouveau texte de recherche et de remplacement au niveau de la carte et de la liste des rubriques sous l’onglet rapports :
-
Exécutez une requête de POST sur le serveur (avec l’authentification correcte) -
http://<server:port>/bin/guides/map-find/indexing. (Facultatif : vous pouvez transmettre des chemins spécifiques des cartes pour les indexer ; par défaut, toutes les cartes seront indexées|| 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 mappages 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 les paramètres paths et root sont transmis, seul le paramètre paths est pris en compte. -
L’API renvoie un jobId. Pour vérifier l’état de la tâche, vous pouvez envoyer une demande de GET avec l’ID de la tâche au même point de terminaison :
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_678) -
Une fois la tâche terminée, la requête de GET précédente répond avec succès et indique si une correspondance a échoué. Les mappages indexés avec succès peuvent être confirmés à partir des journaux du serveur.
Procédure de gestion de la variable 'fmdita rewriter' conflit
Les guides du Experience Manager comportent une réécriture sling personnalisée module de gestion des liens générés en cas de croix (liens entre les rubriques de deux cartes différentes).
Si votre code base comporte un autre module de réécriture sling personnalisé, utilisez une 'order' valeur supérieure à 50, comme l’utilise le module de réécriture sling de Guides de Experience Manager 'order' 50. Pour le remplacer, vous devez disposer d’une valeur supérieure à 50. Pour plus d’informations, voir Pipelines de réécriture de sortie.
Au cours de cette mise à niveau, depuis la variable 'order' est modifiée de 1000 à 50, vous devez fusionner le module de réécriture personnalisé existant, le cas échéant, avec 'fmdita-rewriter'.
Matrice de compatibilité
Cette section répertorie le tableau de compatibilité des applications logicielles prises en charge par les Guides Experience Manager as a Cloud Service de décembre 2023.
FrameMaker et FrameMaker Publishing Server
Connecteur Oxygen
Version du modèle de base de connaissances
Problèmes résolus
Les bogues résolus dans différentes zones sont répertoriés ci-dessous :
Création
- La variable Titre dans l’onglet Éditeur web est tronqué après un point(.) caractère « ? » supplémentaire. 14372
- Les messages d’erreur relatifs aux noms de mappage en double dans l’interface utilisateur d’Assets ne sont pas mis à jour. (14320)
- Une erreur se produit dans la logique de création de version lors du glisser-déposer des ressources. (14291)
- Le contenu réutilisable ignore les identifiants d’élément. (14213)
- Le contrôle des paramètres à masquer Variables de langue panneau sous Sortie est manquant. (14194)
- L’éditeur web renvoie des erreurs d’application lors de l’ajout d’une nouvelle référence ou d’une nouvelle rubrique à l’aide d’un schéma spécialisé dans la vue Disposition. 14094
- Un lien d’ancrage vers
<dlentry>ou<dt>ne parvient pas à afficher le texte du lien. (13543) - La variable Favoris ne se charge pas dans l’éditeur Web. (13495)
- Les citations affichent des liens non cliquables lorsqu’elles sont créées avec un identifiant unique avec des espaces. (13447)
- Dans le Disposition vue d’une carte des actifs numériques, à l’aide de Déplacer à droite pour qu’un chapitre sélectionné ne fonctionne pas comme un sous-élément. (12567)
- La fenêtre Aperçu de l’éditeur XML est tronquée dans les navigateurs Google Chrome et Microsoft Edge. 10755)
- L’éditeur web n’a pas la possibilité de placer un élément à l’intérieur des éléments parents possibles. (8791)
Publication
- Les composants de formulaire ont un chemin d’accès codé en dur pour
delegator.jsp, empêchant le recouvrement des composants AEM Sites. (13993) - La vue balisée du réacteur PDF dans la sortie de publication du PDF natif ne fonctionne pas comme prévu. 13622
- AEM La publication sur site rencontre un problème lors de la validation de la banque de données pour les cartes volumineuses avec des liens de portée partagée. 13531
- Impossible d’activer un site à l’aide du tableau de bord Publication en bloc de guides du Experience Manager . 13439
- La localisation des libellés d’élément ne fonctionne pas correctement dans la sortie AEM Sites. (12144)
- Absente ditaval dans les paramètres prédéfinis de sortie au niveau du profil de dossier créés via l’interface utilisateur de l’éditeur web. (11903)
Gestion
- AEM environnements cloud rencontrent l’exception MongoWrite en raison de noeuds de grande taille. 13509
Traduction
- La variable Accepter/Rejeter les boutons s’affichent par erreur pour la traduction humaine approuvée automatiquement. (14318)
- Des problèmes d’internationalisation (i18n) se produisent lors de la transformation de fichiers DITA non anglais en pages AEM. (14286)
- La synchronisation du contenu traduit échoue à partir des projets de traduction temporaires, et l’assistant de traduction de l’éditeur XML DITA s’affiche incorrectement. En cours statut des tâches approuvées. (9938)
Accessibilité
- Impossible de naviguer dans l’interface utilisateur du canevas de création, car la cible d’action devient bloquée dans l’éditeur de rubrique. (13517)
Problème connu
Adobe a identifié le problème connu suivant pour la version de décembre 2023 :
- "Obtention d’une erreur DTD non valide" se produit par intermittence lors de la mise à niveau vers la version de décembre 2023.