Anpassen von Etiketten, um mehrere Sprachen zu unterstützen

Wenn Sie Anpassungen in Dynamics 365 Customer Engagement (on-premises) erstellen, können Sie mehrere Sprachen unterstützen, indem Sie Etiketten verwenden.

Verwenden von Etiketten

Microsoft.Xrm.Sdk.dll	Internet-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 den Benutzern angezeigt werden, wie etwa Anzeigenamen von Entitäten oder Optionen in einem Optionssatz, können in mehreren Sprachen gespeichert werden. Benutzer können die Sprache auswählen, in der Formulare und Ansichten in Dynamics 365 Customer Engagement (on-premises) angezeigt werden.

Die folgende Tabelle enthält alle Metadaten, die die Label verwenden.

Metadateneigenschaft	Beschreibung
AttributeMetadata.Description	Beschreibung für ein Attribut.
AttributeMetadata.DisplayName	Anzeigename für ein Attribut.
EntityMetadata.Description	Beschreibung für eine Entität.
EntityMetadata.DisplayCollectionName	Plural-Anzeigename für eine Entität.
EntityMetadata.DisplayName	Anzeigename für eine Entität.
AssociatedMenuConfiguration.Label	Etikett für eine Entität in einer Entitätsbeziehung.
OptionMetadata.Label	Etikett für eine Option in einer Auswahlliste, einen Status oder ein Statusattribut.

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 Installieren oder Aktualisieren einer Lösung.

Meldung	Web-API-Vorgang	SDK-Assembly
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 ImportJobs als XML-Dokument ab, das mit Office Excel geöffnet werden kann.	RetrieveFormattedImportJobResults Funktion	RetrieveFormattedImportJobResultsRequest
RetrieveLocLabels Ruft die lokalisierten Labels für das angegebene Attribut ab.	RetrieveLocLabels Funktion	RetrieveLocLabelsRequest
SetLocLabels Legt die lokalisierten Labels für das angegebene Attribut fest.	SetLocLabels Aktion	SetLocLabelsRequest

Anpassen von Etiketten in der Basissprache

Die Anpassungstools bieten Methoden zur Bearbeitung der Anzeigenamen von Entitäten, und Sie können diese Eigenschaften programmgesteuert anpassen. Sie können auch Entitätsmeldungen anpassen. 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 zu Meldungen für die Nachrichten für eine Entität ändern.

Übersetzen des angepassten Entitäts- und Attributtexts

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 Nachricht ExportTranslation (ExportTranslation Aktion oder Klasse 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 Entitäten- oder Attributtext exportiert und übersetzen lassen haben, können Sie die übersetzten Textstrings in die Webanwendung importieren, indem Sie die Nachricht ImportTranslation verwenden (ImportTranslation Aktion oder Klasse ImportTranslationRequest). 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.

Notiz

In Dynamics 365 Customer Engagement (on-premises) kann übersetzter Text mit mehr als 500 Zeichen nicht importiert werden. 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 Dynamics 365 Customer Engagement (on-premises) 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 Dynamics 365 Customer Engagement (on-premises) 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

Dynamics 365 Customer Engagement (on-premises) macht es Ihnen ermöglicht, mehrere Sprachpakete auf einem Server zu speichern und Benutzern die Auswahl von Sprachpaketen 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 Nachrichten mit der Methode IOrganizationService.Execute.

Meldung	Web-API-Vorgang	SDK-Assembly
DeprovisionLanguage Enthält die für die Deprovisionierung einer Sprache erforderlichen Daten	DeprovisionLanguage Aktion	DeprovisionLanguageRequest
ProvisionLanguage Enthält die für die Bereitstellung einer neuen Sprache erforderlichen Daten.	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 Daten, die benötigt werden, um die Version eines installierten Sprachpakets abzurufen.	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

Erweitern des Metadatenmodells für Dynamics 365 Customer Engagement (on-premises)
AnpassenDynamics 365 Customer Engagement (on-premises)
Ändern der Meldungen für eine Entität
AttributeMetadata
EntityMetadata
OptionMetadata