Acrolinx Server - Service Release 4.1.2
Acrolinx 4.1.2 is a service release that fixes a serious bug with the Terminology Manager.
Under some circumstances, it was not possible to delete any terms from the Terminology Manager. An error occurred when users attempted to delete one or more terms. When users deleted terms, some information about the term was incorrectly retained in the database. This disconnected data began to build up in the database. Once the volume of disconnected data became large enough, the 4.1 server was not able to delete a term. This issue occurred because the server attempted to clean up the disconnected data but could not complete the process. To fix the issue, we have introduced a cleanup process that runs when you start the server. Now, when you attempt to delete terms, the server no longer hangs and the terms are instantly deleted.
Acrolinx Server - Service Release 4.1.1
- Eliminate a range of cross-site scripting vulnerabilities
We have also updated the user documentation to reflect these changes.
We have made improvements to the following product areas:
- Security Enhancements
When you upload a file in the Dashboard, the file size and content is now validated.
This measure prevents attackers from uploading malicious scripts.
When you fill out any fields in the Dashboard or the Term Browser, the data that you entered is sanitized before it is saved.
This measure prevents attackers from entering harmful snippets of code that might be executed after you save your changes.
Information that is dynamically displayed in the term help templates is also sanitized before it is displayed in the web browser.
You can edit your term help template to configure what fields are displayed in your term help. Even if an attacker manages to save malicious code on the terminology database, we now make sure that unsafe data is stripped out when the affected field is displayed in the term help template.
You can now configure the server to sanitize files that you export from the Dashboard.
Just like in the previous case, even if an attacker manages to save malicious code on the terminology database, we can now make sure that unsafe data is stripped out of the exported file before you open it in your web browser.
However, we don't sanitize exported files by default because it can disrupt the layout of your file. This issue mainly affects exported CSV files. You can find out more about how to enable export file sanitization the server administration guide.
- Additionally, the contents of files that you import into the Dashboard are also sanitized before the data is written to the terminology database.
Acrolinx Server - Version 4.1 (17 September 2014)
- Provide voice scores for German
- Improve the user experience in the Terminology Manager interface.
We have also updated the user documentation to reflect these changes.
Below, you can find a more detailed list of enhancements and critical bug fixes that we've addressed in this release.
We have made improvements to the following product areas:
Terminology Management Changes
When you edit terms in the Terminology Manager, your changes are now saved immediately. You no longer have to click "Save". However, you can no longer undo your changes by clicking "Cancel". You must edit the term again to revert your changes. This improvement helps you work faster and prevents you from losing your changes by accident.
We've completely redesigned the layout of the term edit page so that term settings are displayed on different tabs instead of all at once. The most important settings are on the first tab, and the more advanced settings are on the last few tabs. This change makes it much easier to get information about a term at a glance, and to find the settings that interest you.
You can now customize the layout of the term edit page according to your specific requirements. For example, you can hide fields, add or remove tabs, or divide the page up into sections. There are many ways to change the layout. For example, you might decide that you prefer to have linked terms on the front tab, and want to move certain fields to another tab. To find out more about how to use this feature, see the new user documentation .
Additionally, there is now a new privilege to view and update the term editor layout. Users who have the role "Terminology Administrator" can view and update the configuration for the term editor layout. All other users can only view the configuration.
The way that Acrolinx stores terms in the terminology database has not changed, but the way we talk about terms has. We have tried to simplify our interface by removing the references to "head terms". In the new Terminology Manager, all terms are created equal. You can edit fields that store conceptual information from any term, and that information is updated for all terms in the term entry. The only reason we needed head terms in previous versions, was because those terms were used to store the conceptual information. Now that conceptual information is not tied to head terms, we don't need them anymore. However term entries still have a unique identifier and everything else stays the same. Hopefully, this interface change makes terminology administration easier to understand.
You can now back up just the data structure of your terminology database without the terms. The data structure includes any custom categories or fields that you have created as well as your import and export configurations. You might back up the data structure without the terms if you want to quickly create a test version of your terminology database on another server. You can find this option on the "Database Backups" page in the "Import and Export" section of the Terminology Manager.
If you harvest terms during a check, Acrolinx creates a term harvesting file in the output directory. You can now use the Acrolinx Term Aggregator to process these term harvesting files into a single XML file. This aggregation is helpful because Acrolinx automatically filters out duplicate terms or variants that you would otherwise have to validate manually. After you convert the XML file into CSV format and import it into Acrolinx, you can validate the new terms in the user interface of the Terminology Manager. The user documentation has been updated with information about the Acrolinx Term Aggregator .
Acrolinx comes installed with several term fields that can accept HTML. You can now preview how these fields will look on the term help page. For example, you can add ordered lists or bold formatting in fields such as "Source of definition" or "Context" and preview how this formatting would look before you close the term edit page. To preview an HTML field, click the new preview button that appears next to HTML fields on the term edit page.
In the Terminology Manager, you use the image upload widget to add images to term entries. You can now select how you want to add the image from a shortcut menu. You also get different dialog boxes depending on whether you want to upload an image file or enter a URL to an image on another server. This new design makes it easier to understand the different options for adding an image.
In previous versions of the Acrolinx server, you could only add comments from the term help page. Now, you can add comments on the Administrative Information tab of the new term edit page. Additionally, you can now delete comments from a term. To delete comments, your users must have a role that contains the new privilege Delete comments from existing terms . You can find this new privilege in the "Term Contribution" section when you edit a role. These improvements make it easier for you to manage your term comments.
Previously, when you added a new term to a term entry, the selected domain was set to a globally defined default domain. Now, the selected domain defaults to match the term that you are updating. For example, suppose that you have the term "wheel" which is in the domain "car parts". If you create the German term "Rad" as a new translation of the term "wheel", the German term "Rad" will also get the domain "car parts". If your source term has more than one domain, any terms you add will get the domain that is at the top of the list in the source term. This enhancement makes it quicker for you to create new terms and add them to existing terms.
When you edit the domains of a term, you select the domains from a dropdown menu. Previously, this dropdown menu always displayed all available domains. Now, the dropdown menu only displays the domains that you have not yet selected. For example, suppose that you have the domains "A", "B", "C", and "D". If your term already belongs to domain "A", the dropdown menu only displays domains "B", "C", and "D" as available domains when you add domains. This usability enhancement improves domain handling for all users of the Terminology Manager. Especially customers with many domains and terms that typically belong to more than one domain benefit from this improvement.
If your terminology database contains terms that might be interpreted as sentence breaks, it is possible that Acrolinx does not find these terms when checking. For example, you might enter the term part. working as a term variant for partially working . Acrolinx does not find such terms because the server always interprets the full stop as a sentence break. Now, the language server log files contain an entry with a list of affected terms if your terminology database contains such terms. You can then send these terms to Acrolinx so that the Acrolinx professional services team can add special rules for them to your resources. After you install the updated resources, Acrolinx finds the affected terms when you check for terminology issues.
There is a new translation view property that you can use to configure the default source language or source language pair. When you search for terms, the Term Browser looks for terms in the configured source languages. If your organization works in two main languages, you can now configure both of them as source languages. For example, you can search for source terms in English and German at the same time by adding the following line to your translation view properties: " translationview.searchForm.defaultSourceLanguages=en,de ". When you enter a search term, the Term Browser suggests matching terms from both languages. When you configure two source languages, Term Browser users can select two search languages from two search language dropdowns.
You can add a custom image to the start page of the translation view of the Term Browser. The image is displayed whenever a user opens the translation view. For example, you can display an image with short instructions for Term Browser users. These instructions are especially helpful for new users. You can find information on how to add this image in the Term Browser user guide .
- Microsoft Windows 8.1
- Microsoft Windows Server 2012
- Red Hat Enterprise Linux 6 (x64)
- Microsoft Windows Server 2000
- Microsoft Windows Server 2003
- Red Hat Enterprise Linux 5 (x64)
For more information about server compatibility, see the Acrolinx System Requirements and Supported Platforms Spreadsheet .
Analytics and Reports
In Acrolinx Analytics, you can create custom reports that are based on predefined report templates. We updated and enhanced the default set of Analytics report templates. You can now create two new reports. The "Quality Score" report gives you an overview of the content quality improvement. The "Voice Scores" report gives you information about the voice scores of your texts. Additionally, we renamed the "Quality" report to "Checking Score".
The Scorecard displays a separate section for each issue type. Each of these sections contains detailed information about the detected issues together with suggestions on how to resolve the issue. If Acrolinx found issues in read-only sections, the Scorecard displays a padlock icon next to the detected issue. For some users, the purpose of this padlock icon was unclear. We added a tooltip so that when users hover over the padlock icon, an explanation is displayed.
If your documents must contain specific keywords that are important for SEO, you can use Acrolinx to check how effectively you have used those keywords in each document. During each SEO check, Acrolinx also analyzes the document content and meta elements to discover potential new keywords. You can now enable the Acrolinx Server to check for variants of assigned and discovered keywords. This function is helpful if you want Acrolinx to detect variations of your keyword like plural forms. For example, suppose that you assign the keyword "cloud storage". If you enable keyword variants in SEO checks, Acrolinx also includes the keyword "cloud storages" when checking for the assigned keyword. You check for keyword variants if you think that variants might have a negative effect on your search optimization or if you scan websites of your competitors.
Server Maintenance Features
In the Dashboard, you can use the Monitor Performance section to monitor the performance of Acrolinx-related processes that are running on your server. If you use an external monitoring tool to read the monitoring data, you now also get information about the backup process of the reporting database. If you use monitoring tools, this information is helpful if you require detailed data about the backup process of the reporting database.
In the Dashboard, you can change the "Standard" target scores that Acrolinx has configured for you. If you use checking profiles, you can also add different sets of target scores. If you no longer require a set of target scores, you can now easily delete it in the Dashboard .
You can now include voice scores in your German Acrolinx resources. Voice scores measure the tone of voice in your content. The voice of your content is made up of several characteristics that you define with your project consultant. The default voice scores are "Klar und verständlich" and "Leicht und locker". You receive scores for each of these characteristics. After you check your content, the Scorecard displays these scores underneath the quality score breakdown.
You can use all 4.x server and plug-in versions to check for voice. This feature also works with the latest version of the Batch Checker so that you can check a whole set of documents for voice. Once, you have checked a set of documents, you can use the "Voice Scores" report in the Analytics section of the Dashboard to get an overview of the improvements over time.
You can configure the main voice settings in the Dashboard. For example you can set voice score targets, and disable or rename voice characteristics. For more details, see the user documentation .
This release fixes 36 bugs. The most important fixes are listed below.
When checking text, it was possible that users received an error message about an internal error and the check did not complete. This issue occurred if the checked text contained text segments that the linguistic engine could misinterpret, for example, cross-references to chapter numbers like "Ch.4.5.1". This issue has been resolved and users can now check affected documents as expected.
If you use a directory service to centrally manage users in your organization, you can configure the Acrolinx Server to search for user authentication information in your directory service instead of recreating users in the Dashboard. You can restrict access to a defined set of user groups. However, it was possible that users that were not members of an authorized user group could access the Acrolinx plug-in and run checks. This issue occurred in multi-tenant environments where the Acrolinx plug-in was only one of many LDAP-dependent applications. Only web-based plug-ins like the Acrolinx Plug-in for Adobe CQ were affected. This issue has been resolved. Users that do not belong to an authorized LDAP group can no longer check with the Acrolinx plug-in. If an unauthorized LDAP user tries to run a check, Acrolinx now adds an entry with the relevant information to the core server log file.
When users tried to log in to the Dashboard, it was possible that this process took several minutes. After logging in, the overall performance of the Dashboard was very slow. For example, it could take up to several minutes to open the different pages. This issue occurred in environments with external terminology databases that contained many domains, typically several hundred. This issue was caused by a server issue that occurred during the creation of the domain structure and has been resolved. Users can now use the Dashboard without performance issues.
In the Acrolinx Dashboard and Term Browser, you can view the help files for terms in your terminology database. The term help files are based on templates that you can customize according to your requirements. Some customers requested to have their term help text displayed in Portuguese or Chinese. Normally, the term help is displayed in the same language that users select for the Dashboard or Term Browser interface. Now, the language options "pt" and "zh" are available in the interface language dropdown. However, these language options only affect the language of the term help files. If you select one of these language options, the rest of the Dashboard and Term Browser interface will be displayed in English.
You can use the reporting data to calculate your Acrolinx cost savings. The relevant reports are part of the custom reporting templates included in your resources. In the previous Acrolinx version, this report was called the "ROI report". This name was misleading for some customers, because the report did not include the initial and running investment cost for Acrolinx. The report has therefore been renamed to "Cost savings report".
This report displays the number of times that terms from your terminology database were detected in documents. The data is collected from all available checks in the selected language, and includes the term name, term status, and term set. The terms are grouped by status. In the previous version, each term was counted only once per document. This has been changed. Now, each term is counted exactly as many times as it occurs in the document.
Previously, when creating custom field, you could define the field type as "Term entry: Details", "Term: General", and "Term: Details". Now that there is a more flexible way to change the field layout, we have simplified the field type. You can now define a field as "Conceptual" or "Term-specific". A "Conceptual" field stores conceptual information. When you update a conceptual field, the information is updated for all linked terms because they all describe the same concept. For example, if you change the image for the English term "cross-head screwdriver", your new image also appears when users open terms that are translations of "cross-head screwdriver. On the other hand, term-specific fields store information that is specific to each term.
Information on Upgrading
We've completely redesigned the layout of the term edit page so that term settings are displayed on different tabs instead of all at once. When you upgrade the server, your term edit page will display in the "default" layout. In the default layout, all custom fields are displayed on the "Custom Information" tab. However, you can customize your term edit layout so that your custom fields appear where you want them to be.
For more standard information on upgrading, see the installation procedures .
If you work with checking profiles, you can select a revision in the change history for extraction settings and save the revision as a new set of extraction settings. The change history is automatically updated when a profile administrator makes changes to segmentation or filter settings in a plug-in. However, in Java-based plug-ins with a version earlier than 4.0 some revisions are randomly created after a user opens the Acrolinx options. You might encounter this issue if you use an older version of the Acrolinx plug-in for Oxygen or Lotus Notes. If you notice revisions in the change history that look unusual, you can ignore them or upgrade your plug-in to version 4.0 or later.
The "View Scorecards" page provides you with any easy way to open older Scorecards without accessing the file system on your server computer. However, if you open Scorecards that were created with an Acrolinx server before version 4.0, parts of the terminology information are not displayed correctly. This issue occurs because these older Scorecards were created as checking reports in the older Acrolinx version. When Acrolinx displays the content from these checking reports as Scorecards, terminology information might be displayed incorrectly.
On the summary page of the Terminology Manager, you can use the Custom Field dropdown to change the contents of the Custom Category Section . If you select a custom field that contains a very large number of items, it might take a long time to reload the page. For example, your administrator might configure a custom field for domains. If the terminology database contains more than one thousand domains and several thousand terms, displaying this custom field might take several minutes.