Просмотреть исходный

Вход в карточку ресурсов

Для входа в Карточку ресурсов - режим чтение нужно подвести курсор на название ресурса (5) и нажать на него, при этом открывается модальное окно "Ресурс".

Документация ROBIN > Карточка ресурса > 2024-11-02_08-47-51.png

Описание элементов интерфейса модального окна "Ресурс"

Описание элементов интерфейса модального окна "Ресурс" представлено в нижеприведенной таблице.

Название элемента интерфейса	Доступные значения\по умолчанию	Описание
Вернуться	-	При нажатии закрывается страница создания ресурса; происходит возврат на страницу "Хранилище ресурсов". Ресурс создан не будет
Редактировать (1)
Название ресурса (2)	-	Название ресурса Пример: Пароль для 1С Данное поле не может быть пустым. В режиме создания/редактирования/изменения в поле появляется кнопка в виде крестика для очищения от текста.
Тип данных (3)	Доступные значения: Строка Число Дата-время Логический Пароль Путь к файлу Путь к папке Изображение Коллекция Словарь Таблица Значение по умолчанию: Строка	Тип данных создаваемого ресурса В списке доступен выбор только одного значения. Выбранное значение влияет на внешний вид поля "Значение". Поле типа данных создаваемого ресурса редактированию/изменению имеющегося ресурса в режиме редактирования карточки ресурсов изменению не подлежит
Значение (4)	Наличие значения по умолчанию зависит от выбранного типа данных	Внешний вид поля и вариант настройки его значения зависят от выбранного типа данных. Подробнее в Варианты значения в зависимости от типа данных Т.к. при открытии страницы создания в поле "Тип данных" по умолчанию выбран тип "Строка", то поле ""Значение" по умолчанию выглядит как редактируемое текстовое поле
Создать - в режиме создания ресурса	-	При нажатии создание ресурса не происходит и страница не закрывается, если: В текущем тенанте уже есть ресурс с таким же названием, при этом появляется предупреждение: *"Ошибка при создании ресурса* *Ресурс с таким названием уже существует"* Обязательные поля не заполнены. Они подсвечиваются красным и под ними появляется фраза *"Данное поле не может быть пустым", появляется предупреждение: "Ошибка при создании ресурса* Заполнены не все поля" При заполнении словаря добавили ключи с одинаковыми названиями, появляется предупреждение: *"Ошибка при создании ресурса* *В словаре есть ключи с одинаковым названием"* Ключ должен быть уникален только в рамках того словаря, в котором он указан, а не среди всех словарей, добавленных в ресурс. Например, сам ресурс - это словарь. Одно из значений словаря указали тоже с типом "Словарь". Получается словарь, содержащий еще один словарь. Они считаются разными словарями, т.е. один словарь не является продолжением другого. Поэтому уникальность ключей проверяется в каждом словаре по отдельности. Если при заполнении таблицы указали столбцы с одинаковым названием, появляется предупреждение: *"Ошибка при создании ресурса* *В таблице есть столбцы с одинаковым названием"* Если все проверки пройдены успешно, создается новый ресурс, происходит возврат на страницу раздела "Хранилище ресурсов", появляется уведомление: *"Ресурс "Название ресурса" успешно создан"*
Сохранить - в режиме редактирования/изменения ресурса
Отменить - в режимах создать/редактировать/изменить	-	При нажатии открывается окно с сообщением: "Вы уверены, что хотите отменить создание/изменения ресурса?" При нажатии на кнопку "Нет", окно закрывается, остается текущая страница При нажатии на кнопку "Да", окно закрывается, происходит возврат на страницу раздела "Хранилище ресурсов", ресурс не создается

Описание вариантов параметра "Значение" в зависимости от типа данных

В поля, где тип данных "Путь к файлу", "Путь к папке" или "Изображение" ввод значения в настоящее время будет только вручную. Т.к. из соображений безопасности, браузеры заменяют путь выбранного файла фейковым, тем самым защищая пользователя, то мы не сможем передать в поле захваченный реальный путь до файла/папки.

