{"_id":"579a634597803620008f9309","__v":1,"project":"55d535ca988e130d000b3f5c","version":{"_id":"55d535cb988e130d000b3f5f","__v":12,"project":"55d535ca988e130d000b3f5c","hasDoc":true,"hasReference":false,"createdAt":"2015-08-20T02:04:59.052Z","releaseDate":"2015-08-20T02:04:59.052Z","categories":["55d535cc988e130d000b3f60","55d6b238d2a8eb1900109eef","55d6b4f3250d7d0d004274cd","55d7967960fc730d00fc2852","55da9804e835f20d009fc5d0","55e75b1de06f4b190080dbfd","55e75b39e06f4b190080dbfe","55e75b7ae06f4b190080dbff","564f5a4e33082f0d001bb709","570fb64aa38d470e0060cbff","586d0dd89a854123001acd65","586d0e3b9a854123001acd66"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1.0"},"user":"573cc5a8f320ae29009dbdb6","category":{"_id":"55e75b7ae06f4b190080dbff","__v":10,"project":"55d535ca988e130d000b3f5c","version":"55d535cb988e130d000b3f5f","pages":["5637e17197666c0d008656a5","569591a4fcb1032d0089e037","569622eafe18811700c9c19b","5696c9588560a60d00e2c1e0","569709ca0b09a41900b2442b","5697129ac8ded91700307b77","5697190a59a6692d003fad6a","5697192969393517000c8280","569f11908f6d4b0d00f13bb2","56a0030b5b981c2b00383df0"],"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2015-09-02T20:26:34.258Z","from_sync":false,"order":4,"slug":"frame-platform","title":"Frame Platform"},"parentDoc":null,"updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-07-28T19:55:49.297Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":11,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Multi-language features\"\n}\n[/block]\nConfiguring multi-language environments on the Frame platform requires careful consideration and planning.  Microsoft’s Server OS can be configured to handle different keyboards/characters in addition to multiple display languages. Beyond the OS layer, individual applications might still require further configuration if the display language is not automatically detected by the app.\n\nFurther considerations include the fact that each Frame application might need to alter the display language and keyboard layout on a per-session basis. To create a customized language environment for each user’s session, dynamic alterations to the operating system must occur before each Frame session is started (using pre-session scripts).\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Operating System Language Features\",\n  \"body\": \"Microsoft’s Operating Systems provide full support for multiple languages and regions. To fully customize the OS environment to support a particular language, you will want to alter both the keyboard layout and display language.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Keyboard layouts\"\n}\n[/block]\nSupport for multiple keyboard layouts lets end-users choose a language to match the keys and characters on their keyboard.\n\nKeyboard layouts also determine which on-screen keyboard is used within the windows environment if physical keyboards cannot be used (for touch displays, tablets, etc).\n\nIn a traditional Windows desktop environment, it is fairly easy to switch between multiple keyboard layouts by clicking on the keyboard icon located in the system tray.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/9c7b168-Screenshot_2016-07-28_at_12.51.30_PM.png\",\n        \"Screenshot 2016-07-28 at 12.51.30 PM.png\",\n        507,\n        170,\n        \"#222122\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nHowever, in a Frame application the Windows system tray will not be visible and the keyboard layout switcher is no longer available. To accommodate for this, Frame has a special keyboard layout switcher in the footer of the Frame terminal. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f3e2fa1-Screenshot_2016-07-28_at_12.52.53_PM.png\",\n        \"Screenshot 2016-07-28 at 12.52.53 PM.png\",\n        620,\n        236,\n        \"#212020\"\n      ],\n      \"border\": true,\n      \"sizing\": \"80\"\n    }\n  ]\n}\n[/block]\nFrame’s keyboard layout switcher is very similar to the Windows keyboard layout switcher and provides all of the same functionality.\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"To enable the Frame keyboard layout switcher, the ‘Keyboard Layouts’ advanced feature needs to be enabled for every account that requires this feature. At this time, only Frame’s support team can turn this on. If you are interested in enabling this feature, please email the support team at ‘support:::at:::fra.me’ and request the ‘Keyboard Layouts’  feature for each of your accounts.\\n\\nOnce this feature is enabled, each user’s session will display the Frame keyboard layout switcher.\",\n  \"title\": \"Action Required for Keyboard Layouts\"\n}\n[/block]\nThe default language for the keyboard layout will be used at the beginning of every session (US English is the default on Frame Platform, see the next section to change the default). It’s important to note that if the keyboard layout was changed during the session, this setting will not be retained at the end of the session. This means that end-users must switch to the desired layout at the beginning of every session.\n\nIf you are interested in supporting multiple languages and retaining the personalized settings for each user, please refer to the [“Multiple Languages” section](https://docs.fra.me/v1.0/docs/multi-language-configuration#multiple-languages) of this document to understand the multiple options provided by Frame.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note about Keyboard Layouts and certain keyboard shortcuts\",\n  \"body\": \"Certain system keyboard shortcuts can conflict with the native Windows keyboard shortcut that switches the current keyboard layout. For example, on OS X, you can use a keyboard shortcut (\\\"CMD+SHIFT+3\\\") to take a screenshot. The key combination to do this sends \\\"ALT+SHIFT\\\" to the Frame session and will switch the system's keyboard layout to another that's available.\\n\\nConflicting shortcuts for OS X that may switch the keyboard layout include: \\n• Screenshot tool: Command + Shift + 3.\\n• Screenshot snip tool: Command + Shift + 4. \\n• Go to next tab: Command + Shift + [.\\n• Go to previous tab: Command + Shift + ].\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Using a single language\"\n}\n[/block]\nThe most common configuration would be to prepare your account’s Sandbox with a default display language and a default keyboard layout other than US English.  \n\nYou only need to change these settings once within the Sandbox Desktop environment to permanently apply the changes to your account. After these adjustments are made and published, all production application sessions will use the updated display language and keyboard layout.\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Changing the default display language\"\n}\n[/block]\nThe default display language setting can be configured in the “Language” section of the control panel on your Sandbox. \n\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/77d3830-Screenshot_2016-07-28_at_12.58.39_PM.png\",\n        \"Screenshot 2016-07-28 at 12.58.39 PM.png\",\n        820,\n        325,\n        \"#e0eae9\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nFrom within the “Language” section, you can specify the default display language by clicking on “Options” next to the language you would prefer.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/1f6a36e-Screenshot_2016-07-28_at_12.59.32_PM.png\",\n        \"Screenshot 2016-07-28 at 12.59.32 PM.png\",\n        901,\n        128,\n        \"#eaf0f4\"\n      ]\n    }\n  ]\n}\n[/block]\nYou will then be asked to log off and then log back in to apply the changes.\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note\",\n  \"body\": \"This section assumes that you have already installed all language keyboards/packs that you require for your applications on the OS. If you have not, you can refer to the “Preparing Windows for Multiple Languages” section in the Appendix.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Change the Default Keyboard Layout\"\n}\n[/block]\nThe default keyboard layout setting can be configured in the “Language” section of the control panel on your Sandbox. \n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/f9e1375-Screenshot_2016-07-28_at_1.02.10_PM.png\",\n        \"Screenshot 2016-07-28 at 1.02.10 PM.png\",\n        814,\n        312,\n        \"#dfeae9\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nOnce you are in the “Language” section, you need to click on the “Advanced settings” on the left side of the panel\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/616cdf0-Screenshot_2016-07-28_at_1.03.29_PM.png\",\n        \"Screenshot 2016-07-28 at 1.03.29 PM.png\",\n        724,\n        295,\n        \"#e5ebf0\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\nFrom here, select the keyboard layout from the “Override for default input method”. After you have chosen the desired layout, click “Save”.\n[block:image]\n{\n  \"images\": [\n    {\n      \"image\": [\n        \"https://files.readme.io/e8a44f7-Screenshot_2016-07-28_at_1.04.26_PM.png\",\n        \"Screenshot 2016-07-28 at 1.04.26 PM.png\",\n        842,\n        219,\n        \"#d3dee8\"\n      ],\n      \"border\": true\n    }\n  ]\n}\n[/block]\n\n[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Note\",\n  \"body\": \"This section assumes that you have already installed all language keyboards/packs that you require for your applications on the OS. If you have not, you can refer to the “Preparing Windows for Multiple Languages” section in the Appendix.\"\n}\n[/block]\n\n[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Multiple languages\"\n}\n[/block]\nFrame supports utilizing multiple languages on the same account to deliver customized experiences for users in different regions sharing the same account. \n\n[block:callout]\n{\n  \"type\": \"warning\",\n  \"body\": \"Configuration of a multi-language environment is more involved than using a single language due to the fact that scripting is necessary to dynamically switch the keyboard layout and display language.\\n\\nIf you are in need of offering multiple languages please contact support@fra.me.  Our support team will enable this feature and walk you through additional instructions.\",\n  \"title\": \"Action required for multiple languages\"\n}\n[/block]\nIf you experience issues with pass through of some characters or keystrokes, please contact support.","excerpt":"Support local language keyboards and localized applications","slug":"multi-language-configuration","type":"basic","title":"Multi-Language configuration"}

Multi-Language configuration

Support local language keyboards and localized applications

[block:api-header] { "type": "basic", "title": "Multi-language features" } [/block] Configuring multi-language environments on the Frame platform requires careful consideration and planning. Microsoft’s Server OS can be configured to handle different keyboards/characters in addition to multiple display languages. Beyond the OS layer, individual applications might still require further configuration if the display language is not automatically detected by the app. Further considerations include the fact that each Frame application might need to alter the display language and keyboard layout on a per-session basis. To create a customized language environment for each user’s session, dynamic alterations to the operating system must occur before each Frame session is started (using pre-session scripts). [block:callout] { "type": "info", "title": "Operating System Language Features", "body": "Microsoft’s Operating Systems provide full support for multiple languages and regions. To fully customize the OS environment to support a particular language, you will want to alter both the keyboard layout and display language." } [/block] [block:api-header] { "type": "basic", "title": "Keyboard layouts" } [/block] Support for multiple keyboard layouts lets end-users choose a language to match the keys and characters on their keyboard. Keyboard layouts also determine which on-screen keyboard is used within the windows environment if physical keyboards cannot be used (for touch displays, tablets, etc). In a traditional Windows desktop environment, it is fairly easy to switch between multiple keyboard layouts by clicking on the keyboard icon located in the system tray. [block:image] { "images": [ { "image": [ "https://files.readme.io/9c7b168-Screenshot_2016-07-28_at_12.51.30_PM.png", "Screenshot 2016-07-28 at 12.51.30 PM.png", 507, 170, "#222122" ], "border": true } ] } [/block] However, in a Frame application the Windows system tray will not be visible and the keyboard layout switcher is no longer available. To accommodate for this, Frame has a special keyboard layout switcher in the footer of the Frame terminal. [block:image] { "images": [ { "image": [ "https://files.readme.io/f3e2fa1-Screenshot_2016-07-28_at_12.52.53_PM.png", "Screenshot 2016-07-28 at 12.52.53 PM.png", 620, 236, "#212020" ], "border": true, "sizing": "80" } ] } [/block] Frame’s keyboard layout switcher is very similar to the Windows keyboard layout switcher and provides all of the same functionality. [block:callout] { "type": "warning", "body": "To enable the Frame keyboard layout switcher, the ‘Keyboard Layouts’ advanced feature needs to be enabled for every account that requires this feature. At this time, only Frame’s support team can turn this on. If you are interested in enabling this feature, please email the support team at ‘support@fra.me’ and request the ‘Keyboard Layouts’ feature for each of your accounts.\n\nOnce this feature is enabled, each user’s session will display the Frame keyboard layout switcher.", "title": "Action Required for Keyboard Layouts" } [/block] The default language for the keyboard layout will be used at the beginning of every session (US English is the default on Frame Platform, see the next section to change the default). It’s important to note that if the keyboard layout was changed during the session, this setting will not be retained at the end of the session. This means that end-users must switch to the desired layout at the beginning of every session. If you are interested in supporting multiple languages and retaining the personalized settings for each user, please refer to the [“Multiple Languages” section](https://docs.fra.me/v1.0/docs/multi-language-configuration#multiple-languages) of this document to understand the multiple options provided by Frame. [block:callout] { "type": "info", "title": "Note about Keyboard Layouts and certain keyboard shortcuts", "body": "Certain system keyboard shortcuts can conflict with the native Windows keyboard shortcut that switches the current keyboard layout. For example, on OS X, you can use a keyboard shortcut (\"CMD+SHIFT+3\") to take a screenshot. The key combination to do this sends \"ALT+SHIFT\" to the Frame session and will switch the system's keyboard layout to another that's available.\n\nConflicting shortcuts for OS X that may switch the keyboard layout include: \n• Screenshot tool: Command + Shift + 3.\n• Screenshot snip tool: Command + Shift + 4. \n• Go to next tab: Command + Shift + [.\n• Go to previous tab: Command + Shift + ]." } [/block] [block:api-header] { "type": "basic", "title": "Using a single language" } [/block] The most common configuration would be to prepare your account’s Sandbox with a default display language and a default keyboard layout other than US English. You only need to change these settings once within the Sandbox Desktop environment to permanently apply the changes to your account. After these adjustments are made and published, all production application sessions will use the updated display language and keyboard layout. [block:api-header] { "type": "basic", "title": "Changing the default display language" } [/block] The default display language setting can be configured in the “Language” section of the control panel on your Sandbox. [block:image] { "images": [ { "image": [ "https://files.readme.io/77d3830-Screenshot_2016-07-28_at_12.58.39_PM.png", "Screenshot 2016-07-28 at 12.58.39 PM.png", 820, 325, "#e0eae9" ], "border": true } ] } [/block] From within the “Language” section, you can specify the default display language by clicking on “Options” next to the language you would prefer. [block:image] { "images": [ { "image": [ "https://files.readme.io/1f6a36e-Screenshot_2016-07-28_at_12.59.32_PM.png", "Screenshot 2016-07-28 at 12.59.32 PM.png", 901, 128, "#eaf0f4" ] } ] } [/block] You will then be asked to log off and then log back in to apply the changes. [block:callout] { "type": "info", "title": "Note", "body": "This section assumes that you have already installed all language keyboards/packs that you require for your applications on the OS. If you have not, you can refer to the “Preparing Windows for Multiple Languages” section in the Appendix." } [/block] [block:api-header] { "type": "basic", "title": "Change the Default Keyboard Layout" } [/block] The default keyboard layout setting can be configured in the “Language” section of the control panel on your Sandbox. [block:image] { "images": [ { "image": [ "https://files.readme.io/f9e1375-Screenshot_2016-07-28_at_1.02.10_PM.png", "Screenshot 2016-07-28 at 1.02.10 PM.png", 814, 312, "#dfeae9" ], "border": true } ] } [/block] Once you are in the “Language” section, you need to click on the “Advanced settings” on the left side of the panel [block:image] { "images": [ { "image": [ "https://files.readme.io/616cdf0-Screenshot_2016-07-28_at_1.03.29_PM.png", "Screenshot 2016-07-28 at 1.03.29 PM.png", 724, 295, "#e5ebf0" ], "border": true } ] } [/block] From here, select the keyboard layout from the “Override for default input method”. After you have chosen the desired layout, click “Save”. [block:image] { "images": [ { "image": [ "https://files.readme.io/e8a44f7-Screenshot_2016-07-28_at_1.04.26_PM.png", "Screenshot 2016-07-28 at 1.04.26 PM.png", 842, 219, "#d3dee8" ], "border": true } ] } [/block] [block:callout] { "type": "info", "title": "Note", "body": "This section assumes that you have already installed all language keyboards/packs that you require for your applications on the OS. If you have not, you can refer to the “Preparing Windows for Multiple Languages” section in the Appendix." } [/block] [block:api-header] { "type": "basic", "title": "Multiple languages" } [/block] Frame supports utilizing multiple languages on the same account to deliver customized experiences for users in different regions sharing the same account. [block:callout] { "type": "warning", "body": "Configuration of a multi-language environment is more involved than using a single language due to the fact that scripting is necessary to dynamically switch the keyboard layout and display language.\n\nIf you are in need of offering multiple languages please contact support@fra.me. Our support team will enable this feature and walk you through additional instructions.", "title": "Action required for multiple languages" } [/block] If you experience issues with pass through of some characters or keystrokes, please contact support.