﻿# Сценарий: импортировать данные и конфигурацию

> [HTML Version](guide-import.html)

Этот сценарий описывает способы импорта в ELMA365: загрузку данных в приложение, перенос конфигурации или синхронизацию пользователей и групп с каталогом AD/LDAP.

Важно различать три типа импорта:

- **данные** — элементы приложений, с которыми работают пользователи: заявки, поставщики, товары, клиенты, документы, обращения;

- **конфигурация и компоненты** — настройки системы: разделы, приложения, формы, бизнес-процессы, страницы, решения и модули;

- **пользователи и группы** — сотрудники и группы из внешнего каталога AD/LDAP.

Например, в рамках сценария работы с закупками можно загрузить справочники поставщиков и товаров, перенести настроенный раздел **Закупки**, установить готовое решение из файла **.e365** или импортировать пользователей и группы из AD/LDAP.

Сценарий показывает общую логику настройки и не заменяет подробные инструкции. На каждом этапе вы найдёте ссылки на статьи справки с подробным описанием нужных действий.

## Подготовка перед началом настройки

Перед запуском импорта определите следующие параметры: 

- **объект переноса** — что нужно перенести: данные, конфигурацию или её компонент, учётные записи пользователей или группы;

- **целевая среда** — куда выполняется импорт: в тестовую компанию, рабочую или другую среду; 

- **связи и зависимости** — наличие связанных данных или зависимостей; 

- **права доступа** — необходимость настройки доступа для объектов после их импорта.

От этих параметров зависит выбор способа переноса. Данные загружаются из файлов формата Excel или CSV. Конфигурация переносится с помощью экспорта и импорта приложения, раздела, решения или модуля. Пользователи и группы импортируются из AD/LDAP.

### Шаг 1. Выберите тип импорта

Метод импорта определяется типом переносимых объектов:

- **импорт данных** — если нужно загрузить записи в существующее приложение. Например, перенесите список компаний в систему, чтобы заполнить приложение-справочник **Поставщики**;

- **импорт конфигурации** — если нужно перенести настройки. Например, из тестовой компании загрузите в рабочую настроенный раздел **Закупки** с приложениями и процессами;

- **импорт из AD/LDAP** — для создания учётных записей сотрудников и переноса групп пользователей.

````
Начало примечание

````
**Полезные статьи:**

- [«Импорт данных»](360009354059.md) — как загрузить записи в приложение;

- [«Экспорт данных»](360009264480.md) — как выгрузить данные из приложения;

- [«Решение в ELMA365»](solution.md) — как объединить связанные компоненты системы в один пакет.

````
Конец примечание

## ````
Направление «Импорт данных»

Используйте эти шаги, если нужно загрузить записи в существующее приложение из файла формата Excel или CSV.

### Шаг 2. Подготовьте приложение и файл

Убедитесь, что в системе создано целевое приложение, а состав и тип его полей соответствуют структуре импортируемого файла. 

Например, перед загрузкой поставщиков проверьте, что в приложении **Поставщики** есть поля **Название компании**, **ИНН**, **Контактное лицо**, **Телефон**, **Email** и **Статус**.

Если данные связаны с другими приложениями, заранее определите порядок загрузки. Сначала загрузите справочники и связанные записи, затем основные данные, которые на них ссылаются. Например, в решении **Закупки** сначала заполняются реестры поставщиков и товаров, после этого — заявки на закупку. 

**Параметры проверки файла до начала импорта: **

- соответствие названий колонок и полей приложения;

- заполнение обязательных полей;

- формат отображения дат и числовых значений;

- значения для полей со списками;

- связи с другими приложениями.

````
Начало примечание

````
**Полезные статьи:**

- [«Импорт данных»](360009354059.md) — какие файлы можно использовать и как сопоставить колонки с полями приложения;

- [«Экспорт данных»](360009264480.md) — как получить файл с текущими данными приложения и использовать его как основу для импорта;

- [«Типы данных в системе»](360009707032.md) — какие типы данных можно использовать в полях;

- [«Тип данных „Приложение“»](app-data-type.md) — как настроить связь с элементами другого приложения.

````
Конец примечание

### ````
Шаг 3. Импортируйте данные и проверьте результат

Загрузите подготовленный файл на страницу приложения и сопоставьте его колонки с полями.

**После завершения импорта проверьте:**

- общее количество успешно загруженных записей;

- заполнение обязательных полей;

- корректность распознавания типов данных: даты, числа, списки;

- активность связей с элементами других приложений;

- отсутствие дублирующихся записей.

Если часть строк не загрузилась, исправьте файл или сопоставление колонок и повторите импорт.

````
Начало примечание

````
**Полезные статьи:**

- [«Импорт данных»](360009354059.md) — как загрузить данные и обработать ошибки импорта;

- [«Поиск дублей»](duplicate-search.md) — как найти повторяющиеся элементы после загрузки.

````
Конец примечание

## ````
Направление «Импорт конфигурации»

Используйте эти шаги, если нужно перенести отдельные компоненты конфигурации: приложение, раздел, решение или модуль.

