DokumentationAEM GuidesDokumentation om AEM Guides

November 2023-utgåvan av Adobe Experience Manager Guides as a Cloud Service

Last update: Fri Jul 12 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Ledare

Den här versionsinformationen innehåller uppgraderingsinstruktioner, kompatibilitetsmatris och problem som åtgärdats i version november 2023 av Adobe Experience Manager Guides as a Cloud Service (senare kallat Experience Manager Guides as a Cloud Service).

Mer information om de nya funktionerna och förbättringarna finns i Nyheter i november 2023-utgåvan av Experience Manager Guides as a Cloud Service.

Uppgradera till november 2023-versionen

Uppgradera din nuvarande Experience Manager Guides as a Cloud Service-konfiguration genom att utföra följande steg:

  1. Ta en titt på Cloud Servicens Git-kod och växla till den gren som är konfigurerad i Cloud Servicens pipeline för den miljö som du vill uppgradera.
  2. Uppdatera <dox.version>-egenskapen i /dox/dox.installer/pom.xml-filen för dina Cloud Services Git-kod till 2023.11.0.406.
  3. Genomför ändringarna och kör Cloud Servicen för att uppgradera till Experience Manager Guides as a Cloud Service från november 2023.

Steg för att aktivera utlösaren för ett skript via en serverlet

(Endast om du har en version som är tidigare än version från juni 2023 av Experience Manager Guides as a Cloud Service)

När du har slutfört installationen kan du välja att HIT-aktivera utlösaren för att starta översättningsjobbet:

POST:

http://localhost:4503/bin/guides/script/start?jobType=translation-map-upgrade

Svar:

{
"msg": "Job is successfully submitted and lock node is created for future reference",
"lockNodePath": "/var/dxml/executor-locks/translation-map-upgrade/1683190032886",
"status": "SCHEDULED"
}

I föregående svar-JSON innehåller nyckeln lockNodePath sökvägen till noden som skapades i databasen som pekar på jobbet som skickades. Den tas automatiskt bort när jobbet är klart. Sedan kan du referera till den här noden för jobbstatus.

Vänta tills jobbet är klart innan du fortsätter till nästa steg.

NOTE
Du bör kontrollera om noden fortfarande finns och jobbens status.
GET
http://<aem_domain>/var/dxml/executor-locks/translation-map-upgrade/1683190032886.json

Steg för att bokföra det befintliga innehållet så att det använder den brutna länkrapporten

(Endast om du har en version som är tidigare än version från juni 2023 av Experience Manager Guides as a Cloud Service)

Utför följande steg för att efterbearbeta befintligt innehåll och använda den nya brutna länkrapporten:

  1. (Valfritt) Om det finns fler än 100 000 DITA-filer i systemet uppdaterar du queryLimitReads och queryLimitInMemory under org.apache.jackrabbit.oak.query.QueryEngineSettingsService till ett större värde (vilket värde som helst som är större än antalet resurser, till exempel 200 000) och distribuerar sedan om.

    • Använd instruktionerna i avsnittet Konfigurationsåsidosättningar i Installera och konfigurera Adobe Experience Manager Guides as a Cloud Service för att skapa konfigurationsfilen.

    • Ange följande (egenskap) information i konfigurationsfilen för att konfigurera alternativet queryLimitReads och queryLimitInMemory:

      table 0-row-3 1-row-3 2-row-3
      PID Egenskapsnyckel Egenskapsvärde
      org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitReads Värde: 200000 Standardvärde: 100000
      org.apache.jackrabbit.oak.query.QueryEngineSettingsService queryLimitInMemory Värde: 200000 Standardvärde: 100000

  2. Kör en POST-förfrågan till servern (med korrekt autentisering) - http://<server:port>//bin/guides/reports/upgrade.

  3. API:t returnerar ett jobId. Om du vill kontrollera statusen för jobbet kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt - http://<server:port>/bin/guides/reports/upgrade?jobId= {jobId}
    (Till exempel: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42_678)

  4. När jobbet är klart svarar den tidigare GETEN med framgång. Om jobbet misslyckas av någon anledning kan felet ses i serverloggarna.

  5. Återgå till standardvärdet eller det tidigare befintliga värdet queryLimitReads om du har ändrat det i steg 1.

