=======Загрузка данных=======

Описание, как настроить автоматический обмен данными между учетной системой и Forecast NOW!  [[консоль|доступно по ссылке.]]

Если обмен не настроен, то нужно сделать следующее:

====== Первоначальная загрузка данных======

=====Загрузка истории продаж=====

1.1.	Запустите программу Forecast NOW!

1.2 [[:активация_лицензии|Активируйте лицензию]] (пока лицензия не активирована, другие окна недоступны)

1.3.	Выберите "Режим пользователя"

{{loading: загрузка_1.png}}

1.4.	В графе «файл для импорта» выберите, выгруженный файл с историей продаж из учетной системы

{{loading: загрузка_2.png}}

1.5.	В графе «путь к хранилищу данных» создайте базу данных

{{loading: загрузка_3.png}}

1.6.	Нажмите «указать формат истории продаж» 

{{loading: загрузка формат.png}}

1.7.	Поставьте галочку в поле «Заголовок» (если ваш файл загрузки содержит заголовки) \\
При наличие в файле заголовка, происходит автоматическое сопоставление полей истории продаж. Поля "Артикул" и "Артикул (доп)" не определяются автоматически.

1.8.	Проверьте формат истории  продаж (чтобы поля соответствовали друг другу)

1.9.	Заполните поля в формате в соответствии с представленными данным, если это не произошло автоматически

1.10.	Нажмите «ОК»

{{loading: загрузка_4.png}}

1.11.	Нажмите «ОК»

{{loading: загрузка_5.png}}

