Действия с переменными
Чтобы вручную создать переменную в классическом потоке, разверните действие Задать переменную. Это действие требует указания имени и значения для новой переменной.
Внимание
В качестве имен переменных нельзя использовать зарезервированные ключевые слова. Полный список зарезервированных ключевых слов см. в статье Зарезервированные ключевые слова в классических потоках.
Чтобы увеличить или уменьшить числовое значение переменной, используйте действия Увеличить переменную и Уменьшить переменную соответственно.
Большинство действий выводят свой результат в переменную. Например, действие Создать новый список создает пустой список.
Точно так же действие Сгенерировать случайное число создает случайное числовое значение. Если вы включите Создать несколько чисел в этом действии, вы создадите переменную списка, содержащую несколько случайных числовых значений.
Чтобы добавить элементы в существующий список, разверните действие Добавить элемент в список и укажите жестко запрограммированное значение или переменную для определения добавляемого элемента. Аналогичным образом можно удалить элементы из списка с помощью действия Удалить элемент из списка.
Заметка
Индексы списка начинаются с 0, что означает, что первый элемент в списке всегда будет иметь индекс 0. Используйте запись %ИмяСписка[0]% для ссылки на первый элемент в списке, %ИмяСписка[1]% для ссылки на второй и т. д.
Если вы хотите создать переменную с таблицей данных, разверните действие Создать новую таблицу данных и укажите начальные элементы с помощью визуального конструктора.
Чтобы манипулировать переменной с таблицей данных, используйте действия соответствующей подгруппы действий, такие как Найти или заменить в таблице данных, а также Обновить элемент таблицы данных.
Создать новую таблицу данных
Создает новую переменную — таблицу данных.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Новая таблица | Нет | Таблица данных | Входная таблица данных. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
DataTable | Таблица данных | Новая таблица данных. |
Исключения
Это действие не включает никаких исключений.
Вставить строку в таблицу данных
Вставляет строку в конец таблицы данных или перед строкой с определенным индексом.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Таблица данных | Нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Она должна быть заранее задана с помощью действия, которое создает переменную в виде таблицы данных. | |
Место вставки | Неприменимо | Конец таблицы данных, перед индексом строки | Конец таблицы данных | Укажите, куда следует вставить новую строку: в конец таблицы данных или перед строкой с указанным индексом. |
Индекс строки | Нет | Числовое значение | Вставьте значение индекса строки, которое будет использоваться, если в качестве параметра "Место вставки" указан индекс строки. | |
Новые значения | Нет | Список, Строка данных | Этот параметр принимает переменную в виде списка или строки данных, в которых количество столбцов должно соответствовать количеству столбцов в таблице данных |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Описание |
---|---|
Индекс элемента выходит за пределы диапазона. | Указывает, что предоставленный индекс элемента выходит за пределы диапазона |
Недопустимые входные аргументы | Указывает, что существует недопустимый входной параметр |
Ошибка несовместимости типов | Указывает, что предоставлен входной параметр несовместимого типа. |
Удалить строку из таблицы данных
Удаляет строку таблицы данных по соответствующему индексу строки.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Таблица данных | Нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Эта переменная должна быть указана действием, которое создает переменную таблицы данных | |
Индекс строки | Нет | Числовое значение | Индекс строки в таблице данных, которую следует удалить. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Описание |
---|---|
Индекс элемента выходит за пределы диапазона. | Указывает, что предоставленный элемент таблицы данных выходит за пределы диапазона |
Обновить элемент таблицы данных
Обновляет элемент строки таблицы данных в определенном столбце.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Таблица данных | Нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Она должна быть заранее задана с помощью действия, которое создает переменную в виде таблицы данных. | |
Column | нет | Текстовое значение | Имя столбца или индекс элемента, который требуется обновить. | |
Строка | нет | Числовое значение | Индекс строки элемента, который требуется обновить. | |
Новое значение | нет | Текстовое значение | Новое значение для обновления значения в строке и столбце с указанными индексами. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Описание |
---|---|
Индекс элемента выходит за пределы диапазона. | Указывает, что предоставленный элемент таблицы данных выходит за пределы диапазона |
Имя столбца не существует. | Указывает, что предоставленное имя столбца не существует |
Индекс столбца выходит за пределы диапазона. | Указывает, что предоставленный индекс столбца выходит за пределы диапазона |
Ошибка несовместимости типов | Указывает, что был предоставлен входной параметр несовместимого типа |
Найти или заменить в таблице данных
Находит и/или заменяет значения в таблице данных.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Таблица данных | Нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Она должна быть заранее задана с помощью действия, которое создает переменную в виде таблицы данных. | |
Режим поиска | Неприменимо | Найти, найти и заменить | Поиск | Режим поиска (найти или найти и заменить) |
Все совпадения | Неприменимо | Логическое значение | Истина | Укажите, следует ли найти или заменить текст во всех найденных ячейках или только в первой найденной ячейке |
Текст для поиска | Нет | Текстовое значение | Текст, который требуется найти в таблице данных. | |
Найти с использованием регулярного выражения | Неприменимо | Логическое значение | Ложь | Укажите, следует ли использовать регулярное выражение для определения совпадения содержимого ячейки с искомым текстом. |
Учитывать регистр | Неприменимо | Логическое значение | Ложь | Укажите, учитывается ли при поиске регистр данных. |
Ячейка целиком | Неприменимо | Логическое значение | Ложь | Укажите, следует ли искать ячейки, содержащие только заданный текст и больше ничего. |
Заменить на | Нет | Текстовое значение | Текст, используемый для замены текста в найденных ячейках. | |
Поиск по | Неприменимо | Везде, в столбце | Везде | Порядок поиска текста (везде или в столбце). |
Имя или индекс столбца | Нет | Текстовое значение | Заголовок или значение индекса столбца |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
DataTableMatches (Совпадения таблицы данных) | Таблица данных | Таблица данных, содержащая индексы строк и столбцов для совпадений |
Исключения
Исключение | Описание |
---|---|
Предоставлено недопустимое регулярное выражение. | Указывает, что предоставленное регулярное выражение недопустимо. |
Имя столбца не существует. | Указывает, что предоставленное имя столбца не существует |
Индекс столбца выходит за пределы диапазона. | Указывает, что предоставленный индекс столбца выходит за пределы диапазона |
Ошибка несовместимости типов | Указывает, что предоставлен входной параметр несовместимого типа. |
Вставить столбец в таблицу данных
Вставляет столбец в конец таблицы данных или перед строкой с определенным индексом.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Таблица данных | Нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Эта переменная должна быть указана действием, которое создает переменную таблицы данных. | |
Место вставки | Неприменимо | Конец таблицы данных, перед индексом столбца | Конец таблицы данных | Укажите, куда следует вставить новый столбец: в конец таблицы данных или перед столбцом с указанным индексом. |
Имя столбца | нет | Текстовое значение | Укажите заголовок нового столбца. | |
Индекс столбца | нет | Числовое значение | Укажите значение индекса столбца, которое будет использоваться при выборе опции Перед индексом столбца для параметра Место вставки. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Description |
---|---|
Индекс столбца выходит за пределы диапазона. | Указывает, что предоставленный индекс столбца выходит за пределы диапазона. |
Повторяющееся имя столбца | Указывает, что указанное имя столбца уже существует. |
Удалить столбец из таблицы данных
Удаление столбца таблицы данных для указанного индекса столбца или имени столбца.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Таблица данных | Нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Эта переменная должна быть указана действием, которое создает переменную таблицы данных. | |
Указать столбец с | Неприменимо | Имя, индекс | Полное имя | Укажите, как следует искать столбец — по имени или по индексу. |
Имя столбца | нет | Текстовое значение | Имя столбца, который должен быть удален. | |
Индекс столбца | нет | Числовое значение | Индекс столбца, который должен быть удален. Индексы столбцов начинаются с 0. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Description |
---|---|
Имя столбца не существует. | Указывает, что предоставленное имя столбца не существует |
Индекс столбца выходит за пределы диапазона. | Указывает, что предоставленный индекс столбца выходит за пределы диапазона |
Удалить пустые строки из таблицы данных
Удаляет строки таблицы данных, в которых все ячейки пусты.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Таблица данных | Нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Она должна быть заранее задана с помощью действия, которое создает переменную в виде таблицы данных. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Удалить дубликаты строк из таблицы данных
Удаляет все повторяющиеся строки из таблицы данных, если значения имеют одинаковый тип данных в каждом столбце.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Data table | нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Указанная переменная должна быть определена действием, которое создает переменную таблицы данных. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Description |
---|---|
Несоответствие типов в ячейках столбца | Указывает, что два или более значений в одном столбце имеют другой тип данных |
Очистить таблицу данных
Удаляет все строки таблицы данных, не затрагивая заголовки таблиц.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Data table | нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Указанная переменная должна быть определена действием, которое создает переменную таблицы данных. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Сортировка данных таблицы
Сортирует строки таблицы данных по возрастанию или убыванию по указанному столбцу, если все его значения имеют один и тот же тип данных.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Data table | нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Указанная переменная должна быть определена действием, которое создает переменную таблицы данных. | |
Указать столбец с | Неприменимо | Имя, индекс | Полное имя | Укажите, как следует искать столбец — по имени или по индексу. |
Имя столбца | нет | Текстовое значение | Имя столбца, который должен быть отсортирован. | |
Индекс столбца | нет | Числовое значение | Индекс столбца, который должен быть отсортирован. Индексы столбцов начинаются с 0. | |
Порядок | Неприменимо | По возрастанию, По убыванию | По возрастанию | Порядок сортировки таблицы данных. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Description |
---|---|
Имя столбца не существует. | Указывает, что предоставленное имя столбца не существует |
Индекс столбца выходит за пределы диапазона. | Указывает, что предоставленный индекс столбца выходит за пределы диапазона |
Несоответствие типов в ячейках столбца | Указывает, что два или более значений в одном столбце имеют другой тип данных |
Фильтрация таблицы данных
Фильтрация строк таблицы данных на основе примененных правил.
Во встроенном мастере действия, который помогает создавать необходимые фильтры, вы можете применить несколько фильтров к разным столбцам, которые определены по имени или индексу. Каждый фильтр состоит из определенного столбца, на который он нацелен, выбранного оператора и присвоенного ему значения.
Кроме того, несколько фильтров применяются вместе с помощью правил «И» и/или «ИЛИ». Сначала в результирующем выражении фильтра разрешаются правила «И», а затем правила «ИЛИ».
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Data table | нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Указанная переменная должна быть определена действием, которое создает переменную таблицы данных. | |
Применяемые фильтры | нет | Правила фильтрации, определенные пользователем | Неприменимо | Правила фильтрации, примененные к определенным столбцам |
Создаваемые переменные
Аргумент | Type | Description |
---|---|---|
FilteredDataTable | Таблица данных | Созданная таблица данных после применения фильтров |
Исключения
Исключение | Description |
---|---|
Имя столбца не существует. | Указывает, что предоставленное имя столбца не существует |
Индекс столбца выходит за пределы диапазона. | Указывает, что предоставленный индекс столбца выходит за пределы диапазона |
Несоответствие типов в ячейках столбца | Указывает, что два или более значений в одном столбце имеют другой тип данных |
Объединить таблицы данных
Объединяет две таблицы данных вместе, определяя поведение слияния в случае, если количество столбцов в них различно.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
---|---|---|---|---|
Первая таблица данных | нет | Таблица данных | Первая переменная таблицы данных, с которой нужно работать. Это также переменная, созданная действием, которая содержит объединенную таблицу данных | |
Вторая таблица данных | нет | Таблица данных | Вторая таблица данных, объединенная с первой таблицей данных | |
Режим объединения | Неприменимо | Добавить дополнительные столбцы, игнорировать дополнительные столбцы, ошибка в дополнительных столбцах | Добавить дополнительные столбцы | Поведение слияния, которое применяется, когда в таблицах разное количество столбцов |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Description |
---|---|
Отсутствует схема | Указывает, что таблицы данных имеют разное количество столбцов |
Объединение таблиц данных
Объединяет две таблицы данных на основе указанного правила объединения.
Во встроенном мастере действия, который помогает создавать необходимые правила объединения, вы можете установить несколько правил, указав столбец из первой и второй таблицы данных соответственно, а также оператор сравнения, который применяется между ними.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
---|---|---|---|---|
Первая таблица данных | нет | Таблица данных | Первая переменная таблицы данных, с которой нужно работать. Указанная переменная должна быть определена действием, которое создает переменную таблицы данных. | |
Вторая таблица данных | нет | Таблица данных | Вторая переменная таблицы данных, с которой нужно работать. Указанная переменная должна быть определена действием, которое создает переменную таблицы данных. | |
Операция объединения | Неприменимо | Внутренний, слева, полный | Внутренний | Операция соединения, которая используется для соединения двух таблиц |
Правила объединения | нет | Правила объединения, определенные пользователем | Неприменимо | Определите столбцы и операцию, которая будет использоваться для объединения двух таблиц данных |
Создаваемые переменные
Аргумент | Type | Description |
---|---|---|
JoinedDataTable | Таблица данных | Созданная таблица данных после операции объединения |
Исключения
Исключение | Description |
---|---|
Имя столбца не существует. | Указывает, что предоставленное имя столбца не существует |
Индекс столбца выходит за пределы диапазона. | Указывает, что предоставленный индекс столбца выходит за пределы диапазона |
Считать из переменной текста CSV-файла
Создает таблицу данных из текста CSV-файла.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
---|---|---|---|---|
Текст CSV-файла | нет | Текстовое значение | Текстовая переменная CSV-файла для чтения. | |
Trim fields | Неприменимо | Логическое значение | Истина | Указывает, следует ли автоматически удалять пробелы в начале и в конце извлеченных ячеек. |
Первая строка содержит имена столбцов | Неприменимо | Логическое значение | False | Указывает, следует ли использовать первую строку текста CSV для установки имен столбцов результирующей таблицы данных. Включите этот параметр, чтобы имена не считывались как данные в таблицу. Последующие действия могут получить доступ к данным, содержащимся в таблице данных, используя имена столбцов (вместо номеров столбцов). |
Получить поля CSV-файла в виде текста | Неприменимо | Логическое значение | False | Укажите, следует ли получать содержимое текстовых полей CSV исключительно в виде текста или в виде наиболее близкого соответствующего типа. Например, Date Time для дат и Numeric для чисел. |
Columns separator | Неприменимо | Предварительно определенный, Произвольный, Фиксированная ширина столбцов | Предварительно определенный | Указывает, следует ли использовать предварительно определенный разделитель столбцов, пользовательский разделитель или же столбцы фиксированной ширины. |
Разделитель | Неприменимо | По умолчанию, Запятая, Точка с запятой, Символ табуляции | По умолчанию | Разделитель столбцов для анализа текста CSV-файла. |
Custom separator | нет | Текстовое значение | Пользовательский разделитель столбцов для анализа текста CSV-файла. | |
Fixed column widths | нет | Текстовое значение | Фиксированная ширина столбцов для использования при анализе текста CSV-файла. Разделите значения ширины с помощью запятых, пробелов, символов табуляции или новой строки. |
Создаваемые переменные
Аргумент | Type | Description |
---|---|---|
CSVTable | Таблица данных | Содержимое текста CSV-файла в виде таблицы данных |
Исключения
Исключение | Description |
---|---|
Не удалось выполнить анализ CSV-файла | Указывает на проблему при синтаксическом анализе текста CSV-файла |
Преобразовать таблицу данных в текст
Преобразует таблицу данных в текст CSV-файла.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Data table | нет | Таблица данных | Переменная в виде таблицы данных, с которой будет выполняться работа. Указанная переменная должна быть определена действием, которое создает переменную таблицы данных. | |
Include column names | Неприменимо | Логическое значение | False | Указывает, должны ли указанные имена столбцов указанного варианта стать первой строкой текста CSV-файла. |
Use custom columns separator | Неприменимо | Логическое значение | False | Указывает, следует ли использовать пользовательский разделитель столбцов или же предварительно определенный разделитель столбцов. |
Разделитель | Неприменимо | По умолчанию, Запятая, Точка с запятой, Символ табуляции | По умолчанию | Разделитель столбцов для использования в указанном тексте CSV-файла. |
Custom columns separator | нет | Текстовое значение | Пользовательский разделитель столбцов для использования в указанном тексте CSV-файла. |
Создаваемые переменные
Аргумент | Type | Description |
---|---|---|
CSVText | Текстовое значение | Переменная для сохранения результата CSV |
Исключения
Исключение | Description |
---|---|
Не удалось выполнить преобразование | Указывает на проблему преобразования таблицы данных в текст CSV-файла |
Усечь число
Получение целой или дробной части числового значения или округление значения до указанного числа десятичных знаков.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Number to truncate | Нет | Числовое значение | Число или переменная, которая содержит числовое значение для усечения или округления. | |
Operation | Н/Д | Получить целую часть, Получить дробную часть, Округлить число | Получить целую часть | Указывает операцию, которую требуется выполнить с данным числом. |
Decimal places | Да | Числовое значение | 3 | Количество десятичных знаков, до которого необходимо округлить данное число. Введите 0, чтобы в результате вернуть целое число |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
TruncatedValue | Числовое значение | Усеченное или округленное число. |
Исключения
Это действие не включает никаких исключений.
Создать случайное число
Создание случайного числа или списка случайных чисел в диапазоне от минимального до максимального значений.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Minimum value | Да | Числовое значение | 0 | Нижняя граница для создания случайных чисел. |
Maximum value | Да | Числовое значение | 100 | Верхняя граница для создания случайных чисел. |
Generate multiple numbers | Н/Д | Логическое значение | Ложь | Указывает, следует ли создать одно случайное число или список случайных чисел. |
How many numbers | Да | Числовое значение | 10 | Указывает, сколько случайных чисел следует создать. |
Allow duplicates | Н/Д | Логическое значение | Ложь | Указывает, следует ли разрешить или запретить отображение одного числа несколько раз в списке случайных чисел. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
RandomNumber | Числовое значение | Новое созданное случайное число. |
RandomNumbers | Списокчисловых значений | Новый созданный список случайных чисел. |
Исключения
Исключение | Описание |
---|---|
Не удалось создать случайное число. | Указывает, что произошла ошибка при создании случайного числа |
Очистить список
Удаление всех элементов из списка.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
List to clear | Нет | Списокобщих значений | Переменная списка, из которой требуется удалить элементы. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Удалить элемент из списка
Удаление одного или нескольких элементов из списка.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Remove item by | Н/Д | Индекс, Значение | Индекс | Указывает, следует ли удалить элемент с указанным индексом или элементы с определенным значением. |
At index | Нет | Числовое значение | Числовой индекс элемента для удаления. | |
With value | Нет | Общее значение | Элемент, который требуется удалить. | |
Remove all item occurrences | Н/Д | Логическое значение | Ложь | Удаляет все вхождения, соответствующие указанному элементу. |
From list | Нет | Списокобщих значений | Список с элементами для удаления. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Исключение | Описание |
---|---|
Индекс элемента выходит за пределы диапазона. | Указывает, что индекс элемента выходит за пределы диапазона. |
Элемент не найден. | Указывает, что элемент не существует в списке. |
Сортировать список
Сортировка элементов списка. Используйте элементы одного типа.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
List to sort | Нет | Списокобщих значений | Переменная, содержащая список для сортировки. | |
Sort by list item's properties | Н/Д | Логическое значение | False | Если элементы списка являются объектами (например, файлами, папками и т. д.), включите этот параметр, чтобы отсортировать элемент по определенному свойству. Оставьте этот параметр отключенным, чтобы отсортировать элементы по их свойству по умолчанию (например, файловые объекты сортируются по их полному пути) |
Первое свойство, по которому требуется выполнить сортировку | Да | Текстовое значение | Имя свойства элемента, по которому требуется выполнить сортировку списка. Обратитесь к файлу справки, чтобы узнать имена свойств каждого объекта | |
Sort | Н/Д | По возрастанию, По убыванию | По возрастанию | Указывает, следует ли сортировать по первому свойству по возрастанию или убыванию. |
Second property to sort by | Да | Текстовое значение | Имя второго свойства, по которому требуется выполнить сортировку списка. | |
Sort | Н/Д | По возрастанию, По убыванию | По возрастанию | Указывает, следует ли сортировать по второму свойству по возрастанию или убыванию. |
Third property to sort by | Да | Текстовое значение | Имя третьего свойства, по которому требуется выполнить сортировку списка. | |
Sort | Н/Д | По возрастанию, По убыванию | По возрастанию | Указывает, следует ли сортировать по третьему свойству по возрастанию или убыванию. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Изменить порядок списка на случайный
Создание списка со случайным порядком элементов.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
List to shuffle | Нет | Списокобщих значений | Переменная, содержащая список, порядок которого требуется изменить на случайный. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Объединить списки
Объединение двух списков в один.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
First list | Нет | Списокобщих значений | Первый список элементов для объединения. | |
Second list | Нет | Списокобщих значений | Второй список элементов для объединения. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
OutputList | Списокобщих значений | Объединенный список. Это не влияет на исходные списки |
Исключения
Исключение | Описание |
---|---|
Предоставленные списки имеют несовместимые типы. | Указывает, что предоставленные списки имеют несовместимые типы. |
Изменить порядок списка на обратный
Расположение элементов списка в обратном порядке.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
List to reverse | Нет | Списокобщих значений | Список, порядок расположения элементов в котором необходимо изменить на обратный. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Удалить повторяющиеся элементы из списка
Удаление нескольких вхождений элементов в списке, чтобы в полученном списке каждый элемент был уникальным.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
List to remove duplicate items from | Нет | Списокобщих значений | Переменная списка, из которой требуется удалить повторяющиеся элементы. | |
Ignore text case while searching for duplicate items | Н/Д | Логическое значение | Ложь | Указывает, следует ли выполнять сравнение текста без учета регистра при поиске повторяющихся элементов (применяется только к спискам, состоящим из текстовых элементов). |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Найти общие элементы списка
Сравнение двух списков и создание нового списка с элементами, общими для обоих списков.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
First list | Нет | Списокобщих значений | Переменная, содержащая первый список для сравнения. | |
Second list | Нет | Списокобщих значений | Переменная, содержащая второй список для сравнения. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
IntersectionList | Списокобщих значений | Новый список общих элементов. |
Исключения
Это действие не включает никаких исключений.
Вычесть списки
Сравнение двух списков и создание нового списка с элементами, которые находятся в первом списке, но не во втором.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
First list | Нет | Списокобщих значений | Переменная, содержащая первый список для сравнения. | |
Second list | Нет | Списокобщих значений | Переменная, содержащая второй список для сравнения. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
ListDifference | Списокобщих значений | Новый полученный список. |
Исключения
Это действие не включает никаких исключений.
Извлечь столбец таблицы данных в список
Преобразование содержимого столбца таблицы данных в список.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Data table | Нет | Таблица данных | Таблица данных со столбцом для преобразования в список. | |
Column name or index | Нет | Текстовое значение | Имя столбца, если определены имена столбцов, или номер индекса столбца для извлечения. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
ColumnAsList | Списокобщих значений | Новый список с содержимым указанной таблицы данных. |
Исключения
Исключение | Описание |
---|---|
Имя столбца не существует. | Указывает, что имени столбца нет в таблице данных. |
Индекс столбца выходит за пределы диапазона. | Указывает, что индекс столбца выходит за пределы диапазона. |
Преобразовать JSON в настраиваемый объект
Преобразование строки JSON в пользовательский объект.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
JSON | Нет | Текстовое значение | Текст JSON или ранее созданная содержащая его переменная для преобразования в настраиваемый объект. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
JsonAsCustomObject | Общее значение | Преобразованный настраиваемый объект из предоставленного JSON |
Исключения
Исключение | Описание |
---|---|
Ошибка анализа JSON. | Указывает, что произошла ошибка анализа указанного JSON |
Преобразовать настраиваемый объект в JSON
Преобразование пользовательского объекта в строку JSON.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Custom object | Нет | Пользовательский объект | Настраиваемый объект для преобразования в JSON. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
CustomObjectAsJson | Текстовое значение | Преобразованный JSON из предоставленного настраиваемого объекта. |
Исключения
Исключение | Описание |
---|---|
Ошибка анализа настраиваемого объекта. | Указывает, что произошла ошибка при анализе настраиваемого объекта |
Добавить элемент в список
Добавление нового элемента в список.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Add item | Нет | Общее значение | Значение или переменная, которую нужно добавить в список. Предоставьте список значений для добавления нескольких элементов. Если в списке есть элементы определенного типа, новый элемент преобразуется в этот тип | |
Into list | Нет | Списокобщих значений | Переменная списка, в которую требуется добавить новые элементы. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
NewList | Списокобщих значений | Новый список. |
Исключения
Это действие не включает никаких исключений.
Создать новый список
Создание нового пустого списка.
Входные параметры
Это действие не требует никаких входных данных.
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
Список (List) | Списокобщих значений | Новый список. |
Исключения
Это действие не включает никаких исключений.
Увеличить переменную
Увеличение значения переменной на определенную величину.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Variable name | Нет | Числовое значение | Числовое значение для увеличения. | |
Increase by | Нет | Числовое значение | Числовое значение или ранее созданная содержащая его переменная, на которую следует увеличить переменную. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Уменьшить переменную
Уменьшение значения переменной на определенную величину.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Variable name | Нет | Числовое значение | Числовое значение или ранее созданная содержащая его переменная, на которую следует уменьшить переменную. | |
Decrease by | Нет | Числовое значение | Числовое значение или ранее созданная содержащая его переменная, на которую следует уменьшить переменную. |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Выполнить выражение Power Fx
Запускает предоставленное выражение Power Fx.
Заметка
Это действие доступно только для классических потоков с Power Fx (предварительная версия).
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Description |
---|---|---|---|---|
Выражение | нет | * | Выражение Power Fx, которое требуется выполнить |
Создаваемые переменные
Это действие не создает никаких переменных.
Исключения
Это действие не включает никаких исключений.
Задать переменную
Задание значения новой или существующей переменной, создание новой переменной или перезапись ранее созданной переменной.
Входные параметры
Аргумент | Необязательно | Принимает | Значение по умолчанию | Описание |
---|---|---|---|---|
Действие | Нет | * | Значение, которое требуется присвоить переменной. |
Создаваемые переменные
Аргумент | Тип | Описание |
---|---|---|
NewVar | * | Имя переменной, которую требуется задать. |
Заметка
Имена переменных должны начинаться либо с буквы, либо с символа подчеркивания (_). После первого символа имена переменных могут содержать буквы, символы подчеркивания и цифры (0-9). Имена не чувствительны к регистру, то есть myVar, myvar и MYVAR считаются одной и той же переменной. Следующие зарезервированные ключевые слова нельзя использовать в качестве имен переменных: if, then, else, switch, case, default, loop, from, to, step, foreach, in, while, next, exit, label, goto, call, output, function, block, end, error, wait, for, set, main, and, or, xor, not, true, false, yes, no, disable, on, repeat, times, throw, action, mod, global, input, import
Исключения
Это действие не включает никаких исключений.