Webitel: Документація

Компонент "String"

1. Опис

Дозволяє маніпулювати з рядками.

Цей компонент присутній у схемах типу:

  • Голосова;

  • Текстова;

  • Форми;

  • Службова.

Блок (Рис. 1(1)) використовується у полі для побудови схеми. При натисканні на блок відкривається панель налаштувань даного компонента (Рис. 1(2)).

String.png
Рис. 1. Компонент "String”

1.1. Блок "String"

Блок складається з таких елементів:

  1. Назви компонента;

  2. Гілка "In" - гілка, що приймає (з'єднує з іншим блоком);

  3. Гілка "Out" - вихідна (з'єднує з наступним блоком) гілка.

При наведенні на поле "Out" з'являється перемикач, який дозволяє з'єднати цей компонент з компонентом, який вже має з'єднання.

Наявність іконки Screenshot 2024-11-07 154742.png позначає, що перемикач увімкнено, і цей компонент можна з'єднати з компонентом, який уже має з'єднання.

Зміна положення перемикача видаляє вихідну гілку цього компонента.

Кнопка Screenshot 2024-11-07 155145.png видаляє блок зі схеми.

1.2. Панель налаштувань "String"

Складається з таких елементів:

  1. Поле "Set result to variable";

  2. Поле "Expression";

  3. Поле "Method";

  4. Поле "Function arguments";

  5. Перемикач "Break";

  6. Елемент "Limit";

  7. Елемент "Add description".

1.2.1. Поле "Set result to variable"

Тут вказується назва нової змінної, в яку буде записуватися результат.

1.2.2. Поле "Expression"

Тут вказується змінна, з якою необхідно виконати маніпуляції.

1.2.3. Поле "Method"

Призначена для вибору методу маніпуляції. Доступні такі варіанти:

  • length - повертає довжину рядка;

  • indexOf - повертає індекс першого входження зазначеного значення в строковий об'єкт String, на якому він був викликаний. Повертає -1, якщо значення не знайдено;

  • search - шукає рядок для вказаного значення і повертає позицію збігу. Значення пошуку може бути рядком або регулярним виразом. Цей метод повертає -1, якщо збіг не знайдено;

  • slice - витягує текст з одного рядка і повертає новий рядок;

  • substring - схожа на slice. Різниця в тому, що підрядок не може приймати негативні індекси;

  • substr - схожий на slice. Різниця в тому, що другий параметр вказує довжину витягнутої частини;

  • replace - замінює вказане значення іншим значенням у рядку;

  • toUpperCase - рядок перетворюється у верхній регістр;

  • charAt - повертає символ за вказаним індексом (позицією) в рядку;

  • charCodeAt - повертає уніфіковане кодування символу за вказаним індексом у рядку;

  • split - рядок може бути перетворено в масив за допомогою функції split;

  • reverse - перевернути наданий рядок;

  • base64 - кодувальник/декодер base64;

  • MD5 - обчислює дайджест із рядка, використовуючи алгоритм MD5;

  • SHA-256 - обчислює дайджест із рядка з використанням алгоритму SHA-256;

  • SHA-512 - обчислює дайджест із рядка з використанням алгоритму SHA-512.

1.2.4. Поле "Function arguments"

Тут можна вказувати аргумент, який необхідний для деяких методів.

1.2.5. Перемикач "Break"

Відповідає за закінчення виконання схеми.

image-20241231-124210.png - ініціює закінчення виконання схеми після цього компонента;

image-20241231-124231.png - перемикач у вимкненому положенні.

1.2.6. Елемент "Limit"

Призначений для визначення максимальної кількості проходжень через цей компонент.

Натискання на кнопку "Add limit" додає поле "Max" та кнопку "Delete limit".

У полі “Max” вказується кількість можливих проходжень.

Якщо через компонент проходження буде більше, ніж зазначено в полі "Max", то використовуватиметься гілка "failover", яка з'являється в блоці компонента при установці ліміту.

Натискання на кнопку "Delete limit" забирає ліміт, повертаючи кнопку "Add limit".

Limit.png


Рис. 2. Встановлення ліміту

1.2.7. Елемент "Add description"

Натискання на кнопку "Add description" додає поле "Description" та кнопку "Delete description".

У полі "Description" вказується опис — коментарі до компонента.

Натискання на кнопку "Delete description" прибирає опис, повертаючи кнопку "Add description".

Description.png


Рис. 3. Елемент "Add description"