Конфигурирование столбцов сетки
После привязки источника данных к сетке можно использовать диалоговое окно Конфигурировать виджет в Mashup Builder, чтобы настроить сетку:
• Добавить пользовательские названия столбцов.
• Выровнять содержимое в заголовке и в ячейках.
• Задать минимальную и максимальную ширину столбцов.
• Настроить рендерер и применить форматирования состояния.
• Исключить конкретные столбцы из источника данных и изменить порядок столбцов в сетке.
• Управлять шириной столбцов, используя пиксели, проценты или доли.
• Включить правку для конкретных столбцов при включении правки для сетки.
• Применить проверку входных данных для конкретного столбца, если включена правка.
Чтобы конфигурировать столбец сетки, выполните следующие шаги.
1. Выберите виджет "Сетка" на канве или используйте панель Проводник.
2. На панели Свойства щелкните 
. Откроется диалоговое окно конфигурации столбца сетки, в котором перечисляются столбцы таблицы данных.
. Откроется диалоговое окно конфигурации столбца сетки, в котором перечисляются столбцы таблицы данных.
3. На левой панели доступны следующие конфигурации:
◦ Чтобы изменить порядок отображения столбцов в сетке, перетащите и отсортируйте столбцы в списке.
◦ Чтобы исключить столбец из данных сетки, установите флажок Исключить справа.
◦ Чтобы скрыть столбец в представлении сетки по умолчанию, снимите флажок Показать. Можно управлять видимостью скрытых столбцов во время выполнения с помощью меню Показать или путем перетаскивания заголовков столбцов, если включено свойство ReorderColumns.
4. Выберите столбец на левой панели и настройте следующие опции справа:
◦ Формат столбца - общие опции форматирования столбцов в сетке.
▪ Название - понятное название столбца.
 | По умолчанию в заголовке столбца отображается имя, определяющее поле. Чтобы изменить текст названия, необходимо ввести название или выбрать лексему локализации. |
▪ Ширина столбца - задает ширину столбца. По умолчанию доступное пространство равномерно делится между столбцами.
▪ Минимальная ширина столбца - задает минимальную ширину, до которой можно сжать текущий столбец.
▪ Максимальная ширина столбца - задает максимальную ширину, до которой можно расширить текущий столбец.
| | Значения минимальной и максимальной ширины игнорируются, если для столбца задана фиксированная ширина. |
▪ Выравнивание ячеек по горизонтали и по вертикали - выравнивание содержимого внутри ячеек тела по верхнему краю, по центру и по нижнему краю или по левому краю, по центру и по правому краю.
▪ Выравнивание заголовка по горизонтали - выравнивание содержимого в ячейке заголовка по верхнему краю, по центру и по нижнему краю или по левому краю, по центру и по правому краю.
▪ Кнопка "Сортировать" - добавляет в заголовок столбца кнопку сортировки, которая позволяет пользователям сортировать значения во время выполнения.
▪ Начальная сортировка - позволяет сортировать значения столбцов по убыванию или по возрастанию при отображении сетки во время выполнения.
▪ Редактируемый - включает правку содержимого столбца, если сетка находится в режиме правки.
Дополнительные сведения о проверке см. в разделе Проверка входных данных в сетке.
▪ Требуется - определяет, требуется ли значение в каждой ячейке при правке данных сетки.
▪ Выражение критериев проверки - определяет выражение, используемое для вычисления входных данных при правке столбца во время выполнения.
▪ Сообщение проверки - сообщение для отображения критериев входных данных и сбоя.
▪ Сведения о критериях проверки - дополнительные сведения, отображаемые в сообщении о критериях проверки или сбое.
▪ Сообщение об успешной проверке - сообщение, отображаемое при успешной проверке.
▪ Сведения об успешной проверке - дополнительные сведения, отображаемые в сообщении об успешном выполнении.
▪ Исключить из формы правки строки - исключает столбец из формы правки строк, если задан режим правки сетки на уровне строки.
◦ Рендерер столбца - позволяет выбрать и сконфигурировать рендерер для данных столбца. Дополнительные сведения см. в разделе Рендереры и форматы столбцов сетки.
◦ Форматирование состояния - применение форматирования состояния к столбцу с использованием сущности определения состояния. Чтобы применить определение состояния к строке, используйте свойство RowFormat виджета.
5. Нажмите кнопку Готово, чтобы применить изменения к сетке.
Изменение порядка столбцов сетки
Столбцы в сетке можно сортировать одним из следующих способов:
• Добавьте атрибут ordinal при динамическом определении столбцов для данных таблицы данных. Например:
.AddField({ name: column, baseType: "STRING", ordinal: 0.0})
| | Атрибут ordinal поддерживается только в ThingWorx 9.3.2 или более поздних версиях. Если для задания порядка используются данные конфигурации JSON, порядковое значение игнорируется. |
• Укажите порядок, используя свойство columnIndex в конфигурации виджета JSON.
• Измените порядок столбцов с помощью диалогового окна конфигурации столбцов.
• Добавьте кнопку сортировки, которая позволяет пользователям сортировать данные столбца во время выполнения.
• Задайте для свойства ColumnsMenuOptions виджета значение Порядок, а затем используйте меню конфигурации столбцов во время выполнения.
Инициирование события при щелчке по гиперссылке
По умолчанию при щелчке по гиперссылке в сетке во время выполнения открывается связанный URL-адрес. В ThingWorx 9.3.6 или более поздней версии вместо этого можно настроить виджет для инициирования события.
1. В диалоговом окне конфигурации сетки выберите столбец таблицы данных, который содержит данные гиперссылки.
2. На вкладке Рендерер столбца выберите Проложить маршрут связей, используя событие.
3. Щелкните Готово, чтобы закрыть диалоговое окно.
На панели Свойства перечисляются следующие свойства контейнера:
• LinkClicked - событие, которое инициируется, если щелкнуть ссылку.
• ClickedLinkData - таблица данных, содержащая строку данных для выбранной ссылки.
• ClickedLinkColumn - возвращает имя столбца для последней выбранной ссылки. Это свойство можно использовать, если сетка содержит несколько столбцов с гиперссылками.
Можно привязать эти свойства, чтобы передавать данные ссылки в сервисы или функции в мэшапе. Например, свойства ClickedLinkData и LinkClicked можно привязать к функции "Навигация", которая передает данные в новый мэшап.