API-basierte Übersetzung

Whatfix ermöglicht es Ihnen, ein benutzerdefiniertes Übersetzungstool hinzuzufügen, das auf Ihren Anforderungen und internen Prozessen basiert.

Gehen Sie wie folgt vor, um ein Übersetzungstool basierend auf einer API-Anforderung hinzuzufügen:

2. Klicken Sie Übersetzungstools.

   

3. Klicken Sie auf der Seite Übersetzungstools auf das Symbol Hinzufügen.  
   

4. Geben Sie im Dialogfeld Integration mit benutzerdefiniertem Tool den Namen des Tools ein, und wählen Sie dann API als Übersetzungsmethode.
   

   
   

5. Klicken Sie Weiter.
   

Übersetzungstools verwenden Codes, um Sprachen zu unterscheiden und Inhalte zu übersetzen. Im Map Languages -Bereich konfigurieren Sie Sprachcodes, um die Ausgangs- und Zielsprache festzulegen. Sie müssen den in dem Übersetzungstool verwendeten Sprachcode mit der von Whatfix unterstützten Sprache abgleichen. Zum Beispiel Fr: fr (Französisch) und De: de (Deutsch).

Note:

• Sie müssen auch die Primäre Sprache zuordnen, die zur Erstellung von Whatfix-Inhalten verwendet wird. Andernfalls kann Whatfix den Inhalt nicht erkennen und für die Übersetzung senden.

• Sobald Sie das Tool integriert haben, fügen Sie Sprachen direkt von der Seite Übersetzungen in der Konfigurationen Sektion hinzu:
  

Nachdem Sie ein Übersetzungstool hinzugefügt haben, verwenden Sie die folgenden Schritte, um Sprachen hinzuzufügen und diese zwischen Whatfix und dem benutzerdefinierten Übersetzungstool abzugleichen:

1. Im Abschnitt Map Sprachen wählen Sie die Dropdown-Liste aus und wählen Sie die Eingabesprache.

2. Geben Sie den Sprachcode ein, der vom Übersetzungstool erkannt wird.

3. Um weitere Sprachcodes zuzuordnen, klicken Sie + Sprachcode hinzufügen.

4. Wählen Sie die Eingabesprache aus und fügen Sie den Sprachcode hinzu.  

Whatfix-Inhalt muss in ein Format umgewandelt werden, damit das Übersetzungswerkzeug die Daten empfangen und interpretieren kann. Dies umfasst die von und zur Sprache, Übersetzungsattribute und andere Details, um den Inhalt und die Felder im Inhalt, die eine Übersetzung erfordern, eindeutig zu identifizieren.

Was die folgenden Schritte angeht, um Whatfix-Daten in ein von dem Custom Tool akzeptiertes Format zu konvertieren:

Note:

Verweisen Sie auf Richtlinien für das Übersetzungstool, um mehr über Javascript und Anforderungsparameter beim Konfigurieren der Schritte für das Anpassen des Übersetzungstools zu erfahren.

1. Geben Sie im Abschnitt Whatfix-Daten in das von benutzerdefinierten Tool akzeptierte Format konvertieren eine Beschreibung (Optional) ein. Standardmäßig ist der Konfigurationstyp auf Javascript eingestellt.
   

2. Geben Sie im Skript-Feld den Javascript-Code ein, um Whatfix-Daten in ein Format zu konvertieren, das vom Benutzerdefinierten Übersetzungs Tool akzeptiert wird.
   

   Hier ist ein Beispiel für Javascript-Code für Microsoft Azure:
   

   funktion konvertiereZuMicrosoftÜbersetzungsEingabe(original_data) {
       var eingabeFürMs = [];
       für (var i = 0; i < original_data.length; i++) {
           var element = original_data[i];
           eingabeFürMs.push({
               "Text": element.value
           });
       }
       return eingabeFürMs;
   }
   
   var microsoftÜbersetzungsEingabe = konvertiereZuMicrosoftÜbersetzungsEingabe(attributes.translationStrings);
   // Hier sehen wir, dass die zu übersetzenden Strings durch attributes.translationStrings zugegriffen werden können
   output.data = microsoftÜbersetzungsEingabe;

   Note:

   Der JS-Skripteditor unterstützt nur Versionen vor ES6. Für weitere Informationen zur Spezifizierung von Variablen und Parametern sehen Sie Richtlinien für Übersetzungswerkzeuge.

   Der vorangehende Javascript-Code liest die translationStrings von Whatfix, formatiert sie in eine Struktur, die Microsoft akzeptiert, und speichert das Ergebnis in einer Variablen namens output.data für den nächsten Schritt.