Например, настоящий путь "C:\users\user\фото_на_паспорт.jpg" будет заменен на "C:\fakepath\фото_на_паспорт.jpg". Робот, получивший такой фейковый путь ресурса, не сможет найти по нему нужный файл.

Описание поля "Значение" в зависимости от типа данных ресурса

Тип данных ресурса	Описание поля "Значение"	Шаблон\пример	Внешний поля "Значение" (инструмент редактирования) при значении по умолчанию
Строка	Внешний вид: редактируемое текстовое поле Значение поля отображается как текст. Если значение не указывали, поле будет пустым По умолчанию при вводе текста высота поля позволяет отобразить только 2 строки текста. Если пользователь вводит больше 2х строк, автоматически высота поля не увеличивается. Высоту поля можно увеличить вручную, потянув за его правый нижний угол При вводе текста в поле отображается то количество строк, которое позволяет текущая высота поля - по умолчанию или та, на которую пользователь "растянул" поле. Если кол-во строк превышает высоту поля, верхние сроки начинают "скрываться" за границей поля так, чтобы вводимая строка всегда оставалась видна в поле Если убрать фокус с поля: высота поля останется такой же, какой была при вводе - по умолчанию или та, на которую пользователь "растянул" поле текст останется на том же месте, где остановили ввод. Т.е. вверх, к 1й строке не поднимется (если она скрылась за границей поля) В поле есть кнопка для очищения от текста	Пример: тест12345678	Пустое поле
Логический	Внешний вид: переключатель, на котором указано сразу оба возможных значения - "Истина" и "Ложь", но подсвечен только выбранный вариант.		Переключатель, установленный на значении "Ложь"
Число	Внешний вид: редактируемое числовое поле, в котором доступен ввод: только цифр от 0-9, "-" и ","; не более одного знака "-" и ",". В поле есть кнопка для очищения от значения Если пользователь очищает поле вручную (например, через backspace) автоматически поле не заполнится каким-либо числом по умолчанию, т.е. поле останется пустым (даже после сохранения ресурса)	Пример: 15	Пустое поле
Пароль	Внешний вид: редактируемое текстовое поле Пока поле не заполнено, в сплывающем окне отображается фраз "Пароль не задан" Пароль вводится в виде точек. При вводе значения в поле появляется кнопка в виде крестика для очистки поля. При очистке значения в сплывающем окне вновь появляется фраза "Пароль не задан"		Пустое поле с подсказкой: "Пароль не задан"
Дата-время	Значение настраивается при помощи 2х полей: редактируемое поле с типом данных "дата-время": По клику на 1е поле с датой появляется форма для выбора даты и времени, содержащая: кнопки выбора года и месяца календарик для выбора дня месяца кнопки для выбора часов, минут и секунд кнопка "Сейчас": по нажатию в поле вводится текущие дата\время кнопка "Ок": по нажатию форма закрывается, выбранные значения остаются в поле Ввести значение можно и вручную. Значение автоматически вводится по маске "dd.mm.yyyy hh:mm:ss". В поле есть кнопка для очищения от значения выпадающий список для выбора часового пояса. Значение по умолчанию - локальный часовой пояс пользователя На интерфейсе время отображается в том часовом поясе, который ранее был установлен для ресурса. Например, при создании или последнем редактировании ресурса ему указали московский часовой пояс. У него будет указано "... 16:00:00 +03:00; Europe/Moscow". Если карточку ресурса откроет пользователь из Уфы, ему также отобразиться значение "... 16:00:00 +03:00; Europe/Moscow" (не "... 18:00:00 +05:00; Asia/Yekaterinburg").	Шаблон для поля с датой: dd.mm.yyyy hh:mm:ss Пример: 30.08.2023 16:35:02
Дата-время		Шаблон для поля с часовым поясом: <смещение относительно UTC> <id часового пояса> Пример: +03:00; Europe/Moscow
Путь к папке	Значение поля отображается как текст. Если значение не указывали, поле будет пустым В поле есть кнопка для очищения от текста Путь к папке можно указать только вручную	Пример: C:\Users\user\Downloads\ROBIN	Пустое поле
Путь к файлу	Значение поля отображается как текст. Если значение не указывали, поле будет пустым В поле есть кнопка для очищения от текста Путь к файлу можно указать только вручную	Пример: C:\Users\user\Downloads\ROBIN\yandexdriver.exe	Пустое поле
Изображение	Значение поля отображается как текст. Если значение не указывали, поле будет пустым В поле есть кнопка для очищения от текста Путь к файлу изображения можно указать только вручную	Пример: ‪C:\Users\Huawei\Desktop\Скриншот.png	Пустое поле
Коллекция	Значение коллекции - это список элементов. Элементы коллекции могут иметь разный тип данных Если у ресурса не указывали значение, отображается фраза *"Элементов: 0"* Если у ресурса указывали значение, то отображается: фраза о кол-ве элементов в коллекции (шаблон и пример см. слева) список элементов Каждая строка списка содержит: порядковый номер элемента (нумерация начинается с 0) название типа данных элемента значение элемента. Внешний вид значения элемента зависит от типа данных этого элемента (см. соотв. описание для разных типов). Но есть отличия от стандартного внешнего вида для типов "Коллекция" и "Словарь": рядом с фразой о кол-ве элементов\записей есть шеврон для скрытия\раскрытия списка элементов\записей. При открытии карточки в режиме чтения все такие шевроны в свернутом виде. При нажатии на развернутый шеврон сворачивается только тот список, к которому относится шеврон, и его дочерние списки. При этом родительские списки (если они есть) и списки того же уровня вложенности не сворачиваются Ограничения на кол-во элементов в коллекции нет У основной коллекции (когда тип всего ресурса - коллекция) в списке элементов есть отдельный выпадающий список. Но у списков дочерних коллекций (когда коллекция внутри коллекции\словаря) отдельного выпадающего списка нет Если выбран тип данных "Коллекция", то значение будет состоят из нескольких элементов интерфейса. Подробнее ниже		Если текст "Элементов: 0",то список элементов коллекции отсутствует
Словарь	Значение словаря - это список записей, состоящих из ключа и значения. Записи могут иметь разный тип данных Если текст "Записей: 0", то список записей словаря отсутствует Ограничения на кол-во записей в словаре нет У основного словаря (когда тип всего ресурса - словарь) в списке записей есть отдельный выпадающий список. Но у списков дочерних словарей (когда словарь внутри коллекции\словаря) отдельного выпадающего списка нет Если выбран тип данных "Словарь", то значение будет состоят из нескольких элементов интерфейса. Подробнее ниже		Если текст "Записей: 0", то список записей словаря отсутствует
Таблица	Если выбран тип данных "Таблица", то значение будет состоят из нескольких элементов интерфейса Если текст "Столбцов: 0; строк: 0",то таблица отсутствует Подробнее ниже		Если текст "Столбцов: 0; строк: 0",то таблица отсутствует

