Проверка ячейки
Можно выполнить проверку ячеек в расширенной сетке и расширенной сетке дерева. Проверка ячейки позволяет не допускать недействительные записи в сетке во время правки. При проверке ячейки можно отобразить ошибку проверки и указать сообщение об исправлении ошибок во всплывающей подсказке. Ошибки проверки можно просмотреть в конфигурации Mashup Builder с помощью свойств ValidationErrorCellStyle и ValidationErrorTooltipStyle. Можно также выполнить проверку ячейки, используя конфигурацию JSON.
• Используйте свойство ValidationErrorCellStyle, чтобы задать стиль ячейки при возникновении ошибки проверки. Этот стиль заменяет любой другой стиль, который был сконфигурирован для ячейки.
• Используйте свойство ValidationErrorTooltipStyle, чтобы задать стиль всплывающей подсказки при возникновении ошибки проверки.
• Можно сконфигурировать выражения проверки и сообщения об ошибках, используя JSON или диалоговое окно конфигурации виджета. Чтобы локализовать сообщение об ошибке, используйте лексему локализации.
При обнаружении ошибки во всплывающей подсказке ячейки отображается настроенное сообщение об ошибке, а граница ячейки выделяется красным или желтым цветом в зависимости от типа ошибки.
Существует два типа ошибок проверки:
• Ошибка, связанная с блокировкой, - это предупреждение об ошибках. Например, ошибки в столбце идентификатора или ошибки в пустой ячейке, которая была сконфигурирована с валидатором NotEmpty. Невозможно сохранить изменения до тех пор, пока эти ошибки не будут устранены. Эти ошибки по умолчанию выделяются красной границей.
• Неблокирующая ошибка: такие ошибки не являются критическими, например запись строкового значения в ячейку, которая была сконфигурирована для целочисленных значений. Такие изменения можно сохранить до устранения этих ошибок. Эти ошибки по умолчанию выделяются желтой границей.
Различие между этими ошибками см. в следующем примере.
 | Проверка ячеек важна для столбца основного ключа во избежание ошибок или исключений сервера. Столбец основного ключа назначается с помощью свойства IDFieldName. Обычно это столбец идентификатора. |
Добавьте следующее содержимое, чтобы проверять ячейки и определять стиль ошибки проверки и стиль всплывающей подсказки.
"cellEditor": { // optional: defines cell-editing options for this column
"enabled": true, // *{boolean} to indicate whether cell editing is enable for this column
"validator": { // optional: when defined will validate input values against the chosen validator types and error and success messages will be displayed.
"types": ['NotEmpty'], // {Array} optional: defines list of validator types, e.g. 'NotEmpty', 'ValidURL' or 'Custom'.
"errorMessage": "[[invalidNumberNotEmpty]]", // *{string} localization token name of the error message.
"errorStyle": "cellValidationErrorStyle" // *{string} style definition name of the error message. }
}
"enabled": true, // *{boolean} to indicate whether cell editing is enable for this column
"validator": { // optional: when defined will validate input values against the chosen validator types and error and success messages will be displayed.
"types": ['NotEmpty'], // {Array} optional: defines list of validator types, e.g. 'NotEmpty', 'ValidURL' or 'Custom'.
"errorMessage": "[[invalidNumberNotEmpty]]", // *{string} localization token name of the error message.
"errorStyle": "cellValidationErrorStyle" // *{string} style definition name of the error message. }
}
"cellValidationErrorStyle": {
"backgroundColor": "",
"secondaryBackgroundColor": "",
"foregroundColor": "black",
"textDecoration": "none",
"image": "",
"lineColor": "red",
"borderStyle": "solid",
"borderWidth": "1px",
"fontFamily": ["helvetica", "arial"],
"fontStyle": "normal",
"fontSize": "11px",
"fontWeight": "normal"
},
"cellValidationErrorTooltipStyle": {
"backgroundColor": "red",
"secondaryBackgroundColor": "",
"foregroundColor": "white",
"textDecoration": "none",
"image": "",
"lineColor": "white",
"borderStyle": "solid",
"borderWidth": "1px",
"fontFamily": ["helvetica", "arial"],
"fontStyle": "normal",
"fontSize": "11px",
"fontWeight": "normal"
},
"tooltipStyle": {
"backgroundColor": "#0000ff",
"secondaryBackgroundColor": "",
"foregroundColor": "#ffffff",
"textDecoration": "",
"image": "",
"lineColor": "",
"borderStyle": "none",
"borderWidth": "",
"fontFamily": ["helvetica", "arial"],
"fontStyle": "normal",
"fontSize": "12px",
"fontWeight": ""
},
"backgroundColor": "",
"secondaryBackgroundColor": "",
"foregroundColor": "black",
"textDecoration": "none",
"image": "",
"lineColor": "red",
"borderStyle": "solid",
"borderWidth": "1px",
"fontFamily": ["helvetica", "arial"],
"fontStyle": "normal",
"fontSize": "11px",
"fontWeight": "normal"
},
"cellValidationErrorTooltipStyle": {
"backgroundColor": "red",
"secondaryBackgroundColor": "",
"foregroundColor": "white",
"textDecoration": "none",
"image": "",
"lineColor": "white",
"borderStyle": "solid",
"borderWidth": "1px",
"fontFamily": ["helvetica", "arial"],
"fontStyle": "normal",
"fontSize": "11px",
"fontWeight": "normal"
},
"tooltipStyle": {
"backgroundColor": "#0000ff",
"secondaryBackgroundColor": "",
"foregroundColor": "#ffffff",
"textDecoration": "",
"image": "",
"lineColor": "",
"borderStyle": "none",
"borderWidth": "",
"fontFamily": ["helvetica", "arial"],
"fontStyle": "normal",
"fontSize": "12px",
"fontWeight": ""
},
Проверка доступна для каждого типа рендерера. В зависимости от типа рендерера столбцов можно указать валидатор в конфигурации JSON. Для каждого типа рендерера доступны следующие валидаторы.
Рендерер | Валидаторы |
|---|---|
string | <None>, NotEmpty, ValidURL |
integer | <None>, NotEmpty, (ValidInteger is default) |
long | <None>, NotEmpty, (ValidNumeric is default) |
number | <None>, NotEmpty, (ValidNumeric is default) |
Логическое значение | <None>, NotEmpty, (ValidBoolean is default) |
location | <None>, NotEmpty, (ValidLocation is default) |
html | <None>, NotEmpty |
imagelink | <None>, NotEmpty |
гиперссылка | <None>, NotEmpty, ValidURL |
datetime | <None>, NotEmpty, (ValidDatetime is default) |