Steg för att indexera befintligt innehåll så att det använder den nya sök- och ersätt-listan och ämneslistan på fliken Rapporter:

(Endast om du har en version som är tidigare än version från juni 2023 av Experience Manager Guides as a Cloud Service)

Utför följande steg för att indexera det befintliga innehållet och använd den nya sök- och ersätt-texten på mappnivå och ämneslista på fliken Rapporter:

  1. Kör en POST-förfrågan till servern (med korrekt autentisering) - http://<server:port>/bin/guides/map-find/indexing. (Valfritt: Du kan skicka specifika sökvägar för mappningarna för att indexera dem. Som standard indexeras alla mappningar || Till exempel: https://<Server:port>/bin/guides/map-find/indexing?paths=<map_path_in_repository>)

  2. Du kan också skicka en rotmapp för att indexera DITA-mappningarna för en viss mapp (och dess undermappar). Exempel: http://<server:port>/bin/guides/map-find/indexing?root=/content/dam/test. Observera, att om både sökvägsparametern och rotparametern skickas, beaktas bara sökvägsparametern.

  3. API:t returnerar ett jobId. Om du vill kontrollera jobbets status kan du skicka en GET-förfrågan med jobb-ID till samma slutpunkt: http://<server:port>/bin/guides/map-find/indexing?jobId={jobId}(Exempel: http://localhost:8080/bin/guides/map-find/indexing?jobId=2022/9/15/7/27/7dfa1271-981e-4617-b5a4-c18379f11c42)

  4. När jobbet är klart svarar den tidigare GETEN med framgång och anger om några kartor misslyckades. De korrekt indexerade mappningarna kan bekräftas från serverloggarna.

Steg som ska hantera 'fmdita rewriter'-konflikten

Experience Manager Guides har en anpassad omskrivarmodul för hantering av länkar som genereras vid korsmappningar (länkar mellan ämnen på två olika kartor).

Om du har en annan anpassad återskrivningsskrivare i kodbasen använder du ett 'order'-värde som är större än 50, eftersom Experience Manager Guides återskrivningsprogram använder 'order' 50. Om du vill åsidosätta detta måste du ange ett värde > 50. Mer information finns i Skriva om utdata.

Under den här uppgraderingen måste du, eftersom värdet 'order' ändras från 1 000 till 50, sammanfoga den befintliga anpassade omskrivaren, om sådan finns, med 'fmdita-rewriter'.

Kompatibilitetsmatris

I det här avsnittet visas kompatibilitetsmatrisen för de program som stöds i Experience Manager Guides as a Cloud Service från november 2023.

FrameMaker och FrameMaker Publishing Server

Experience Manager Guides Guides as a Cloud Release
FMPS
FrameMaker
2023.11.0
Inte kompatibel
2022 eller senare

Syrgasanslutning

Experience Manager Guides som Cloud-release
Syrgasanslutningsfönster
Syrgasanslutning Mac
Redigera i syrgasfönster
Redigera i Syrgas Mac
2023.11.0
3.2-uuid 5
3.2-uuid 5
2,3
2,3

Kunskapsbasmallens version

Komponentpaketets namn
Komponentversion
Mallversion
Experience Manager Guides Components Content Package for Cloud Service
dxml-components.all-1.2.2
aem-site-template-dxml.all-1.0.15

Åtgärdade problem

De buggar som har åtgärdats i olika områden listas nedan:

Redigering

  • Avstånd efter conref <ph>-element försvinner när ämnet sparas. 13642
  • Programfel inträffar när DITA-filer sparas innan efterbearbetningen är klar. 13571
  • Om titeln för ett ämne innehåller ett snedstreck /, visar fliken i redigeraren bara de bokstäver som kommer efter det. 13455
  • Förhandsvisningen av bilden försvinner inte när du har visat förhandsvisningen i redigeraren. 13454
  • Popup-fönstret Infoga nyckelord visas inte när rotmappsdefinierade nycklar används i andra ämnen. (12950)
  • Stängningsikoner visas inte när mycket stora bilder förhandsvisas på panelen Versionshistorik. 12867
  • Det går inte att ändra tidszonen för kolumnen Version skapad den för baslinjerna. 12711
  • Panelen Versionshistorik i Assets-gränssnittet visar en felaktig tidsstämpel för fältet Aktuell. 12624
  • Om du skapar en DITA-fil från en mall med ett filnamn som börjar med numeriska tecken resulterar det i ett namnutrymmesfel. (12188)
  • Fönstret Nyckelreferenser öppnas i Web Editor när taggen varname infogas. (10940)
  • Zip-filer känns inte igen i Web Editor och du kan inte dra och släppa dem. (12709)
  • Innehållet med vissa attribut som används på det markeras inte i redigerings- eller förhandsgranskningsläge. (11063)
  • När du stänger ett ämne efter att du har redigerat det omdirigeras du till AEM hemsida i stället för att gå tillbaka till mappvyn. (13306)
  • Efterbearbetningen av filer som har kopierats och klistrats in i molntjänsterna fördröjs. 12457
  • Rotmappsinställningen finns kvar i Web Editor även om användaren inte uttryckligen har angett den i användarinställningarna. (11551)

