Release Notes - FirstSpirit Module

1. General Information

PRODUCT	VERSION
Java	17 or above
FirstSpirit	5.2.240408 or newer, isolated mode and FragmentCreator support

PRODUCT

VERSION

Java

17 or above

FirstSpirit

5.2.240408 or newer, isolated mode and FragmentCreator support

2. Update Information

Deploy the FSM and update its uses.

translationstudio’s language mapping templates will be updated from the deprecated FS_LIST to FS_CATALOG input component automatically. Unfortunately, the existing values cannot be stored and will have to be edited and saved manually.

translationstudio only supports the FirstSpirit isolated mode.

2.1. Updating from versions prior 201111

The FirstSpirit workflows have been replaced by updated, more adaptable workflows with added transitions. Permissions have to be granted to use these workflows

Previous translationstudio workflows will not send translation requests to the translationstudio application anymore and have to be removed from your system manually.

3. New Features & Fixed Issues

The following features have been added or fixed.

VERSION DESCRIPTION

VERSION	DESCRIPTION
240723	Add license management section to configuration.
240722	Declarative jakarta web-app updates. This does not affect the migrated libraries themselves.
240717	The mail configuration is accessible via translationstudio’s project component.
240716	Allow TMS overwrite list to be mandatory.
240515	Link templates are loaded if necessary for each page node to avoid clearance.
240514	The management configuration is accessible via translationstudio’s project component.
	Plugin configuration can send test mails.
240422	You may disable translationstudio’s report (AppSlot), if necessary.
240109	Add connector number suffix if connectors with the identical display name exist.
231213	Show FS report only in projects using the translationstudio project component.
	Fix issue module.xml inconsistency.
231120	Flag to use secure https/sockets connection mode added.
231116	New manual schedule task to update translationstudio in all projects that use the project component.
231017	SUMM AI connector added
	Preview page option has been removed, since it relies on a PDF output channel to work effectively (this is an outdated approach).
231016	Java 17 migration
230919	Configuration could not be saved completely. Fixed missing properties.
230816	DeepL, AWS, Azure and Google Translate do not automatically replace hyphen with underscore in language associations gui.
230814	Workflows allow to translate all datasets via option instead of having to select each manually.
230511	Missing global page prefix fixed.
230503	translationstudio workflow display name set for all project languages.
230328	Fixed TMS Overwrite configuration option.
230323	DeepL connector can use glossaries
221020	Workflow section list can use snippet information to display section display name
	Monitoring panel dataset iddentification fix.
220901	Configuration page allows to make due date field mandatory
220831	Increased hybrid encryption key size to 2048 bits
220816	Installer checks table temples uid if possible instead of name to avoid duplicates.
220811	Clarified success message box to indicate it having to be closed to continue.
220804.1	Translation workflows will evaluate permissions of language mappings to decide if they are to be shown or not (if set at all).
220804	Monitoring tools update to project status gui.
220802	Installer searchers for scripts and templates by uid/name (faster) and only if that fails via iterating over all scripts/templates (slower).
220801	Multiple langauge mappings will not be ignored when translating datasets.
220722	Source and target language selection optionally with dropdown multiselect instead of checkboxes.
220714	Monitoring project component allows to edit translation status information and match them against FirstSpirit projects.
220708	It is possible to overwrite the connector’s project as set in the language mappings via the configuration page.
220624	Fixed transition permissions of the Translate dataset worfklow.
220621	Machine translation connectors sort languages alphabetically.
	DeepL connector provides list of avilable source and target languge codes.
220522	New monitoring interface added (project component)
220513	The report shows connector projects with associated files instead of generic TMS ids
220406	Dataset translation workflow does not fail if an entity is added twice.
220210	Page-based translation status information are grouped by type and in chunks of 4 to reduce the occupied space
220112	Metrics report item also shows translationstudio application version
	Configuration page lets you hide the due date, translation type and workflow content area pages as well
211124	Dataset may use word counting.
	Limit access to TranslationHelper in ContentCreator
211026	Workflow transitions all set to "Change" permission from element by default to avoid permission issues.
210908	Metadata updates failed (HELP-54037).
210729	Restructuring of connectors configuration panel
	Set connection timeout when connecting to translationstudio
	New across connector creates projects instead of duplicating existing ones
	Old across connector (duplicats projects) deprecated
210723	Rename TranslationHelper confirmation button to clarify subsequent step
	Customise translation workflow submit button via configuration page
	Add word count to translation request
	Configuration page permission exception handling.
210428	translationstudio report sorts entries in descending order to list most recently updated elements first.
	Deprecated translation workflows do not generate preview pages.
