Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.
Комментарий: Восстановить из v. 7

...

Convert

...

the collection to

...

the string

Группа Коллекция, подгруппа Массивы

Описание

Действие объединяет элементы коллекции в одну строку.

Иконка

Image Removed

Параметры

Входные параметры

  • Поле "Коллекция"    Коллекция, элементы которой будут конвертированы в строку.
  • Поле "Разделитель"  Символ или символы, которые будут разделять элементы в строке."

Выходные параметры

  • "Результат". Описание: "Строка с объединенными элементами из коллекции.". Тип данных - Строка.

Настройки

...

Свойство

...

Описание

...

Тип

...

Пример заполнения

...

Обязательность заполнения поля

...

Параметры

...

Поле "Коллекция"

...

Коллекция, элементы которой будут конвертированы в строку

...

Коллекция

...

Обязательное.

...

Да

...

Поле "Разделитель"

...

Символ или символы, которые будут разделять элементы в строке

...

Коллекция

...

Необязательное

...

Да

...

Результаты

...

Результат

...

Строка с объединенными элементами из коллекции

...

Строка

 

Особые условия использования 

Collection group, Arrays subgroup

Description

The action converts the collection elements to one string. 

Action icon

Image Added

Parameters

Input parameters

  • The "Collection" field - the collection whose elements will be converted to a string. 
  • The "Separator" field - the character or characters that will separate the elements in the string. 

Output parameters

  • "Result". Description: the string with converted elements from the collection. Data type - Robin.String. 

Settings

PropertyDescriptionTypeFilling exampleMandatory field
Parameters
CollectionThe collection whose elements will be converted to a string.Robin.Collection
Yes
SeparatorThe character or characters that will separate the elements in the string.Robin.String
No
Results
ResultThe string with joined elements from the collection.Robin.String


