Различия

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

--- консоль [09.07.2019 04:53]
Evgeny Viktorov [Пример работы с программой для командной строки Windows]
+++ консоль [05.06.2020 00:49] (текущий)
Timur Osmanov [Логирование выполнения команды]
@@ Строка 28: / Строка 28: @@
 FSystemConsole.exe import --properties -r D:\FNOW\SUPPLIERS\Suppliers.csv base >> C:\fcn_logs\log-swod-%date%.txt
-rem загружаем поля для товаров в режиме замены, выводим логи загрузки в отдельный файл
+rem загружаем поля для товаров в режиме обновления, выводим логи загрузки в отдельный файл
 FSystemConsole.exe import --items-fields -a D:\FNOW\SUPPLIERS\Itemfields.csv base >> C:\fcn_logs\log-swod-%date%.txt
@@ Строка 60: / Строка 60: @@
 timeout 300 > NULL
-rem формируем заказы по фильтру 1 с учетом ранее проведенной балансировки
+rem формируем заказы по фильтру 1 с учетом ранее проведенной балансировки, возможные ошибки консоли выводим в отдельный файл
 FSystemConsole.exe make-orders --user "user" --consider-balancing "1" "base" "D:\FNOW\OUT\ORDERS" >> C:\fcn_logs\log-swod-%date%.txt
+echo %ERRORLEVEL% >> E:\log\log-swod-%date%.txt
 </code>
+=====Логирование выполнения команды=====
+Процесс выполнения любой консольной команды можно записывать в лог файл. Для этого, в конце команды нужно указать флаг "''log''" и после знака "''=''" путь к файлу лога.
+Пример с указанием пути к файлу:
+<code>FSystemConsole.exe import -sh -r "D:\FNOW\format.format"  "D:\FNOW\SALES"  base --log=C:\fcn_logs\log-swod.txt</code>
+Если путь к файлу не указан или файл не доступен, то лог консоли будет записан в новый сгенерированный файл в профиле в папке %AppData%\Ingenious Team\ForecastNOW\logs
+Пример без указания пути к файлу:
+<code>FSystemConsole.exe import -sh -r "D:\FNOW\format.format"  "D:\FNOW\SALES"  base --log</code>
 =====Логирование неудачных запусков утилиты=====
@@ Строка 70: / Строка 83: @@
 Если при старте работы с консольной утилитой возникает ошибка ключа защиты, то происходит 5 переподключений.
 При этом в консоль выводится сообщение: \\
-<code>protection key error. try to reconect...</code>
+<code>protection key error. try to reconnect...</code>
@@ Строка 80: / Строка 93: @@
 {{ settings: consolelog.png?550 }}
+Если консольная утилита завершилась из-за возникновения ошибки, то создаётся [[crashdumps|дамп памяти]]. \\
+Путь к созданному файлу дампа, отображается в командной строке. По умолчанию файл дампа памяти создаётся в папке C:\ProgramData\Ingenious Team\ForecastNOW\CrashDumps в формате dmp. \\
+Данный файл можно передать в службу технической поддержки, для анализа и выявления причины завершения работы консольной утилиты.
 ====Коды ошибок при работе консольной утилиты====
 |0| Нормальное завершение работы|
@@ Строка 112: / Строка 129: @@
 |29| У товара нет ближайшей доступной даты формирования заказа|
 |31| Ошибка аутентификации при отправке заказа по электронной почте|
+|34| В базе данных нет правил автоустановки с указанным типом|
+|35| Ни одно из введенных названий правил с указанным типом не соответствует тем, что находятся в базе данных|
+|36| Массовая загрузка данных в таблицу sales недоступна. Загрузка была произведена в обычном режиме.|
 ====Остановка работы консольной утилиты при возникновение ошибок====
 Если во время работы консольной утилиты выявлены ошибки, то можно отменить дальнейшее выполнение команд. Для этого нужно в файл для консольной утилиты вставить дополнительную команду:
