Zum Hauptinhalt gehen
 

Wie können wir helfen?

Suche

Admin Guide

  • Aktualisiert

Allgemeine Konfigurationen

Einrichten von Single Sign-on (SSO)

Bevor Sie Acrolinx für AEM verwenden können, müssen Sie SSO für Acrolinx einrichten. Folgen Sie dazu der Anleitung in unserem Artikel Einrichten von Acrolinx für Single Sign-on.

Verbindung zu Acrolinx herstellen

Bevor Sie Ihren Content prüfen können, müssen Sie AEM so konfigurieren, dass interne Prüfanfragen an Acrolinx weitergeleitet werden. Wenn Sie die Verbindung zwischen AEM und Acrolinx aktivieren, wird auch die Stapelprüfung für Sites und Guides aktiviert.

So ermöglichen Sie AEM die Verbindung zu Acrolinx:

  1. Öffnen Sie in AEM die Adobe Experience Manager Web Console, indem Sie zu Tools > Operations > Web Console navigieren.

  2. Klicken Sie auf die Zeile Acrolinx Connection Settings und nehmen Sie in dem daraufhin angezeigten Dialogfeld die folgenden Änderungen vor:

    • Geben Sie in das Feld Acrolinx Platform URL Ihre Acrolinx-URL ein.

    • Geben Sie in das Feld General Access Token das generische Passwort ein, das Sie in der Hauptserver-Eigenschaftendatei konfiguriert haben, als Sie Acrolinx für Single Sign-on eingerichtet haben.

  3. (Optional) Wenn Sie Cookies an Ihre Acrolinx-Plattform weiterleiten möchten, wählen Sie die Option Forward Cookies to Acrolinx.

  4. (Optional) Wählen Sie Turn on HTTP Proxy, um Acrolinx-Anfragen über einen individuelle HTTP-Proxy weiterzuleiten.

  5. Klicken Sie auf Save.

Jetzt können Sie mit Acrolinx einzelne Prüfungen und Stapelprüfungen in AEM durchführen!

Zugriff auf AEM-Mandanten konfigurieren

Beachten Sie, dass Acrolinx standardmäßig für Sites und Guides sichtbar ist. Sie können die Konfiguration in der AEM Web Console ändern. Die Standard-Regex ist .*.

Hinweis

Verwenden Sie dies, um den Acrolinx-Zugriff auf AEM-Mandanten zu konfigurieren. Die Regex-Konfiguration betrifft sowohl die Stapel-Prüfung als auch die Sidebar-Prüfung.

Acrolinx  für eine Website verfügbar machen

Wenn Sie Acrolinx nur mit einer bestimmten Website verwenden möchten, können Sie einen regulären Ausdruck hinzufügen, der dem Namen der entsprechenden Website entspricht.

Um Acrolinx nur für eine Website verfügbar zu machen, z. B. für die Website we-retail und ihre Unterseiten, gehen Sie wie folgt vor:

Setzen Sie das Eingabefeld auf:

we-retail

In der Sites Admin Console können Sie die Stammseite von we-retail und ihre Unterseiten stapelweise prüfen. Die Sidebar wird nur für Ressourcen angezeigt, die we-retail enthalten.

Zum Beispiel: editor.html/content/we-retail>/language-masters/en/experience.html.

Acrolinx für mehrere Websites verfügbar machen

So konfigurieren Sie mehrere Websites:

Setzen Sie das Eingabefeld auf:

we-retail|wknd-events

Dies führt dazu, dass die Sidebar für Ressourcen angezeigt wird, die sowohl wknd-events als auch we-retail enthalten. Sie sehen sie nun für editor.html/content/we-retail>/language-masters/de/experience.html und editor.html/content/wknd-events.html.

Hinzufügen eines*r Acrolinx-Systembenutzer*in für die Stapelprüfung

Mit der Stapelprüfungsoption für XML/DITA (Guides) in AEM Assets können Sie mehrere XML-basierte Dateien direkt in der AEM-Konsole prüfen. Um eine Stapelprüfung durchzuführen, müssen Sie jedoch eine*n Systembenutzer*in auf dem AEM-Server erstellen.

Tipp

