Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Wenn Sie Anpassungen in Microsoft Dataverse erstellen, können Sie mehrere Sprachen mithilfe von Bezeichnungen unterstützen.
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 mit Hilfe der Klasse Label (Label ComplexType oder Label) implementiert, die Sprachpakete unterstützt. Zeichenfolgen, die Benutzern angezeigt werden, z. B. Anzeigenamen oder Auswahlmöglichkeiten, können in mehreren Sprachen gespeichert werden. Benutzer können auswählen, welche Sprache in Formularen und Ansichten in Dataverse angezeigt werden soll.
In der folgenden Tabelle sind alle Tabellendefinitionen aufgeführt, die das Label verwenden.
| Tabellendefinitionseigenschaft | Description |
|---|---|
AttributeMetadata.Description |
Beschreibung für eine Spalte. |
AttributeMetadata.DisplayName |
Anzeigename für eine Spalte. |
EntityMetadata.Description |
Beschreibung für eine Tabelle. |
EntityMetadata.DisplayCollectionName |
Pluraler Anzeigename für eine Tabelle. |
EntityMetadata.DisplayName |
Anzeigename für eine Tabelle. |
AssociatedMenuConfiguration.Label |
Bezeichnung, die für eine Tabelle in einer Tabellenbeziehung verwendet wird. |
OptionMetadata.Label |
Bezeichnung, die für einen Wert in einer Auswahl-, Zustands- oder Statusspalte 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 Zeichenfolge 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 basierend auf dem Importauftrag auf die gleiche Weise generieren wie beim Importieren einer Lösung. Weitere Informationen finden Sie unter Importieren einer nicht verwalteten Lösung.
| Nachricht | Web-API-Vorgang | .NET SDK-Klasse |
|---|---|---|
ExportTranslation
Exportiert alle Übersetzungen für eine bestimmte Lösung in eine komprimierte Datei. |
ExportTranslation-Aktion | ExportTranslationRequest |
ImportTranslation
Importiert alle Übersetzungen aus einer komprimierten Datei. |
ImportTranslation-Aktion | ImportTranslationRequest |
RetrieveFormattedImportJobResults
Ruft die Ergebnisse eines ImportJob als XML-Dokument ab, das mit Office Excel geöffnet werden soll. |
RetrieveFormattedImportJobResults-Funktion | RetrieveFormattedImportJobResultsRequest |
RetrieveLocLabels
Ruft die lokalisierten Bezeichnungen für die angegebene Spalte ab. |
RetrieveLocLabels-Funktion | RetrieveLocLabelsRequest |
SetLocLabels
Legt die lokalisierten Beschriftungen für die angegebene Spalte fest. |
SetLocLabels-Aktion | SetLocLabelsRequest |
Anpassen von Etiketten in der Basissprache
Die Anpassungstools bieten Möglichkeiten zum Bearbeiten von Anzeigenamen, und Sie können diese Eigenschaften programmgesteuert anpassen. Sie können Nachrichten auch 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 "Bearbeiten von Systemtabellenmeldungen (Vorschau)".
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 Webanwendung oder mithilfe der ExportTranslation Nachricht (ExportTranslation Action oder ExportTranslationRequest Klasse) exportieren.
Exportierter Text wird als komprimierte Datei gespeichert, die eine CrmTranslations.xml datei enthält, die Sie mit Office Excel öffnen. 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 übersetzt haben, können Sie die übersetzten Textzeichenfolgen in der Webanwendung mithilfe der ImportTranslation Nachricht (ImportTranslation Action oder ImportTranslationRequest Klasse) importieren. Die datei, die Sie importieren, muss eine komprimierte Datei sein, die die CrmTranslations.xml Datei und die [Content_Types].xml Datei enthält, 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 können Sie mehrere Sprachpakete auf einem Server installieren und dem Benutzer das Auswählen eines Sprachpakets 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 Nachrichten mit der Methode IOrganizationService.Execute.
| Nachricht | Web-API-Vorgang | .NET SDK-Klasse |
|---|---|---|
DeprovisionLanguage
Enthält die Daten, die zur Deprovisionierung einer Sprache erforderlich sind. |
DeprovisionLanguage-Aktion | DeprovisionLanguageRequest |
ProvisionLanguage
Enthält die daten, die zum Bereitstellen einer neuen Sprache erforderlich sind. |
ProvisionLanguage-Aktion | ProvisionLanguageRequest |
RetrieveAvailableLanguages
Ruft die Liste der verfügbaren Sprachen ab. |
RetrieveAvailableLanguages-Funktion | RetrieveAvailableLanguagesRequest |
RetrieveDeprovisionedLanguages
Ruft die Liste der auf dem Server installierten Sprachpakete ab, die deaktiviert wurden. |
RetrieveDeprovisionedLanguages-Funktion | RetrieveDeprovisionedLanguagesRequest |
RetrieveInstalledLanguagePacks
Enthält die daten, die zum Abrufen der Liste der auf dem Server installierten Sprachpakete erforderlich sind. |
RetrieveInstalledLanguagePacks-Funktion | RetrieveInstalledLanguagePacksRequest |
RetrieveInstalledLanguagePackVersion
Enthält die zum Abrufen der Version eines installierten Sprachpakets erforderlichen Daten. |
RetrieveLicenseInfo-Funktion | RetrieveInstalledLanguagePackVersionRequest |
RetrieveProvisionedLanguages
Ruft die Liste der auf dem Server installierten Sprachpakete ab, die aktiviert sind. |
RetrieveProvisionedLanguages-Funktion | RetrieveProvisionedLanguagesRequest |
RetrieveProvisionedLanguagePackVersion
Ruft die Version der auf dem Server installierten Sprachpakete ab. |
RetrieveProvisionedLanguagePackVersion-Funktion | RetrieveProvisionedLanguagePackVersionRequest |
Siehe auch
Anpassen von Tabellendefinitionen
AttributeMetadata
EntityMetadata
OptionMetadata