Трекер хода выполнения (с поддержкой тем)
Виджет "Трекер хода выполнения" позволяет разбить сложные компоновки на несколько видов. Виджет можно использовать для упрощения сложного процесса путем разделения рабочего процесса на последовательные шаги. Для каждого шага в трекере хода выполнения может отображаться вложенный мэшап, в котором показаны отдельные виджеты. Виджет "Вложенный мэшап" можно использовать для отображения конкретного мэшапа для номера текущего шага. Текущий шаг подсвечивается, и пользователи могут перемещаться между шагами, что облегчает понимание эволюции формы или процесса.
Формат данных
Необходимо создать таблицу данных с определениями полей, которые представляют структуру данных для шагов. Таблица данных должна включать определение поля для номера шага, метки и связанного мэшапа. В следующей таблице перечислены форматы данных для таблицы данных.
|
Номер шага
|
Метка шага
|
Наименование мэшапа для шага
|
Интерактивный шаг
|
Состояние шага
|
|
|---|---|---|---|---|---|
|
Определение поля
|
StepNumber: {name: 'StepNumber', baseType: 'NUMBER'}
|
StepLabel: {name: 'StepLabel', baseType: 'STRING'}
|
StepMashupName: {name: 'StepMashupName', baseType: MASHUPNAME'}
|
StepInteracive: {name: 'StepInteracive', baseType: 'BOOLEAN'}
|
StepState: {name: 'StepState', baseType: 'STRING'}
|
|
Использование
|
Определяет номер шага.
|
Определяет метку шага.
|
Определяет наименование мэшапа, связанного с шагом.
|
Определяет состояние взаимодействия для шага.
|
Определяет состояние шага. Опции: Complete, Inactive, Current, Error
|
|
Базовый тип
|
NUMBER
|
STRING
|
NUMBER
|
BOOLEAN
|
STRING
|
|
Пример строки
|
StepNumber: 1
|
StepLabel: 'Step 1'
|
StepMashupName: 'Mashup1'
|
StepInteractive: true
|
StepLabel: 'current'
|
На следующем рисунке показан пример возвращенных данных из таблицы данных с четырьмя определениями полей для оси Y:
Добавление виджета "Трекер хода выполнения" в мэшап
1. Добавьте "Трекер хода выполнения" в пустой контейнер в компоновке.
2. Добавьте "Вложенный мэшап" во второй контейнер.
3. На панели Данные привяжите свойство All Data возвращенной таблицы данных к свойству Data виджета.
4. На панели Свойства настройте следующие свойства:
◦ StepNumberField - выберите столбец таблицы данных для номера шага.
◦ StepLabelField - выберите столбец таблицы данных для метки шага.
◦ StepMashupNameField - выберите столбец таблицы данных для наименования мэшапа. Убедитесь, что существуют наименования мэшапов.
◦ StepInteractiveField - выберите столбец таблицы данных, используемый для указания, является ли шаг интерактивным.
◦ StepStateField - выберите столбец таблицы данных, используемый для указания текущего шага.
5. Можно также задать для свойства виджета IsInteractive значение True, чтобы пользователи могли перемещаться между шагами, щелкая метку шага.
6. Привяжите свойство CurrentStepMashup виджета к свойству Name виджета "Вложенный мэшап".
7. Щелкните Сохранить, а затем щелкните Просмотр мэшапа.
Во время выполнения отображается мэшап, связанный с текущим шагом.
Включение интерактивных шагов
По умолчанию поддержка взаимодействия пользователя с шагами отключена во время выполнения. Чтобы добавить поддержку переходов между шагами, необходимо использовать события из виджетов или сервисов в мэшапе. Например, можно добавить кнопки, которые позволяют пользователям переходить к следующему или предыдущему шагу.
Можно включить свойство IsInteractive, позволяющее пользователям перемещаться между шагами во время выполнения, щелкнув метку шага. Это также позволяет пользователям перемещаться между шагами в произвольном порядке. На следующем рисунке показан интерактивный трекер хода выполнения.
Свойства виджета
Имя свойства | Описание | Базовый тип | Значение по умолчанию | Привязывание | Локализация |
|---|---|---|---|---|---|
CurrentStepMashup | Загружает наименование мэшапа для текущего шага. | STRING | Н/Д | Д | Н |
CurrentStepNumber | Задает или загружает номер текущего шага во время выполнения. | NUMBER | Н/Д | Д | Н |
Data | Источник данных таблицы данных, используемый для определения шагов при отображении в виджете. | INFOTABLE | Д | Н | |
DisableAutoStepCompletion | Отключает автоматическое завершение шагов при переходе между шагами в трекере хода выполнения. Если включено, состояние шага всегда задается с использованием данных таблицы данных, указанных с помощью свойства StepStateField. | BOOLEAN | False | Н | Н |
ErrorStateIcon | Указывает значок, отображаемый, если невозможно загрузить данные трекера хода выполнения. | MEDIALINK | error | Д | Н |
ErrorStateText | Указывает текст, отображаемый, если невозможно загрузить данные трекера хода выполнения. | STRING | [[ProgressTracker.unableToLoadData]] | Д | Д |
IsInteractive | Указывает, могут ли шаги быть интерактивными. | BOOLEAN | False | Д | Н |
MinStepSpacing | Задает минимальную длину горизонтальной линии, разделяющей шаги в трекере хода выполнения. | NUMBER | 90 | Н | Н |
NoBindingIcon | Указывает значок, отображаемый, если трекер хода выполнения не привязан к источнику данных. | MEDIALINK | bind | Н | Н |
NoBindingText | Указывает текст, отображаемый, если трекер хода выполнения не привязан к источнику данных. | STRING | [[ProgressTracker.noDataToDisplay]] | Н | Д |
NoDataIcon | Указывает значок, отображаемый, если трекер хода выполнения не содержит ни одного шага. | MEDIALINK | not visible | Д | Н |
NoDataText | Указывает текст, отображаемый, если трекер хода выполнения не содержит ни одного шага. | STRING | [[ProgressTracker.noStepData]] | Д | Д |
SelectedData | Таблица данных, представляющая данные выбранного шага. | INFOTABLE | Д | Н | |
StepClicked | Доступное для связывания событие, инициируемое при щелчке шага. | Событие | Д | Н | |
StepInteractiveField | Указывает поле таблицы данных, определяющее, будет ли шаг интерактивным. | Поле таблицы данных | Н | Н | |
StepLabelField | Указывает поле таблицы данных, содержащее метки шагов. | Поле таблицы данных | Н | Н | |
StepMashupNameField | Указывает поле таблицы данных, определяющее мэшап, отображаемый для каждого шага. | Поле таблицы данных | Н | Н | |
StepNumberField | Указывает поле таблицы данных, содержащее номера шагов. | Поле таблицы данных | Н | Н | |
StepSize | Задает размер значков шагов. Опции: Мелкий, Средний, Большой | STRING | Средний | Д | Н |
StepStateField | Указывает поле таблицы данных, определяющее состояние шага. | Поле таблицы данных | Н | Н | |
TabSequence | Задает последовательность, в которой виджет подсвечивается, когда пользователь нажимает клавишу TAB. | NUMBER | 0 | Н | Н |
Height | Задает высоту виджета при добавлении его в контейнер с фиксированными размерами. | NUMBER | 90 | Н | Н |
Width | Задает ширину виджета при добавлении его в контейнер с фиксированными размерами. | NUMBER | 600 | Н | Н |