@@ Строка 158: / Строка 178: @@
 </code>
-режим - замена, обновление или частичное обновление
+режим - замена, обновление или частичное обновление \\
-формат - формат истории продаж, актуально только для истории продаж
+формат - формат истории продаж, актуально только для истории продаж \\
-база_данных - название базы данных Forecast NOW!
+база_данных - название базы данных Forecast NOW! \\
@@ Строка 170: / Строка 190: @@
  -a, --analogs    импорт аналогов
  -mс, --marketing-campaigns       импорт акций
- -of, ----orderFrequency    импорт сроков доставки от поставщиков
  -sp, --suppliers   импорт данных поставщиков
- --all    импорт файла формата xml, содержащего историю продаж и параметры
+ --all    импорт файла формата xml, содержащего историю продаж, параметры, классификацию и даты поступления заказов
  --storage-aliases  импорт файла, содержащего названия складов
  --customer-purchases   импорт файла, содержащего закупки для клиентов
@@ Строка 190: / Строка 209: @@
 --prepare-report-settings импорт файла, содержащего фильтры подготовки заказа
 --recipients-limits импорт файла, содержащего ограничения для внутренних перемещений
+--clients импорт файла содержащего данные по клиентам
 </code>
@@ Строка 208: / Строка 228: @@
 [[формат_данных_для_загрузки#формат_файла_для_выгрузкизагрузки_аналогов|Формат файла аналогов]]
 ==Акции==
-[[формат_данных_для_загрузки#формат_файла_для_обмена_данными_по_акциям|Формат файла акций]]
+[[формат_данных_для_загрузки#формат_файла_для_обмена_данными_по_акциям|Формат файла акций]]. Акции можно загружать в двух форматах.
 ==Загрузка xml файла==
@@ Строка 220: / Строка 240: @@
 [[настройки:список_поставщиков#формат_файла_загрузки|формат файла данных поставщиков]]
-==Загрузка сроков доставки поставщиков==
-[[настройки:список_поставщиков#загрузка_сроков_доставки|формат файла сроков доставки поставщиков]]
 ==Загрузка закупок для клиентов==
@@ Строка 257: / Строка 276: @@
 [[формат_данных_для_загрузки#ограничения_на_внутренние_перемещения|Формат файла ограничений на внутренние перемещения]]
+==Данные по клиентам==
+[[формат_данных_для_загрузки#данные_по_клиентам|Формат файла с данными по клиентам]]
 ===Режим(только для истории продаж, классификации, произвольных полей товаров, параметров)===
@@ Строка 267: / Строка 288: @@
  -r, --remove                           режим замены и удаления старой информации
  -a, --append                           режим добавления и обновления информации
- -s                                     сохранение старых свойств в классификации. Может использоваться только при загрузке комплексного xml файла. Указывается в конце команды
+ -s                                     сохранение старых свойств в классификации. Может использоваться при загрузке комплексного xml файла. Указывается в конце команды
 </code>
@@ Строка 368: / Строка 389: @@
 Флаг должен быть указан  сразу после [[консоль#тип|типа]] импортируемого файла
+<code>--user <пользователь></code>
+Используется при загрузке настроек балансировки. Указывается пользователь
+для которого производится загрузка настроек балансировки.
@@ Строка 397: / Строка 419: @@
 =====Сжатие базы данных=====
+Сжатие происходит через массовую загрузку из файла.
+Файл со сжатой историей продаж создается во временной папке для массовой загрузки (указывается в [[настройки/глобальные_настройки#пути_сохранения|Глобальных настройках]]) \\
+Чтобы все прошло корректно сжатие должно быть запущено на компьютере где расположен сервер СУБД. \\
+Программа должна быть запущена под пользователем, который имеет права на запись во временную папку для массовой загрузке, а сервер СУБД имеет права на чтение из этой папки. \\
+Перед процессом сжатия, автоматически создается дамп базы. \\
+Команда для запуска сжатия базы:
+<code>FSystemConsole.exe compress [database-name]</code>
-compress database, где database - имя/путь к базе данных
+database-name - имя базы данных
 ===Пример===
-<code>FSystemConsole.exe update base </code>
+<code>FSystemConsole.exe compress base </code>
 =====Формирование заказов без участия пользователя=====
@@ Строка 498: / Строка 530: @@
 <!---rc-to-buy-immutable - Заказать без корректировок---->
 <!---rc-to-buy-untreated - Заказать без обработок---->
+<!---rc-manual-edit - Ручное редактирование---->
 <!---rc-purchase-price - Цена закупа---->
 <!---rc-purchase-cost - Сумма---->
@@ Строка 548: / Строка 581: @@
 <!---rc-to-buy-edit-cause - Причина редактирования---->
 <!---rc-optimal-service-level - Оптимальный УС---->
+<!--rc-total-demand-filials - Суммарная потребность филиалов-->
+<!--rc-available-rest - Свободный остаток-->
 <!---rc-product-properties - Значения свойств товара---->
 <!---rc-product-parameters - Значение параметров товара---->
@@ Строка 616: / Строка 651: @@
  | --group-order-roundbystorage storage
-<code>----save-union-only</code>
+<code>--save-union-only</code>
 Сохранение только объединенных заказов
@@ Строка 645: / Строка 680: @@
 <code>--email</code>
 Флаг для автоматической [[формирование_заказа#отправка_заказа_поставщику_по_электронной_почте|отправки сохранённых заказов на email]], указанный в карточке поставщика. Заказы отправляются только при указание флага с форматом, в указанном формате.
+Пустые заказы и нулевые заказы (где у всех позиций заказать =0) отправлены не будут
 <code>filter</code>
@@ Строка 696: / Строка 733: @@
 ) не удалит заказы с диска. тогда заказы перестанут грузится у всего набора пользователей П. об этом будет сообщено в явном виде в программе.
+Если при формирование заказов, должны быть учтены ограничения поставщиков, но по каким то причинам, ограничения не были соблюдены, то при запуске программы будет выведено соответствующее сообщение, со списком заказов. Товарам к которым не применилось ограничение, будет записан соответствующий комментарий.
@@ Строка 738: / Строка 776: @@
 ===Формат файла с настройками балансировки===
 Рекомендуется указывать файл настроек балансировки, сохраненного из программы в соответствующем [[формат_данных_для_загрузки#настройки_балансировки|формате]]
-</note> в комбинации с использованием фильтра для отбора товаров, участвующих в балансировке.
+в комбинации с использованием фильтра для отбора товаров, участвующих в балансировке.
 Также поддерживается, формат, позволяющий задавать товары, участвующие в балансировке и прочие параметры ее проведения:
@@ Строка 780: / Строка 818: @@
 особенности поставки;<не учитывать|основные|балансировка>
 иерархия складов;<основная|балансировка>
-расписание заказов;<основное|балансировка>
+расписание заказов;<не учитывать|основное|балансировка>
 алгоритм балансировки;<по рентабельности|пропорциональное распределение остатка с рц>
-направление балансировки;<значение направления из настроек "Направления балансировки"> </code>
+направление балансировки;<значение направления из настроек "Направления балансировки">
+метод разворота аналогов;<сначала старые запасы, потом новые|сначала дешевые, потом дорогие|по приоритету|обратно приоритету> </code>
 .3.	Дополнительные настройки (если строчка присутствует в файле настроек, то эта настройка будет учтена при проведении балансировки)
 <code>учитывать аналоги
-разворачивать аналоги
 не учитывать разницу цен
 норма складского запаса равна сроку поставки + периодичность
@@ Строка 806: / Строка 844: @@
 доставка;от(РЦ1);до(РЦ2);срок(1);стоимость(2000);кг(3);%(4)
 доставка;от(РЦ1);до(Ф2);срок(455);стоимость(21);кг(1);%(20)
-Отображать все нулевые перемещения;Отображать все
+Отображать все нулевые перемещения;Есть дефицит
 доход на высвобожденные средства;10
 не перемещать товар;14
@@ Строка 813: / Строка 851: @@
 расписание заказов;балансировка
 учитывать аналоги
-разворачивать аналоги
+метод разворота аналогов;сначала старые запасы, потом новые
 не учитывать разницу цен
 норма складского запаса равна сроку поставки + периодичность
@@ Строка 839: / Строка 877: @@
 ====Полный синтаксис команды====
-<code>FSystemConsole balancing database [source] target [--user] [--filter] [--xml] [--csv] [--xlsx][--consider-balancing] [--no-split-by-destinations] [--no-verification]</code>
+<code>FSystemConsole balancing database [source] target [--user] [--filter] [--xml] [--csv] [--xlsx][--consider-balancing] [--no-split-by-destinations] [--no-verification] [--balancing-by-clients]</code>
@@ Строка 863: / Строка 901: @@
 При указании этих флагов (одного или нескольких) балансировка также будет сохраняться в указанном формате. По умолчанию балансировка сохраняется в excel csv, для флага "--csv" просто в csv (в имя файла дописывается --csv так как расширение файлов у них одинаковое). Если файл цели указан с расширением xml, то флаг "--xml" можно не указывать.
+В excel csv формате балансировка сохраняется всегда.
   *<code>--no-split-by-destinations</code>
@@ Строка 875: / Строка 915: @@
 ''none balancing reports where created'' - если количество сформированных балансировок равно нулю.
+  *<code>--balancing-by-clients</code>
+[[балансировка_запасов#балансировка_по_клиентам|Балансировка будет формироваться по клиентам]]. То есть, в качестве реципиента выступают клиенты.
+Если данный флаг не указан, то балансировка формируется исходя из настроек балансировки, пользователя указанного в команде.
@@ Строка 947: / Строка 991: @@
  Далее указываются статусы для фильтрации. Для указания нескольких статусов их нужно перечислить через ;
-Виды [[акции_новые&#фильтрация_по_коэффициенту_увеличения_спроса|значений]]:
+Виды [[акции_новые1#фильтрация_по_коэффициенту_увеличения_спроса|значений]]:
   *notset - не установлен
@@ Строка 961: / Строка 1005: @@
   *exceeded_period_treshold - период акции больше, чем указан в [[настройки/глобальные_настройки#Ограничение для расчета акций по их длительности|глобальной настройке]]
+Если используются [[настройки/глобальные_настройки#коэффициенты_акций_по_товарам|потоварные коэффициенты акций]], то расчёт и прогнозирование коэффициентов, будет производиться только по товарам удовлетворяющим условиям фильтра.
 ==Фильтрация по времени проведения акций==
 Акции можно отфильтровать по времени их проведения  - прошедшие, текущие, будущие
@@ Строка 1029: / Строка 1074: @@
 ==Прогресс - бар==
 В командной строке будет отражен прогресс-бар степени завершенности расчета акций и число рассчитанных и расчитываемых акций
-=====Проведение анализа-эффективности без участи пользователя=====
+=====Проведение анализа-эффективности без участия пользователя=====
 ====Синтаксис====
@@ Строка 1067: / Строка 1112: @@
 Файл, куда сохранятся результаты анализа
+=====Расчёт прогноза - плана заказов=====
+ \\
+**Синтаксис**
+<code>FSystemConsole.exe stockplan database --filter filter [--user userName] --target target --dates date1 date2 [--xlsx] [--csv] [настройки плана заказов]</code>
+''database'' - путь или имя базы для расчетов
+''filter''- имя фильтра, созданного в программе для выбора товаров, попадающих в план заказов
+''user'' - имя пользователя. Если указан пользователь, то используются настройки плана заказов, указанные у этого пользователя в программе (Тип анализа, Временная корзина, Единицы измерения)
+''target'' - файл, куда сохранится рассчитанный план заказов
+''dates'' - период расчёта плана заказов. dates1 - дата От, dates2 - дата До
+''xlsx csv'' - указывается в каком формате сохранится план заказов xlsx или utf8 csv. если флаг не указан, то сохранится в xlsx.
+**Настройки плана заказов**
+  * Тип анализа
+<code>--type (income | ordered | rests | payment)</code>
+''income'' - Приходы \\
+''ordered'' - Заказано \\
+''rests'' - Остатки \\
+''payment'' - План оплат \\
+  * Временная корзина
+<code>--timeBucket (week | month | quarter)</code>
+''week'' - По неделям \\
+''month'' - По месяцам \\
+''quarter'' - По кварталам \\
+  * Единицы измерения
+<code>--units (sell | purchase | amount | weight | volume | reports | sku)</code>
+''sell'' - в Реализационных ценах \\
+''purchase'' - в Закупочных ценах \\
+''amount'' - Нат. ед. \\
+''weight'' - Вес \\
+''volume'' - Объём \\
+''reports'' - Число заказов \\
+''sku'' - SKU \\
+<note important>План оплат формируется только в закупочных ценах и не может быть поквартальным.</note>
+**Пример команды**
+<code>FSystemConsole.exe stockplan demo.db --filter filter№1 --user FCN --target "D:\FNOW\OUT" --dates 01.01.2020 01.04.2020 </code>
 =====Проведение ABC анализа=====
 Вы можете проводить ABC- XYZ и кросс ABC-анализ автоматически при помощи консольной утилиты. Результаты анализа запишутся в базу, а также в Excel файл с разбиением товаров по группам.
@@ Строка 1090: / Строка 1184: @@
 дополнительные столбцы;список через ';' свойств и параметров для вывода</code>
-склад - имя склада или пусто (тогда расчет будет произведен по всем складам)
+склад - код склада или пусто (тогда расчет будет произведен по всем складам)
 тип - группа или срез
@@ Строка 1125: / Строка 1219: @@
 <code>не анализировать новые товары</code>
+если нужно [[анализ/abc-xyz#учёт_дефицитных_дней_при_проведение_авс_анализа|учитывать дефицит]] при формирование ABC анализа:
+<code>учитывать дефицит</code>
 ===Примеры файлов для проведения анализа===
 <code>15.04.2017;20.04.2017
 Склад;срез;Поставщик;Алефонсина
+учитывать дефицит
 не анализировать новые товары
 ось;X;ABC;Продажи, ед.;5;35
@@ Строка 1199: / Строка 1299: @@
 source - файл настроек (может не существовать, если задан ключ --dates)
-target - файл для сохранения результата - если указаны форматы сохранения при помощи флагов, то расширение файла можно не прописывать, если не указfны - то расширение xlsx
+target - файл для сохранения результата - если указаны форматы сохранения при помощи флагов, то расширение файла можно не прописывать, если не указаны - то расширение xlsx
 --dates dateFrom dateTo - даты от и до для расчёта. Если не указан ключ --dates и даты, то даты берутся из файла настроек. Если указан ключ, но не даты, то берутся минимальная и максимальная даты из базы. Если указан ключ и даты, то берутся даты из аргументов
@@ Строка 1240: / Строка 1340: @@
 <code>
-analogs              очистка аналогов
+analogs                  очистка аналогов
-products             удаление товаров из базы
+products                 удаление товаров из базы
-customer-purchases   удаление закупок для клиентов
+customer-purchases       удаление закупок для клиентов
-composite            очистка данных о комплектах
+composite                очистка данных о комплектах
-items-fields         очистка полей для товаров
+items-fields             очистка полей для товаров
-arrivals             очистка дат поступления заказов
+arrivals                 очистка дат поступления заказов
-orders               очистка реестра заказов
+orders                   очистка реестра заказов
-order-schedule     очистка расписаний заказов
+order-schedule           очистка расписаний заказов
-storage-graphs      иерархия складов
+storage-graphs           иерархия складов
 balancing-destinations   направления балансировки
+clients                  справочник клиентов
 </code>
@@ Строка 1356: / Строка 1457: @@
   *Комплексные форматы заказов
+=====Частичная выгрузка данных=====
+Если необходимо выгрузить информацию только по одному товару, с одного склада, то нужно воспользоваться командой по частичной выгрузке. Часть информации будет выгружена полностью, так как может не иметь привязки к товару. Информация сохраняется в csv файлах, для последующей загрузки в программу.
+**Синтаксис команды**
+<code>
+FSystemConsole.exe export-test-data source Код_склада;Артикул_товара target
+</code>
+  * source - имя базы
+  * target - путь к экспортированному файлу
+**Пример**
+<code>
+FSystemConsole.exe export-test-data demo.db Склад№1;4000000000016 C:\FCN
+</code>
+В C:\FCN буду выгружены файлы : \\
+''export_order_shedules_Склад№1_4000000000016.csv'' - Все календари и расписания заказов \\
+''export_prepare_reports_fitlers_Склад№1_4000000000016.csv'' - Все фильтры подготовки заказов \\
+''export_properties_Склад№1_4000000000016.csv'' - параметры для товара 4000000000016 со склада Склад№1 \\
+''export_sales_history_Склад№1_4000000000016.csv'' - продажи для товара 4000000000016 со склада Склад№1 в формате "Склад;Артикул;Клиент;Дата;Продано;Остаток на складе;Цена реализации;Закупочная цена;Учётная цена" \\
+''export_storage_graphs_Склад№1_4000000000016.csv'' - Все иерархии складов \\
+''export_suppliers_Склад№1_4000000000016.csv'' - Весь справочник поставщиков \\
+''export_user_settings_Склад№1_4000000000016.csv'' - Все глобальные и локальные настройки для всех пользователей из базы. \\
 =====Проверка цифровой подписи заказа=====
@@ Строка 1372: / Строка 1500: @@
 <code>
-FSystemConsole acvtivate-licence <путь к файлу лицензии>
+FSystemConsole activate-license <путь к файлу лицензии>
 </code>
@@ Строка 1404: / Строка 1532: @@
 Если во время работы команды что-то пойдёт не так, то об этом будут сообщено в журнале через ненулевой код возврата.
+=====Очистка журнала действий пользователей=====
+<code>FSystemConsole clearlog database</code>
+database - имя базы
+Команда позволяет очистить журнал действий пользователей от старых записей, которые не попадают в период указанный в [[настройки/глобальные_настройки#хранение_истории_действий_пользователя|глобальной настройке]] \\
+Если глобальная настройка по [[настройки/глобальные_настройки#очищать_журнал_действий_пользователя_при_закрытии_программы|автоматической очистки журнала]] выключена, то можно использовать данную команду.
+=====Применение правил автоматической установки=====
+<code>FSystemConsole apply-parameters-rules [--general/--seasonal] database [--names/--tags] </code>
+general — применить все правила кроме сезонности \\
+seasonal — расчет и применение правил сезонности
+Совместное использование в одной команде флагов general и seasonal, не допускается
+database — название базы
+names — после флага, в кавычках, через запятую, указываются названия правил ("правило1,правило2,правило3"), которые нужно применить. \\
+tags — после флага, в кавычках, через пробел, указывается список тэгов в соответствие с которыми применяются автоправила
+Совместное использование в одной команде флагов names и tags, не допускается
+Если список названий правил и тип правил, не указаны, то операция будет произведена над всеми правилами в базе(если такие есть).