Различия

Показаны различия между двумя версиями страницы.

--- product:tables:users:import [18.04.2019 07:49] – создано mayn
+++ product:tables:users:import [25.09.2025 07:19] (текущий) – [Код объекта в шаблоне] Сердцев Сергей
@@ Строка 1: / Строка 1: @@
 ====== Импорт записей в справочник из MS Excel ======
-В системе «Адванта» имеется возможность загрузки данных из файлов MS Excel в справочники. Благодаря этому можно легко загружать в систему таблицы контактов, смет, спецификаций и прочей информации.
+Добавляйте записи в справочники из файлов MS Excel.  \\
+Легко загружайте в систему: таблицы контактов, смет, спецификаций и проч.
+<callout type="danger" title="Обратите внимание"> Такие компоненты в ADVANTA совместимы только с продуктами** Microsoft Office**. \\ Мы не можем дать гарантии совместимости с офисными пакетами других производителей. \\ Файлы в них могут открываться с искажениями форматирования, либо, в отдельных случаях, могут не открываться вообще. \\ Это не является ошибкой системы. </callout>
-=====Импорт записей справочника=====
+===== Механика импорта =====
-==== Шаг 1. Сохранить шаблон справочника ====
   - Зайдите в справочник объекта
-  - Кнопка «загрузить из Excel» -> «Скачать файл-шаблон» (Рисунок 1)  \\  <image shape="thumbnail">{{ :product:tables:users:table_import_1.png?direct |}}</image>  \\  <TEXT align="center">**Рисунок 1** -- Загрузка данных в справочник</text>
+  - Кнопка «загрузить из Excel» -> «Скачать файл-шаблон» (Рисунок Imp.1)  \\  <image shape="thumbnail">{{ :product:tables:users:table_import_1.png?nolink |}}</image>  \\  <TEXT align="center">**Рисунок Imp.1** -- Загрузка данных в справочник</text>
-  - Заполните файл данными и сохраните его
+  - Заполните файл данными и сохраните его.
+  - Вернитесь на страницу справочника -> "загрузить из Excel" -> "Выберите файл" -- прикрепите заполненный шаблон
+  - Кнопка "Импортировать".
-==== Шаг 2. Загрузить данные в справочник ====
+===== Как заполнять файл =====
-  - В справочнике проекта -> «загрузить из Excel» -> «Загрузить заполненный шаблон» (Рисунок 1)
-  - Прикрепить созданный файл и загрузить его.
-В результате в проект будут импортированы данные из файла MS Excel.
+==== Код объекта в шаблоне ====
-<callout type="info" icon="true">
+Из необычного, в шаблоне, который нужно заполнить записями, вы увидите поле -- ''Код*''. В нём -- GUID тех объектов, к которым относится справочник.
-Ряд особенностей, связанных с указанием названия файла MS Excel, который будет использоваться для импорта записей в справочник:
-  - Для того, чтобы в скачиваемом шаблоне была доступна иерархическая структура с подчиненными объектами, нужно включить значения параметра «Структура записей справочника» = «Иерархическая» ([страница настроек справочника в Администрировании|Создание справочников и общие свойства справочников.]).
+<callout type="success" icon="true">
-  - При импорте записей в справочник, в котором даты записей должны вводиться вручную (Опция «Использовать дату» = «Да, ручной ввод») **нельзя использовать в названии файла конструкцию с подчеркиванием перед словом -- <_любое слово>**.
+Всего один раз заполнив и загрузив шаблон, **вы можете внести записи в справочники нескольких объектов**.
-  - При импорте записей в справочник, в котором даты записей привязаны к плановым датам проекта к названиям файлов (Опция «Использовать дату» = «Да, использовать расчетные даты проекта»), **в конце названия файла нужно оставлять выражения <_BindDateToProjectBegin\_>, либо <_BindDateToProjectEnd\_>** (в зависимости от типа дат, к которым привязываются даты записей), **перед другими словами в названии символ подчеркивания использовать также нельзя**. Также, после конструкций <_BindDateToProjectBegin\_>, либо <_BindDateToProjectEnd\_> можно использовать пробел и уже после него вставлять в название другие необходимые слова и выражения.
+Чтобы записи разошлись по нужным местам, в шаблоне должны быть указаны объекты и **их коды** (UID - уникальные идентификаторы объектов), к которым справочники привязаны.
+Чтобы колонка ''Код*'' отображалась в файле шаблона для экспорта, необходимо в [[product:tables:admin:new#Структура справочника|настройках справочника]], для параметра ''Структура записей справочника'' выбрать значение ''Иерархическая''
 </callout>
-=====Создание новых значений реквизита-классификатора одновременно с импортом записей справочника=====
+Чтобы добавить запись в справочник объекта, добавляйте данные справа от заполненного поля "Код", если необходимо добавить несколько записей в один и тот же объект, следующие записи добавляйте в строки под строкой с заполненным полем "Код". При этом поле "Код" для тех записей, которые нужно добавить в тот же объект, заполнять не нужно.
-В окне выбора файла для импорта записей справочника имеется чек-бокс «Импортировать новые значения в реквизиты-классификаторы» (Рисунок 2).
+//Новая запись справочника -- новая строка в Excel, расположенная под нужным объектом.//
-При неактивном чек-боксе (значение по умолчанию) импорт файла происходит стандартным способом: при отсутствии значений классификаторов, указанных в строках файла, формируются ошибки загрузки.
+<image shape="thumbnail">{{ :product:tables:users:table_import_3.png?nolink |}}</image>
-При активации чек-бокса, в процессе импорта, на первом этапе создаются новые значения всех классификаторов, присутствующих в колонках файла. На втором этапе производится собственно импорт строк файла в записи справочника.
+<TEXT align="center">**Рисунок Imp.2** -- Импорт данных из строк файла MS Excel</text>
-Чек-бокс «Импортировать новые значения в реквизиты-классификаторы» доступен только для пользователей, обладающих соответствующими правами (право «Импорт значений классификаторов» из группы прав «Операции с импортом»).
-<image shape="thumbnail">{{ :product:tables:users:table_import_2.png?direct |}}</image>
+==== Даты. Особенности ====
-<TEXT align="center">**Рисунок 2** -- Импортировать новые значения в реквизиты-классификаторы</text>
+===Если дата вводится вручную===
+Если в справочник даты должны вводиться вручную(([[product/tables/admin/new#использовать_дату|опция справочника]] ''Использовать дату'' = ''Да, ручной ввод'')), **нельзя использовать в названии файла конструкцию с подчеркиванием перед словом:** ''_любое слово''.
-=====Импорт справочника с пустыми строками задач=====
+=== Если дата привязана к плановым датам проекта ===
+При импорте записей в справочник, в котором даты записей привязаны к плановым датам проекта(([[product/tables/admin/new#использовать_дату|опция справочника]] ''Использовать дату'' = ''Да, использовать расчетные даты проекта'')), **в конце названия файла нужно оставлять выражения**: ''_BindDateToProjectBegin\_'' либо ''_BindDateToProjectEnd\_''
-С целью удобства заполнения справочников с иерархической структурой реализован импорт данных из строк файла MS Excel с незаполненным кодом проекта (Рисунок 3).
+<callout type="danger">Перед другими словами в названии символ подчеркивания использовать также нельзя.</callout>
-В файле-шаблоне пользователь может вставить неограниченное количество строк с незаполненным кодом проекта. Импорт всех таких строк (с незаполненным кодом проекта) осуществляется в записи справочника того проекта, на уровне которого и ниже они расположены, вплоть до следующей строки с не пустым кодом проекта.
-<image shape="thumbnail">{{ :product:tables:users:table_import_3.png?direct |}}</image>
+Также, после конструкций ''_BindDateToProjectBegin\_'', либо ''_BindDateToProjectEnd\_'' можно использовать пробел и уже после него вставлять в название другие необходимые слова и выражения.
-<TEXT align="center">**Рисунок 3** -- Импорт данных из строк файла MS Excel с незаполненным кодом проекта</text>
-=====Импорт справочника с реквизитом-классификатором, у которого разрешен выбор нескольких значений=====
+====Реквизит-классификатор с несколькими значениями====
-При импорте данных из MS Excel справочника с реквизитом-классификатором, у которого разрешен выбор нескольких значений, следует все требуемые для одной строки справочника значения реквизита-классификатора располагать в одной ячейке файла MS Excel, друг под другом. Это можно сделать с помощью сочетания клавиш Alt+Enter: следует ввести первое значение, затем создать следующую строку в ячейке, нажав Alt+Enter, после чего в следующую строку ввести второе значение и т.п.
+//Как импортировать запись с [[product:requisites:requisite-class|реквизитом-классификатором]], в котором должно быть несколько значений?//
+В файле-шаблоне MS Excel, в ячейке этого реквизита разделяйте значения разрывом строки -- **Alt+Enter**:
+При импорте данных из MS Excel справочника с реквизитом-классификатором, у которого разрешен выбор нескольких значений, следует все требуемые для одной строки справочника значения реквизита-классификатора располагать в одной ячейке файла MS Excel, друг под другом. Это можно сделать с помощью сочетания клавиш Alt+Enter: следует ввести первое значение, затем создать следующую строку в ячейке, нажав Alt+Enter, после чего в следующую строку ввести второе значение и т.д.
+<image shape="thumbnail">{{ :product:tables:users:table_import_4.png?nolink |}}</image>
+<TEXT align="center">**Рисунок Imp.3** -- Справочник с реквизитом-классификатором, у которого разрешен выбор нескольких значений</text>
+===== Новое значение реквизита-классификатора =====
+Одновременно с импортом можно создавать новые значения для [[product:requisites:requisite-class|реквизитов-классификаторов]].
+<callout type="info" icon="true">Доступна только для пользователей [[product:access:about|с правом]] на «Импорт значений классификаторов» из группы прав «Операции с импортом».</callout>
+<callout icon="fa fa-briefcase">
+Например, есть [[product:requisites:requisite-class|реквизит-классификатор]] "Версия продукта", и у него есть преднастроенные значения: v.1.0, v.1.1, v.1.2  \\
+Но запись в справочник касается уже новой версии продукта -- v.2.0 => это значение должно попасть в справочник.
+</callout>
-<image shape="thumbnail">{{ :product:tables:users:table_import_4.png?direct |}}</image>
+  * Если чек-бокс **включен**, в процессе импорта
-<TEXT align="center">**Рисунок 4** -- Справочник с реквизитом-классификатором, у которого разрешен выбор нескольких значений</text>
+    - создаются новые значения всех классификаторов, присутствующих в колонках файла;
+    - импортируются строки файла в записи справочника.
+  * Если чек-бокс **НЕ** включен (значение по умолчанию), и в файле есть неопознанные значения реквизита-классификатора, формируются ошибки загрузки.
+  * При активации чек-бокса,
+<image shape="thumbnail">{{ :product:tables:users:table_import_2.png?nolink |}}</image>
+<TEXT align="center">**Рисунок Imp.4** -- Импортировать новые значения в реквизиты-классификаторы</text>