Fixed persisting translations for attribute groups and improved errors for empty translations on attribute/attribute groups save (#33943)

* added fix for attribute groups

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* Improved translations for attributes

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* improvement

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* improvement

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* improvement

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* improvement

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* improved fetching translations in NewAttributeSettings

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* improved fetching translations in NewAttributeSettings

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* cleanup

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

* cleanup

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

---------

Signed-off-by: Agnieszka Gancarczyk <agagancarczyk@gmail.com>

js/apps/admin-ui/maven-resources/theme/keycloak.v2/admin/messages/messages_en.properties

@@ -3281,3 +3281,4 @@ termsAndConditionsDeclined=You need to accept the Terms and Conditions to contin
 somethingWentWrong=Something went wrong
 somethingWentWrongDescription=Sorry, an unexpected error has occurred.
 tryAgain=Try again
+errorSavingTranslations=Error saving translations\: '{{error}}'

js/apps/admin-ui/src/realm-settings/NewAttributeSettings.tsx

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
 import type {
   UserProfileAttribute,
   UserProfileConfig,
@@ -61,6 +62,7 @@ type UserProfileAttributeFormFields = Omit<
     annotations: IndexedAnnotations[];
     hasSelector: boolean;
     hasRequiredScopes: boolean;
+    translations?: TranslationForm[];
   };
 
 type Attribute = {
@@ -172,7 +174,8 @@ export default function NewAttributeSettings() {
 
   useFetch(
     async () => {
-      const translationsToSave: any[] = [];
+      const translationsToSave: Translations[] = [];
+
       await Promise.all(
         combinedLocales.map(async (selectedLocale) => {
           try {
@@ -183,55 +186,50 @@ export default function NewAttributeSettings() {
               });
 
             const formData = form.getValues();
-            const formattedKey = formData.displayName?.substring(
+            const formattedKey =
+              formData.displayName?.substring(
                 2,
                 formData.displayName.length - 1,
-            );
+              ) || "";
-            const filteredTranslations: Array<{
-              locale: string;
-              value: string;
-            }> = [];
-            const allTranslations = Object.entries(translations).map(
-              ([key, value]) => ({
-                key,
-                value,
-              }),
-            );
 
-            allTranslations.forEach((translation) => {
+            const filteredTranslations: TranslationForm[] = Object.entries(
-              if (translation.key === formattedKey) {
+              translations,
-                filteredTranslations.push({
+            )
+              .filter(([key]) => key === formattedKey)
+              .map(([_, value]) => ({
                 locale: selectedLocale,
-                  value: translation.value,
+                value,
-                });
+              }));
-              }
-            });
 
-            const translationToSave: any = {
+            if (filteredTranslations.length > 0) {
+              translationsToSave.push({
                 key: formattedKey,
                 translations: filteredTranslations,
-            };
+              });
-
+            }
-            translationsToSave.push(translationToSave);
           } catch (error) {
-            console.error(
+            addError("errorSavingTranslations", error);
-              `Error fetching translations for ${selectedLocale}:`,
-              error,
-            );
           }
         }),
       );
+
       return translationsToSave;
     },
-    (translationsToSaveData) => {
+    (translationsToSave) => {
-      setTranslationsData(() => ({
+      if (translationsToSave && translationsToSave.length > 0) {
-        key: translationsToSaveData[0].key,
+        const allTranslations = translationsToSave.flatMap(
-        translations: translationsToSaveData.flatMap(
+          (translation) => translation.translations,
-          (translationData) => translationData.translations,
+        );
-        ),
+
-      }));
+        setTranslationsData({
+          key: translationsToSave[0].key,
+          translations: allTranslations,
+        });
+
+        form.setValue("translations", allTranslations);
+      }
     },
-    [combinedLocales],
+    [combinedLocales, realmName, form],
   );
 
   useFetch(
@@ -282,8 +280,9 @@ export default function NewAttributeSettings() {
 
   const saveTranslations = async () => {
     try {
-      const nonEmptyTranslations = translationsData.translations.map(
+      const nonEmptyTranslations = translationsData.translations
-        async (translation) => {
+        .filter((translation) => translation.value.trim() !== "")
+        .map(async (translation) => {
           try {
             await adminClient.realms.addLocalization(
               {
@@ -293,11 +292,11 @@ export default function NewAttributeSettings() {
               },
               translation.value,
             );
-          } catch {
+          } catch (error) {
-            console.error(`Error saving translation for ${translation.locale}`);
+            addError(t("errorSavingTranslations"), error);
           }
-        },
+        });
-      );
+
       await Promise.all(nonEmptyTranslations);
     } catch (error) {
       console.error(`Error saving translations: ${error}`);
@@ -377,7 +376,7 @@ export default function NewAttributeSettings() {
         (translation) => translation.value.trim() !== "",
       );
 
-      if (!hasNonEmptyTranslations && !formFields.displayName) {
+      if (!hasNonEmptyTranslations) {
         addError("createAttributeError", t("translationError"));
         return;
       }

js/apps/admin-ui/src/realm-settings/user-profile/AttributesGroupForm.tsx

@@ -1,3 +1,4 @@
+/* eslint-disable @typescript-eslint/no-empty-function */
 import type { UserProfileGroup } from "@keycloak/keycloak-admin-client/lib/defs/userProfileMetadata";
 import {
   HelpItem,
@@ -17,7 +18,6 @@ import {
   TextContent,
   TextInput,
 } from "@patternfly/react-core";
-import { GlobeRouteIcon } from "@patternfly/react-icons";
 import { useEffect, useMemo, useState } from "react";
 import {
   FormProvider,
@@ -27,7 +27,6 @@ import {
 } from "react-hook-form";
 import { useTranslation } from "react-i18next";
 import { Link, useNavigate, useParams } from "react-router-dom";
-import { useAdminClient } from "../../admin-client";
 import { FormAccess } from "../../components/form/FormAccess";
 import { KeyValueInput } from "../../components/key-value-form/KeyValueInput";
 import type { KeyValueType } from "../../components/key-value-form/key-value-convert";
@@ -44,6 +43,8 @@ import {
   AddTranslationsDialog,
   TranslationsType,
 } from "./attribute/AddTranslationsDialog";
+import { GlobeRouteIcon } from "@patternfly/react-icons";
+import { useAdminClient } from "../../admin-client";
 
 function parseAnnotations(input: Record<string, unknown>): KeyValueType[] {
   return Object.entries(input).reduce((p, [key, value]) => {
@@ -77,11 +78,6 @@ type Translations = {
   translations: TranslationForm[];
 };
 
-type TranslationsSets = {
-  displayHeader: Translations;
-  displayDescription: Translations;
-};
-
 const defaultValues: FormFields = {
   annotations: [],
   displayDescription: "",
@@ -112,20 +108,21 @@ export default function AttributesGroupForm() {
   const [addTranslationsModalOpen, toggleModal] = useToggle();
   const regexPattern = /\$\{([^}]+)\}/;
   const [type, setType] = useState<TranslationsType>();
-  const [translationsData, setTranslationsData] = useState<TranslationsSets>({
+
+  const [translationsData, setTranslationsData] = useState({
     displayHeader: {
       key: "",
-      translations: [],
+      translations: [] as TranslationForm[],
     },
     displayDescription: {
       key: "",
-      translations: [],
+      translations: [] as TranslationForm[],
     },
   });
 
   const matchingGroup = useMemo(
     () => config?.groups?.find(({ name }) => name === params.name),
-    [config?.groups],
+    [config?.groups, params.name],
   );
 
   useEffect(() => {
@@ -138,120 +135,98 @@ export default function AttributesGroupForm() {
       : [];
 
     form.reset({ ...defaultValues, ...matchingGroup, annotations });
-  }, [matchingGroup]);
+  }, [matchingGroup, form]);
 
   useEffect(() => {
     form.setValue(
       "displayHeader",
-      matchingGroup
+      matchingGroup?.displayHeader || generatedAttributesGroupDisplayName || "",
-        ? matchingGroup.displayHeader!
-        : generatedAttributesGroupDisplayName,
     );
     form.setValue(
       "displayDescription",
-      matchingGroup
+      matchingGroup?.displayDescription ||
-        ? matchingGroup.displayDescription!
+        generatedAttributesGroupDisplayDescription ||
-        : generatedAttributesGroupDisplayDescription,
+        "",
     );
   }, [
     generatedAttributesGroupDisplayName,
     generatedAttributesGroupDisplayDescription,
+    matchingGroup,
+    form,
   ]);
 
   useFetch(
     async () => {
       const translationsToSaveDisplayHeader: Translations[] = [];
       const translationsToSaveDisplayDescription: Translations[] = [];
-      const formData = form.getValues();
 
-      const translationsResults = await Promise.all(
+      await Promise.all(
-        combinedLocales.map(async (selectedLocale) => {
+        combinedLocales.map(async (locale: string) => {
           try {
             const translations =
               await adminClient.realms.getRealmLocalizationTexts({
                 realm: realmName,
-                selectedLocale,
+                selectedLocale: locale,
               });
 
-            const formattedDisplayHeaderKey = formData.displayHeader?.substring(
+            const formData = form.getValues();
-              2,
+            const extractKey = (value: string | undefined) => {
-              formData.displayHeader.length - 1,
+              const match = value?.match(/\$\{(.*?)\}/);
-            );
+              return match ? match[1] : "";
-            const formattedDisplayDescriptionKey =
-              formData.displayDescription?.substring(
-                2,
-                formData.displayDescription.length - 1,
-              );
-
-            return {
-              locale: selectedLocale,
-              headerTranslation: translations[formattedDisplayHeaderKey] ?? "",
-              descriptionTranslation:
-                translations[formattedDisplayDescriptionKey] ?? "",
             };
+
+            const displayHeaderKey = extractKey(formData.displayHeader) || "";
+            const displayDescriptionKey =
+              extractKey(formData.displayDescription) || "";
+
+            const headerTranslation = translations[displayHeaderKey] || "";
+            const descriptionTranslation =
+              translations[displayDescriptionKey] || "";
+
+            if (headerTranslation) {
+              translationsToSaveDisplayHeader.push({
+                key: displayHeaderKey,
+                translations: [{ locale, value: headerTranslation }],
+              });
+            }
+
+            if (descriptionTranslation) {
+              translationsToSaveDisplayDescription.push({
+                key: displayDescriptionKey,
+                translations: [{ locale, value: descriptionTranslation }],
+              });
+            }
           } catch (error) {
-            console.error(
+            console.error(`Error fetching translations for ${locale}:`, error);
-              `Error fetching translations for ${selectedLocale}:`,
-              error,
-            );
-            return null;
           }
         }),
       );
 
-      translationsResults.forEach((translationsResult) => {
+      const translationsDataNew = {
-        if (translationsResult) {
-          const { locale, headerTranslation, descriptionTranslation } =
-            translationsResult;
-          translationsToSaveDisplayHeader.push({
-            key: formData.displayHeader?.substring(
-              2,
-              formData.displayHeader.length - 1,
-            ),
-            translations: [
-              {
-                locale,
-                value: headerTranslation,
-              },
-            ],
-          });
-          translationsToSaveDisplayDescription.push({
-            key: formData.displayDescription?.substring(
-              2,
-              formData.displayDescription.length - 1,
-            ),
-            translations: [
-              {
-                locale,
-                value: descriptionTranslation,
-              },
-            ],
-          });
-        }
-      });
-
-      return {
-        translationsToSaveDisplayHeader,
-        translationsToSaveDisplayDescription,
-      };
-    },
-    (data) => {
-      setTranslationsData({
         displayHeader: {
-          key: data.translationsToSaveDisplayHeader[0].key,
+          key:
-          translations: data.translationsToSaveDisplayHeader.flatMap(
+            translationsToSaveDisplayHeader.length > 0
-            (translationData) => translationData.translations,
+              ? translationsToSaveDisplayHeader[0].key
+              : "",
+          translations: translationsToSaveDisplayHeader.flatMap(
+            (data) => data.translations,
           ),
         },
         displayDescription: {
-          key: data.translationsToSaveDisplayDescription[0].key,
+          key:
-          translations: data.translationsToSaveDisplayDescription.flatMap(
+            translationsToSaveDisplayDescription.length > 0
-            (translationData) => translationData.translations,
+              ? translationsToSaveDisplayDescription[0].key
+              : "",
+          translations: translationsToSaveDisplayDescription.flatMap(
+            (data) => data.translations,
           ),
         },
-      });
+      };
+
+      setTranslationsData(translationsDataNew);
     },
-    [combinedLocales],
+    () => {},
+    [combinedLocales, realmName, form],
   );
 
   const saveTranslations = async () => {
@@ -278,10 +253,11 @@ export default function AttributesGroupForm() {
 
     try {
       if (
-        translationsData.displayHeader &&
+        translationsData &&
         translationsData.displayHeader.translations.length > 0
       ) {
         for (const translation of translationsData.displayHeader.translations) {
+          if (translation.locale && translation.value) {
             await addLocalization(
               translationsData.displayHeader.key,
               translation.locale,
@@ -289,13 +265,15 @@ export default function AttributesGroupForm() {
             );
           }
         }
+      }
 
       if (
-        translationsData.displayDescription &&
+        translationsData &&
         translationsData.displayDescription.translations.length > 0
       ) {
         for (const translation of translationsData.displayDescription
           .translations) {
+          if (translation.locale && translation.value) {
             await addLocalization(
               translationsData.displayDescription.key,
               translation.locale,
@@ -303,6 +281,7 @@ export default function AttributesGroupForm() {
             );
           }
         }
+      }
     } catch (error) {
       console.error(`Error while processing translations: ${error}`);
     }
@@ -331,7 +310,6 @@ export default function AttributesGroupForm() {
         translationsData.displayHeader.translations.some(
           (translation) => translation.value.trim() !== "",
         );
-
       const hasNonEmptyDisplayDescriptionTranslations =
         translationsData.displayDescription.translations.some(
           (translation) => translation.value.trim() !== "",

js/apps/admin-ui/src/realm-settings/user-profile/attribute/AddTranslationsDialog.tsx

@@ -142,10 +142,13 @@ export const AddTranslationsDialog = ({
   useEffect(() => {
     combinedLocales.forEach((locale, rowIndex) => {
       setValue(`translations.${rowIndex}.locale`, locale);
+
+      const translationExists =
+        translations.translations[rowIndex] !== undefined;
       setValue(
         `translations.${rowIndex}.value`,
-        translations.translations.length > 0
+        translationExists
-          ? translations.translations[rowIndex].value
+          ? translations.translations[rowIndex]?.value
           : defaultTranslations[locale] || "",
       );
     });