210427	AccessAPI exceptions during installation handled.
210326	You may decide to only submit released translation requests to translationstudio
	translationstudio denied translation of datasets with incomplete language mappings.
	FS-Report preview links use target language instead of master language.
	FS-Report could produce NPE if FirstSpirit page had been deleted
210305	Custom configuration template supports preview page creation flag.
210212	Potential NullPointerException fixed (HELP-50220)
210115	Custom messages can be sent to translationstudio via dedicated REST endpoint.
	ContentCreator icon updates.
	ContentCreator allows to fetch translation status information for sections.
201217	Automatic installation failed when schema already existed.
201211	Module class loading issues resolved.
	You can configure the workflow forms more easily (changing labels, etc.).
	Connector discovery finds translationstudio connectors automatically now.
	translationstudio API access available.
201201	It is possible to skip the analysis of potentially problematic reference names by adding the project property pp_translationstudio_skip_uid_analysis of type `CMS_INPUT_TOGGLE`.
	New tutorial added to the documentation showing how to create custom scripts to send custom requests to translationstudio.
	New connector events.
	Maximum number of pages/datasources per job can be configured per quota.
201028	Script templates are set to template type to avoid accessibility.
	Translation request from label "Complete Translation until" renamed to "Due date".
	Manually set form defaults of the translation request forms will not be overwritten after an update.
	Translation request form allows to select source/target language mappings via checkbox instead of FS_REFERENCE to allow for more flexibility.
	Workflows have a dedicated "execute scheduled task" script to allow to adapt the workflow process in general.
	Configuration form now allows to configure how often translatable xml files should be processed unsuccessfully before finally being dumped to avoid infinite retries.
	You can remove "Translation Memory System" items from the report filter by adding the project property pp_translationstudio_report_tms of type `CMS_INPUT_TOGGLE`
	You can foce translationstudio to only transfer released translation requests to the translationstudio Application.
201027	The translation request form allows to select multiple target language mappings to reduce complexity
201006	SiteArchitect will cache configured connector project lists for 1min to improve performance.
	Automatic update via distribution settings fixed.
200907	Order of template installation changed
	Page-based translation status information added to FirstSpirit module
	FragmentCreator support
	Hooks can be configured using the configuration panel

240723

Add license management section to configuration.

240722

Declarative jakarta web-app updates. This does not affect the migrated libraries themselves.

240717

The mail configuration is accessible via translationstudio’s project component.

240716

Allow TMS overwrite list to be mandatory.

240515

Link templates are loaded if necessary for each page node to avoid clearance.

240514

The management configuration is accessible via translationstudio’s project component.

Plugin configuration can send test mails.

240422

You may disable translationstudio’s report (AppSlot), if necessary.

240109

Add connector number suffix if connectors with the identical display name exist.

231213

Show FS report only in projects using the translationstudio project component.

Fix issue module.xml inconsistency.

231120

Flag to use secure https/sockets connection mode added.

231116

New manual schedule task to update translationstudio in all projects that use the project component.

231017

SUMM AI connector added

Preview page option has been removed, since it relies on a PDF output channel to work effectively (this is an outdated approach).

231016

Java 17 migration

230919

Configuration could not be saved completely. Fixed missing properties.

230816

DeepL, AWS, Azure and Google Translate do not automatically replace hyphen with underscore in language associations gui.

230814

Workflows allow to translate all datasets via option instead of having to select each manually.

230511

Missing global page prefix fixed.

230503

translationstudio workflow display name set for all project languages.

230328

Fixed TMS Overwrite configuration option.

230323

DeepL connector can use glossaries

221020

Workflow section list can use snippet information to display section display name

Monitoring panel dataset iddentification fix.

220901

Configuration page allows to make due date field mandatory

220831

Increased hybrid encryption key size to 2048 bits

220816

Installer checks table temples uid if possible instead of name to avoid duplicates.

220811

Clarified success message box to indicate it having to be closed to continue.

220804.1

Translation workflows will evaluate permissions of language mappings to decide if they are to be shown or not (if set at all).

220804

Monitoring tools update to project status gui.

220802

Installer searchers for scripts and templates by uid/name (faster) and only if that fails via iterating over all scripts/templates (slower).

220801

Multiple langauge mappings will not be ignored when translating datasets.

220722

Source and target language selection optionally with dropdown multiselect instead of checkboxes.

220714

Monitoring project component allows to edit translation status information and match them against FirstSpirit projects.

220708

It is possible to overwrite the connector’s project as set in the language mappings via the configuration page.

220624

Fixed transition permissions of the Translate dataset worfklow.

220621