Dieser Schritt ermöglicht es Ihnen, übersetzten Inhalt über einen API-Anforderungsantrag vom benutzerdefinierten Übersetzungswerkzeug anzufordern.

Gehen Sie wie folgt vor, um die API-Anfrage zu konfigurieren:

1. Geben Sie im Abschnitt Benutzerdefiniertes Tool konfigurieren eine Beschreibung ein (optional) und wählen Sie den Konfigurationstyp aus Wählen Sie entweder den Typ Javascript oder Anfrage.
   

   Note:

   Verweisen Sie auf Richtlinien für das Übersetzungstool, um mehr über Javascript und Anforderungsparameter beim Konfigurieren der Schritte für das Anpassungstool zur Übersetzung zu erfahren.

   
   Basierend auf der Konfiguration führen Sie die Schritte im folgenden Akkordeon aus:

   Anfrage

   A. Wählen Sie im Methoden-Dropdown POST.

   

   B. Geben Sie die URL ein.

   
   Beispiel-URL:

   https://api.cognitive.microsofttranslator.com/translate?api-version=3.0&to=${attributes.targetLocale}&from=${attributes.sourceLocale}&textType=html
   // Hier können wir sehen, dass wir für den Zugriff auf Quell und Zielgebietsschema attributes.sourceLocale und attributes.targetLocale verwenden
   

   C. Geben Sie die Parameterdetails im Headers-Feld an. Aus Sicherheitsgründen klicken Sie auf das Unhide-Symbol und fügen Sie dann die Header hinzu.  

   

   Hier ist ein Beispielcode für Header:

   {
       "Content-Type": "application/json",
       "Ocp-Apim-Subscription-Key": "YOUR_SUBSCRIPTION_KEY",
       "Ocp-Apim-Subscription-Region": "Global"
   }
   

   
   Note: Sie müssen den Subscription Key für das Anpassungstool angeben.

   Javascript

   Geben Sie im Script-Feld den Javascript-Code ein, um über das Anpassungsübersetzungs-Tool angeforderte Inhalte zu erhalten.

Zusätzliche Konfigurationen

In bestimmten Szenarien, basierend auf dem anpassbaren Werkzeug, könnten zusätzliche Konfigurationsschritte erforderlich sein, um Inhalt zu erhalten. Verwenden Sie das + Konfiguration hinzufügen -Symbol, um zusätzliche Schritte für die API-Anforderung bereitzustellen.

Ähnlich den oben hervorgehobenen Schritten, geben Sie die Einzelheiten im Konfiguration 2 Abschnitt ein:

Der von dem Übersetzungstool erhaltene Inhalt muss umstrukturiert werden, um mit dem Datenformat von Whatfix übereinzustimmen.

Verwenden Sie die folgenden Schritte, um das Format vom Benutzerdefinierten Übersetzungstool in das Whatfix Datenformat zu konvertieren:

1. Geben Sie im Abschnitt Format von benutzerdefiniertem Tool in Whatfix Daten eine Beschreibung (Optional) ein. Standardmäßig ist der Konfigurationstyp auf Javascript eingestellt.
   

   
   

2. Geben Sie in das Feld Skript den Javascript-Code ein, um das Format des angepassten Tools in das von Whatfix akzeptierte Format zu konvertieren.
   
   Hier ist ein Beispiel für Javascript-Code:

   function mergeTranslatedValues(original_data, translated_data) {
       var result = [];
       for (var i = 0; i < original_data.length; i++) {
           var originalItem = original_data[i];
           var translatedItem = translated_data[i];
           result.push({
               key: originalItem.key,
               value: translatedItem.translations[0].text
           });
       }
       return result;
   }
   
   var mergedData = mergeTranslatedValues(attributes.translationStrings, input);
   // Output der vorherigen Schritte kann durch die Verwendung des Eingabeschlüsselworts zugegriffen werden
   output.data = mergedData;
   

   Der vorangegangene Javascript-Code kombiniert den übersetzten Text von Microsoft Azure mit den Originalschlüsseln von Whatfix und kann den übersetzten Text korrekt anzeigen.

3. Klicken Sie Speichern .