GlobalLink Connect Cloud for CoreMedia Content Cloud v12.2406.1.0

GlobalLink Connect Cloud for CoreMedia Content Cloud v12.2406.1.0

Merge pull request #74 from CoreMedia/develop

CHANGELOG.md

@@ -1,6 +1,25 @@
 Changelog
 ================================================================================
 
+v2406.1.0-1
+--------------------------------------------------------------------------------
+
+Despite adapting the connector to CoreMedia Content Cloud v12.2406.1.0, we
+hardened the connector in these aspects:
+
+* Introduced a defined behavior for the undocumented submission status
+  `REDELIVERED`.
+* Fixed submission instruction handling to deal with its features (HTML content)
+  and limitations (character types).
+* Fixed submission name handling to deal with its limitations (character types).
+* Hardened the connector in case of submission errors (an extra state reachable
+  in the GCC backend).
+* Hardened the connector for "submission not found" scenarios that may occur
+  due to wrong or connector key settings.
+
+Find more detailed release notes in the newly introduced documentation
+section [Changelog](./docs/changelog/README.md).
+
 v2406.0.1-1
 --------------------------------------------------------------------------------
 
@@ -121,7 +140,7 @@ in the properties file.
 * Configuration has been refactored so that the GlobalLink settings are not 
 automatically published with the pages that they are linked to. The Settings 
 have to be located in specific folders instead. Ensure that the name of the 
-path and the folder match the convention mentioned below.
+path, and the folder match the convention mentioned below.
 
 
   **Upgrade Steps:**
@@ -270,7 +289,7 @@ v2107.3-1
     offered tasks. These features are however not available in the Studio (yet).
 
 * The source locale of the submission is now also send as part of the file upload 
