Version de juillet 2023 des Guides Adobe Experience Manager 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 juillet 2023 des Guides Adobe Experience Manager (ultérieurement 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 de juillet 2023 d’AEM Guides as a Cloud Service.
Mise à niveau vers la version de juillet 2023
Mettez à niveau votre configuration as a Cloud Service actuelle AEM Guides 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.7.0.314. - Validez les modifications et exécutez le pipeline Cloud Service pour effectuer la mise à niveau vers la version de juillet 2023 d’AEM Guides 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 d’AEM Guides 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 pourrez alors vous référer à ce noeud pour connaître l’état actuel 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 d’AEM Guides as a Cloud Service)
Effectuez les étapes suivantes pour le post-traitement du contenu existant et l’utilisation du nouveau rapport de lien rompu :
-
(Facultatif) Si le système contient plus de 100 000 fichiers dita, mettez à jour la variable
queryLimitReadsunderorg.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 l’option queryLimitReads :
table 0-row-3 1-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
-
-
Exécutez une requête de POST sur le serveur (avec l’authentification correcte) -
http://<server:port>//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: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 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 peut être 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 d’AEM Guides 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) -
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.
Matrice de compatibilité
Cette section répertorie le tableau de compatibilité des applications logicielles prises en charge par AEM Guides as a Cloud Service de juillet 2023.
FrameMaker et FrameMaker Publishing Server
Connecteur Oxygen
Problèmes résolus
Les bogues résolus dans différentes zones sont répertoriés ci-dessous :
Création
- Les attributs intégrés/affichés ne s’affichent pas dans la vue Disposition de l’éditeur web. (12498)
- Le téléchargement de fichiers dans le module externe Oxygen pour AEM Guides ne fonctionne pas dans les services cloud si vous l’avez fait ! dans le nom du fichier. (12207)
- La publication de mappage DITA est très lente avec un modèle modifiable. (12075)
- La configuration de l’interface utilisateur du profil global ne correspond pas au profil du dossier. (1970)
- Les références au contenu sont rompues lorsque les fichiers DITA sont copiés et collés. (1959)
- Impossible de modifier le fragment de contenu en mode Colonne avec les AEM Guides installés. (7342)
- Le contenu est perdu lorsqu’un xref non encapsulé se trouve sous des balises de sous-élément. 12532
Publication
- Le processus d’approbation ne fonctionne pas lorsque la propriété docstate est remplacée par "end state" à partir des propriétés File du panneau de droite. (11026)