Описание полей/кнопок для настройки значения типа "Коллекция"

Количество элементов коллекции

Это краткое отображение значения коллекции, которое указывает текущее количество ее элементов (1).

Шаблон:

Элементов: <количество элементов коллекции>

Пример:

Элементов: 3

Документация ROBIN > Карточка ресурса > 2024-10-31_08-35-11.png

Число в этой фразе меняется сразу, как только пользователь добавляет или удаляет элемент из коллекции (т.е. еще до сохранения ресурса). Если в коллекции нет элементов, то указано "Элементов: 0"

Если это дочерняя коллекция (коллекция внутри коллекции\словаря), то рядом есть шеврон (2), который:

скрывает\отображает поле "Тип данных элемента" и список элементов этой коллекции
не влияет на скрытие\отображение родительской коллекции и других элементов родительской коллекции

Если значение дочерней коллекции - "Элементов: 0", то шеврона нет, поле "Тип данных элемента" не скрыто.

Документация ROBIN > Карточка ресурса > 2024-10-31_08-24-52.png

Тип данных элемента

Тип данных добавляемого элемента коллекции.

Доступные значения:

Строка
Число
Дата-время
Логический
Пароль
Путь к файлу
Путь к папке
Изображение
Коллекция
Словарь
Таблица

Значение по умолчанию: "Строка"

