Multilingual support
This page outlines multi-lingual support information.
Last updated
This page outlines multi-lingual support information.
Last updated
POST
<Cinchy-URL>/API/Translate
Pass in a list of literal GUIDs, along with a language and region. If translations are found in that language, they will be returned.
Name | Type | Description |
---|
If the translation exists in the language and region specified, it will be returned.
If the translation exists in the language but not the specified region, it will still be translated and returned.
If the GUID exists but it's not available in the specified language, the default text in the Literals table will return.
If the GUID doesn't exist or you don't have permission to it, it will return the GUID back as the translation.
Cinchy has three tables to provide language support.
[Cinchy].[Literal Groups]
[Cinchy].[Literals]
[Cinchy].[Literal Translations].
This table can optionally be used to group the translations. The default Cinchy strings belong to the Cinchy literal group. We recommend you create one literal group per applet or UI so you can retrieve the full list of GUIDs required for that page/applet easily.
This table defines all the strings that you want to translate.
String that displays if no translation is found for the language specified.
GUID used to refer to the literal. A UUID will be generated by default, but can be overrode using the GUID Override field to something more human-readable.
Use this to group your strings so they can be easily retrieved. Note that this is a multi-select so you can use a single literal for multiple applets (including using the default Cinchy literals and translations for custom applets).
This is the table where the translations are stored.
This is the translated string that's returned.
This is the literal the translation is for.
A language must be specified for a translation. Region can also be optionally specified for region specific words (ex. color vs colour).
debug | boolean | Defaults to false if not specified. Debug true will explain why that string was returned as the translation. |
region | string | Subtag from the Regions table. User's preferences will be used if not specified. |
guids | array | Array of strings. Guids from the Literals table. |
language | string | Subtag from the Languages table. User's preferences will be used if not specified. |