Anpassen von Etiketten, um mehrere Sprachen zu unterstützen

Artikel
05/09/2023

Wenn Sie Anpassungen in Microsoft Dataverse erstellen, können Sie mehrere Sprachen unterstützen, indem Sie Etiketten verwenden.

Verwenden von Etiketten

Microsoft.Xrm.Sdk.dll	Web-API
Label Klasse	Label ComplexType
LocalizedLabel Klasse	LocalizedLabel ComplexType

Etiketten sind lokalisierte Zeichenfolgen, die Benutzern in den Client-Anwendungen angezeigt werden. Sie werden implementiert durch Verwendung der Label (Label ComplexType oder Label-Klasse), die Sprachpakete unterstützt. Zeichenketten, die dem Benutzer angezeigt werden, wie z. B. Anzeigenamen oder Auswahlmöglichkeiten, können in mehreren Sprachen gespeichert werden. Benutzer können die Sprache auswählen, in der Formulare und Ansichten in Dataverse angezeigt werden.

In der folgenden Tabelle sind alle Tabellendefinitionen aufgeführt, die die Label verwenden.

Eigenschaft der Tabellendefinitionen	Beschreibung
AttributeMetadata.Description	Beschreibung für eine Spalte.
AttributeMetadata.DisplayName	Anzeigename für eine Spalte.
EntityMetadata.Description	Beschreibung für eine Tabelle.
EntityMetadata.DisplayCollectionName	Plural-Anzeigename für eine Tabelle.
EntityMetadata.DisplayName	Anzeigename für eine Tabelle.
AssociatedMenuConfiguration.Label	Label, das für eine Tabelle in einer Tabellenbeziehung verwendet wird.
OptionMetadata.Label	Label, das für einen Wert in einer Auswahl-, Status- oder Status-Spalte verwendet wird.

Die Label kann eine Zeichenfolge für jede installierte Sprache speichern. Dieses Array ist die LocalizedLabels-Eigenschaft. Es muss immer ein Etikett für die Basissprache gespeichert sein. Die Etiketten für die anderen Sprachen können null sein. Wenn der Benutzer die Benutzeroberfläche in einer Sprache anzeigen möchte und ein Etikett keine Zeichenfpölge für diese Sprache hat, wird das Etikett für die Basissprache verwendet.

Sie können die UserLocalizedLabel-Eigenschaft verwenden, um das Etikett für die von dem Benutzer ausgewählte Sprache abzurufen.

Mit Etiketten zu verwendende Meldungen

In der folgenden Tabelle werden die Meldungen aufgeführt, mit denen Sie mit lokalisierten Etiketten arbeiten können, um mehrere Sprachen zu unterstützen. Beim Importieren von Übersetzungen können Sie einen Bericht auf der Grundlage des Importjobs wie beim Importieren einer Lösung generieren. Weitere Informationen finden Sie unter Importieren einer nicht verwalteten Lösung.

Nachricht	Web-API-Vorgang	SDK-Assembly
`ExportTranslation` Exportiert alle Übersetzungen für eine bestimmte Lösung in eine komprimierte Datei.	ExportTranslation Action	ExportTranslationRequest
`ImportTranslation` Importiert alle Übersetzungen aus einer komprimierten Datei.	ImportTranslation Action	ImportTranslationRequest
`RetrieveFormattedImportJobResults` Ruft die Ergebnisse eines ImportJob als XML-Dokument ab, das dafür entwickelt ist, mit Office Excel geöffnet zu werden.	RetrieveFormattedImportJobResults Function	RetrieveFormattedImportJobResultsRequest
`RetrieveLocLabels` Ruft die lokalisierten Labels für die angegebene Spalte ab.	RetrieveLocLabels Function	RetrieveLocLabelsRequest
`SetLocLabels` Legt die lokalisierten Labels für die angegebene Spalte fest.	SetLocLabels Action	SetLocLabelsRequest

Anpassen von Etiketten in der Basissprache

Die Tools für die Anpassung bieten Möglichkeiten zur Bearbeitung von Anzeigenamen und Sie können diese Eigenschaften programmatisch anpassen. Sie können auch Nachrichten bearbeiten. Es wird aber nicht jede Meldung angezeigt. Eine weitere Methode, Text in der Anwendung zu suchen und anzupassen besteht darin, die Übersetzungen zu exportieren, die Werte für die Basissprache zu bearbeiten und die Übersetzungen wieder zu importieren. Obwohl dies nicht der eigentliche Verwendungszweck dieser Funktion ist, ist dies eine unterstützte Methode zur Identifizierung und Anpassung von in der Anwendung verwendetem Text. Weitere Informationen finden Sie unter Ändern von Nachrichten für eine Tabelle.

Benutzerdefinierte Texte für Tabellen und Spalten übersetzen

Da Sie Anpassungen in der Anwendung nur unter Verwendung der Basissprache vornehmen können, gilt: Wenn Sie für diese Anpassungen lokalisierte Bezeichnungen und Anzeigezeichenfolgen zur Verfügung stellen möchten, müssen Sie den Text der Bezeichnungen exportieren, damit sie für andere Sprachen lokalisiert werden können, die für die Organisation aktiviert sind.