Special conditions of use

  • The action can only convert collection items with the data types "String" or "Number".
  • If there are no string/numeric elements in the collection, the action will return an empty string.
  • If the collection contains elements of other types besides string/numeric elements, the action will convert only string/numeric elements.
  • The user can enter character\characters that will separate the elements in the string. Example: the elements of the collection are
  • Действие может объединять только элементы коллекции с типами данных «Строка» или «Число».
  • Если в коллекции нет строковых\числовых элементов, то действие вернет пустую строку.
  • Если в коллекции помимо строковых\числовых элементов, есть элементы других типов, то действие объединит только строковые\числовые элементы.
  • Пользователь может ввести символ\символы, которые будут разделять элементы в строке. Пример: Элементы коллекции: "1", "2", "3", "а". РазделительSeparator: "|". РезультатResult: строка string "1|2|3|аa".Если пользователь не выберет разделитель, то элементы в строке будут идти друг за другом. Пример: Элементы коллекции
  • If the user does not set a separator, the elements in the string will go one after the other. Example: The elements of a collection are: "1", "2", "3", "а".   Результат Result: строка string "123а123a".
  • Если в коллекции находится один строковый\числовой элемент, то действие вернет строку с одним элементов. В таком случае указанный разделитель не будет учитываться.
  • If there is one string/numeric element in the collection, the action will return a string with one element. In this case, the set separator will not be taken into account.
  • Output the collection of whole numbers without zero (i.e., not Целые числа выводить в коллекцию без нуля (то есть не "1.0" , а but "1").

 Пример использования 

Задача 1:

Объединение без разделителя

Решение

  1. Установить действие "Объединить элементы коллекции" на рабочую область.
  2. Корректно заполнить параметры: "Коллекция" - указать коллекцию с несколькими строковыми или числовыми элементами, указать "Разделитель" в виде символа\символов.
  3. Запустить робота.

Реализация

Example of use

Task 1 

Conversion without the separator. 

Solution

  1. Set the "Convert the collection to the string" items action to the workspace.
  2. Set the parameters correctly: in the "Collection" parameter set the collection with several string or numeric elements, set the "Separator" as a character/characters. 
  3. Run the robot. 

Implementation

  1. Set the "Convert the collection to the string" action to the workspace. 
  2. Set the parameters correctly: in the "Collection" field set the collection with several string or numeric elements, do not set the "Separator".
  3. Run the robot. 
  4. Установить действие "Объединить элементы коллекции" на рабочую область.
  5. Корректно заполнить параметры: "Коллекция" - указать коллекцию с несколькими строковыми или числовыми элементами, "Разделитель" - не указывать.
  6. Запустить робота.




Результат: Действие вернуло строку со строковыми и числовыми элементами коллекции, которые разделены указанными символами\символом.

Задача 2:

Объединение с разделителем

Решение

  1. Установить действие "Объединить элементы коллекции" на рабочую область.
  2. Корректно заполнить параметры: "Коллекция" - указать коллекцию с несколькими строковыми или числовыми элементами, "Разделитель" - указать символ\символы.
  3. Запустить робота.

Реализация

  1. Повторить пункты 1-3 Задачи 1.
  2. Корректно заполнить параметры: "Коллекция" - указать коллекцию с несколькими строковыми или числовыми элементами, "Разделитель" - не указывать.

Результат: Действие вернуло строку с идущими друг за другом строковыми и числовыми элементами указанной коллекции.

 Image Removed

Задача 3:

Объединение коллекции без строковых\числовых элементов

Решение

  1. Установить действие "Объединить элементы коллекции" на рабочую область.
  2. Корректно заполнить параметры: "Коллекция" - указать коллекцию без строковых и числовых элементов, "Разделитель" - указать символ\символы.
  3. Запустить робота.

Реализация

  1. Повторить пункты 1-3 Задачи 1.
  2. В Параметрах «Коллекция» не указывать  тип  коллекции. Оставить не заполненным.

 Image Removed

Результат: Действие вернуло пустую строку.

Задача 4

Объединение коллекции с целыми числами

  1. Установить действие "Объединить элементы коллекции" на рабочую область.
  2. Корректно заполнить параметры: "Коллекция" - указать коллекцию с целыми числами.
  3. Запустить робота.

Реализация

  1. Повторить пункты 1-3 Задачи 1.
  2. Задать в коллекции элементы в виде целых чисел, с разрядом после запятой в виде нуля.

Image Removed

Результат: Действие вернуло строку с идущими друг за другом целыми числами. Нуль после целых чисел не записан.


Result

The action returned the string with string and numeric collection elements that were separated with the set character/characters. 

Task 2:

Conversion with the separator

Solution

  1. Set the "Convert the collection to the string" action to the workspace. 
  2. Set the parameters correctly: in the "Collection" parameter set the collection with several string or numeric elements, set the "Separator" as a character/characters. 
  3. Run the robot. 

Implementation

  1. Repeat steps 1-3 of Task 1.
  2. Set the parameters correctly: in the "Collection" field set the collection with several string or numeric elements, do not set the "Separator".
  3. Run the robot.

Result

The action returned a string of consecutive string and numeric elements of the set collection.

 Image Added

Task 3

Conversion of the collection without string/numeric elements. 

Solution

  1. Set the "Convert the collection to the string" action to the workspace.
  2. Set the parameters correctly: in the "Collection" parameter set the collection without string or numeric elements, set the "Separator" as a character/characters.
  3. Run the robot. 

Implementation

  1. Repeat steps 1-3 of Task 1. 
  2. In the "Collection" parameters don't set the collection type. Leave it empty. 

 Image Added


Result

The action returned an empty string.

Task 4

Conversion of the collection with whole numbers

  1. Set the "Convert the collection to the string" action to the workspace. 
  2. Set the parameters correctly: in the "Collection" parameter set the collection with whole numbers.
  3. Run the robot. 

Implementation

  1. Repeat steps 1-3 of Task 1. 
  2. Set the elements in the collection as whole numbers, with the decimal place as zero.

Image Added

Result

The action returned a string of consecutive whole numbers. The zero after the whole numbers is not written.

Collection elementsЭлементы коллекции: "10.0", "11.0". РезультатResult: "1011".