Каждая добавляемая строка с элементом содержит:

Порядковый номер элемента. Нумерация начинается с 0
Название типа данных элемента
Значение элемента. Внешний вид поля(ей)\кнопок для настройки значения элемента зависит от типа данных этого элемента.
Кнопку "Удалить элемент". При нажатии удаляется строка с выбранным элементом. При этом порядковые номера тех элементов, которые были ниже, уменьшаются на 1

В списке доступен выбор только одного значения. Выбранное значение влияет на то, какой вид (поля\кнопки для настройки) будет иметь значение добавляемого элемента.

Если это поле для выбора типа элемента у основной коллекции (когда тип всего ресурса - коллекция), то при выпадающем списке вниз/вверх это поле не перемещается (как шапка у таблиц в разделах), прокручиваются только строки с элементами коллекции.

По нажатию в список элементов коллекции добавляется еще одна строка с новым элементом. Тип данных этого элемента = тому, который на тот момент был выбран в поле "Тип данных элемента".

Если это кнопка для добавления элемента у основной коллекции (когда тип всего ресурса - коллекция), то при выпадающем списке вниз/вверх эта кнопка не перемещается (как кнопки над таблицами в разделах), прокручиваются только строки с элементами коллекции.

Документация ROBIN > Карточка ресурса > 2024-10-31_07-49-32.png

Документация ROBIN > Карточка ресурса > 2024-10-31_07-50-48.png

Но аналогичное поле у дочерней коллекции (коллекция внутри коллекции/cловаря), будет прокручиваться вместе с элементами.

Документация ROBIN > Карточка ресурса > 2024-10-31_09-18-13.png

Описание полей/кнопок для настройки значения типа "Словарь"

Значение - Количество записей словаря

Это краткое отображение значения словаря, которое указывает текущее количество его записей.

Шаблон:

Записей: <количество записей словаря>

Пример:

Записей: 3

Документация ROBIN > Карточка ресурса > 2024-10-31_21-52-40.png

Число в этой фразе (1) меняется сразу, как только пользователь добавляет или удаляет запись из словаря (т.е. еще до сохранения ресурса). Если в словаре нет записей, то указано "Записей: 0"

Если это дочерний словарь (словарь внутри коллекции\словаря), то рядом есть шеврон, который:

скрывает\отображает кнопку "Добавить запись" и список записей этого словаря
не влияет на скрытие\отображение родительского словаря и др. записей родительского словаря

Если значение дочернего словаря - "Записей: 0", то шеврона нет, кнопка "Добавить запись" не скрыта.

Добавить запись (Кнопка) (2)

По нажатию кнопки (2) в список записей словаря добавляется еще одна строка с новой записью. Каждая добавляемая строка содержит:

поле "Ключ" (3)
выпадающий список "Тип данных записи" (4)
поля/кнопки "Значение" (5)
кнопка "Удалить запись" (6)

Описание этих элементов приведено далее.

При выпадающем списке вниз прокручиваются только строки с записями словаря, эта кнопка не перемещается (как шапка у таблиц в разделах).

Если это кнопка для добавления записи у основного словаря (когда тип всего ресурса - словарь), то при выпадающем списке вниз\вверх эта кнопка не перемещается (как кнопки над таблицами в разделах), прокручиваются только строки с записями словаря. Но аналогичная кнопка у дочернего словаря (словарь внутри коллекции\словаря), будет прокручиваться вместе с записями.

Ключ (Поле) (3)

Если добавлена строка с записью словаря

Строковое поле для указания ключа записи словаря. Указано в каждой строке с записью словаря.

Тип данных записи (Выпадающий список) (4)

Тип данных значения записи словаря. Поле указано в каждой строке с записью словаря.

Доступные значения:

