Загрузка данных из табличного документа — различия между версиями

Материал из КинтВики
Перейти к: навигация, поиск
 
(не показано 27 промежуточных версий 3 участников)
Строка 1: Строка 1:
<noinclude>[[Категория:Администрирование 1С:Предприятие 8|*18]]</noinclude>
+
<noinclude>[[Категория: Загрузка данных (КУС)|*2]]</noinclude>
<!-- Загрузка данных в справочники осуществляется с помощью обработки «Загрузка данных из табличного документа». -->
+
{{info|Загрузка данных из макета mxl описана [[Загрузка данных из макета mxl|здесь]]}}
<!-- Допускается загрузка данных из файлов форматов xls, mxl, txt. -->
 
В программу можно загружать данные из файлов форматов xls, mxl, txt.
 
  
Загрузка данных в справочников из внешнего файла производится с помощью процедуры '''Загрузка данных из табличного документа'''. Загрузка справочников — одна из ее функций.
+
С помощью обработки «Загрузка данных из табличного документа» можно загружать данные в объекты программы (чаще всего в справочники) из табличных документов форматов xls, mxl, txt.
  
# Выберите в режиме "Администрирования" раздел "Загрузка данных из табличного документа".
+
В первой строке табличного документа должны быть названия столбцов — идентификаторы колонок (реквизитов).
#: [[Файл:первый11.png|600px]]
+
 
# На закладке '''Настройка загрузки''' выберите необходимый источник данных.
+
Обработка находится в разделе АДМИНИСТРИРОВАНИЕ — '''Сервис''':
#: [[Файл:источник данных.png|600px]]
+
: [[Файл:Открытие загрузки данных из табличного документа.png]]
# По кнопке "Настройки" можно загрузить ранее подготовленные настройки или выгрузить сохраненные.
+
 
#: [[Файл:настройки_кус.png|600px]]
+
=== Закладка Исходные данные ===
# По кнопке "Варианты настроек" можно сохранять, добавлять, удалять внесенные изменения.
+
1. В поле «Табличный документ» выберите файл формата xls, mxl, txt., из которого надо загрузить данные:
#: [[Файл:варианты настроек_кус.png|600px]]
+
: [[Файл:Загрузка из табл. док. Исходные данные.png]]
#: При включенном свойстве добавление новых элементов в справочник не производится, а изменяются только существующие элементы, определенные полями поиска.
+
 
# Во вкладке "Исходные данные"можно загрузить данные из файлов форматов xls, mxl, txt.
+
[[Файл:Изменить таблицу.png]] / [[Файл:Отменить изменение таблицы.png]] — отобразить / скрыть табличный документ с данными.
#: [[Файл:загрузка_кус.png|600px]]
+
 
# В табличной части необходимо указать порядок компонентов конфигурации, а так же задать необходимые параметры.
+
В верхней части формы отображается табличный документ. Можно редактировать табличный документ прямо здесь — в этой форме. После завершения редактирования нажмите кнопку '''''Сохранить изменения''''' и '''''Перечитать''''' — перезаполните таблицу данных.
#: [[Файл:параментры_кус.png|600px]]
+
 
#: Для примера в статье есть ссылка на файл настроек, загружаемый в разделе "Настройки" и табличный файл, загружаемый в разделе "Исходные данные"
+
В нижней части отображается таблица с данными для загрузки в программу — что загрузится в программу. Данные в таблице отображаются в зависимости от настроек, сделанных на закладке '''Настройка загрузки'''. Отметьте галочками данные, которые надо загрузить.
#: [[Файл:Файл настроек.zip]]
+
 
== См. также ==
+
=== Закладка Настройка загрузки ===
* [[:Категория: Загрузка данных (КУС)]]
+
2. В поле «Загрузить в» выберите объект программы, в который надо загрузить данные: справочник, документ, регистр, план.
 +
: [[Файл:Загрузка из табл. док. Настройка загрузки.png]]
 +
 
 +
Справа отображаются реквизиты объекта. Слева — поля выбранного курсором реквизита.
 +
 
 +
[[Файл:Раскрыть панель.png]] [[Файл:Скрыть панель.png]] — раскрыть или скрыть левую таблицу с полями реквизитов.
 +
 
 +
В правой таблице с реквизитами отметьте галочками реквизиты, которые надо загрузить.
 +
 
 +
«Режим загрузки» — в этом столбце можно выбрать режим:
 +
* ''Заполнять'' — значение будет заполнено по соответствующей колонке таблицы данных (поиск реквизитов-справочников выполняется по наименованию) или предопределенным значением.
 +
