Dell Powerconnect W-ClearPass Hardware Appliances W-ClearPass Guest 6.0 Deploy - Page 168

Account Expiration, Visible If

Page 168 highlights

See "Form Field Conversion Functions" on page 301 for a detailed list of the options available to you for the Conversion and Value Format functions. The Display Param is the name of a form field, the value of which will be passed to the Display Function. In almost all cases this option should contain the name of the form field. Display Arguments are available for use with a form field and are used to control the conversion process. In the case of the expire_time form field, the Display Function is set to NwaDateFormat to perform a conversion from a UNIX time to a date/time string, and the Display Argument specifies the format to use for the conversion. See "Form Field Display Formatting Functions" on page 301 for a detailed list of the options available to you for the Display Function and Static Display Function. The Enable If and Visible If options in the form field editor allow you to specify JavaScript expressions. The result obtained by evaluating these expressions is used to enable/disable, or show/hide the form field in real time, while an operator is using the form. Unlike the other parts of the form field editor, the Enable If and Visible If expressions are evaluated by the operator's Web browser. These expressions are not used by the server for any other purpose. The expression must be a Boolean expression in the JavaScript language; statements and other code should not be included as this will cause a syntax error when the form is displayed in a Web browser. Because of the scoping rules of JavaScript, all of the user interface elements that make up the form are available as variables in the local scope with the same name as the form field. Thus, to access the current value of a text field named sample_field in a JavaScript expression, you would use the code sample_field.value. Most user interface elements support the value property to retrieve the current value. For check boxes, however, use the checked property to determine if the check box is currently selected. The most practical use for this capability is to hide a form field until a certain value of some other related field has been selected. For example, the default create_user form has an Account Expiration drop-down list. One of the values in this list is special: the -1 option displays the value Account expires at a specified time... When this option is selected, the form expands to include the Expires After row, allowing the user to specify a time other than one of the options in the list. The expire_time field uses the JavaScript expression expire_after.value < 0 for the Visible If option. When the -1 option has been selected, this condition will become true and the field will be displayed. Additional examples of the Visible If conditional expressions can be found in the guest_edit form. 168 | Form Field Validation Processing Sequence Dell Networking W-ClearPass Guest 6.0 | Deployment Guide

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320

168
| Form Field Validation Processing Sequence
Dell Networking W-ClearPass Guest 6.0 | Deployment Guide
See
"Form Field Conversion Functions" on page 301
for a detailed list of the options available to you for the
Conversion and Value Format functions.
The
Display Param
is the name of a form field, the value of which will be passed to the Display Function. In almost
all cases this option should contain the name of the form field.
Display Arguments are available for use with a form field and are used to control the conversion process. In the case
of the
expire_time
form field, the Display Function is set to
NwaDateFormat
to perform a conversion from a UNIX
time to a date/time string, and the Display Argument specifies the format to use for the conversion.
See
"Form Field Display Formatting Functions" on page 301
for a detailed list of the options available to you for the
Display Function and Static Display Function.
The
Enable If
and
Visible If
options in the form field editor allow you to specify JavaScript expressions. The result
obtained by evaluating these expressions is used to enable/disable, or show/hide the form field in real time, while an
operator is using the form.
Unlike the other parts of the form field editor, the
Enable If
and
Visible If
expressions are evaluated by the
operator’s Web browser. These expressions are not used by the server for any other purpose.
The expression must be a Boolean expression in the JavaScript language; statements and other code should not be
included as this will cause a syntax error when the form is displayed in a Web browser.
Because of the scoping rules of JavaScript, all of the user interface elements that make up the form are available as
variables in the local scope with the same name as the form field. Thus, to access the current value of a text field
named
sample_field
in a JavaScript expression, you would use the code
sample_field.value
.
Most user interface elements support the
value
property to retrieve the current value. For check boxes, however, use
the
checked
property to determine if the check box is currently selected.
The most practical use for this capability is to hide a form field until a certain value of some other related field has
been selected.
For example, the default
create_user
form has an
Account Expiration
drop-down list. One of the values in this list is
special: the
-1
option displays the value
Account expires at a specified time…
When this option is selected, the form expands to include the
Expires After
row, allowing the user to specify a time
other than one of the options in the list.
The
expire_time
field uses the JavaScript expression
expire_after.value < 0
for the
Visible If
option. When the -1
option has been selected, this condition will become true and the field will be displayed.
Additional examples of the
Visible If
conditional expressions can be found in the
guest_edit
form.