Строка
Число
Дата-время
Логический
Пароль
Путь к файлу
Путь к папке
Изображение
Коллекция
Словарь
Таблица

Значение по умолчанию: "Строка"

В списке доступен выбор только одного значения.

Значение (Поле) (5)

Указано в каждой строке с записью словаря.

Внешний вид поля и вариант настройки его значения зависят от выбранного типа данных (см. соответствующее описание выше Варианты значения в зависимости от типа данных).

Если добавлена строка с записью словаря

Удалить запись (Кнопка) (6)

При нажатии удаляется выбранная запись.

Кнопка указана в каждой строке с записью словаря.

Если добавлена строка с записью словаря

Описание полей/кнопок для настройки значения типа "Таблица"

Количество столбцов и строк таблицы

Шаблон:

Столбцов: <количество столбцов>; строк: <количество строк>

Пример:

Столбцов: 5; строк: 2

Документация ROBIN > Карточка ресурса > 2024-10-31_22-25-56.png

Числа в этой фразе (1) меняются сразу, как только пользователь добавляет или удаляет столбцы\строки из таблицы (т.е. еще до сохранения ресурса) - по кнопкам на самой таблице или при помощи полей "Столбцов" и "Строк".

Если в таблице нет ни одного столбца (строк в этом случае тоже нет), то указано "Столбцов: 0; строк: 0"

Если это дочерняя таблица (т.е. таблица внутри коллекции/словаря), то рядом есть шеврон, который:

Скрывает\отображает кнопку "Очистить таблицу"/"Заполнить таблицу" и сформированную таблицу.
Не влияет на скрытие\отображение родительского словаря и др. его записей (аналогично и для родительской коллекции).

Если значение дочерней таблицы - "Столбцов: 0; строк: 0", то шеврона нет, кнопка "Заполнить таблицу"/"Очистить таблицу" не скрыта.

Заполнить таблицу/Очистить таблицу Кнопка

Видима, если в таблице 0 столбцов.

По нажатию:

"Заполнить таблицу" заменяется на кнопку "Очистить таблицу"
появляются поля "Столбцов" и "Строк", в которых уже указано значение "1". Соответственно, фраза "Столбцов: 0; строк: 0" сразу актуализируется до "Столбцов: 1, строк: 1"
появляется таблица с 1 столбцом и 1 строкой (шапка не считается строкой и не учитывается в этом количестве)

Очистить таблицу Кнопка (2)

Видима, если в таблице столбцов > 0.

По нажатию:

"Очистить таблицу" заменяется на кнопку "Заполнить таблицу"
скрываются поля "Столбцов" и "Строк"
удаляется вся таблица, даже если в ней уже были заполнены ячейки.
Фраза "Столбцов: n; строк: k" сразу актуализируется до "Столбцов: 0; строк: 0"

Если пользователь удалит все столбцы (любым способом), то сама таблица пропадет, но кнопка "Очистить таблицу" не заменится на "Заполнить таблицу", не скроются поля "Столбцов" и "Строк", т.е. все еще будет активен режим заполнения таблицы.

"Столбцов" Поле (3)

Видима, если отображается кнопка "Очистить таблицу".

Числовое поле, в котором можно указать количество столбцов таблицы.

Значение по умолчанию: 1
Доступные значения: цифры от 0-9
Мин. значение, которое можно ввести = 0; макс. = 100
Значение можно указать вручную или по кнопкам в виде стрелочек
При увеличении кол-ва столбцов, они добавляются в конец таблицы
По умолчанию название каждого нового столбца = значению счетчика столбцов. Значение счетчика не меняется, если удалили некоторые столбцы. Счетчик начинается с 0
Например, по умолчанию в таблице 0 столбцов. Пользователь добавляет 4 столбца - они добавляются с названием "0", "1", "2" и "3". Текущее значение счетчика столбцов = 3. Пользователь переименовывает столбец "1" на "Тест", удаляет столбец "2" и "3", добавляет новый столбец. В итоге в таблице будет 3 столбца с названиями "0", "Тест" и "4". Текущее значение счетчика столбцов = 4
При уменьшении кол-ва столбцов, они будут удалены с конца таблицы. Если при уменьшении столбцов в них содержатся данные, то их наличие игнорируется и столбец все равно удаляется
Если в полях "Столбцов" и "Строк" указано "0", то при добавлении столбцов, в поле "Строк" значение все равно останется "0". В таблице будет только ее "шапка", которая не входит в число строк. Для табличных значений допустимо наличие n столбцов и 0 строк

