modules:digits

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Last revision Both sides next revision
modules:digits [2017/12/29 14:50]
admin
modules:digits [2018/08/28 19:18]
admin
Line 1: Line 1:
 ====== Digits ====== ====== Digits ======
  
-{{:​digits.png?​nolink|}}+<WRAP group> 
 +<WRAP COLUMN>{{INLINETOC width18 4-6|Digits Module}}</​WRAP>​ 
 +<WRAP COLUMN>​{{:​modules:module-digits.png?​nolink |}}</​WRAP>​ 
 +</​WRAP>​ 
 ---- ----
  
 ===Function=== ===Function===
-This module collects individual digit information. This module is commonly used for things like credit card number, account ID, or a transaction number. If users have a number that people typically read off each digit individually,​ then they should use this module.+This module collects individual digit information. ​\\ This module is commonly used for things like zip code, credit card number, account ID, or a transaction number. If users have a number that people typically read off each digit individually,​ then they should use this module.
  
-If minimum and maximum digits are set then any input that does not match will return an errorFor exampleif the minimum ​is set to 2 and the maximum to 4, values like 5 or 54928 would both be invalid.+Note: For numeric ​input such as a currency amount or a mathematical number, please use the [[modules:​number|Number]] ( {{:decimal.svg?​nolink&​16x16|}} ) module. The digits module handles individually spoken digits such as “One Two Nine”whereas ​the Number module ​is designed for spoken numbers such as “one hundred twenty-nine”.
  
-If the min and max are set to the same number then the input value must be that exact length. For example, if the min and max are both set to 2, then 5, and 549 would be invalid input, but 54 would be valid. Because credit card numbers are 16 digits set both the min and max to 16 when collecting credit card numbers to ensure data accuracy and transactional efficiency. 
  
-//​**Important Note:** This module differs from the [[modules:​number|Number]] ( {{:​decimal.svg?​nolink&​16x16|}} ) module. The difference between the two modules revolves around the way that numbers ​are spoken. For example, ​“one hundred twenty-nine” ​is a decimal value, whereas ​the digit values of that number are onetwo, and nine.//+\\ If the [[#min-digits|minimum]] and [[#​max-digits|maximum]] digits ​are set, any input that does not match will return a no-match error.\\ For example, ​if the minimum ​is set to 2 and the maximum to 4values like 5 or 54928 would both be invalid.
  
 +If the minimum and maximum digits are set to the same number, the input value must be that exact length. ​
 +\\ For example, if the min and max are both set to 2, then 5, and 549 would be invalid input, but 54 would be valid. ​
 +\\ Because credit card numbers are 16 digits, set both the min and max to 16 (or 15/16 if accepting AMEX) when collecting credit card numbers to ensure data accuracy and transactional efficiency.
 +
 +
 +----
 ===Module Settings=== ===Module Settings===
-  * Barge-In (enabled by default) +{{:​modules:​settingsmod-digits.png?​nolink|}}
-  * Enable Speech Input +
-  * Min Digits +
-  * Max Digits +
-  * Private +
-  * Show Custom Errors+
  
 +{{page>​modules:​module-settings#​barge-in&​link&​noeditbutton&​nofooter&​firstseconly&​noreadmore}}
 +**Note**: This setting is enabled by default.
 +
 +----
 +{{page>​modules:​module-settings#​enable-speech-input&​link&​noeditbutton&​nofooter&​firstseconly&​noreadmore}}
 +
 +----
 +{{page>​modules:​module-settings#​max-digits&​link&​noeditbutton&​nofooter&​firstseconly&​noreadmore}}
 +
 +----
 +{{page>​modules:​module-settings#​min-digits&​link&​noeditbutton&​nofooter&​firstseconly&​noreadmore}}
 +
 +----
 +{{page>​modules:​module-settings#​private&​link&​noeditbutton&​nofooter&​firstseconly&​noreadmore}}
 +
 +----
 +{{page>​modules:​module-settings#​show-custom-errors&​link&​noeditbutton&​nofooter&​firstseconly&​noreadmore}}
 +
 +
 +
 +----
 **Advanced Settings**: Advanced Fuse users may want to use shadow variables that are available with input modules. For more information on this functionality,​ please visit the [[:​shadow_variables|Shadow Variables]] page. **Advanced Settings**: Advanced Fuse users may want to use shadow variables that are available with input modules. For more information on this functionality,​ please visit the [[:​shadow_variables|Shadow Variables]] page.
modules/digits.txt · Last modified: 2018/08/28 19:23 by admin