Добавляет новое действие в конец коллекции действий элемента результата глобального поиска.
Синтаксис
Добавить(<Значение>, <Текст>, <Картинка>)Полное описание, параметры и ограничения
КоллекцияДействийЭлементаРезультатаГлобальногоПоиска.Добавить (GlobalSearchResultItemActionCollection.Add)
КоллекцияДействийЭлементаРезультатаГлобальногоПоиска (GlobalSearchResultItemActionCollection)
Добавить (Add)
Доступен, начиная с версии 8.3.18.
Синтаксис:
Добавить(<Значение>, <Текст>, <Картинка>)
Параметры:
<Значение> (необязательный)
Тип: Произвольный.
Значение действия элемента результата глобального поиска.
Значение по умолчанию: Неопределено.
<Текст> (необязательный)
Тип: Строка, ФорматированнаяСтрока.
Текст, отображаемый в действии элемента результата глобального поиска.
Значение по умолчанию: Пустая строка.
<Картинка> (необязательный)
Тип: Картинка.
Картинка, отображаемая в действии элемента результата глобального поиска.
Значение по умолчанию: Пустая картинка.
Возвращаемое значение:
Тип: ДействиеЭлементаРезультатаГлобальногоПоиска.
Описание:
Добавляет новое действие в конец коллекции действий элемента результата глобального поиска.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент).
Использование в версии:
Доступен, начиная с версии 8.3.18.
Методическая информация
Практические примеры
Найти и убрать действие, не запуская его
Ищем по значению, обрабатываем отсутствие, удаляем найденный объект и оставшийся индекс. Очищаем только собственную карточку.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную базу. В серверном общем модуле УчебныеЗадачи создайте процедуру ВыполнитьПример() Экспорт и вставьте в неё код одного урока. Вызовите её из серверного обработчика собственной учебной обработки.
Каждый урок создаёт новую коллекцию в памяти. Код не загружает и не сохраняет избранное пользователя, не заменяет план ГлобальныйПоиск, не запускает поиск, не открывает ссылку и не читает рабочие документы.
Для трёх уроков избранного создайте в собственной учебной конфигурации два пустых справочника УчебныеКниги и УчебныеАвторы. Учебные ссылки относятся к спискам этих объектов; записи справочников для упражнения не нужны. Право СохранениеДанныхПользователя требуется для использования избранного по справке платформы.
Карточка = Новый ЭлементРезультатаГлобальногоПоиска("guide-book", "Книга");
Действия = Карточка.Действия;
Действия.Добавить("guide-describe", "Описание");
Действия.Добавить("guide-check", "Проверка");
Найдено = Действия.Найти("guide-check");
Если Найдено = Неопределено Тогда
ВызватьИсключение "Учебное действие не найдено";
КонецЕсли;
Сообщить(Найдено.Текст = "Проверка");
Сообщить(ТипЗнч(Найдено) = Тип("ДействиеЭлементаРезультатаГлобальногоПоиска"));
Сообщить(Действия.Найти("Проверка") = Неопределено);
Действия.Удалить(Найдено);
Сообщить(Действия.Количество() = 1);
Если Действия.Количество() = 1 Тогда
Действия.Удалить(0);
КонецЕсли;
Сообщить(Действия.Количество() = 0);
Действия.Добавить("guide-own", "Собственное действие");
Действия.Очистить();
Сообщить(Действия.Количество() = 0);Разбор по шагам
Найти сравнивает Значение и возвращает первое совпадение. Подпись Проверка не является ключом guide-check.
Проверяем Неопределено до чтения Текст. Для собственных уникальных ключей ожидается ровно найденное учебное действие.
В локальной справке возвращаемый тип Найти ошибочно назван действием сообщения системы взаимодействия. Не конструируем такой объект; отдельно проверяем фактический ТипЗнч найденного действия при запуске в 1С.
Удалить принимает индекс или объект действия, не строковое значение. Поэтому перед удалением по ключу сначала Найти.
Очистить применяется к собственной карточке, а не к сохранённым рабочим результатам.
Как проверить результат
Шесть проверок должны дать Истина, включая фактический тип найденного объекта; расхождение типа зафиксируйте как результат проверки платформы.
После удаления двух действий количество 0; после добавления и очистки снова 0. Нажатия ссылок не происходят.
Ожидаемый результат
Показаны поиск, нормальное отсутствие, удаление по объекту/индексу и граница ошибки в документации.
На что обратить внимание
Не переносите указанную опечатку справки в прикладной тип объекта.
Проверяйте реальный возвращённый тип при спорной документации; здесь запуск в 1С ещё не подтверждён.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Дать учебному результату два понятных действия
Добавляем ссылки-действия в настоящую коллекцию карточки, меняем порядок и проверяем значения. Нажатия и бизнес-операции не выполняются.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную базу. В серверном общем модуле УчебныеЗадачи создайте процедуру ВыполнитьПример() Экспорт и вставьте в неё код одного урока. Вызовите её из серверного обработчика собственной учебной обработки.
Каждый урок создаёт новую коллекцию в памяти. Код не загружает и не сохраняет избранное пользователя, не заменяет план ГлобальныйПоиск, не запускает поиск, не открывает ссылку и не читает рабочие документы.
Для трёх уроков избранного создайте в собственной учебной конфигурации два пустых справочника УчебныеКниги и УчебныеАвторы. Учебные ссылки относятся к спискам этих объектов; записи справочников для упражнения не нужны. Право СохранениеДанныхПользователя требуется для использования избранного по справке платформы.
Карточка = Новый ЭлементРезультатаГлобальногоПоиска("guide-book", "Книга");
Действия = Карточка.Действия;
Описание = Действия.Добавить("guide-describe", "Описание", Новый Картинка);
Действия.Вставить(0, "guide-check", "Проверить учебные данные", Новый Картинка);
Описание.Текст = "Показать описание книги";
Описание.Значение = "guide-describe-book";
Описание.Картинка = Новый Картинка;
Сообщить(Действия.Количество() = 2);
Сообщить(Действия.Индекс(Описание) = 1);
Сообщить(ТипЗнч(Описание.Картинка) = Тип("Картинка"));
Действия.Сдвинуть(Описание, -1);
Сообщить(Действия.Индекс(Описание) = 0);
Сообщить(Действия.Получить(0).Текст = "Показать описание книги");
Сообщить(Действия.Получить(0).Значение = "guide-describe-book");
Действия.Сдвинуть(0, 1);
Сообщить(Действия.Индекс(Описание) = 1);Разбор по шагам
Коллекция Действия берётся из карточки; у этого типа коллекции нет конструктора. Само свойство Карточка.Действия только для чтения.
Добавить возвращает платформенное действие. Его Значение — собственный ключ для будущего обработчика, Текст — подпись, Картинка — изображение.
Вставить(0, ...) ставит второе действие перед первым. Сдвинуть(Описание, -1) передаёт объект действия и переносит его к началу.
Сдвинуть(0, 1) показывает другую перегрузку по индексу. После каждого перемещения заново определяем позицию.
Создание коллекции и подписи не исполняет действие. Для настоящего нажатия требуется обработчик ПриВыбореДействияРезультатаГлобальногоПоиска приложения.
Как проверить результат
Семь контрольных Истина; после последнего сдвига Описание снова в позиции 1.
Ни одна книга не открыта и не изменена: коды guide-check/guide-describe-book в этом уроке только данные действий.
Ожидаемый результат
Показаны все три свойства действия, вставка и обе перегрузки перемещения.
На что обратить внимание
Строковый ключ не выполняется как BSL и сам не открывает форму.
Отрицательное смещение означает движение к началу, положительное — к концу, а не сортировку по алфавиту.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.