Vergewissern Sie sich, dass Sie sich mit dem Adminkonto anmelden.

  1. Gehen Sie zu http://:4502/crx/explorer/index.jsp.

  2. Klicken Sie auf User Administration > Create System User.

  3. Fügen Sie auf der Registerkarte Properties die folgenden Informationen hinzu, und klicken Sie auf Submit, um den*die Benutzer*in anzulegen.

    • UserId – in diesem Fall „acrolinxSystemUser“

    • Intermediate Path – /home/users/system

    Hinweis

    Pfad, unter dem Sie den*die Systembenutzer*in speichern möchten. Wenn es keinen Pfad gibt, speichert AEM den*die Benutzer*in in einem beliebigen Knoten. Dieses Feld ist optional. Es ist aber immer besser, einen Pfad anzugeben, damit Sie den*die Benutzer*in leichter verfolgen können.

  4. Navigieren Sie zu http://:4502/useradmin und doppelklicken Sie im linken Panel auf die Gruppe administrators. Öffnen Sie die Registerkarte Members.

    Tipp

    Bevor Sie die Gruppe administrators öffnen, stellen Sie unter acrolinxSystemUser > Groups sicher, dass der*die Systembenutzer*in nicht bereits der Gruppe administrators angehört.

  5. Ziehen Sie den acrolinxSystemUseracrolinxSystemUser auf die Registerkarte MembersMembers und klicken Sie auf Save.

Erweiterte Konfigurationen

Konfiguration der Komponenten

Sie bearbeiten nun Ihr Content-Profil für AEM, um Komponenten zu definieren, die Acrolinx ein- oder ausschließen soll. Dazu identifizieren Sie zunächst alle Komponenten, die Sie auf Ihrer Website verwenden. Dann fügen Sie diese zu Ihrem Content-Profil für AEM hinzu.

Hinweis

Wenn Sie XML- und DITA-Dateien in AEM stapelweise prüfen möchten, müssen Sie Ihre Komponenten zu den XML- und DITA-Content-Profilen hinzufügen.

Wir empfehlen das folgende Verfahren, um Ihre Komponenten zu identifizieren und Ihr Content-Profil zu aktualisieren:

  1. Gehen Sie in AEM zu Tools > CRXDE Lite, um CRXDE Lite zu öffnen.

  2. Gehn Sie zu Apps > [Ihre AEM-Website] > Components > Content. Sie sehen eine Liste aller Komponenten, die Sie auf Ihrer Website aktiviert haben.

  3. Melden Sie sich in einer separaten Browser-Registerkarte beim Acrolinx Dashboard an.

  4. Gehen Sie zu Konfigurationen > Content-Profile.

  5. Öffnen Sie Ihr Content-Profil für AEM, XML oder DITA und gehen Sie auf die Registerkarte Extraktion.

  6. Fügen Sie dem Content-Profil beliebige Komponenten hinzu. Um z. B. Content aus der image-Komponente einzubeziehen, geben Sie Folgendes ein:

    AEM_Content_Profile_Example.png

Tipp

Um eine Komponente von AEM einzubeziehen, nutzen Sie generell folgende Einstellungen:

  • Filter mode (Filtermodus) = include

  • Break Level (Umbruch) = sentence

Konfiguration des Stapelprüfung-Schedulers

Wenn Sie die On-Premise-Version von AEM verwenden, können Sie konfigurieren, wie viele Prüfanfragen Acrolinx während einer Stapelprüfung parallel verarbeitet. Standardmäßig verarbeitet Acrolinx 5 Anfragen auf einmal.

So konfigurieren Sie, wie viele Prüfanfragen während einer Stapelprüfung verarbeitet werden:

  1. Gehen Sie in AEM zu Tools > CRXDE Lite, um CRXDE Lite zu öffnen.

  2. Gehen Sie zu Apps > [Ihre AEM-Website] > config > org.apache.sling.event.jobs.QueueConfiguration~checkDitaJobConsumer, um die Liste Properties zu öffnen.

  3. Suchen Sie die Eigenschaft queue.maxparallel und legen Sie fest, wie viele Prüfanfragen Acrolinx parallel verarbeiten soll.