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

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

Текущая версия на 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. Нажмите кнопку Выполнить загрузку — данные загрузятся в программу.