### Шаг 4. Выберите объект переноса

Определите объект и выберите инструмент переноса в зависимости от поставленной задачи:

- **одно приложение** — экспорт и импорт приложения;

- **раздел с несколькими приложениями** — экспорт и импорт раздела;

- **связанный набор компонентов** — экспорт и импорт решения в файле **.e365**;

- **расширение или интеграционный компонент** — экспорт и импорт модуля;

- **все настройки и архитектура компании** — экспорт и обновление конфигурации.

Например, если нужно перенести только приложение **Поставщики**, подойдёт экспорт приложения. Если нужно перенести весь сценарий закупок с разделом, приложениями и процессами, рекомендуем подготовить решение **Закупки** и экспортировать его в файл формата **.e365**.

````
Начало примечание

````
**Полезные статьи:**

- [«Экспорт приложения»](360009669292.md) — как выгрузить приложение для переноса;

- [«Экспорт раздела»](360007722171.md) — как выгрузить раздел;

- [«Экспорт решения в файл .e365»](export-solution-file.md) — как выгрузить решение с зависимостями;

- [«Экспорт модуля»](export_extention.md) — как выгрузить модуль;

- [«Экспорт и обновление конфигурации»](configuration.md) — как выгрузить всю структуру компании.

````
Конец примечание

### ````
Шаг 5. Импортируйте компонент и проверьте результат

Перед импортом проверьте наличие внешних зависимостей: системные разделы, лицензируемые продукты, модули, пользователи, группы или другие объекты, на которые ссылается переносимый компонент.

Импортируйте выбранный объект в целевую компанию. Если решение уже установлено, используйте обновление решения, а не повторную установку нового пакета.

**После импорта убедитесь, что компоненты доступны в системе:**

- раздел отображается в главном меню;

- приложения открываются без ошибок;

- процессы доступны для запуска;

- страницы и виджеты корректно работают.

````
Начало примечание

````
**Полезные статьи:**

- [«Импорт решения из файла .e365»](upload-solution-file.md) — как установить решение из файла **.e365**;

- [«Обновить решение»](update_solution.md) — как обновить установленное решение новой версией;

- [«Импорт модуля»](import_extention.md) — как импортировать модуль.

````
Конец примечание

## ````
Направление «Импорт пользователей и групп»

Используйте эти шаги, если нужно загрузить пользователей и группы из AD/LDAP.

Такой импорт создаёт пользователей и группы в ELMA365, но не заменяет настройку прав доступа.

### Шаг 6. Импортируйте пользователей и группы из AD/LDAP

Настройте параметры интеграции с внешним каталогом и запустите процесс импорта данных. 

**После импорта проверьте:**

- наличие созданных учётных записей в справочнике пользователей;

- статус активности импортированных сотрудников;

- корректность распределения пользователей по группам;

- корректность выполнения операции импорта и синхронизации.

````
Начало примечание

````
**Полезные статьи:**

- [«Импорт внутренних пользователей из AD/LDAP»](import_ad_ldap.md) — как импортировать внутренних пользователей;

- [«Импорт групп из AD/LDAP»](groups-ad-ldap.md) — как импортировать группы;

- [«Работа с операциями импорта и синхронизации»](operations-ad-ldap.md) — как отслеживать операции импорта и синхронизации;

- [«Статусы импортированных пользователей»](user-status-ad-ldap.md) — как проверить результат импорта пользователей.

````
Конец примечание

### ````
Шаг 7. Проверьте результат в рабочем сценарии

После завершения любого типа импорта проведите комплексную проверку данных и настроек: 

- **для данных** — откройте несколько записей в приложении и проверьте связи между ними. Например, после загрузки поставщиков и товаров создайте тестовую заявку на закупку;

- **для конфигурации или её компонента** — проверьте основной сценарий: раздел отображается, приложения открываются, формы и процессы корректно работают;

- **для пользователей и групп** — убедитесь, что пользователи активны, входят в нужные группы и смогут получить доступ после настройки прав.

````
Начало примечание

````
**Полезные статьи:**

- [«Доступ к разделу»](360009660872.md) — как проверить, какие группы пользователей видят раздел;

- [«Доступ к приложению»](360009919211.md) — как проверить доступ к приложению;

- [«Доступ к данным приложения»](360007527512.md) — как проверить права на данные приложения.

````
Конец примечание

## ````
Коротко по маршруту

1. **Сначала выберите тип импорта:**

Определите, что нужно перенести — данные, конфигурацию или пользователей и группы.

2. **При импорте данных:**

- подготовьте приложение и файл Excel или CSV;

- импортируйте данные;

- проверьте записи, связи и дубли.

3. **При импорте конфигурации или компонента:**

- выберите объект переноса: приложение, раздел, решение, модуль;

- импортируйте конфигурацию в целевую компанию;

- проверьте зависимости и работу перенесённых компонентов;

- если решение уже установлено, используйте обновление решения;

4. **При импорте пользователей и группы:**

- настройте импорт из каталога AD/LDAP;

- проверьте пользователей, группы и операции синхронизации;

- после импорта настройте права доступа пользователям.