Producteigenschapswaarden lokaliseren

Productnamen kunnen worden gelokaliseerd voor verschillende regio's. Met behulp van Dynamics 365 Sales kunt u gelokaliseerde labels opgeven voor bepaalde productkenmerken, zodat mensen de gelokaliseerde namen zien die overeenkomen met hun taalvoorkeuren. In dit artikel wordt uitgelegd hoe ontwikkelaars met deze functie kunnen communiceren. Voor stapsgewijze instructies voor het gebruik van deze functie in de toepassing raadpleegt u de vorige versiedocumentatie over productnamen en eigenschappen vertalen in meerdere talen.

Kenmerken die gelokaliseerde eigenschapswaarden ondersteunen

De volgende lijst bevat de kenmerken die lokaliseerbare waarden ondersteunen:

• Product.Name

• DynamicProperty.Name

• DynamicPropertyOptionSetItem.DynamicPropertyOptionName

• DynamicPropertyOptionSetItem.DynamicPropertyOptionDescription

  De StringAttributeMetadata en MemoAttributeMetadata klassen hebben een booleaanse eigenschap die alleen-lezen IsLocalizable is false voor alle kenmerken, behalve de vier in de voorgaande tabel.

Gelokaliseerde eigenschapswaarden ophalen

U hoeft niets anders te doen om de gelokaliseerde waarde op te halen die overeenkomt met de taalvoorkeur van de gebruiker. Als er een gelokaliseerde waarde bestaat voor de voorkeurstaal van de gebruiker, retourneert het systeem deze. Als er geen gelokaliseerde waarde bestaat, retourneert het systeem de waarde voor de basistaal van de organisatie. Dit gedrag behoudt achterwaartse compatibiliteit; alle code die momenteel gebruikmaakt van het kenmerk productnaam blijft werken met behulp van gelokaliseerde waarden. Als de lokalisatie van eigenschapswaarden onvolledig is, kunnen gebruikers gemengde taalwaarden zien.

Als u alle gelokaliseerde labels voor een specifiek lokaliseerbaar kenmerk wilt ophalen, gebruikt u het RetrieveLocLabelsRequest bericht.

Query's uitvoeren met behulp van gelokaliseerde waarden

Wanneer u query's uitvoert op tabellen met behulp van waarden voor gelokaliseerde kenmerken in voorwaarden, evalueert het systeem eerst de voorwaarden met behulp van uw voorkeurstaal. Als er geen gelokaliseerde waarden voor het kenmerk zijn, wordt de query teruggezet naar de basistaal. De queryresultaten voor gelokaliseerde kenmerkwaarden worden geretourneerd in uw voorkeurstaal als deze bestaan. Anders worden de resultaten geretourneerd in uw basistaal.

Records maken of bijwerken met lokaliseerbare kenmerken

Records met localiseerbare kenmerken zijn alleen ter inzage, tenzij uw voorkeurstaal de basistaal van de organisatie is. U kunt alleen records met gelokaliseerde eigenschapswaarden maken met behulp van de basistaal van de organisatie. Als u de basistaalwaarde voor een lokaliseerbaar attribuut bijwerkt, wordt de gelokaliseerde waarde voor dat attribuut niet gewijzigd, behalve als u de waarde voor de basistaal wist. Als u de basistaalwaarde instelt op null of een lege tekenreeks, worden alle gelokaliseerde waarden voor die eigenschap ook gewist.

Als u gelokaliseerde labels wilt toevoegen of bijwerken voor een specifiek lokaliseerbaar kenmerk, gebruikt u het SetLocLabelsRequest bericht of importeert u vertaalde waarden. Wijzigingen in de lokaliseerbare kenmerken worden weergegeven in de controlegeschiedenis voor de record. De taalcode-id (LCID) voor de gelokaliseerde waarde wordt weergegeven in de controlegeschiedenis.

Lokaliseerbare kenmerken vertalen

Het proces voor het lokaliseren van lokaliseerbare kenmerken is vergelijkbaar met het proces dat wordt gebruikt om gelokaliseerde oplossingslabels te vertalen. [! INCLUDE[proc_more_information]Aangepaste tabel- en kolomtekst vertalen

In tegenstelling tot het vertalen van metagegevenswaarden heeft de gebruiker die gelokaliseerde kenmerkwaarden exporteert en importeert, niet de beveiligingsrol van de systeembeheerder nodig. De beveiligingsrol van de verkoopmanager heeft de bevoegdheden die nodig zijn om lokaliseerbare attributen te vertalen. De persoon die gelokaliseerde eigenschapswaarden vertaalt, kan alleen de records exporteren die ze kunnen bekijken en kan alleen die records bijwerken waarvoor ze de bevoegdheden hebben om te updaten.

Als u lokaliseerbare kenmerken programmatisch wilt vertalen, moet u eerst de huidige gelokaliseerde labeldefinities exporteren met behulp van ExportFieldTranslationRequest. De ExportFieldTranslationResponse. ExportTranslationFile eigenschap bevat een byte[] voor een gecomprimeerd crmFieldTranslations.zip bestand met een [Content_types].xml bestand en een crmFieldTranslations.xml bestand dat kan worden geopend met behulp van Office Excel. Het werkblad Gelokaliseerde labels bevat een kolom met een LCID-waarde voor elke ingerichte taal voor de organisatie. De kolom met de basistaalwaarden wordt ingevuld en de kolommen voor elke ingerichte taal bevatten eventuele eerder gelokaliseerde waarden. Een vertaler kan dit bestand bewerken om gelokaliseerde labels te bieden voor de lokaliseerbare eigenschappen.

Nadat u het crmFieldTranslations.xml-bestand hebt bewerkt om gelokaliseerde labels op te geven, comprimeert u het bestand samen met het bestand [Content_types].xml en stelt u dat bestand in als de TranslationFile eigenschap van de ImportFieldTranslationRequest.

De waarden wijzigen die zijn opgenomen bij het exporteren van vertaalde eigenschapswaarden

Aanpasbare weergaven die zijn gekoppeld aan de tabellen die lokaliseerbare eigenschapswaarden ondersteunen, bepalen de waarden die zijn opgenomen in de geëxporteerde vertalingen. Alleen de producttabellen geven deze weergave weer in de gebruikersinterface voor aanpassing. Deze weergaven hebben de naam Export Field Translations. De volgende tabel bevat de SavedQueryId voor deze weergaven.

U kunt de FetchXml eigenschap van deze weergaven bewerken om alle kenmerkeigenschapswaarden te filteren die u niet wilt opnemen. U kunt bijvoorbeeld gearchiveerde records uitsluiten of alleen die records opnemen die na een bepaalde datum zijn bijgewerkt.

De voortgang van de importtaken voor veldvertaling monitoren

De systeemtaaktabellen bevatten de volgende weergaven om de voortgang van importtaken voor veldvertaling te controleren:

• Alle importtaken voor veldvertaling

• Veldvertalingsimport taken voltooid

• Importtaken voor veldvertaling in voortgang

• Importtaken voor mijn veldvertaling

• Importtaken voor veldvertaling niet gestart

  De volgende voorwaarden veroorzaken fouten bij het importeren van vertaaltaken:

Een taal verwijderen

Het systeem bewaart gelokaliseerde labels voor een taal die u verwijdert. Als u de taal opnieuw installeert, zijn de labels al aanwezig.

Verwante gegevens

Productcatalogus-tabellen
Aangepaste tabel- en kolomtekst Vertalenproductnamen en eigenschappen in meerdere talen