-    call to the gcc API. Thank you @mtommila for suggesting this change and 
+    call to the gcc API. Thank you, @mtommila, for suggesting this change and 
     providing a [Pull Request](https://github.com/CoreMedia/coremedia-globallink-connect-integration/pull/37).
 
     In the context of this change `GCExchangeFacade.uploadContent(String fileName, Resource resource, Locale sourceLocale)` 
@@ -287,14 +306,14 @@ v2104.1-1
 
 * Added the possibility to configure the connection to GlobalLink in properties 
     file on the server with [CoreMedia/coremedia-globallink-connect-integration#25](https://github.com/CoreMedia/coremedia-globallink-connect-integration/issues/25) - 
-    Thank you @mtommila for suggesting this change and providing a Pull Request.
+    Thank you, @mtommila, for suggesting this change and providing a Pull Request.
 
 * The notes from the Start Translation Workflow Window are now sent as instructions 
     to GlobalLink. Optionally, the submitter's name can be added to the submission. 
     The workflow is also prepared to take an optional string that represents the 
     type of the workflow on the GlobalLink side. This still requires the UI to 
     be implemented in Studio. - [CoreMedia/coremedia-globallink-connect-integration#26](https://github.com/CoreMedia/coremedia-globallink-connect-integration/issues/26) - 
-    Thank you @mtommila for suggesting this change and providing a Pull Request.
+    Thank you, @mtommila, for suggesting this change and providing a Pull Request.
 
 * Fixed concurrency issue of `DefaultGCExchangeFacadeSessionProvider` which 
   could cause `java.util.NoSuchElementExceptions` [CoreMedia/coremedia-globallink-connect-integration#33](https://github.com/CoreMedia/coremedia-globallink-connect-integration/issues/33)
@@ -320,7 +339,7 @@ v2101.3-1
 * Fixed [CoreMedia/coremedia-globallink-connect-integration#23](https://github.com/CoreMedia/coremedia-globallink-connect-integration/issues/18)
 
     The API of the `GCExchangeFacade` was updated to also return the submission identifier 
-    shown in GlobalLink Project Director and Connect Cloud. If you had accessed the
+    shown in GlobalLink Project Director and Connect Cloud. If you had accessed
     the submission state through `GCExchangeFacade.getSubmissionState(submissionId)`, you have
     to migrate to `GCExchangeFacade.getSubmission(submissionId).getState()`.
 

KNOWN_ISSUES.md

@@ -26,7 +26,7 @@ Example message for such a failure report:
 
 ### Submission Locales
 
-What do the submission locales refer to? From Connectors - Config:
+What do the submission locales refer to? From Connectors — Config:
 
 * `locale_label`,
 * `pd_locale`, or

README.md

@@ -6,7 +6,7 @@
      * Change "message" for GCC (Used) version to the recently used version.
 -->
 
-![CoreMedia Content Cloud Version](https://img.shields.io/static/v1?message=2406.0&label=CoreMedia%20Content%20Cloud&style=for-the-badge&color=672779)
+![CoreMedia Content Cloud Version](https://img.shields.io/static/v1?message=2406.1&label=CoreMedia%20Content%20Cloud&style=for-the-badge&color=672779)
 ![GCC Used](https://img.shields.io/static/v1?message=v3.1.3&label=GCC%20REST%20API%20%28Used%29&style=for-the-badge&color=green)
 [![Maven Central: GCC Recent](https://img.shields.io/maven-central/v/com.translations.globallink/gcc-restclient.svg?label=GCC%20REST%20API%20%28Recent%29&style=for-the-badge)](https://central.sonatype.com/search?q=com.translations.globallink%3Agcc-restclient)
 
@@ -33,7 +33,7 @@ This open-source extension adds the following functionality to the CoreMedia Stu
 * Editors in CoreMedia Studio are notified about completion, cancellation, and
     import and communication errors of a translation workflow with GlobalLink.
 
-**Detailed documentation available at
+**A detailed documentation available at
 [GitHub Pages](https://coremedia.github.io/coremedia-globallink-connect-integration/),
 or browse directly in [docs/ folder](./docs/README.md).**
 
@@ -48,10 +48,6 @@ or browse directly in [docs/ folder](./docs/README.md).**
 
     Will contain preparations for next supported major.
 
-* **ci/develop:**
-
-    An artificial branch required for CoreMedia internal CI systems.
-
 * **Version Tags:**
 
     For adaptions to CoreMedia CMS major versions you will find corresponding

apps/studio-client/apps/main/gcc/package.json

@@ -8,9 +8,9 @@
     "@coremedia-labs/studio-client.ext.gcc-studio-client": "1.0.0-SNAPSHOT"
   },
   "devDependencies": {
-    "@jangaroo/build": "^3.0.1",
-    "@jangaroo/core": "^3.0.1",
-    "@jangaroo/publish": "^3.0.1",
+    "@jangaroo/build": "^3.1.0",
+    "@jangaroo/core": "^3.1.0",
+    "@jangaroo/publish": "^3.1.0",
     "rimraf": "^5.0.7"
   },
   "scripts": {

apps/studio-client/apps/workflow/gcc/package.json

@@ -8,9 +8,9 @@
     "@coremedia-labs/studio-client.ext.gcc-studio-client": "1.0.0-SNAPSHOT"
   },
   "devDependencies": {
-    "@jangaroo/build": "^3.0.1",
-    "@jangaroo/core": "^3.0.1",
-    "@jangaroo/publish": "^3.0.1",
+    "@jangaroo/build": "^3.1.0",
+    "@jangaroo/core": "^3.1.0",
+    "@jangaroo/publish": "^3.1.0",
     "rimraf": "^5.0.7"
   },
   "scripts": {

apps/studio-client/shared/js/gcc/package.json

@@ -5,22 +5,22 @@
   "license": "CoreMedia Open Source License",
   "private": true,
   "dependencies": {
-    "@coremedia/studio-client.cap-base-models": "2406.0.1",
-    "@coremedia/studio-client.cap-rest-client": "2406.0.1",
-    "@coremedia/studio-client.cap-rest-client-impl": "2406.0.1",
-    "@coremedia/studio-client.client-core": "2406.0.1",
-    "@coremedia/studio-client.client-core-impl": "2406.0.1",
-    "@coremedia/studio-client.core-icons": "2406.0.1",
-    "@coremedia/studio-client.workflow-models": "2406.0.1",
-    "@coremedia/studio-client.workflow-plugin-models": "2406.0.1",
+    "@coremedia/studio-client.cap-base-models": "2406.1.0",
+    "@coremedia/studio-client.cap-rest-client": "2406.1.0",
+    "@coremedia/studio-client.cap-rest-client-impl": "2406.1.0",
+    "@coremedia/studio-client.client-core": "2406.1.0",
+    "@coremedia/studio-client.client-core-impl": "2406.1.0",
+    "@coremedia/studio-client.core-icons": "2406.1.0",
+    "@coremedia/studio-client.workflow-models": "2406.1.0",
+    "@coremedia/studio-client.workflow-plugin-models": "2406.1.0",
     "@jangaroo/ext-ts": "^2.0.0",
-    "@jangaroo/runtime": "^3.0.1"
+    "@jangaroo/runtime": "^3.1.0"
   },
   "devDependencies": {
-    "@jangaroo/build": "^3.0.1",
-    "@jangaroo/core": "^3.0.1",
-    "@coremedia/eslint-config-studio-client-ext": "2406.0.1",
-    "@jangaroo/publish": "^3.0.1",
+    "@jangaroo/build": "^3.1.0",
+    "@jangaroo/core": "^3.1.0",
+    "@coremedia/eslint-config-studio-client-ext": "2406.1.0",
+    "@jangaroo/publish": "^3.1.0",
     "eslint": "^8.57.0",
     "rimraf": "^5.0.7"
   },

apps/studio-client/shared/js/gcc/src/GccWorkflowLocalization_de_properties.ts

@@ -11,6 +11,7 @@ ResourceBundleUtil.override(GccWorkflowLocalization_properties, {
   TranslationGlobalLink_task_CancelTranslation_displayName: "Warten auf Abbruch-Verarbeitung",
   TranslationGlobalLink_task_DownloadTranslation_displayName: "Warten auf Übersetzung",
   TranslationGlobalLink_task_ReviewDeliveredTranslation_displayName: "Übersetzung prüfen",
+  TranslationGlobalLink_task_ReviewRedeliveredTranslation_displayName: "Übersetzung prüfen (erneut ausgeliefert)",
   TranslationGlobalLink_task_ReviewCancelledTranslation_displayName: "Abbruch prüfen",
   TranslationGlobalLink_task_RollbackContent_displayName: "Verwerfen der Änderungen",
   TranslationGlobalLink_task_Complete_displayName: "Aktualisierung des Status der abgeleiteten Inhalte",
@@ -26,6 +27,7 @@ ResourceBundleUtil.override(GccWorkflowLocalization_properties, {
   TranslationGlobalLink_state_finishTranslation_displayName: "Lokalisierung abschließen",
   TranslationGlobalLink_state_DownloadTranslation_displayName: "Warten auf Übersetzung",
   TranslationGlobalLink_state_ReviewDeliveredTranslation_displayName: "Übersetzung prüfen",
+  TranslationGlobalLink_state_ReviewRedeliveredTranslation_displayName: "Übersetzung prüfen (erneut ausgeliefert)",
   TranslationGlobalLink_state_ReviewCancelledTranslation_displayName: "Abbruch prüfen",
   TranslationGlobalLink_state_translationReviewed_displayName: "Lokalisierung abschließen (Übersetzung geprüft)",
   TranslationGlobalLink_state_continueRetry_displayName: "Weiter, und erneut versuchen",
@@ -43,8 +45,13 @@ ResourceBundleUtil.override(GccWorkflowLocalization_properties, {
     "Die Konfiguration der GlobalLink-Verbindung ist fehlerhaft. Der Wert für 'fileType' wird nicht von GlobalLink unterstützt.",
   "GCC-WF-40002_text":
     "Die Verbindung zu GlobalLink ist aufgrund eines abgelaufenen oder fehlerhaften 'apiKey' fehlgeschlagen.",
+  "GCC-WF-40003_text":
+    "Der angegebene Connector Key in der Konfiguration der GlobalLink-Verbindung ist ungültig (Eigenschaft 'key').",
   "GCC-WF-40050_text": "Die GlobalLink-Auftragsnummer ist fehlerhaft.",
   "GCC-WF-50050_text": "Der XLIFF-Export ist fehlgeschlagen.",
+  "GCC-WF-60000_text": "Allgemeiner GlobalLink-Auftragsfehler.",
+  "GCC-WF-60001_text":
+    "GlobalLink-Auftrag nicht gefunden. Die Konfiguration der GlobalLink-Verbindung könnte fehlerhaft sein.",
   "GCC-WF-61001_text": "Das Abbrechen des GlobalLink-Auftrags ist fehlgeschlagen.",
   dateLiesInPast_globalLinkDueDate_text: "Bitte Fälligkeitsdatum in der Zukunft auswählen.",
   dateInvalid_globalLinkDueDate_text: "Bitte gültiges Fälligkeitsdatum eingeben.",

apps/studio-client/shared/js/gcc/src/GccWorkflowLocalization_properties.ts

@@ -8,6 +8,7 @@ interface GccWorkflowLocalization_properties {
   TranslationGlobalLink_task_CancelTranslation_displayName: string;
   TranslationGlobalLink_task_DownloadTranslation_displayName: string;
   TranslationGlobalLink_task_ReviewDeliveredTranslation_displayName: string;
+  TranslationGlobalLink_task_ReviewRedeliveredTranslation_displayName: string;
   TranslationGlobalLink_task_ReviewCancelledTranslation_displayName: string;
   TranslationGlobalLink_task_RollbackContent_displayName: string;
   TranslationGlobalLink_task_Complete_displayName: string;
@@ -22,6 +23,7 @@ interface GccWorkflowLocalization_properties {
   TranslationGlobalLink_state_finishTranslation_displayName: string;
   TranslationGlobalLink_state_DownloadTranslation_displayName: string;
   TranslationGlobalLink_state_ReviewDeliveredTranslation_displayName: string;
+  TranslationGlobalLink_state_ReviewRedeliveredTranslation_displayName: string;
   TranslationGlobalLink_state_ReviewCancelledTranslation_displayName: string;
   TranslationGlobalLink_state_translationReviewed_displayName: string;
   TranslationGlobalLink_state_continueRetry_displayName: string;
@@ -37,8 +39,11 @@ interface GccWorkflowLocalization_properties {
   "GCC-WF-40000_text": string;
   "GCC-WF-40001_text": string;
   "GCC-WF-40002_text": string;
+  "GCC-WF-40003_text": string;
   "GCC-WF-40050_text": string;
   "GCC-WF-50050_text": string;
+  "GCC-WF-60000_text": string;
+  "GCC-WF-60001_text": string;
   "GCC-WF-61001_text": string;
   dateLiesInPast_globalLinkDueDate_text: string;
   dateInvalid_globalLinkDueDate_text: string;
@@ -56,6 +61,7 @@ const GccWorkflowLocalization_properties: GccWorkflowLocalization_properties = {
   TranslationGlobalLink_task_CancelTranslation_displayName: "Awaiting cancelation to finish",
   TranslationGlobalLink_task_DownloadTranslation_displayName: "Awaiting translation results",
   TranslationGlobalLink_task_ReviewDeliveredTranslation_displayName: "Review translation",
+  TranslationGlobalLink_task_ReviewRedeliveredTranslation_displayName: "Review translation (redelivered)",
   TranslationGlobalLink_task_ReviewCancelledTranslation_displayName: "Review cancelation",
   TranslationGlobalLink_task_RollbackContent_displayName: "Performing rollback",
   TranslationGlobalLink_task_Complete_displayName: "Updating derived content states",
@@ -71,6 +77,7 @@ const GccWorkflowLocalization_properties: GccWorkflowLocalization_properties = {
   TranslationGlobalLink_state_finishTranslation_displayName: "Finish content localization",
   TranslationGlobalLink_state_DownloadTranslation_displayName: "Awaiting translation results",
   TranslationGlobalLink_state_ReviewDeliveredTranslation_displayName: "Review translation",
+  TranslationGlobalLink_state_ReviewRedeliveredTranslation_displayName: "Review translation (redelivered)",
   TranslationGlobalLink_state_ReviewCancelledTranslation_displayName: "Review cancelation",
   TranslationGlobalLink_state_translationReviewed_displayName: "Finish content localization (Translation Reviewed)",
   TranslationGlobalLink_state_continueRetry_displayName: "Continue and retry",
@@ -82,12 +89,15 @@ const GccWorkflowLocalization_properties: GccWorkflowLocalization_properties = {
 
   "GCC-WF-10000_text": "An unexpected error occurred.",
   "GCC-WF-20000_text": "Error communicating with GlobalLink.",
-  "GCC-WF-30001_text": "A local IO error occurred.",
+  "GCC-WF-30001_text": "A local I/O error occurred.",
   "GCC-WF-40000_text": "The GlobalLink configuration settings are inconsistent.",
   "GCC-WF-40001_text": "The GlobalLink configuration settings contain an unsupported value for 'fileType'.",
   "GCC-WF-40002_text": "The connection to GlobalLink failed because of an expired or invalid 'apiKey'.",
+  "GCC-WF-40003_text": "The given connector key in the GlobalLink configuration is invalid (property: 'key').",
   "GCC-WF-40050_text": "Encountered an illegal submission ID.",
   "GCC-WF-50050_text": "An XLIFF export failure occurred.",
+  "GCC-WF-60000_text": "General submission failure.",
+  "GCC-WF-60001_text": "Submission not found. Your GlobalLink configuration may have issues.",
   "GCC-WF-61001_text": "Failure while trying to cancel GlobalLink submission.",
   dateLiesInPast_globalLinkDueDate_text: "Please choose a future Due Date.",
   dateInvalid_globalLinkDueDate_text: "Please enter a valid Due Date.",