Aktivieren der Anforderungstransformation für gekürzte URLs in der AEM as a Cloud Service-Autoreninstanz

Last update: Fri Jul 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

In Adobe Experience Manager (AEM) as a Cloud Service werden gekürzte URLs in der Autoreninstanz zur standardmäßigen Startseite (/aem/start.html) anstelle des beabsichtigten Inhalts umgeleitet. Dieses Problem betrifft Teams, die Profilseiten mithilfe von URLs validieren, bei denen das /content/websites Präfix weggelassen wird. Das Problem tritt auf, weil die Autoreninstanz standardmäßig keine Anforderungstransformationen anwendet. Sie können dies beheben, indem Sie eine benutzerdefinierte CDN-Konfiguration mithilfe der AEM Config-Pipeline bereitstellen.

Beschreibung description

Umgebung

Produkt: Adobe Experience Manager as a Cloud Service (AEMaaCS) - Sites
Instanz: AEMaaCS-Autoreninstanz mit CDN-Konfiguration, bereitgestellt über die Konfigurations-Pipeline

Problem/Symptome

Durch den Zugriff auf eine gekürzte URL wie /ui/en/about/people/profiles.user-name+8b1126ad.html wird zur AEM-Startseite weitergeleitet.
Wenn Sie den vollständigen Pfad verwenden, zeigt /content/websites/ui/en/about/people/profiles.user-name+8b1126ad.html die Profilseite korrekt an.
Auf AEM as a Cloud Service löst die Autoreninstanz URLs direkt aus dem JCR auf und verwendet keinen herkömmlichen Dispatcher.

Ursache

Standardmäßig wendet AEMaaCS Anforderungstransformationsregeln mithilfe von Dispatcher-Rewrite-Regeln nur auf der Veröffentlichungsebene an. Die Autoreninstanz verwendet keinen Dispatcher, weshalb gekürzte URLs nicht automatisch umgewandelt werden. Um dies auf der Autorenebene zu aktivieren, muss eine CDN-Konfiguration über die Konfigurations-Pipeline bereitgestellt werden. Die Umwandlungsregel muss außerdem die richtige Syntax verwenden, einschließlich korrekten Escapings (z. B. \"/content/websites\\\\1\").

Auflösung resolution

Um das Problem zu beheben,

Stellen Sie mithilfe der AEM Config-Pipeline eine CDN-Konfiguration bereit. Diese Konfiguration sollte eine benutzerdefinierte Regel mit dem Namen add-content-websites-prefix enthalten. Die Regel prüft, ob sich die Anfrage auf der Autorenebene befindet und ob der Pfad mit /ui/ beginnt. Wenn beide Bedingungen erfüllt sind, wird der Pfad durch Voranstellen von /content/websites neu geschrieben.

code language-none

code language-none
kind: "CDN" version: "1" metadata: { envTypes: [ "dev", "stage", "prod"] } data: requestTransformations: rules: - name: add-content-websites-prefix when: allOf: - { reqProperty: tier, equals: author } - { reqProperty: path, matches: "/ui/" } actions: - type: transform reqProperty: path op: replace match: (.*)$ replacement: "/content/websites\\1"

kind: "CDN"
version: "1"
metadata: { envTypes: [ "dev", "stage", "prod"]  }
data:
  requestTransformations:
    rules:
      - name: add-content-websites-prefix
        when:
          allOf:
            - { reqProperty: tier, equals: author }
            - { reqProperty: path, matches: "/ui/" }
        actions:
          - type: transform
            reqProperty: path
            op: replace
            match: (.*)$
            replacement: "/content/websites\\1"

Testen Sie nach Bereitstellung der Konfiguration gekürzte URLs auf der Autoreninstanz. Sie sollten jetzt korrekt auf den beabsichtigten Inhalt aufgelöst werden.

Weitere Überlegungen

Während der vordefinierte CDN-basierte Anforderungstransformationsmechanismus ursprünglich für Veröffentlichungsumgebungen vorgesehen war, können Sie ihn auf Autorenumgebungen erweitern, indem Sie eine entsprechende Konfiguration über die Konfigurations-Pipeline bereitstellen.
Adobe empfiehlt die Verwendung vollständiger Pfade für die routinemäßige Inhaltsvalidierung auf der Autoreninstanz. Testen Sie immer benutzerdefinierte Umwandlungsregeln, um eine Unterbrechung des Authoring-Workflows zu vermeiden.