Please follow the links for a guide to the use of the listed keys for use in XML configuration files. Also see “A Brief Guide to the control Logic of XML settings” and “a brief guide to reading OS logs“. A note to our non-Engish readers: This document is English only – sorry for the inconvenience this may incur.
Note that you only add or change necessary parameters, such as urls and texts, and keep the other parameters if possible. This makes your config file small.
| Keys | Valid from/to version | Short explanation | Type |
Default (Used if not filled in) |
| AdmBtnTxtTyp | 1.0.67 | Controls local login button text: If 1: Shows (alternative) device name. If 0: Shows “Login” | Number | 1 |
| Autocap | 2.0 – | Automatic capitalization of input field text of web pages shown in ManagdWAL/plus. On/off. Reserved for future use. | Boolean | Defaults to “false” |
| Autocomp | 2.0 – | Automatic completion of words typen in input field text of web pages shown in ManagdWAL/plus. On/off. Reserved for future use. | Boolean | Defaults to “false” |
| Beeps | 1.00.0 – | App event audible cue (beep) | Boolean | Defaults to “true”. See table of sounds. |
| BtnSelFntScl | 1.0.76 | Scale font of button as percentage when selected | Integer | Defaults to 115 |
| Autocorr | 1.00.0 – | Automatic correction of input field text of web pages shown in ManagdWAL/plus. On/off. Reserved for future use. | Boolean | Defaults to “false” |
| CachLoc | x.0 – | Disck cache location. Reserved for future use. | String | Defaults to device default location. |
| CachUpdatHr | x.0 – | Disk cache extra update (web crawl) daily hour. Reserved for future use. | String | T03:30:00Z |
| CachUpdatWait | x.0- | Cache update wait. Under consideration for later addition. | Defaults to 1800 seconds | |
| CachUpdOnlyIdly | 2.0- | Cache to only be updated if device idle, meaning with no user interaction going on. On/off. Reserved for future use. | Boolean | Defaults to “false” |
| Debg | 1.0 – | Debug level, as shown on attached console. Number 1-100, with 1=only errors, 2=more details, 3=all logging. | Number | Defaults to 3 |
| DevNam | 1.0.67 | Defines an alternative device ID; since iOS 16+ blocks access to device name | String | Defaults to “DeviceNameID” [or “” (empty string)] |
| DskCachSize | 1.0 – | Disck cache size in gigabytes. | Number | Defaults to 100. |
| HBL01 | 1.0 – | Label 01 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to usr_id. |
| HBL02 | 1.0 – | Label 02 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to usr_nam. |
| HBL03 | 1.0 – | Label 03 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to email. |
| HBL04 | 1.0 – | Label 04 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to device_id. |
| HBL05 | 1.0 – | Label 05 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to offline_en. |
| HBL06 | 1.0 – | Label 06 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to offl_upd_time |
| HBL07 | 1.0 – | Label 07 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to batt_charge |
| HBL08 | 1.0 – | Label 08 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to conf_misreads, providing number of misreads. |
| HBL09 | 1.0 – | Label 09 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to misread_desc, providing key names of data not read. |
| HBL10 | 1.0 – | Label 10 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to MB_RAM_in_use, providing key names of data not read. |
| HBL11 | 1.0 – | Label 11 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to home_buttoned |
| HBL12 | 1.0 – | Label 12 of data added to the heartbeat. Can be used absolutely freely. | String | No default. |
| HBL13 | 1.0 – | Label 13 of data added to the heartbeat. Can be used absolutely freely. | String | No default. |
| HBL14 | 1.0 – | Label 14 of data added to the heartbeat. Can be used absolutely freely. | String | No default. |
| HBK15 | 1.0 – | Label 15 of data added to the heartbeat. Can be used absolutely freely. | String | No default. |
| HBMsgHead | 1.0 – | Hearbeat customized header. | String | Defaults to empty string. Privacy related: See footnote (1) |
| HBSrv | 1.0 – | Hearbeat logging server name. | String | Defaults to empty string, meaning hearbeat logging off. |
| HBV01 | 1.0 – | Value 01 of data added to the heartbeat. Can be used absolutely freely. | String | Empty string Privacy related: See footnote (1) |
| HBV02 | 1.0 – | Value 02 of data added to the heartbeat. Can be used absolutely freely. | String | Empty string Privacy related: See footnote (1) |
| HBV03 | 1.0 – | Value 03 of data added to the heartbeat. Can be used absolutely freely. | String | Empty string Privacy related: See footnote (1) |
| HBV04 | 1.0 – | Value 04 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to #var:DeviceName#, resulting in the actual device name. Privacy related: See footnote (1) |
| HBV05 | 1.0 – | Value 05 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to false. |
| HBV06 | 1.0 – | Value 06 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to #var:OfflineUpdTime#, resulting in the last offline update time. Awaits implementation. |
| HBV07 | 1.0 – | Value 07 of data added to the heartbeat. Can be used absolutely freely. | String | #var:battCharge#, resulting in the battery charge level in number+%, such as 97 |
| HBV08 | 1.0 – | Value 08 of data added to the heartbeat. Can be used absolutely freely. | String | #var:numMisrds#, resulting in the number if misreads from bundled settings. |
| HBV09 | 1.0 – | Value 09 of data added to the heartbeat. Can be used absolutely freely. | String | #var:showMisrds#, resulting in an excerpt of the actual misreads from bundled settings. |
| HBV10 | 1.0 – | Value 10 of data added to the heartbeat. Can be used absolutely freely. | String | #var:MbRamInUse#, resulting in number of MB of RAM in use by app. |
| HBV11 | 1.0 – | Value 11 of data added to the heartbeat. Can be used absolutely freely. | String | Defaults to #var:HomeButtoned, resulting in the Home Button pressed status (indicating whether the unit is still emitting a hearbeat even if not showing interface, currently a feature disaled). |
| HBV12 | 1.0 – | Value 12 of data added to the heartbeat. Can be used absolutely freely. | String | No default. Privacy related: See footnote (1) |
| HBV13 | 1.0 – | Value 13 of data added to the heartbeat. Can be used absolutely freely. | String | No default. Privacy related: See footnote (1) |
| HBV14 | 1.0 – | Value 14 of data added to the heartbeat. Can be used absolutely freely. | String | No default. Privacy related: See footnote (1) |
| HBV15 | 1.0 – | Value 15 of data added to the heartbeat. Can be used absolutely freely. | String | No default. Privacy related: See footnote (1) |
| HBWait | 1.0 – | Wait between heartbeats. | Number | Defaults to 300 seconds. |
| HideWAd | 1.0 – | Hide web address line, preventing users from entering links at their choosing. Defaults to hide (true). | Number | Defaults to true. |
| Iso639.2-1 | 1.0 – | First language (in sequence). Using standardized ISO 639.2 language codes is recommended, but this field can be used freely, including using any UTF-8 coded characters | String | Required to be filled in, when using XML file to control quick-launch items (qLIs)/menu line. Without XML this will default to ENG (English) |
| Iso639.2-2 | 1.0 – | Second language (in sequence). Turns off second language if empty, and will then promote the Iso639.2-3 language to second language. This field can be used freely, including using any UTF-8 coded characters | String | No default, if first language is set in XML. Without XML this will default to 中文 (CHI) (Chinese) |
| Iso639.2-3 | 1.0 – | Third language (in sequence). Turns off second language if empty, and will then promote the Iso639.2-4 language to third (or even second) language. This field can be used freely, including using any UTF-8 coded characters | String | No default, if first language is set in XML. Without XML this will default to SPA (Spanish) |
| Iso639.2-4 | 1.0 – | Fourth language (in sequence). Turns off this language if empty. This field can be used freely, including using any UTF-8 coded characters | String | No default, if first language is set in XML. Without XML this will default to हिन्दी (HIN), that is Hindu. |
| Iso639.2-5 | 1.0 – | Fifth language (in sequence). Turns off this language if empty. This field can be used freely, including using any UTF-8 coded characters | String | No default, if first language is set in XML. Without XML this will default to বাংলা (BEN), that is Bengali. |
| LocID | 2.0 – | Location ID. Reserved for future use. | String | No default |
| LoclAdm | 1.0 – | Local administration allowed. | Boolean | Defaults to “true”. |
| LoclAdmLogotWt | 1.0 – | Local administrator not active logout wait time. Reserved for future use. | 0, that is turned off. | |
| LoclAdmPw | 1.0 – | Local administrator password. Is strongly advised to be changed from detault via the EMM/MDM/MAM/UEM system. Note that the first two and the last two characters of the password is sent to the Apple Console (if attached) for debugging purposes, see a brief guide to reading console logs. | String | Defaults to “WALpw1” (without hyphens). |
| NewsTckrCaching | 2.0 – | Whether news ticker data should be cached, or not. Reserved for future use. | Boolean | Defaults to “true”. |
| NewsTckrTxt-n | 2.0 – | News ticker text corresponding to active language ‘n” (1-5) Reserved for future use. | Empty string. | |
| NewsTckrUrl-1 | 2.0 – | News ticker url with link to full news story, corresponding to active language ‘n” (1-5) Reserved for future use. | Empty string. | |
| NumOfQlis | 1.0 – | Number of quick launch items. | Number | Defaults to 5. |
| OfflinDetctWait | 2.0 – | Offline detect wait time. For detection of loss of network connectivity. Pending implementation. | No default | |
| PrsdLangBtnWaTmSec | 1.0 | Pressed language button wait time in whole seconds. This timer prevents presenting a usage logging message (if enabled) until user has finished changing language. | Number | Defaults to 2 (seconds) |
| Qli0Caching | 2.0 – | Quick launch item 0 .. 9 static content caching (on/off) (Pending full implementaion) | Defaults to “false” | |
| Qli0FntCol, Qli1FntCol … Qli9FntCol | 1.0 | Font color for respective quick launch items. | String | Defaults to #8a1d2fFF, that is (hex code for) a dark lilac color. Please refer to the color table for some color suggestions. |
| Qli0FntSiz, Qli1FntSiz … Qli9FntSiz | 1.0 – | Font size for respective quick launch items. It is recommended to use sizes in the range of 17-35 for most uses. | Number | Defaults to 22. |
| Qli0FntNam, Qli1FntNam … Qli9FntNam | 1.0 | Font name of respective quick launch items. | String | Helvetica-Bold |
| Qli0MaxCachCrwl, Qli1MaxCachCrwl … Qli9MaxCachCrwl | 1.0 – | Quick launch item 0 .. 9 maximum number of levels for cache crawling. Reserved for future use. | Defaults to 0 (off). | |
| Qli0SafOffln | 1.0 – | Quick launch item alternative browser, that is: Safari embedded browser for support of Service Workers. Reserved for future use. | Defaults to “false” (off). | |
| Qli0Txt-1 Qli0Txt-2 Qli0Txt-3 Qli0Txt-4 Qli0Txt-5 | 1.0 – | First quick launch item descriptive text, language number 1, 2, 3, 4 and 5. Qli0Txt-1 is mandatory in actual deployments, using a customized XML file transferred via an EMM/MDM/MAM/UEM system. | Boolean | Without MDM in used and actively pushing a text with this identifier, defaults to Royal Cloud Solutions configuration info webpage. |
| Qli1Txt1, Qli1Txt2 … Qli4Txt-5 | 1.0 | Second, third, fourth and Fifth Quick Launch Item, languages 1-5 | String | Defaults to Royald Cloud Solutions configuration info webpage, and will not show up up in actual use when Qli0Txt-1 is filled in. |
| Qli6Txt-1, Qli6Txt-2… Qli9Txt-5 | 1.0 – | (Optional) the other potential five quick launch item descriptive texts, with up to five languages. This corresponds to the fifth, sixth, seventh, eight, ninth and tenth quick launch item URLs for the respective languages. | String | No defaults, requires XML custom configuration file transfer to client. |
| Qli0Url-1 | 1.0 – | Quick launch item URL number 0, language 1. This is corresponding to the first language of the descriptive texts. | String | No default – If remote control of content is to be active, this key with corresponding value is required to be filled in, using a XML file that is transferred via . |
| …… | No default | |||
| Qli0Url-5 | 1.0 – | Quick launch item URL number 0, language 5. This is corresponding to the first language of the descriptive texts. | String | No default. |
| Qli1Url-1, Qli1Url2 … Qli9Url5 | 1.0 – | Respective URLs corresponding to the descripive texts (see Qli1Txt-1 … Qli9Txt-5 above) | String | Defaults for Qli1Url1-Qli4Url5 as explained above (app above) unless Qli0Txt-1 is filled in, and thus XML data required for the appropriate Title/URL data. |
| QliLanSelFntCol | 1.0 – | Language select button font color. Color of language descriptions (Iso639.2-1–Iso639.2-5). | String | Defaults to #8a1d2fFF |
| QliLanSelFntNam | 1.0 – | Language select button font name. | String | Defaults to Helvetica-Bold |
| QliLanSelFntSiz | 1.0 – | Language select button font size. It is recommended to use sizes in the range of 17-35 for most uses. | Number | Defaults to 22. |
| QliRstFntCol | 1.0 – | Reset button font color. See color table. | String | Defaults to #FF8C05FF |
| QliRstFntNam | 1.0 – | Reset button font name. | String | Defaults to Helvetica-Bold |
| QliRstFntSiz | 1.0 – | Reset button font size. It is recommended to use sizes in the range of 17-35 for most uses. | Number | Defaults to 22. |
| QliRstTxt-1 | 1.0 – | Reset button text (title), language 1 | String | Defaults to Reset (corresponding to English) |
| QliRstTxt-2 | 1.0 – | Reset button text (title), language 2 | String | Defaults to 重启 (corresponding to simplified Chinese) |
| QliRstTxt-3 | 1.0 – | Reset button text (title), language 3 | String | Defaults to Reiniciar (corresponding to Spanish) |
| QliRstTxt-4 | 1.0 – | Reset button text (title), language 4 | String | Defaults to रीसेट (corresponding to Hindi) |
| QliRstTxt-5 | 1.0 – | Reset button text (title), language 5 | String | Defaults to রিসেট (corresponding to Bengali) |
| RamCachSize | 1.0 – | RAM cache size in gigabytes. Reserved for future use. | Number | Defaults to 100 megabytes. |
| SafUpdatHr | 1.0 – | Safari update daily hour. Reserved for future use. | String | Defaults to T04:30:00Z |
| ScrSavLcdBacklit | 1.0 – | Screen saver LCD backligt level. Given in percents of max. Reset to default device level at normal exit. | Number | Defaults to 1 (That is, 1 %). |
| ScrSavWait | 1.0 – | Screen saver wait time in minutes. Time since latest user input to screen saver is activated. | Number | Defaults to 5 minutes. |
| SnglAppMod | 1.0 – | Single application mode activated. | Boolean | Defaults to true (on). |
| statsEnable | 1.0 – | Simple statistics enabled. | Boolean | Defaults to true. Privacy related: See footnote (1) |
| StdLcdBacklit | 1.0 – | Standard LCD backligt level. Given in percents of max. If set to 0, defaults to device standard LCD backlight level. Reset to default device level at normal exit. | Number | Defaults to 0, meaning using default LCD backlight level when not in app “always on” screensave. |
| SuppEmail | 2.0 – | Support email. Reserved for future use. | Empty string. | |
| SuppPhone | 2.0 – | Support phone. Reserved for future use. | Empty string. | |
| UsgStatsTit-1 | 1.0 – | Heading (title) of alert to users (language 1) that data of their use of the devide may be logged, according to the actual use. This is more often anonymous usage data, unless the given configuration explicitly adds personalized data in the HBV-fields. | String | Defaults to “Collection of anonymous usage statistics.” Privacy related: See footnote (1) |
| UsgStatsTit-2 | 1.0 – | As for UsgStatsTit-1, but for language 2. | String | Defaults to “收集匿名使用情况统计信息。” Privacy related: See footnote (1) |
| UsgStatsTit-3 | 1.0 – | As for UsgStatsTit-1, but for language 3. | String | Defaults to “Recopilación de estadísticas de uso anónimo.” Privacy related: See footnote (1) |
| UsgStatsTit-4 | 1.0 – | As for UsgStatsTit-1, but for language 4. | String | Defaults to ” अनाम उपयोग आंकड़ों का संग्रह।” Privacy related: See footnote (1) |
| UsgStatsTit-5 | 1.0 – | As for UsgStatsTit-1, but for language 5. | String | Defaults to “বেনামে ব্যবহারের পরিসংখ্যান সংগ্রহ।” Privacy related: See footnote (1) |
| UsgStatsTitCol | 1.x – | Currently not in use. | Defaults to 000000FF | |
| UsgStatsTitFntNam | 1.0 – | Font name for usage statistics alert. If an illegal font is proposed, will use system font instead. | String | Defaults to Helvetica-Bold |
| UsgStatsTitFntSiz | 1.0 – | Font size for usage statistics alert. for respective quick launch items. It is recommended to use sizes in the range of 17-35 for most uses. | Number | Defaults to 22 |
| UsgStatsTxt-1 | 1.0 – | Message text to users about extent and purpose of logging, if enabled (see statsEnable and UsgStInfAtLanCng). Corresponds with language 1. If you log any personal data, message default has to be overriden (defined) in XML file. | String | Defaults to “This device collects the number of finger presses on the screen, only categorized by which quick launch link (QLI) is active. This is used for assessing how the service is being used, to help us improve this service. Please contact the hosting institution if you have any question. Note that this application does not collect any names or other identifiable information about you as a end-user.” Privacy related: See footnote (1) |
| UsgStatsTxt-2 | 1.0 – | As for UsgStatsTxt-1, but for language 2. | String | Defaults to “该设备收集屏幕上手指按下的次数，仅按激活快速启动链接（QLI）的类别进行分类。 这用于评估服务的使用方式，以帮助我们改进此服务。 如有任何疑问，请联系托管机构。 请注意，此应用程序不会收集有关您作为最终用户的任何名称或其他可识别信息。”. Privacy related: See footnote (1) |
| UsgStatsTxt-3 | 1.0 – | As for UsgStatsTxt-1, but for language 3. | String | Defaults to “Este dispositivo recopila la cantidad de pulsaciones de dedos en la pantalla, solo clasificadas por qué enlace de inicio rápido (QLI) está activo. Esto se utiliza para evaluar cómo se usa el servicio, para ayudarnos a mejorarlo. Póngase en contacto con la institución de acogida si tiene alguna pregunta. Tenga en cuenta que esta aplicación no recopila ningún nombre u otra información identificable sobre usted como usuario final.”. Privacy related: See footnote (1) |
| UsgStatsTxt-4 | 1.0 – | As for UsgStatsTxt-1, but for language 4. | String | Defaults to “यह डिवाइस स्क्रीन पर फिंगर प्रेस की संख्या एकत्र करता है, केवल वर्गीकृत करता है जिसके द्वारा त्वरित लॉन्च लिंक (QLI) सक्रिय है। इसका उपयोग यह आकलन करने के लिए किया जाता है कि इस सेवा का उपयोग कैसे किया जा रहा है, जिससे हमें इस सेवा को बेहतर बनाने में मदद मिल सके। यदि आपके कोई प्रश्न हैं, तो कृपया होस्टिंग संस्थान से संपर्क करें। ध्यान दें कि यह एप्लिकेशन अंतिम उपयोगकर्ता के रूप में आपके बारे में कोई नाम या अन्य पहचान योग्य जानकारी एकत्र नहीं करता है।”. Privacy related: See footnote (1) |
| UsgStatsTxt-5 | 1.0 – | As for UsgStatsTxt-1, but for language 5. | String | “এই ডিভাইসটি স্ক্রিনে আঙুলের চাপগুলির সংখ্যা সংগ্রহ করে, কেবল শ্রেণিবদ্ধ করে যার মাধ্যমে দ্রুত প্রবর্তন লিঙ্ক (কিউএলআই) সক্রিয় রয়েছে। আমাদের পরিষেবাটি উন্নত করতে সহায়তা করতে পরিষেবাটি কীভাবে ব্যবহৃত হচ্ছে তা মূল্যায়নের জন্য এটি ব্যবহার করা হয়। আপনার যদি কোনও প্রশ্ন থাকে তবে দয়া করে হোস্টিং সংস্থায় যোগাযোগ করুন। নোট করুন যে এই অ্যাপ্লিকেশনটি শেষ ব্যবহারকারী হিসাবে আপনার সম্পর্কে কোনও নাম বা অন্যান্য সনাক্তকারী তথ্য সংগ্রহ করে না।”. Privacy related: See footnote (1) |
| UsgStatsTxtCol | 1.0 – | Not in use. | String | Defaults to “#000000” |
| UsgStatsTxtFntNam | 1.0 – | Font of text for usage logging alerts. | String | Defaults to “Helvetica-Bold” |
| UsgStatsTxtFntSiz | 1.0 – | Font size of text fo usage logging alerts. | Number | Defaults to 22 |
| UsgStatsAccpt-1 | 1.0 – | User acknowledgement and acceptance of usage logging, language 1 | String | Defaults to “Read and accepted” (English) Privacy related: See footnote (1) |
| UsgStatsAccpt-2 | 1.0 – | As for UsgStatsAccpt-1, language 2. | String | Defaults to “重启” (Simplified Chinese) Privacy related: See footnote (1) |
| UsgStatsAccpt-3 | 1.0 – | As for UsgStatsAccpt-1, language 3. | String | Defaults to “Leído y aceptado” (Spanish) Privacy related: See footnote (1) |
| UsgStatsAccpt-4 | 1.0 – | As for UsgStatsAccpt-1, language 4. | String | Defaults to “पढ़ें और स्वीकार किए जाते हैं” (Hindi) Privacy related: See footnote (1) |
| UsgStatsAccpt-5 | 1.0 – | As for UsgStatsAccpt-1, language 5. | String | Defaults to “পড়ুন এবং স্বীকৃত (Bengali) Privacy related: See footnote (1) |
| UsgStInfAtAZrPgWt | 1.0 – | Usage logging alerts also when Zero Page (see there), that is when it is reasonable to excpect that a new user is using the device, given certain usage cases such as info kiosks with numeroius customers entering and exiting the use. | Boolean | Defaults to “true” (on). Privacy related: See footnote (1) |
| UsgStInfAtLanCng | 1.0 – | Usage logging alerts also on after completed language change, assuming new user present (see timer setting for language change), if turned off to avoid possibly unneccesary alerts). | Boolean | Defaults to “true” (on) Privacy related: See footnote (1) |
| Xtn01 | 1.0 – | String extension field 01-05. To be used when EMM/MDM/MAM/UEM system single string limit is too small, breaking up longer strings using this (or the other four fields) for transport, with reassembly in the ManagdWALplus app. | String | Defaults to .com/ |
| Xtn02 | 1.0 – | String | Defaults to >xtn01>home/<03xtn< | |
| Xtn03 | 1.0 – | String | Defaults to chn/ | |
| Xtn04 | 1.0 – | String | Defaults to royalcloudsolutions.no/ | |
| ZeroPageWait | 1.0 – | Reverts to startup web pages after this wait when in screensave | Number | Defaults to 3 minutes |
Replacement parameters not associated with specific HBLs:
#var:appVersion#: Apps actual version, e.g. 1.00.56/60, where number after “/” is build number
#var:iOSVersion#: Actual version of OS running on device
#var:ChargingState#: Charging state; either Charging, Unplugged or Unknown
Footnotes:
(1) Privacy note: If privacy related data are collected in any way, make sure that users are informed thereof and accepting this, usiong the privacy splash screen and click-wrap (accept) functions accordingly. However it is good privacy practice in most information kiosks to avoid collecting privacy information altoghether.