Problem
Wenn Sie die Sidebar im Rahmen einer Batch-Prüfung verwenden, können Sie gelegentlich Inkonsistenzen in den Acrolinx-Bewertungen (Scores) für denselben Inhalt feststellen. Dieses Verhalten tritt bei CCMS-ähnlichen Anwendungen auf, bei denen Acrolinx sowohl im Frontend (Sidebar) als auch im Backend (automatisierte oder Batch-Prüfung) integriert ist.
In der Sidebar kann zum Beispiel ein Acrolinx Score von 81 angezeigt werden, der grün erscheint.
Wenn Acrolinx denselben Artikel im Rahmen einer automatisierten Prüfung beim Speichern prüft, wird möglicherweise ein Wert von 79 angezeigt, der gelb erscheint.
Diese Integrationen betrifft es
Produkt |
Version |
---|---|
Adobe Experience Manager |
Alle |
Command Line Interface (CLI) mit Sidebar-Integrationen |
Alle |
Content Analyzer mit Sidebar-Integration |
Alle |
Confluence |
Alle |
Salesforce Knowledge |
Alle |
SharePoint Online mit Office Online |
Alle |
WordPress |
Alle |
Kunden- oder partnereigene Integration, bei denen sowohl Sidebar als auch automatisierte Prüfung nebeneinander bestehen |
Alle |
Lösung
Stellen Sie sicher, dass alle Prüffunktionen:
- das gleiche Target verwenden
- dasselbe Contentprofil verwenden
Wenn Sie immer noch unterschiedliche Acrolinx-Bewertungen (Scores) erhalten, folgendes zur Information:
Acrolinx-Integrationen sind auf die APIs einer Anwendung angewiesen, um den Inhalt abzurufen bzw. zu extrahieren. Weder Entwickler noch Acrolinx können die APIs von Anwendungen, auf denen Acrolinx läuft, beeinflussen oder ändern. Das Einzige, was wir beeinflussen können, ist die Art und Weise, wie Acrolinx das extrahierte Dokument liest.
Hintergrund: So liest und bewertet Acrolinx
Je nach Anwendungssoftware bzw. Host-Editor und je nachdem, wie die Inhalte in der Datenbank gespeichert sind, kann es vorkommen, dass die Bewertungen (Scores) bei verschiedenen Prüfmerkmalen nicht exakt übereinstimmen. Obwohl das Dokument in den Augen des Betrachters denselben Inhalt hat, kann die zugrunde liegende HTML- oder XML-Struktur je nach API unterschiedlich sein.
Extraktion eines Dokuments innerhalb der Integration
Eine Acrolinx-Integration ruft eine Anwendungs-API auf, um den Inhalt und die Struktur eines Inhalts in seiner Gesamtheit abzurufen. Das Dokument enthält sowohl die Wörter, die der Leser sieht, als auch alle strukturellen Inhalte und Metainformationen, die der Leser nicht sieht. Dabei kann es sich zum Beispiel um HTML oder XML handeln.
Dokumenten-Extraktion in der Sidebar
Wenn Sie die Acrolinx-Sidebar verwenden, um Ihre Inhalte zu prüfen, greift die Acrolinx-Integration auf die Frontend-API Ihrer Anwendung zurück, um das Dokument im Quellformat zu extrahieren.
Dokumenten-Extraktion im Backend
Wenn die automatisierten oder Batch-Prüfungen von Acrolinx laufen, verlässt sich die Acrolinx-Integration auf die Backend-API Ihrer Anwendung, um das Dokument im Quellformat zu extrahieren.
Extraktion eines Dokuments auf der Acrolinx-Plattform
Acrolinx-Integrationen übernehmen die Dokumenten-Extraktion in der Hostanwendung. Aber auch die Acrolinx-Plattform verwendet Extraktionseinstellungen, um die natürliche Sprache der Inhalte herauszufiltern, die Acrolinx schließlich liest. Möglicherweise können Sie einige der Unterschiede in HTML oder XML ausgleichen, indem Sie die Extraktionseinstellungen des Inhaltsprofils ändern.
Wie die Acrolinx-Scores berechnet werden
Die Acrolinx-Bewertung wird auf der Grundlage der Anzahl der Wörter in Ihrem Dokument normalisiert. Wenn die Sidebar-Prüfung eine Wortzahl X und die automatische Prüfung Y ergibt, kann die Wortzahl allein die Ursache für die geringfügigen Unterschiede in den Acrolinx Scores sein.
Insbesondere bei sehr kurzen Dokumenten kann der kleinste Unterschied in der zugrundeliegenden Dokumentstruktur zu einer leicht unterschiedlichen Bewertung führen. In der Regel beträgt der Unterschied nur wenige Punkte, während die Fehler, die Acrolinx findet, genau die selben sind.
Additional Information
-
Content Profiles let you configure how Acrolinx reads your content.