Exportieren von angepasstem Text zur Übersetzung

Sie können die Übersetzungen in der Web-Anwendung oder über die Nachricht ExportTranslation (Klasse ExportTranslation Action oder ExportTranslationRequest) exportieren.

Der exportierte Text wird als komprimierte Datei gespeichert, die ein CrmTranslations.xml enthält, das Sie mit Office Excel öffnen können. Sie können diese Datei an einen Sprachexperten, an eine Übersetzungsagentur oder an ein Lokalisierungsunternehmen senden.

Importieren von übersetztem Text

Nachdem Sie den angepassten Tabellen- oder Spaltentext exportiert und übersetzen lassen haben, können Sie die übersetzten Textstrings in der Web-Anwendung importieren, indem Sie die ImportTranslation-Nachricht (ImportTranslation Action- oder ImportTranslationRequest-Klasse) verwenden. Die Datei, die Sie importieren, muss eine komprimierte Datei sein, in der die CrmTranslations.xml und die [Content_Types].xml Datei im Stammverzeichnis enthalten ist, genauso wie sie exportiert wurden.

Nach dem Importieren der fertig gestellten Übersetzungen wird benutzerdefinierter Text für Benutzer angezeigt, die in den Sprachen arbeiten, in die der Text übersetzt wurde.

Hinweis

Dataverse kann übersetzten Text mit mehr als 500 Zeichen nicht importieren. Wenn Elemente in Ihrer Übersetzung eine Länge von 500 Zeichen überschreiten, tritt beim Importvorgang ein Fehler auf. Überprüfen Sie bei Auftreten eines Importfehlers die Zeile in der Datei, durch die der Fehler verursacht wurde, verringern Sie die Zeichenanzahl, und führen Sie einen erneuten Importvorgang aus.

Da die Anpassung nur in der Ausgangssprache unterstützt wird, können Sie Dataverse so verwenden, dass die Ausgangssprache auf Ihre Spracheinstellung festgelegt ist. Wenn Sie überprüfen möchten, ob der übersetzte Text angezeigt wird, muss die Spracheinstellung für die Benutzeroberfläche von Dataverse geändert werden. Zum Ausführen weiterer Anpassungen muss die Spracheinstellung dann wieder auf die Ausgangssprache festgelegt werden.

Verwalten von Sprachen für Ihre Organisation

Mit Dataverse wird es Ihnen ermöglicht, mehrere Language Packs auf einem Server zu speichern und Benutzern die Auswahl eines Language Packs zu ermöglichen. Informationen zum Installieren der Language Packs finden Sie in unter Aktivieren von Sprachen. Dieser Abschnitt enthält Informationen zu den Meldungen, mit denen die für Ihre Organisation installierten Sprachpakete verwaltet werden.

Die folgende Tabelle enthält die Meldungen, die Sie für die Arbeit mit Sprachpaketen verwenden. Verwenden Sie diese Meldungen mit der IOrganizationService.Execute-Methode. Methode verwenden.

Nachricht	Web-API-Vorgang	SDK-Assembly
`DeprovisionLanguage` Enthält die Daten, die nötig sind, um die Bereitstellung einer Sprache aufzuheben.	DeprovisionLanguage Action	DeprovisionLanguageRequest
`ProvisionLanguage` Enthält die Daten, die nötig sind, um eine Sprache bereitzustellen.	ProvisionLanguage Action	ProvisionLanguageRequest
`RetrieveAvailableLanguages` Ruft die Liste der verfügbaren Sprachen ab.	RetrieveAvailableLanguages Function	RetrieveAvailableLanguagesRequest
`RetrieveDeprovisionedLanguages` Ruft die Liste der auf dem Server installierten Sprachpakete ab, die deaktiviert wurden.	RetrieveDeprovisionedLanguages Function	RetrieveDeprovisionedLanguagesRequest
`RetrieveInstalledLanguagePacks` Enthält die Daten, die benötigt werden, um die Liste der auf dem Server installierten Sprachpakete abzurufen.	RetrieveInstalledLanguagePacks Function	RetrieveInstalledLanguagePacksRequest
`RetrieveInstalledLanguagePackVersion` Enthält die Daten, die benötigt werden, um die Version eines installierten Sprachpakets abzurufen.	RetrieveLicenseInfo Function	RetrieveInstalledLanguagePackVersionRequest
`RetrieveProvisionedLanguages` Ruft die Liste der auf dem Server installierten Sprachpakete ab, die aktiviert sind.	RetrieveProvisionedLanguages Function	RetrieveProvisionedLanguagesRequest
`RetrieveProvisionedLanguagePackVersion` Ruft die Version der auf dem Server installierten Sprachpakete ab.	RetrieveProvisionedLanguagePackVersion Function	RetrieveProvisionedLanguagePackVersionRequest

Siehe auch

Anpassen von Tabellendefinitionen
AttributeMetadata
EntityMetadata
OptionMetadata