<noteimportant>
Такой режим загрузки истории продаж доступен только для пустой базы (в которую никакая загрузка ранее не производилась). В дальнейшем история продаж грузится или через [[загрузка_данных_в_forecast_now#загрузка_других_данных_в_программу|Данные -Загрузить-История продаж]] или при помощи [[консоль|консольной утилиты]]
</note>

По умолчанию, при загрузке истории продаж, создаются временные файлы, благодаря чему, сокращается время загрузки. Это возможно только в том случае, когда программа расположена на том же компьютере, на котором запущен сервер базы данных (в C:\ProgramData\Ingenious Team\ForecastNOW\dbserver-config.ini должен быть указан Host - 127.0.0.1 или localhost). \\
Папка по умолчанию для расположения временных файлов при загрузке: \\
C:/ProgramData/Ingenious Team/ForecastNOW/Temp \\

Изменить путь для создания временных файлов можно в Глобальных настройках, [[настройки/глобальные_настройки#пути_сохранения|Временная папка для массовой загрузки]]
или же напрямую в файле настроек соединения с базой (C:\ProgramData\Ingenious Team\ForecastNOW\dbserver-config.ini) изменить настройку:

''BulkInsertTempDir=C:\\ProgramData\\Ingenious Team\\ForecastNOW\\Temp''

Если временная папка для массовой загрузки недоступна для записи или чтения, или массовая загрузка не удалась, то загрузка будет произведена в обычном режиме. \\
Об этом будет выведено сообщение, как в графическом приложение, так и в консольном.
==== Режимы загрузки истории продаж====
Доступно 3 режима загрузки истории продаж: «Заменить», «Обновить» и «Обновить частично»

Если минимальная дата истории продаж загружаемого файла меньше максимальной даты в базе, то вам будет предложено выбрать режим «Заменить» или «Обновить». Если выбирается «Заменить», то  история продаж в базе от даты минимальной даты загружаемой истории продаж до максимальной даты загружаемой истории продаж  затирается (по складам, имеющимся в загружаемом файле), на ее место загружается история из файла.
При режиме "Обновить частично" обновятся данные только по тем столбцам, которые присутствуют в файле загрузки

<note tip>

При загрузке истории продаж (из файлов формата csv, xml и комплексного xml, в ручном и автоматическом режиме) в режиме замены очищается история продаж только для складов, которые есть в загружаемой истории продаж.
Таким образом, вы можете перезагружать историю продаж для исправления неправильных данных в режиме замены для отдельных складов.
Если у вас есть неправильные данные (продажи или остатки), то в файле должна быть информация, начиная или раньше этой даты.

</note>

Если выбирается «Обновить», изменятся только строчки с полным совпадением товара, склада, клиента (при наличии) и даты.Таким образом, при помощи «Заменить» вы можете исправить ошибочные данные, ранее занесенные в учетную систему и исправленные в ней (неправильные продажи, остатки и т.п.)

<note important>При загрузке истории продаж, данные за будущие периоды игнорируются</note>

====Ошибки импорта истории продаж====

При импорте истории продаж Forecast NOW! проверяет импортируемый файл на корректность.

В случае ошибок выдается сообщение, содержащее номер строки файла выгрузки с ошибкой и саму ошибку. В диалоговом окне выдается не более 5 строк с одинаковой ошибкой. С полным списком ошибок в загружаемом файле  можно ознакомиться в автоматически формируемом  файле вида название базы_importsaleshistory_дата и время импорта (в диалоговом окне можно будет автоматически перейти к этому файлу)

{{loading: im001.png}}

Ниже приведен список возможных ошибок и варианты их устранения

**"Не задан код продукта" "Проверьте поле «Код продукта»"**

У какой-то строки отсутствует код продукта. Обычно такая строка сразу начинается с ;
Возможно, код у продукта не задан в учетной системе или ошибка в механизме выгрузки. Если таких строчек мало (1-5), то можно открыть файл выгрузки при помощи программы Notepad++ и удалить эти строчки вручную. 

Существует несколько ошибок вида **«Не задан –название поля-Проверьте «название поля»**

В этом случае обычно строчка содержит в себе 2 разделителя полей подряд:  ;;  || или ,,

Необходимо проверить механизм выгрузки данных 

Ошибки такого вида являются критичными (отображаются красным) и не позволяют осуществить загрузку данных дальше.

  *"Не задано кол-во продаж" "Проверьте поле «Кол-во»"
  *"Не задана дата продажи" "Проверьте поле «Дата продажи»"
  *"Не задана цена реализации" "Проверьте поле «Цена реализации»"
  *"Не задана сумма продажи" "Проверьте поле «Сумма продажи»"
  *"Не задана цена закупки" "Проверьте поле «Цена закупа»"
  *"Не задана сумма закупки" "Проверьте поле «Сумма закупа»"
  *"Не задано кол-во товара на складе" "Проверьте поле «На складе»"
  *"Не задано кол-во товара в пути" "Проверьте поле «В пути»"
  *"Не задано кол-во товара в заказе" "Проверьте поле «Заказать»"
  *"Не задано кол-во товара в резерве" "Проверьте поле «В резерве»"
  *"Не задана учетная цена товара" "Проверьте поле «Учетная цена»"

Следующий тип ошибки:

**«Неверный формат_название параметра»**

Такой тип ошибки является критичным. Обычно это связано с неверным указанием формата загружаемого файла (неверно проставлено соответствие полей). Необходимо проверить формат загружаемого файла

{{loading: im002.png}}

  *"Неверный формат кол-во продаж" "Проверьте поле «Кол-во» в импорте данных.Скорее всего, там представлены нечисловые значения."*

Скорее всего, неправильно выставлен формат загружаемого файла- необходимо его проверить, чтобы полю «Кол-во» соответствовало поле с объемом продаж за день

  *"Неверный формат даты продажи" "Проверьте поле «Дата продажи» в импорте данных.Скорее всего, нужно представить значения в формате даты."

Может быть неправильно выставлен формат загружаемого файла или формат даты (программа поддерживает 2 формата гггг-ММ-дд и дд.мм.гггг – нужно выбрать верный вверху диалогового окна выставления формата загружаемого файла

{{loading: im003.png}}

Другие подобные ошибки:

  *"Неверный формат цены реализации" "Проверьте поле «Цена реализации» в импорте данных.Скорее всего, там представлены нечисловые значения."
  *"Неверный формат суммы продажи" "Не задана сумма продажи"
  *"Неверный формат цены закупки" "Проверьте поле «Цена закупа» в импорте данных.Скорее всего, там представлены нечисловые значения."
  *"Неверный формат суммы закупки" "Проверьте поле «Сумма закупа» в импорте данных.Скорее всего, там представлены нечисловые значения. "
  *"Неверный формат кол-ва товара на складе" "Проверьте поле «На складе» в импорте данных.Скорее всего, там представлены нечисловые значения."
  *"Неверный формат кол-ва товара в пути" "Проверьте поле «В пути» в импорте данных.Скорее всего, там представлены нечисловые значения."
  *"Неверный формат кол-ва товара в заказе" "Проверьте поле «Заказать» в импорте данных.Скорее всего, там представлены нечисловые значения."
  *"Неверный формат кол-ва товара в резерве" "Проверьте поле «В резерве» в импорте данных.Скорее всего, там представлены нечисловые значения."
  *"Неверный формат учетной цены товара" "Проверьте поле «Учетная цена» в импорте данных.Скорее всего, там представлены нечисловые значения."

  * **"Неверное кол-во входных параметров" "Проверьте формат импорта данных (возможно, вы забыли задать все необходимые поля)."**

В загружаемом файле больше полей, разделенных ; или | или , чем выставлено в заполняемом формате – необходимо проверить формат загружаемого файла

  * **"Противоречивые данные за конкретный день" "Проверьте группировку данных по дням"**

За один и тот же день у одного товара по одному складу и одному клиенту указаны разные данные (например, кол-во проданного или остаток).
Необходимо проверить механизм выгрузки

  *Ошибки с ценами
  *"Цена закупа выше или равна цене реализации или учетной цене" "Проверьте цены закупки, реализации и учета"
  *"Учетная цена выше цены реализации" "Проверьте учетную цену и цену реализации"

Если в одной строчке файла выгрузки цена закупки выше или равна цены реализации. 
Ошибка не является критичной, но если таких строчек много, то необходимо проверить выгрузку

  *"Цена реализации указана неверно" "Укажите такую цену, которая будет больше нуля"
  *"Учетная или закупочная цена задана неверно" "Одна из этих цен должна быть строго больше нуля"

  *"Несоответствие имен" "У товаров с одинаковым кодом не могут быть разные названия. Проверьте выгрузку."
У товаров с одним и тем же идентификатором (код/артикул ) разные названия. 
Скорее всего, неправильно представленные данные в учетной системе – необходимо проверить товары с совпадающими кодами и разными названиям
  *"Одинаковые строчки в выгрузке" "Проверьте выгрузку"

=====Загрузка других данных в программу=====
В Forecast NOW! при помощи Данные - Загрузить можно загрузить в программу:
  *историю продаж 
  *партии остатков
  *поставщиков
  *классификацию
  *параметры
  *временные параметры
  *правила автоустановки параметров
  *комплекты
  *аналоги
  *пользователей и группы пользователей
  *акции
  *расписание заказов
  *фильтры подготовки заказов
  *критерии выбора товаров при изменении заказа до заданных ограничений
  *закупки для клиентов
  *справочник клиентов
  *поля для товаров
  *поступления
  *сегменты клиентов
  *заказы
  *направления балансировки
  *ограничения балансировки
  *настройки балансировки
  *структуры подчинённости складов
  *зоны хранения
  *склады
 

{{loading: load_16012020.png}}

====Загрузка классификации====
Классификация загружается через Данные - Загрузить - Классификация

Файл загрузки должен быть определенного [[формат_данных_для_загрузки#формат_загрузки_классификации|формата]]

===Режимы загрузки классификации===

Как с загрузкой истории продаж, так и с загрузкой классификации, возможны два варианта действий. Загрузка в режиме «Заменить» и «Обновить».

Режим «Заменить» применяется для загрузки полной классификации при первоначальной загрузке истории продаж, для создания новых групп, новых товаров и изменения принадлежности групп. Алгоритм работы точно такой же, как при загрузки истории продаж: старая классификация полностью заменяется данными из новой классификации. Поэтому загружаемая классификация в режиме "Заменить" должна быть полной и содержать в себе все данные. 

Для того,чтобы сохранить при замене классификации созданные ранее пользователем свойства нужно поставить галочку в соответствующем поле при загрузке классификации:

{{classification: class1000.png}}

Режим «Обновить» применяется для загрузки дополнительной информации по имеющейся классификации.

<note important>В режиме «Обновить» запрещается создание новых групп, изменение принадлежности групп, изменение названия групп. Режим «Обновить» используется только для загрузки данных по действующей классификации. Например, с помощью этого режима вы можете изменить свойства для товаров или указать принадлежность нового товара к имеющейся группе.</note>

В запущенной программе:

1.11.	Выберите пункт «Данные – Загрузить - Классификацию»

{{loading: load1001.png}}

1.12.	Выберите файл с выгруженной  классификацией  и нажмите ОК

{{loading: загрузка_7.png}}

1.13.	Выберите «заменить классификацию»

{{loading: загрузка_8.png}}

1.14.	Перезапустите программу

1.15.	Нажмите «продолжить без импорта»

{{loading: загрузка_9.png}}

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

====Загрузка параметров====
Параметры загружаются через Данные - Загрузить - Параметры

{{loading: load1002.png}}

Загружаемый файл должен иметь определенный [[формат_данных_для_загрузки#формат_файла_для_выгрузки_загрузки_параметров|формат]]

===Режимы загрузки===
  *Обновить – будут изменены только параметры и их значения по строчкам, присутствующим в файле
  *Заменить - в таком режиме затираются значения всех параметров, которые есть в файле для всех складов, которые есть в файле.


===Ошибки импорта параметров===
Программа проверяет загружаемый файл параметров и выводит сообщение о наличии и типе ошибок.

Виды ошибок:
"Ошибка синтаксиса" - "В строке неверное количество элементов, разделённых символом ';'" 

"Пропущено значение параметра" 

"Неизвестный параметр" - "Указанное имя не является именем параметра" 

"Некорректное значение параметра" – название параметра не совпадает с [[формат_данных_для_загрузки#название_параметров_ключевые_слова|необходимым для загрузки]]

"Пропущено наименование товара" 

"Несовместимые значения параметров." - '% срока годности, от поставщика' должен быть строго больше '% срока годности, клиенту'.

"Противоречивые значения параметров" - "Значение параметра для этого товара ранее уже присутствовало в файле." 

"Дублированная запись" - "Эта запись уже присутствовала в файле, дублированную запись можно удалить

"Товар отсутствует в истории продаж" - код товара из файла параметров отсутствует в истории продаж

"Склад отсутствует в истории продаж" - склад  из файла параметров отсутствует в истории продаж

Если в файле параметров, csv формата, в коде склада или товара есть нечитаемый символ, то при загрузке будет выдаваться соответствующая критическая ошибка.
====Загрузка аналогов====

Параметры загружаются через Данные - Загрузить - Аналоги

{{:loading:load1003.png|}}

Загружаемый файл должен иметь определенный [[формат_данных_для_загрузки#формат_файла_для_выгрузки_загрузки_аналогов|формат]]

====Загрузка акций====

Данные по акциям можно загружать автоматически через меню Данные – Загрузить – Акции, соблюдая [[:Формат данных для загрузки#Формат файла для обмена данными по акциям|формат]] файла загрузки

{{actions: action7.png}}

Файл акций в [[формат_данных_для_загрузки#формат_файла_для_обмена_данными_по_акциям|формате с заголовком]], при загрузке дописывает имеющиеся в базе данные.
===Ошибки в файле загрузке акций===
При загрузке файла акций программа проводит проверку этого файла и выдает ошибки (в случае их наличия).

Список возможных ошибок для файла с секциями:
  -Существование неизвестной секции - критичная ошибка
  -Указание данных (приписывание товаров, клиентов, складов, указание настроек) для необъявленной акции - некритичная ошибка
  -Неверная команда (критичная ошибка)
  -Команда находится в неположенной секции (указать пользователю где должна находится команда) - критичная ошибка
  -Неверное количество аргументов для команды - критичная ошибка

Список возможных ошибок для файла с заголовком:
  - Не заданы обязательные столбцы для загрузки - критичная ошибка
  - Задан неизвестный столбец - критичная ошибка
  - Неверное количество полей - критичная ошибка
  - Неверно задана дата - критичная ошибка
  - Неверно задано значение поля Заказать заранее за, дней - критичная ошибка
  - Неверно заданы значения полей Коэффициент товара, Коэффициент акции, Выполнение плана (мин, макс, среднее), Точность планирования (мин, макс, среднее), Объем, Прогнозируемый объём спроса, Фактический объём спроса, Плановый объём спроса - критичная ошибка
  - Неверно задано значение поля Активность - критичная ошибка
  - Неверно задано значение поля Тип акции - критичная ошибка
  - Задан объем, но не задана дата объема (также проверяется, что дату объема нельзя указать, не указав сам объем) - критичная ошибка
  - Неизвестный склад - некритичная ошибка
  - Неизвестный товар - некритичная ошибка
  - Неизвестный клиент - некритичная ошибка
====Загрузка пользователей и групп====

В Forecast NOW! через Данные - загрузить - Пользователи и группы можно загрузить данные по [[настройка_прав_пользователей|пользователям и группам]], предварительно [[сохранение_данных_в_forecast_now|сохраненные из другой базы]]

====Загрузка расписания заказов====

В Forecast NOW! через Данные - загрузить - Расписание заказов можно загрузить  [[формирование_заказа#расписание_заказов|расписания заказов]], предварительно [[сохранение_данных_в_forecast_now|сохраненные из другой базы]]

====Загрузка фильтров подготовки заказов====
В Forecast NOW! через Данные - загрузить - Фильтры подготовки заказов можно загрузить  фильтры подготовки заказов, предварительно [[сохранение_данных_в_forecast_now|сохраненные из другой базы]]

====Загрузка критериев выбора товаров====

При использовании [[формирование_заказа#ограничения_заказа|ограничений заказа]] можно выбрать критерием изменения заказа "Пользовательский"

В этом случае Пользователь сам задает список и приоритет товаров в файле (чем выше товар в файле, тем он приоритетнее)

Файл должен из себя представлять столбец товаров, описанных как Склад;Артикул

Пример Файла:

Демо-склад1;4000000000023

Демо-склад1;4000000000024

Демо-склад1;4000000000016

Для того, чтобы загрузить такой файл можно воспользоваться Данные - Загрузить - Критерии выбора товаров

====Загрузка закупок для клиентов====
Если у вас есть плановые закупки, не относящиеся к обычному спросу, то вы можете их загрузить через Данные-Загрузить-Закупки для клиентов или консольную утилиту. Закупки для клиентов (если придутся на период расчёта) увеличат [[формирование_заказа#оптимальный_запас|оптимальный товарный запас]] при формировании заказа, балансировки, оценку запасов в [[обеспечение_продаж|прогноз-обеспечение продаж]] и могут повлиять на [[анализ/эффективность#дополнительные_показатели_для_анализа_эффективности|показатели Анализа-Эффективности]] связанные с Оптимальным товарным запасом 

 Синтаксис команды для загрузки через [[консоль|консольную утилиту]]:
<code>import --customer-purchases путь_к_файлу имя_базы</code>
Файл загрузки закупок клиентов должен быть определенного [[формат_данных_для_загрузки#формат_файла_для_закупок_клиентов|формата]]

===Ошибки файла закупок для клиентов===
При загрузке закупок для клиентов программа проводит проверку и может найти следующие ошибки:

  -Неверное число элементов в строке
  -Неверная дата (неверный формат или несуществующая дата)
  -Неверное значение (не число или число <= 0)
  -Конфликт данных (для склада/товара/клиента/даты указано несколько значений)
====Загрузка произвольных полей товара для таблицы Заказа====
Если вы хотите загружать какие-то признаки/свойства, относящиеся к паре товар-склад, то вы можете воспользоваться произвольными полями товара для таблицы Заказов.

В ручном режиме Загрузка осуществляется через Данные -Загрузить - Поля для товаров.

Доступно 2 режима:
  *обновление (обновляет данные по присутствующим в файле полям и товарам) 
  *замена (вся информация по полям товаров очищается по тем складам, которые присутствуют в файле загрузки и на ее место встает информация из файла загрузки)

Синтаксис команды для загрузки файла через [[консоль|консольную утилиту]] 

<code>import --items-fields  [-режим] путь_к_файлу имя_базы</code>

режим:

-a обновление

-r замена

Файл загрузки полей для товара должен быть определенного [[формат_данных_для_загрузки#Формат файла произвольных полей для таблицы заказа|формата]]

====Загрузка поступлений товаров с датами====
Для использования алгоритма, учитывающего даты поступления товаров необходимо загрузить файл с поступлениями.

В ручном режиме Загрузка осуществляется через Данные -Загрузить - Поступления.

Доступно 2 режима:
  *обновление (обновляет данные по присутствующим в файле поступлениям и товарам) 
  *замена ( перед импортом удаляются все данные о поступлениях  от максимальной даты в базе  и все данные по поступлениям для заказов, ИД которых присутствуют в файле.)

Синтаксис команды для загрузки файла через [[консоль|консольную утилиту]] 

<code>import --arrivals  [-режим] путь_к_файлу имя_базы</code>

режим:

-a обновление

-r замена

Файл загрузки поступления должен быть определенного формата - [[формат_данных_для_загрузки#Формат файла произвольных полей для таблицы заказа|csv]] или [[загрузка_данных_в_forecastnow#Ожидаемые поступления с датами|xml]]

====Загрузка направлений балансировки====
Загрузка направлений балансировки доступна  в ручном режиме (Данные – Загрузить – Направления балансировки) или при помощи консоли, команды вида
<code>
FSystemConsole.exe import -- balancing-destinations <путь к файлу> <имя базы данных>
</code>
Файл загрузки должен быть определенного [[формат_данных_для_загрузки#Направления балансировки|формата]]

====Загрузка настроек балансировки====
Загрузка настроек балансировки доступна  в ручном режиме (Данные – Загрузить – Настройки балансировки) или при помощи консоли, команды вида
<code>
FSystemConsole.exe import -- settings-balancin <путь к файлу> <имя базы данных>
</code>
Файл загрузки должен быть определенного [[формат_данных_для_загрузки#настройки_балансировки|формата]] \\
При загрузке происходит проверка файла на корректность. Если в файле присутствуют ошибки, то он не загрузится и будет выведено сообщение с указанием пути где хранится лог с ошибками.

====Загрузка структуры подчиненности складов====
Загрузка направлений балансировки доступна доступна в ручном режиме (Данные – Загрузить – Структуры подчиненности складов) или при помощи консоли, команды вида
<code>
FSystemConsole.exe import --storage-destinations <путь к файлу> <имя базы данных>
</code>

Файл загрузки должен быть определенного [[формат_данных_для_загрузки#Структура подчиненности складов|формата]]

====Загрузка зон хранения====
Загрузка зон хранения доступна в ручном режиме (Данные – Загрузить –Зоны хранения) или при помощи команды для консольной утилиты.
<code>
FSystemConsole.exe import --storage-area <путь к файлу> <имя базы данных>
</code>

Файл загрузки должен быть определенного [[формат_данных_для_загрузки#зоны_хранения|формата]]


====Загрузка данных по клиентам====

Загрузка справочника клиентов доступна в ручном режиме (Файл-Данные-Загрузить-Справочник клиентов) или при помощи команды для консольной утилиты

<code>
FSystemConsole.exe import --clients <путь к файлу> <имя базы данных>
</code>

Файл загрузки должен быть определённого [[справочник_клиентов#формат_файла_загрузки|формата]]

====Загрузка данных поставщиков====

{{page>настройки/список_поставщиков#загрузка_данных_поставщиков&noheader}}
=====Ошибки в файле загрузки=====
В случае наличия ошибок в файле загрузки в диалоговом окне будут отображены первые 5 ошибок по каждому типу ошибки, также будет предоставлена информация о числе строк с ошибками каждого типа.

Ссохраняться в файл ошибок загрузки будет первая тысяча ошибок каждого типа

{{ loading:errorsloading.png?550 }}
=====Альтернативный диалог загрузки файлов=====

По умолчанию используется стандартный диалог загрузки файлов.

При возникновении неполадок можно использовать альтернативный диалог

Чтобы использовать альтернативный диалог загрузки файлов, его необходимо выбрать в Настройки – Глобальные Настройки:

{{loading: load1004.png}}