Machine translation connectors sort languages alphabetically.

DeepL connector provides list of avilable source and target languge codes.

220522

New monitoring interface added (project component)

220513

The report shows connector projects with associated files instead of generic TMS ids

220406

Dataset translation workflow does not fail if an entity is added twice.

220210

Page-based translation status information are grouped by type and in chunks of 4 to reduce the occupied space

220112

Metrics report item also shows translationstudio application version

Configuration page lets you hide the due date, translation type and workflow content area pages as well

211124

Dataset may use word counting.

Limit access to TranslationHelper in ContentCreator

211026

Workflow transitions all set to "Change" permission from element by default to avoid permission issues.

210908

Metadata updates failed (HELP-54037).

210729

Restructuring of connectors configuration panel

Set connection timeout when connecting to translationstudio

New across connector creates projects instead of duplicating existing ones

Old across connector (duplicats projects) deprecated

210723

Rename TranslationHelper confirmation button to clarify subsequent step

Customise translation workflow submit button via configuration page

Add word count to translation request

Configuration page permission exception handling.

210428

translationstudio report sorts entries in descending order to list most recently updated elements first.

Deprecated translation workflows do not generate preview pages.

210427

AccessAPI exceptions during installation handled.

210326

You may decide to only submit released translation requests to translationstudio

translationstudio denied translation of datasets with incomplete language mappings.

FS-Report preview links use target language instead of master language.

FS-Report could produce NPE if FirstSpirit page had been deleted

210305

Custom configuration template supports preview page creation flag.

210212

Potential NullPointerException fixed (HELP-50220)

210115

Custom messages can be sent to translationstudio via dedicated REST endpoint.

ContentCreator icon updates.

ContentCreator allows to fetch translation status information for sections.

201217

Automatic installation failed when schema already existed.

201211

Module class loading issues resolved.

You can configure the workflow forms more easily (changing labels, etc.).

Connector discovery finds translationstudio connectors automatically now.

translationstudio API access available.

201201

It is possible to skip the analysis of potentially problematic reference names by adding the project property pp_translationstudio_skip_uid_analysis of type CMS_INPUT_TOGGLE.

New tutorial added to the documentation showing how to create custom scripts to send custom requests to translationstudio.

New connector events.

Maximum number of pages/datasources per job can be configured per quota.

201028

Script templates are set to template type to avoid accessibility.

Translation request from label "Complete Translation until" renamed to "Due date".

Manually set form defaults of the translation request forms will not be overwritten after an update.

Translation request form allows to select source/target language mappings via checkbox instead of FS_REFERENCE to allow for more flexibility.

Workflows have a dedicated "execute scheduled task" script to allow to adapt the workflow process in general.

Configuration form now allows to configure how often translatable xml files should be processed unsuccessfully before finally being dumped to avoid infinite retries.

You can remove "Translation Memory System" items from the report filter by adding the project property pp_translationstudio_report_tms of type CMS_INPUT_TOGGLE

You can foce translationstudio to only transfer released translation requests to the translationstudio Application.

201027

The translation request form allows to select multiple target language mappings to reduce complexity

201006

SiteArchitect will cache configured connector project lists for 1min to improve performance.

Automatic update via distribution settings fixed.

200907

Order of template installation changed

Page-based translation status information added to FirstSpirit module

FragmentCreator support

Hooks can be configured using the configuration panel

4. Known Issues

Due to FS_LIST deprecation, translationstudio Version 4.2.0+ migrated from FS_LIST to FS_CATALOG.

Therefore, all language mapping instances (global content pages) may have to be updated again manually. If translatable XML files contain FS_LISTs, you have to wait until they are imported again before changing the input components to FS_CATALOG.

translationstudio requires page and section reference names to be lowercase alphanumeric and to (optionally) have a underscore character. This pattern will be used automatically when creating new pages or sections using ContentCreator or SiteArchitect. If you create sections or pages using the FirstSpirit API, you have to guarantee this pattern yourself. Elements not following this pattern will not be processed by translationstudio.

5. Acknowledgements

Due to the internal processing of FS_LIST and FS_CATALOG input components and potential non-existing fields in XML files using FirstSpirit’s filesystem synchronisation feature, it might be necessary to overwrite the target language xml file with the source’s original and replace its target fields. Therefore, changes made to the target language’s fields might be overwritten, e.g. manually added list entries. However, it is possible to restore previous versions using FirstSpirit’s version history.

6. Help

The Technical Support of the e-Spirit AG provides expert technical support to customers and partners covering any topic related to the FirstSpirit product. You can get and find more help concerning relevant topics in the FirstSpirit community.