Плитка
Определение и использование
Компонент "Плитка" - это виджет, позволяющий отображать пары "наименование-значение", также называемые атрибутами, в формате плитки. Компонент "Плитка" предназначен для подсветки ключевых участков информации, чтобы пользователи могли быстро их увидеть. Значение атрибута отображается в верхней половине плитки, а наименование атрибута отображается в нижней половине плитки. Значение может занимать до двух строк, а наименование может занять одну строку. Если значение или наименование слишком длинное и не умещается в плитке, оно обрезается и это обозначается многоточием. Все плитки, как правило, расположены в одной строке. Если плиток слишком много для одной строки, каждая плитка сжимается, чтобы все они вписались в размер строки. Если плиток все равно слишком много, чтобы поместить их в одной строке, отображение плиток переносится на вторую строку.
На приведенном ниже изображении показан компонент "Плитка".
Можно сконфигурировать компонент "Плитка" следующими способами.
• Задание максимального числа отображаемых плиток
• Добавление дополнительного атрибута
Базовая плитка - это базовая предопределенная конфигурация, доступная для компонента "Плитка".
Свойства привязки
Входные данные | ||
|---|---|---|
Имя свойства | Описание | Тип свойства |
Input | Используется для идентификации данных, которые должны вызываться из серверной системы. Пример JSON: { "version":"1.0.0", "data":[ { "adapter":{ "thingName":"PTC.WCAdapter", "instanceName":"windchill" }, "itemListsData":[ { "objectType":"PTC.ChangeMgmt.ChangeRequest", "items":[ { "id":{ "value":"OR:wt.change2.WTChangeRequest2:439476" } } ] } ] } ] } | JSON в формате CCO |
TailoringName | Уникально идентифицирует экземпляр компонента "Плитка". Это значение используется для внутреннего поиска информации о настройке конкретного экземпляра. Используйте это свойство привязки, только если существует специальная страница настройки для пользовательского задания. | Строка |
Свойства конфигурации
В следующей таблице и на изображении показаны свойства JSON, используемые для конфигурирования этого компонента.
Дополнительные сведения о структуре конфигурации см. в разделе Структура конфигурации компонента.
Дополнительные сведения о подсвойствах см. в разделе Подсвойства и ключи контейнера.
Имя свойства | Описание | Тип свойства | Значение по умолчанию | Обязательное или необязательное | ||
|---|---|---|---|---|---|---|
attributes | Наименования свойств, для которых ожидается поступление данных из серверной системы. Эти атрибуты могут либо загружаться из серверной системы, либо быть дополнительными. | Н/Д | Обязательное | |||
maxTileCount | Максимальное число атрибутов, отображаемых в плитке. Если задано как пустая строка, число отображаемых плиток не ограничено. | Н/Д | Необязательное | |||
Примеры конфигураций
Пример конфигурации для компонента "Плитка" см. в разделе конфигурации Базовая плитка.
Сервисы настройки
В дополнение к конфигурации каждый компонент поддерживает расширение бизнес-логики для настройки компонента. Бизнес-логика каждого компонента включает в себя переопределяемые сервисы в шаблоне вещи, которые можно расширять и переопределять. Переопределяемые сервисы для этого компонента подробно описаны в следующей таблице.
Примеры возвращаемых значений и параметров для каждого сервиса приведены в разделе Примеры ввода/вывода для сервисов настройки.
Наименование | Описание |
|---|---|
GetConfigurations | Возвращает доступные конфигурации для реализации компонента. Параметры: нет Возвращает: JSON |
GetImplementationLabel | Возвращает локализованное наименование компонента или лексему, которые можно использовать для получения локализованного наименования. Это локализованное наименование отображается в интерфейсе пользователя Mashup Builder. Параметры: нет Возвращает: строку |
ProcessAttributesConfiguration | Обрабатывает конфигурацию атрибутов и разделяет атрибуты на стандартные атрибуты и дополнительные атрибуты. Возвращает JSON с парами "ключ-значение" в следующем виде: • OOTBAttributes : OOTB Attributes configuration CCO JSON • additionalAttributes : Additional Attributes configuration CCO JSON Атрибуты разделяются на стандартные и дополнительные на основании их типа объекта. Атрибуты, имеющие тип объекта, заканчивающийся на .Custom.Adapter или Custom.Implementation, обрабатываются как дополнительные атрибуты. Все остальные атрибуты считаются стандартными атрибутами. Параметры: attributes (обязательный) - JSON со списком стандартных атрибутов и дополнительных атрибутов. configuration (необязательный) - JSON с окончательной объединенной конфигурацией, полученной из ресурса диспетчера настройки. Возвращает: JSON в формате CCO |
GetAttributesValues | Возвращает JSON с атрибутами и их значениями. Параметры: input (обязательный) - JSON в формате CCO, содержащий идентификатор входных данных, которые нужно вызвать из серверной системы, и информацию об адаптере для серверной системы. configuration (необязательный) - JSON с окончательной объединенной конфигурацией, полученной из ресурса диспетчера настройки. attributes (обязательный) - JSON со списком стандартных атрибутов и дополнительных атрибутов. Возвращает: JSON в формате CCO |
GetAdditionalAttributesValues | Возвращает JSON со значениями для дополнительных атрибутов. Этот сервис должен быть реализован в реализации компонента. Параметры: input (обязательный) - JSON в формате CCO, содержащий идентификатор входных данных, которые нужно вызвать из серверной системы, и информацию об адаптере для серверной системы. configuration (необязательный) - JSON с окончательной объединенной конфигурацией, полученной из ресурса диспетчера настройки. attributes (обязательный) - JSON со списком дополнительных атрибутов. OOTBAttributesValues (необязательный) - JSON в формате CCO со значениями стандартных атрибутов, возвращаемых действием GetAttributesValues. Эти значения можно использовать для расчета значений дополнительных атрибутов. Возвращает: JSON в формате CCO |
GetAdditionalAttributes | Возвращает список дополнительных атрибутов, которые нужно добавить в список доступных стандартных атрибутов. Параметры: нет Возвращает: JSON |
Определение реализации
Определение реализации для компонента "Плитка" см. в разделе конфигурации Базовая плитка.