* ''Искать'' — будет выполнен поиск реквизита по настройке ключевых полей этого реквизита (таблица полей открывается с помощью кнопки справа от таблицы реквизитов). Создание новых в этом режиме пока не поддерживается.
 +
*: Пример: если нужно искать контрагента по ИНН, установите режим загрузки этого реквизита «Искать». Откройте настройку полей, отметьте галочкой поле ИНН и установите соответствие с колонкой таблицы данных.
 +
* ''Вычислять'' — будет выполнен программный код в столбце «Выражение».
 +
 
 +
«Значение заполнения» — в этом столбце укажите значение, которым заполнять реквизит в объекте:
 +
* «Колонка таблицы данных» — брать значение из столбца в таблице данных: укажите столбец.
 +
* «Значение» — укажите объект в программе, из которого брать значения этого реквизита.
 +
 
 +
«Поле поиска» — при загрузке будет выполнен поиск объекта по отмеченным реквизитам
 +
 
 +
«Создавать новый» — галочка в этом столбце означает, что если в таблице с данными будет значение реквизита, которого нет в программе, этот элемент создастся автоматически.
 +
 
 +
'''''Установить соответствие колонок'''''
 +
: В столбец «Значение заполнения» подставятся названия соответствующих столбцов из табличного документа. Нажмите сначала эту кнопку, программа установит соответствие колонок, недостающим реквизитам укажите значения вручную.
 +
 
 +
С помощью кнопки '''''Настройки''''' можно загрузить ранее подготовленные настройки или выгрузить сохраненные.
 +
: [[Файл:Загрузка из табл. док. кнопка Настройки.png]]
 +
 
 +
С помощью кнопки '''''Варианты настроек''''' можно сохранять, добавлять, удалять изменения в настройках.
 +
: [[Файл:Загрузка из табл. док. кнопка Варианты настроек.png]]
 +
 
 +
:Пример файла настроек [[Файл: Файл настроек.mxl]].
 +
:Пример табличного списка данных [[Файл: Пример табличного списка данных.xlsx]].
 +
3. При необходимости на левой панели с полями реквизитов укажите значения полей реквизитов, которые надо загрузить.
 +
 
 +
4. На закладке '''Исходные данные''' отображается таблица с данными, которые загрузятся в программу. (Если открыт файл с данными, то таблица находится в нижней части.) Нажмите кнопку '''''Заполнить таблицу''''' — в таблице отобразятся данные соответствующие сделанным настройкам. Отметьте галочками — что загружать.
 +
 
 +
5. Нажмите кнопку '''''Выполнить загрузку''''' — данные загрузятся в программу.
 +
 
 +
<!-- ------------------ Помощь, прикрепленная к обработке "Загрузка данных в справочники" в КУС -------------------------
 +
Порядок работы с обработкой.
 +
 
 +
Закладка "Исходные данные"
 +
 
 +
* Здесь выбирается табличный документ-источник данных
 +
 
 +
** В первой строке таб. документа должны быть идентификаторы колонок (реквизитов)
 +
 
 +
* Есть возможность редактирования табличного документа прямо в форме. После завершения редактирования можно сохранить изменения и перечитать таблицу данных.
 +
 
 +
Закладка "Настройка загрузки"
 +
 
 +
* Здесь выбирается объект метаданных, в который будет выполняться загрузка. Сейчас поддерживается загрузка справочников и документов.
 +
 
 +
* Если объект имеет табличные части, будет доступна настройка загрузки табличных частей:
 +
 
 +
** "Колонка идентификатор таб. части" - определяет колонку, которая содержит имена табличных частей. Необходима для отделения реквизитов шапки и табличной части
 +
 
 +
** Ключевые поля - по этим колонкам будет определяться объект для загрузки, т.к. при наличии нескольких строк в табличной части, реквизиты шапки могут дублироваться.
 +
 
 +
Таблица настройки реквизитов
 +
 
 +
* Колонка "Режим загрузки": определяет то, как будет заполняться реквизит объекта
 +
 
 +
** "Заполнять": значение будет заполнено по соответствующей колонке таблицы данных (поиск реквизитов-справочников выполняется по наименованию) или предопределенным значением
 +
 
 +
** "Искать": будет выполнен поиск реквизита по настройке ключевых полей этого реквизита (таблица полей открывается с помощью кнопки справа от таблицы реквизитов). Создание новых в этом режиме пока не поддерживается.
 +
 
 +
