Zum Hauptinhalt gehen
 

Wie können wir helfen?

Suche

Admin Guide

  • Aktualisiert

Allgemeine Konfigurationen

Einrichten von Single Sign-on

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 zur Einrichtung 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!

Konfigurieren des Zugriffs auf AEM-Ressourcen

Hinweis

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

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

Acrolinx für eine Site 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 Sites 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.

Acrolinx für eine bestimmte Komponente unzugänglich machen

So deaktivieren Sie die AEM Guides Sidebar und die Stapelprüfung in Assets:

Setzen Sie das Eingabefeld auf:

(libs/fmdita/|content/dam/)

So deaktivieren Sie nur die AEM Guides Sidebar:

Setzen Sie das Eingabefeld auf:

(libs/fmdita/)

Hinzufügen eines*r Acrolinx Systembenutzers*in

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 (UserId des*der Systembenutzers*in, den*die Sie zuweisen möchten) – 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.

Deaktivieren von Acrolinx in Sites

So beenden Sie die Verwendung von Acrolinx in Sites:

  1. Gehen Sie im AEM Cloud Manager zu Environments und wählen Sie Acrolinx Exchange Partner Program aus.

  2. Klicken Sie auf Configuration > Add/Update, um den Dialog Environment Configuration zu öffnen.

  3. Geben Sie die folgenden Details ein:

    • Name: ACROLINX_SIDEBAR_SITES

    • Value: false

    • Service Applied: All

    • Type: Variable

    Klicken Sie auf Add.

  4. Klicken Sie auf Save. Nach dem Speichern sehen Sie den Status Updating am oberen Rand der Tabelle und neben der neu hinzugefügten Variablen. Sobald die Aktualisierung abgeschlossen ist, wird die neue Umgebungsvariable in der Tabelle Environment Configuration angezeigt.

Sobald Sie die Variable hinzugefügt haben, ist die Acrolinx Sidebar in Sites nicht mehr sichtbar.

Tipp

Um die Acrolinx Sidebar wieder zu aktivieren, setzen Sie Value auf true.

Erweiterte Konfigurationen

[en] Configure components

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

[en] Configure batch check scheduler

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.

[en] Configure outgoing network request timeouts

[en] You can set the default timeouts for outgoing network requests in Acrolinx.

[en] To configure the timeout for outgoing network requests, do the following:

  1. [en] Go to Acrolinx Connection Settings on http://localhost:4502/system/console/configMgr.

  2. [en] Enter your preferred value under HTTP(S) Timeout. This is set to 1 second by default.

    [en] You can set the following:

    • [en] Connection request timeout = HTTP_TIMEOUT * 5

    • [en] Connection timeout = HTTP_TIMEOUT

    • [en] Socket timeout = HTTP_TIMEOUT * 5

  3. [en] Click Save.