Publicering

  • Publish som innehållsavsnittsfunktion fungerar inte för filer som listas i sökresultaten. (14090)
  • Vid ursprunglig PDF-publicering kräver bakgrundsfärgen för mallayouten en sidinläsning när du återgår till None. 13621
  • Problem vid implementering av datastore för en stor DITA-karta med scope-peer-länkar AEM Site publishing. (13530)
  • I Native PDF-publicering äventyras tillgängligheten eftersom bilder i sidhuvud och sidfot inte visar alternativ text. (12829)
  • Det går inte att duplicera sidlayout i PDF utan att lägga till något tillägg automatiskt. (12534)
  • När du genererar utdata från PDF med Native PDF-publicering kommer filnamnet att trunkeras efter en viss period. (13620)
  • Felaktiga ikoner och verktygstips visas för alternativet Redigera innehåll i verktygsfältet Sidlayouter i mallarna som används för Native PDF. 13492
  • Anpassade metadata är inte tillgängliga i det slutliga resultatet. (12116)
  • fmdita rewriter står i konflikt med användarens omskrivarkonfiguration och leder till att långa URL-adresser visas i stället för länkarna. (12076)
  • I AEM webbplatsförinställning är alternativet att generera separata PDF för varje ämne inte funktionellt. (11555)
  • Inbyggd PDF-publicering saknar stöd för CMYK-färgmodellskonvertering. (10754)
  • Dynamiska baslinjeanrop använder namnet i stället för titeln, vilket leder till att det inte går att exportera DITA-mappnings-API. 14268

Förvaltning

  • Innehållsreferensen bryts vid kopiering och inklistring av DITA-filer med självreferenslänkar utan GUID. (13540)
  • Baslinjen i Web Editor visar titeln för den föregående versionen i stället för den valda versionen av DITA-filen. 13444)
  • Fliken Rapporter i webbredigerarens gränssnitt kan inte visa ämneslistan för gamla DITA-kartor som skapats före uppgraderingen av Experience Manager Guides as a Cloud Service från juli 2023. (11852)
  • Villkorsförinställningar för stora DITA-kartor skapas inte. (10936)
  • En självreferenslänk visas under listan med brutna länkar i rapporter. 13539

Granska

  • Granskningspanelerna sida vid sida i den föregående och den aktuella versionen i Web Editor är inte korrekta i oktober 2023-versionen av Experience Manager Guides as a Cloud Service. (14156)
  • Anpassning av e-postmallar för arbetsflödet Granska fungerar inte när noderna ersätts. 13954
  • Knappen Stäng på granskningssidan i Experience Manager Guides tar användarna till AEM hemsida. 13535
  • Brutna tecken visas när fragment skapas på koreanska. 13489
  • Det går inte att klicka på koreanska bilagor på Experience Manager Guides Review-skärmen. 13436
  • Karttitel klipps av på skärmen för granskning och samarbete, utan möjlighet att visa hela titeln. (13012)

Översättning

  • Automatisk godkännande fungerar inte ibland, och undantag uppstår om ett felaktigt värde har angetts för Översättningsstatus. 13607
  • Baslinjen som exporteras från översättningsinstrumentpanelen misslyckas och öppnas inte på målspråket. (12993)

Känt fel

Adobe har identifierat följande kända fel i novemberversionen 2023.

  • Selektiv omgenerering av ämnen för AEM webbplatsutdata misslyckas.
recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178