*** Пример: если нужно искать контрагента по ИНН, устанавливаем режим загрузки этого реквизита в "Искать", потом открываем настройку полей, устанавливаем флаг у поля ИНН и устанавливаем соответствие с колонкой таблицы данных.
 +
 
 +
** "Вычислять": будет выполнен программный код в колонке "Выражение"
 +
 
 +
* Колонка "Поле поиска": при загрузке будет выполнен поиск объекта по отмеченным реквизитам
 +
 
 +
* Колонка "Создавать новый": создавать новое значение реквизита, если по наименованию не найдено. -->

Текущая версия на 12:42, 20 ноября 2024

Загрузка данных из макета mxl описана здесь

С помощью обработки «Загрузка данных из табличного документа» можно загружать данные в объекты программы (чаще всего в справочники) из табличных документов форматов xls, mxl, txt.

В первой строке табличного документа должны быть названия столбцов — идентификаторы колонок (реквизитов).

Обработка находится в разделе АДМИНИСТРИРОВАНИЕ — Сервис:

Открытие загрузки данных из табличного документа.png

Закладка Исходные данные

1. В поле «Табличный документ» выберите файл формата xls, mxl, txt., из которого надо загрузить данные:

Загрузка из табл. док. Исходные данные.png

Изменить таблицу.png / Отменить изменение таблицы.png — отобразить / скрыть табличный документ с данными.

В верхней части формы отображается табличный документ. Можно редактировать табличный документ прямо здесь — в этой форме. После завершения редактирования нажмите кнопку Сохранить изменения и Перечитать — перезаполните таблицу данных.

В нижней части отображается таблица с данными для загрузки в программу — что загрузится в программу. Данные в таблице отображаются в зависимости от настроек, сделанных на закладке Настройка загрузки. Отметьте галочками данные, которые надо загрузить.

Закладка Настройка загрузки

2. В поле «Загрузить в» выберите объект программы, в который надо загрузить данные: справочник, документ, регистр, план.

Загрузка из табл. док. Настройка загрузки.png

Справа отображаются реквизиты объекта. Слева — поля выбранного курсором реквизита.

Раскрыть панель.png Скрыть панель.png — раскрыть или скрыть левую таблицу с полями реквизитов.

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

«Режим загрузки» — в этом столбце можно выбрать режим:

  • Заполнять — значение будет заполнено по соответствующей колонке таблицы данных (поиск реквизитов-справочников выполняется по наименованию) или предопределенным значением.
  • Искать — будет выполнен поиск реквизита по настройке ключевых полей этого реквизита (таблица полей открывается с помощью кнопки справа от таблицы реквизитов). Создание новых в этом режиме пока не поддерживается.
    Пример: если нужно искать контрагента по ИНН, установите режим загрузки этого реквизита «Искать». Откройте настройку полей, отметьте галочкой поле ИНН и установите соответствие с колонкой таблицы данных.
  • Вычислять — будет выполнен программный код в столбце «Выражение».

«Значение заполнения» — в этом столбце укажите значение, которым заполнять реквизит в объекте:

  • «Колонка таблицы данных» — брать значение из столбца в таблице данных: укажите столбец.
  • «Значение» — укажите объект в программе, из которого брать значения этого реквизита.

«Поле поиска» — при загрузке будет выполнен поиск объекта по отмеченным реквизитам

«Создавать новый» — галочка в этом столбце означает, что если в таблице с данными будет значение реквизита, которого нет в программе, этот элемент создастся автоматически.

Установить соответствие колонок

В столбец «Значение заполнения» подставятся названия соответствующих столбцов из табличного документа. Нажмите сначала эту кнопку, программа установит соответствие колонок, недостающим реквизитам укажите значения вручную.

С помощью кнопки Настройки можно загрузить ранее подготовленные настройки или выгрузить сохраненные.

Загрузка из табл. док. кнопка Настройки.png

С помощью кнопки Варианты настроек можно сохранять, добавлять, удалять изменения в настройках.

Загрузка из табл. док. кнопка Варианты настроек.png
Пример файла настроек Файл:Файл настроек.mxl.
Пример табличного списка данных Файл:Пример табличного списка данных.xlsx.

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

4. На закладке Исходные данные отображается таблица с данными, которые загрузятся в программу. (Если открыт файл с данными, то таблица находится в нижней части.) Нажмите кнопку Заполнить таблицу — в таблице отобразятся данные соответствующие сделанным настройкам. Отметьте галочками — что загружать.

5. Нажмите кнопку Выполнить загрузку — данные загрузятся в программу.