"Строк" Поле (4)

Видима, если отображается кнопка "Очистить таблицу".

Числовое поле, в котором можно указать количество строк таблицы.

Значение по умолчанию: 1
Доступные значения: цифры от 0-9
Мин. значение, которое можно ввести = 0; макс. = 100
Значение можно указать вручную или по кнопкам в виде стрелочек
При увеличении кол-ва строк, они добавляются в конец таблицы
При уменьшении кол-ва строк, они будут удалены с конца таблицы. Если при уменьшении строк в них содержатся данные, то их наличие игнорируется и строка все равно удаляется.
Если в полях "Столбцов" и "Строк" указано "0", то при добавлении строк, в поле "Столбцов" установится значение 1, и вместе со строками добавится 1 столбец (у таблицы сразу будет "шапка"). Для табличных значений недопустимо наличие k строк и 0 столбцов

Подсказка о размере таблицы (5)

Видима, если отображается кнопка "Очистить таблицу".

Текст подсказки:

"Максимальный размер таблицы — 100 строк и 100 столбцов"

Таблица, сформированная при помощи полей "Столбцов" и "Строк" и/или кнопок на самой таблице:

Можно сужать/расширять столбцы при помощи вертикальных границ таблицы
Если все строки и/или столбцы не помещаются на странице, появляется вертикальный и\или горизонтальный выпадающий список (соответственно), который работает только в рамках области таблицы. При выпадающем списке прокручиваются только строки таблицы, шапка таблицы не скрывается
Строки таблицы пронумерованы. Нумерация начинается с 0. Шапка таблицы не считается строкой, поэтому не учитывается в кол-ве строк и не пронумерована
Если текст в ячейке не умещается в 1 строку, то остальная его часть не видна. Значение отображается полностью только при его редактировании. При этом для отображения всего текста столбец увеличится вниз и вправо по размеру текста
По двойному клику на:
- название столбца, его ячейка становится редактируемой и можно изменить название. Для сохранения изменений нужно убрать фокус с поля
- ячейку в строке (строка с "шапкой" не считается) она становится редактируемой и можно добавить\изменить\очистить ее содержимое. Для сохранения изменений нужно убрать фокус с поля

значения в ячейках таблицы можно менять

Cформированная таблица (6)

Если кол-во столбцов > 0

Тип элемента интерфейса	Название элемента интерфейса	Видимость	Примечание
Кнопка	без названия кнопка в форме плюса в "шапке" таблицы	При наведении на название столбца	По нажатию добавляется новый столбец - справа от выбранного. Данные из выбранного столбца не дублируется. Название нового столбца - порядковый номер этого столбца. Нумерация начинается с 0.
Кнопка	без названия кнопка в форме мусорки в "шапке" таблицы	При наведении на название столбца	По нажатию удаляется выбранный столбец. Если в удаляемом столбце содержатся данные, то их наличие игнорируется и столбец все равно удаляется.
Кнопка	без названия кнопка в форме плюса в строке таблицы	При наведении на строку таблицы. Но в строке с "шапкой" таблицы эта кнопка не появляется - там действуют кнопки для столбцов	По нажатию добавляется новая строка - под выбранной. Данные из выбранной строки не дублируется.
Кнопка	без названия кнопка в форме мусорки в строке таблицы	При наведении на строку таблицы. Но в строке с "шапкой" таблицы эта кнопка не появляется - там действуют кнопки для столбцов	По нажатию удаляется выбранная строка. Если в удаляемой строке содержатся данные, то их наличие игнорируется и строка все равно удаляется.