ВнешнийИсточникДанныхТаблицаМенеджерЗаписи.<Имя внешнего источника>.<Имя таблицы внешнего источника данных>.Заполнить

Методы · Fill

Вызывает заполнение элемента данными из какого-либо другого объекта. При этом в модуле объекта вызывается процедура ОбработкаЗаполнения. В ней может размещаться алгоритм, заполняющий данные элемента из переданного значения. Для заполнения может использоваться значение любого типа. Для этого типа в процедуре ОбработкаЗаполнения должен быть описан алгоритм заполнения.

Синтаксис

Заполнить(<ДанныеЗаполнения>)
Полное описание, параметры и ограничения

ВнешнийИсточникДанныхТаблицаМенеджерЗаписи.<Имя внешнего источника>.<Имя таблицы внешнего источника данных>.Заполнить (ExternalDataSourceTableRecordManager.<External source name>.<External data source table name>.Fill)

ВнешнийИсточникДанныхТаблицаМенеджерЗаписи.<Имя внешнего источника>.<Имя таблицы внешнего источника данных> (ExternalDataSourceTableRecordManager.<External source name>.<External data source table name>)

Заполнить (Fill)

Доступен, начиная с версии 8.3.5.

Синтаксис:
Заполнить(<ДанныеЗаполнения>)
Параметры:

<ДанныеЗаполнения> (необязательный)
Тип: Произвольный.
Значение, на основании которого выполняется заполнение.
Описание:

Вызывает заполнение элемента данными из какого-либо другого объекта. При этом в модуле объекта вызывается процедура ОбработкаЗаполнения. В ней может размещаться алгоритм, заполняющий данные элемента из переданного значения.
Для заполнения может использоваться значение любого типа. Для этого типа в процедуре ОбработкаЗаполнения должен быть описан алгоритм заполнения.

Доступность:

Толстый клиент.

Использование в версии:

Доступен, начиная с версии 8.3.5.

Методическая информация

Практические примеры

Заполнение и запись собственной внешней строки

Заполнить запускает настроенную обработку заполнения, а Записать сохраняет строку. Значение Количество дополнительно задаётся явно.

Где и как запускать

Синтаксический пример для толстого клиента: вставьте код в тело обработчика своей учебной формы. Настройте указанный внешний источник заранее. В тонкий клиент эти фрагменты переносить нельзя. Здесь код не запускался.

Подготовка

  1. В источнике Аналитика настройте таблицу Остатки как НеобъектныеДанные: строковое ключевое поле Код и числовое поле Количество. Для чтения подготовьте свою учебную строку с Код = BOOK.

  2. Это отдельная внешняя таблица, не таблица измерения куба. Примеры записи и удаления разрешается выполнять только на собственных тестовых данных.

  3. Сначала разберите обработчик ОбработкаЗаполнения вашей таблицы: он получает ДанныеЗаполнения и определяет, как их применять. Перед запуском согласуйте изменение собственной строки BOOK.

Менеджер = ВнешниеИсточникиДанных.Аналитика.Таблицы.Остатки.СоздатьМенеджерЗаписи();
Менеджер.Код = "BOOK";
Менеджер.Прочитать();
Менеджер.Заполнить(Новый Структура("Количество", 5));
Менеджер.Количество = 5;
Сообщить("Изменён: " + Строка(Менеджер.Модифицированность()));
Менеджер.Записать(Ложь);
Менеджер.Прочитать();
Если Менеджер.Выбран() Тогда
    Сообщить("После записи: " + Строка(Менеджер.Количество));
КонецЕсли;

Разбор по шагам

  1. Прочитайте собственную строку и передайте данные в алгоритм Заполнить.

  2. Явно установите Количество = 5 и вызовите Записать без присваивания результата.

  3. Прочитайте строку заново и посмотрите сохранённое количество.

Как проверить результат

  1. После успешной записи и повторного чтения собственная строка содержит Количество = 5.

  2. Отдельно проверьте, что ваша ОбработкаЗаполнения действительно использует переданную структуру; автоматическое копирование не обещается.

Ожидаемый результат

Показан обычный синтаксис вызовов и способ использовать результат. Здесь пример не исполнялся; результат зависит от подготовленных метаданных и внешних учебных данных.

На что обратить внимание

  1. Записать — процедура, а не функция с булевым результатом.

  2. Для ранее прочитанного менеджера запись удаляет прочитанную строку перед записью изменённой. Ложь ограничивает замещение другой строки с совпавшим ключом, но не отменяет этот механизм и не обещает атомарности.

Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.

Не хотите разбираться сами?

Адаптируем это решение под вашу базу. Оценка бесплатно.

Оставить задачу

1С, 1С:Предприятие — товарные знаки ООО «1С». Сайт не является официальным представительством фирмы «1С» и не аффилирован с ней.