Personalizzare le etichette per il supporto di più lingue
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Quando si creano personalizzazioni di Microsoft Dynamics 365, è possibile supportare più lingue utilizzano le etichette.
In questo argomento
Utilizzare le etichette
Messaggi da utilizzare con le etichette
Personalizzare le etichette nella lingua di base
Tradurre un'entità personalizzata e il testo dell'attributo
Gestire le lingue per l'organizzazione
Utilizzare le etichette
Le etichette sono stringhe localizzate visualizzate agli utenti nelle applicazioni client. Vengono implementate tramite la classe Label, che supporta i Language Pack. Le stringhe visualizzate agli utenti, ad esempio i nomi visualizzati delle entità o le opzioni contenute in un set di opzioni, possono essere archiviati in più lingue. Gli utenti possono scegliere la lingua in cui visualizzare i moduli e le visualizzazioni in Microsoft Dynamics 365.
Nella tabella seguente sono elencati tutti i metadati utilizzati dalla classe Label.
Proprietà dei metadati |
Descrizione |
|---|---|
Descrizione di un attributo. |
|
Nome visualizzato di un attributo. |
|
Descrizione di un'entità. |
|
Nome visualizzato plurale di un'entità. |
|
Nome visualizzato di un'entità. |
|
Etichetta utilizzata per un'entità in una relazione di entità. |
|
Etichetta utilizzata in un'opzione in un elenco a discesa, stato o attributo di stato. |
La classe Label può archiviare una stringa per ogni lingua installata. Questa matrice è la proprietà LocalizedLabels. Deve essere sempre presente un'etichetta archiviata per la lingua di base. Le etichette per altre lingue possono essere null. Se l'utente desidera visualizzare l'interfaccia utente in una lingua e un'etichetta non dispone di una stringa per tale lingua, viene utilizzata l'etichetta per la lingua di base.
È possibile utilizzare la proprietà UserLocalizedLabel per recuperare l'etichetta della lingua scelta dall'utente.
Messaggi da utilizzare con le etichette
Nella tabella seguente sono elencati i messaggi che è possibile utilizzare con le etichette localizzate per supportare più lingue. Se si importano le traduzioni è possibile generare un report basato sul processo di importazione nello stesso modo in cui è possibile farlo per importare una soluzione. Per ulteriori informazioni, vedere Installare o aggiornare una soluzione.
Messaggio |
Descrizione |
|---|---|
Esporta tutte le traduzioni per una soluzione specifica in un file compresso. |
|
Importa tutte le traduzioni da un file compresso. |
|
Recupera i risultati di un ImportJob come documento XML progettato per essere aperto tramite Microsoft Office Excel. |
|
Recupera le etichette localizzate per l'attributo specificato. |
|
Imposta le etichette localizzate per l'attributo specificato. |
Personalizzare le etichette nella lingua di base
Gli strumenti di personalizzazione offrono modi per modificare i nomi visualizzati delle entità, consentono inoltre di personalizzare queste proprietà a livello di programmazione. È inoltre possibile modificare i messaggi delle entità. Tuttavia, non viene esposto ogni messaggio. Un altro modo per individuare e personalizzare il testo utilizzato nell'applicazione è esportare le traduzioni, modificare i valori per la lingua di base e importare nuovamente le traduzioni. Sebbene questo non sia lo scopo previsto di questa funzionalità questa è un'alternativa supportata per identificare e personalizzare il testo utilizzato nell'applicazione. Per ulteriori informazioni, vedere Modificare i messaggi per un'entità.
Tradurre un'entità personalizzata e il testo dell'attributo
Poiché è possibile eseguire personalizzazioni nell'applicazione mediante la lingua di base, se si desidera fornire le etichette localizzate per queste personalizzazioni, è necessario esportare il testo delle etichette in modo da poterle localizzare per tutte le altre lingue abilitate per l'organizzazione.
Esportare il testo personalizzato per la traduzione
È possibile esportare le traduzioni nell'applicazione Web o utilizzando messaggio ExportTranslationRequest.
Il testo esportato viene salvato come un file compresso contenente un CrmTranslations.xml che verrà aperto tramite Microsoft Office Excel. È possibile inviare questo file a un traduttore esperto, a un'agenzia di traduzione o a una società di localizzazione.
Per ulteriori informazioni, vedere Schemi di riferimento di Office 2003 XML.
Importare testo tradotto
Dopo aver esportato e tradotto l'entità personalizzata o il testo dell'attributo è possibile importare le stringhe di testo tradotte nell'applicazione Web utilizzando il messaggio ImportTranslationRequest. Il file importato deve essere un file compresso contenente il file CrmTranslations.xml e il file [Content_Types].xml proprio come sono stati esportati.
Al termine dell'importazione, il testo personalizzato verrà visualizzato per gli utenti che lavorano nelle lingue per cui sono disponibili traduzioni.
Nota
Microsoft Dynamics 365 non supporta l'importazione di testo tradotto con una lunghezza maggiore di 500 caratteri. Il processo di importazione avrà esito negativo se il file delle traduzioni include elementi più lunghi di 500 caratteri. In caso di esito negativo del processo di importazione, controllare la riga del file che ha causato l'errore, ridurre il numero di caratteri e riprovare l'importazione.
Dato che la personalizzazione è supportata solo nella lingua di base, è possibile che si lavori in Microsoft Dynamics 365 con la lingua di base impostata come preferenza per la lingua. Per verificare che il testo tradotto venga visualizzato, modificare la preferenza per la lingua dell'interfaccia utente di Microsoft Dynamics 365. Per eseguire ulteriori personalizzazioni, tornare alla lingua di base.
Gestire le lingue per l'organizzazione
Microsoft Dynamics 365 (online e locale) consente di installare più Language Pack in un server permettendo all'utente di selezionare il Language Pack desiderato. Per ulteriori informazioni su come installare i Language Pack, vedere Guida all'installazione, TechNet: Installare e abilitare un Language Pack. Questa sezione contiene informazioni sui messaggi utilizzati per gestire le lingue installate per l'organizzazione.
Nella tabella seguente sono elencati i messaggi che è possibile utilizzare con i Language Pack. Utilizzare questi messaggi con il metodo Execute.
Messaggio |
Descrizione |
|---|---|
Contiene i dati necessari per il deprovisioning di una lingua |
|
Contiene i dati necessari per il deprovisioning di una nuova lingua. |
|
Recupera l'elenco delle lingue disponibili. |
|
Recupera l'elenco dei Language Pack installati nel server che sono stati disabilitati. |
|
Contiene i dati necessari per recuperare l'elenco dei Language Pack installati nel server. |
|
Contiene i dati necessari per recuperare la versione dei Language Pack installati. |
|
Recupera l'elenco dei Language Pack installati nel server che sono abilitati. |
|
Recupera la versione dei Language Pack installati nel server. |
Vedere anche
Utilizzare il servizio Organizzazione con i metadati di Dynamics 365
Personalizzare le applicazioni di Microsoft Dynamics 365
Modificare i messaggi per un'entità
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright