> For the complete documentation index, see [llms.txt](https://docs.aamsystems.ru/passoffice/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aamsystems.ru/passoffice/passoffice-guide/admin-guide-doc/manual/organizations/import-iz-csv.md).

# Импорт из CSV/Excel

#### **Пошаговая инструкция: Импорт объектов из CSV/Excel в систему**

**1. Активация функции импорта**

Чтобы в разделе появилась кнопка **«Импортировать объекты из CSV/Excel»**:

1. Перейдите в **«Конфигурирование» → «Внешний вид» → «Меню и отчеты»**.
2. Найдите нужный раздел (например, «Посетители», «Пропуска») и нажмите **«Редактировать»**.
3. Перейдите на вкладку **«Доступные действия»** и активируйте опцию импорта.
4. Сохраните изменения.

Теперь в выбранном разделе появится кнопка **«Импорт»**.

***

**2. Подготовка файла для импорта**

1. Нажмите **«Импорт из CSV/Excel»** → **«Скачать образец»** (чтобы увидеть правильную структуру).
2. Заполните файл (**CSV или Excel**):
   * **Первая строка** должна содержать **названия столбцов** (как в системе).
   * Все поля в **Excel** должны быть в формате **«Текстовый»** (чтобы избежать ошибок с числами и датами).
   * Поддерживаемые кодировки: **UTF-8, Windows-1251**.
   * **Excel 2003 не поддерживается!**
   * При сохранении в **CSV** выбирайте: **CSV (разделитель — запятая) (\*.csv)**.

<figure><img src="/files/ULmW0RkcA82wjXTtjTBN" alt=""><figcaption><p>Образец CSV файла</p></figcaption></figure>

***

**3. Настройка импорта**

1. **Загрузите файл** в систему.
2. Если в файле есть заголовки, отметьте **«Распознать заголовки»** (система сама сопоставит столбцы).
3. **Первичный ключ** (опционально):
   * Поставьте галочку в столбце, который должен проверяться на дубли (например, **«ФИО»** или **«Тип документа»**).
   * Если объект с таким значением уже есть в системе, он **не будет создаваться повторно**.
   * Пример:
     * Если в **PassOffice** уже есть **«Иванов Иван Иванович»**, а в файле он тоже есть, новый посетитель **не создастся**.
     * Если в системе есть тип документа **«Паспорт»**, а в файле он указан, новый тип **не добавится**.
4. **«Создавать объект, если не найден по первичным ключам»**:
   * Если включено, система **добавит только новые объекты**.

<figure><img src="/files/W1OQpIcY7pjHeLEXU2HM" alt=""><figcaption><p>Пример сопоставления полей</p></figcaption></figure>

***

**4. Дополнительные настройки**

1. **Вкладка «Конфигурирование»**:
   * Укажите **маску для дат** (например, `ДД.ММ.ГГГГ`).
   * Выберите **категорию людей по умолчанию**.
2. **Вкладка «Загрузка изображений»** (если нужно):
   * Прикрепите файлы с фотографиями (если в CSV есть ссылки на них).

***

**5. Запуск импорта**

1. Проверьте все настройки.
2. Нажмите **«Импорт»**.
3. Система покажет **отчет об успешном импорте или ошибках** (если данные некорректны).

***