DocumentationAEM GuidesDocumentation d’AEM Guides

Version de décembre 2023 d’Adobe Experience Manager Guides as a Cloud Service

Last update: Fri Nov 21 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Leader

Cette note de mise à jour couvre les instructions de mise à niveau, la matrice de compatibilité et les problèmes résolus dans la version de décembre 2023 d’Adobe Experience Manager Guides as a Cloud Service (plus tard appelée Experience Manager Guides as a Cloud Service).

Pour plus d’informations sur les nouvelles fonctionnalités et améliorations, consultez Nouveautés de la version de décembre 2023 de Experience Manager Guides as a Cloud Service.

Mise à niveau vers la version de décembre 2023

Mettez à niveau votre configuration as a Cloud Service Experience Manager Guides actuelle en procédant comme suit :

  1. Consultez le code Git des services cloud et passez à la branche configurée dans le pipeline des services cloud correspondant à l’environnement à mettre à niveau.
  2. Mettez à jour <dox.version> propriété dans /dox/dox.installer/pom.xml fichier de votre code Git Cloud Services sur 2023.12.0.16.
  3. Validez les modifications et exécutez le pipeline Cloud Services pour effectuer la mise à niveau vers la version de décembre 2023 de Experience Manager 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 de Experience Manager 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é. Vous pouvez alors vous référer à ce nœud pour connaître le statut du traitement.

Patientez jusqu’à ce que ce traitement soit terminé avant de passer aux étapes suivantes.

NOTE
Vous devez vérifier si le nœud est toujours présent, ainsi que le statut de la tâche.
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 Experience Manager Guides as a Cloud Service)

Effectuez les étapes suivantes pour post-traiter le contenu existant et utiliser le nouveau rapport de lien rompu :

  1. (Facultatif) Si le système contient plus de 100 000 fichiers DITA, mettez à jour les queryLimitReads et queryLimitInMemory sous org.apache.jackrabbit.oak.query.QueryEngineSettingsService avec 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 les options queryLimitReads et queryLimitInMemory :

      table 0-row-3 1-row-3 2-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
      org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Valeur : 200000 Valeur par défaut : 100000

  2. Exécutez une requête POST au serveur (avec l’authentification correcte) - http://<server>//bin/guides/reports/upgrade.

  3. 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>/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)

  4. 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.

  5. Revenez à la valeur par défaut ou à la valeur existante précédente de queryLimitReads si 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 de Experience Manager 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 :

  1. 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>)

  2. 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.

  3. 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_678).

  4. 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.

Procédure à suivre pour gérer le conflit de 'fmdita rewriter'

Experience Manager Guides dispose d’un module custom sling rewriter qui gère les liens générés en cas de mappages croisés (liens entre les rubriques de deux mappages différents).

Si votre base de code contient un autre module de réécriture Sling personnalisé, utilisez une valeur de 'order' supérieure à 50, car le module de réécriture Sling de Experience Manager Guides utilise 'order' 50. Pour remplacer cela, vous avez besoin d’une valeur >50. Pour plus d’informations, consultez la section Pipelines de réécriture de sortie.

Lors de cette mise à niveau, puisque la valeur 'order' est modifiée de 1 000 à 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 la matrice de compatibilité pour les applications logicielles prises en charge par la version de décembre 2023 de Experience Manager Guides as a Cloud Service.

FrameMaker et FrameMaker Publishing Server

Version de Experience Manager Guides as a Cloud
FMPS
FrameMaker
2023.12.0
Non compatible
2022 ou version ultérieure

Connecteur D'Oxygène

Version de Experience Manager Guides as a Cloud
Fenêtres du connecteur d'oxygène
Mac du connecteur d'oxygène
Modifier dans Oxygen Windows
Modifier dans Oxygen Mac
2023.12.0
3.3-uuid.5
3.3-uuid.5
2,3
2,3

Version du modèle de la base de connaissances

Nom du package de composants
Version des composants
Version du modèle
Package de contenu de composants Experience Manager Guides pour Cloud Service
dxml-components.all-1.2.2
aem-site-template-dxml.all-1.0.15

Problèmes résolus

Les bogues corrigés dans différentes zones sont répertoriés ci-dessous :

Création

  • Le Titre de l’onglet Éditeur web est tronqué après un point(.). (14372)
  • Le message d’erreur pour les noms de mappage en double dans l’interface utilisateur d’Assets n’est 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 de paramètre permettant de masquer le panneau Variables de langue sous l’onglet Sortie est manquant. (14194)
  • L’éditeur web renvoie des erreurs d’application lors de l’ajout d’une nouvelle référence ou rubrique à l’aide d’un schéma spécialisé en mode Mise en page. (14094)
  • Un lien d’ancrage vers <dlentry> ou <dt> élément n’affiche pas le texte du lien. (13543)
  • Le chargement de la collection Favoris dans l’éditeur web échoue. (13495)
  • Les citations affichent des liens non cliquables lorsqu’elles sont créées avec un ID unique et des espaces. (13447)
  • Dans la vue Disposition d’une structure Bookmap, l’utilisation de l’option Déplacer vers la droite pour transformer un chapitre sélectionné en sous-élément ne fonctionne pas. (12567)
  • La fenêtre d’aperçu de l’éditeur XML est tronquée dans les navigateurs Google Chrome et Microsoft Edge. (10755)
  • L’éditeur web ne peut pas encapsuler un élément dans les éventuels éléments parents. (8791)

Publication

  • Les composants Fmdita ont un chemin d’accès codé en dur de delegator.jsp, ce qui empêche la superposition des composants AEM Sites. (13993)
  • La vue balisée du réacteur PDF dans la sortie de publication Native PDF ne fonctionne pas comme prévu. (13622)
  • La publication sur le site AEM rencontre un problème lors de la validation dans le magasin de données pour les cartes volumineuses avec des liens d’homologue de portée. (13531)
  • Impossible d’activer un site à l’aide du tableau de bord de publication en bloc Experience Manager Guides. (13439)
  • La localisation des libellés d’élément ne fonctionne pas correctement dans la sortie AEM Sites. (12144)
  • Option ditaval manquante 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

  • Les environnements cloud d’AEM rencontrent une exception MongoWrite en raison de nœuds de grande taille. (13509)

Traduction

  • Les boutons Accepter/Rejeter s’affichent par erreur pour la traduction humaine approuvée automatiquement. (14318)
  • Les problèmes d'internationalisation (i18n) se produisent lors de la transformation de fichiers DITA non anglais en pages AEM. (14286)
  • Les contenus traduits ne peuvent pas être synchronisés à partir de projets de traduction temporaires et l'assistant de traduction de l'éditeur XML DITA affiche incorrectement le statut En cours pour les tâches approuvées. (9938)

Accessibilité

  • Impossible de naviguer dans l’interface utilisateur de la zone de travail de création, car le focus est piégé dans l’éditeur de rubrique. (13517)

Problème connu

Adobe a identifié le problème connu suivant pour la version de décembre 2023 :

  • « Erreur d’obtention d’une DTD non valide » se produit par intermittence lors de la mise à niveau vers la version de décembre 2023.
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178