{"id":18317793,"url":"https://github.com/azakharo/megaplan_reports","last_synced_at":"2025-07-19T01:04:05.303Z","repository":{"id":57294227,"uuid":"122602434","full_name":"azakharo/megaplan_reports","owner":"azakharo","description":"Generate XLSX report using data from Megaplan","archived":false,"fork":false,"pushed_at":"2023-10-26T04:01:34.000Z","size":69,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-01T02:51:12.708Z","etag":null,"topics":["megaplan","nodejs","xlsx"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/azakharo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-23T09:45:24.000Z","updated_at":"2021-08-20T05:04:33.000Z","dependencies_parsed_at":"2025-04-05T21:42:33.809Z","dependency_job_id":null,"html_url":"https://github.com/azakharo/megaplan_reports","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/azakharo/megaplan_reports","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azakharo%2Fmegaplan_reports","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azakharo%2Fmegaplan_reports/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azakharo%2Fmegaplan_reports/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azakharo%2Fmegaplan_reports/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/azakharo","download_url":"https://codeload.github.com/azakharo/megaplan_reports/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/azakharo%2Fmegaplan_reports/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265866248,"owners_count":23840937,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["megaplan","nodejs","xlsx"],"created_at":"2024-11-05T18:07:33.071Z","updated_at":"2025-07-19T01:04:05.279Z","avatar_url":"https://github.com/azakharo.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Описание\n\n`megaplan_report` - это скрипт, который формирует отчёт по данным из Мегаплана за выбранный временной период.  \n`megaplan_config` - это скрипт, который позволяет задать параметры доступа к Мегаплану.\n\n\n# Предварительные условия\n\nДля работы скриптов необходимо установить Node.js.  \nЗагрузить и установить Node.js можно c [официального сайта](https://nodejs.org/en/).  \nВерсия должна быть \u003e= 8.0 (такая и предлагается на офиц.сайте).\n\nЖелательно установить Node.js в такую папку, чтобы полный путь к папке не содержал пробелы. Например, `C:\\nodejs`.  \n\nДля удобства последующего запуска скриптов нужно добавить папку, в кот. установлена Node.js, в переменную окружения PATH. \nЭто позволит запускать скрипты с помощь команды след.вида (без указания полного пути к node.js): `node имя_скрипта.js`.\n*По-моему, программа установки сама добавит путь к Node.js в системные пути (либо нужно в процессе установки выбрать соответствующую галочку).*   \n\nКроме того, можно ассоциировать все файлы с расширением `.js` с Node.js. \nДля этого в Windows можно создать пустой файл с расширением js. \nЗатем 2 раза щёлкнуть на нём мышкой. Windows спросит, какой программой \nнужно открывать подобные файлы. Нужно указать файл `node.exe` из папки, где установлена Node.js.\n\n**Как проверить, что Node.js правильно установлена?**  \nДля этого нужно выполнить следующее:\n* Открыть консоль (в Windows нажать Win+R, набрать `cmd` и нажать Enter).\n* в консоли выполнить команду `node --version`. В рез-те должна быть напечатал версия Node.js.\n\n\n# Установка скриптов\n\n* Открыть консоль.\n* в консоли выполнить команду: `npm install -g megaplan-reports`\n\n*Проверка установки*:\n* в консоли выполнить команду `megaplan_report -h`. \nДолжна быть показана справочная информация по параметрам запуска скрипта.\n\n\n# Генерация отчёта\n\nДля генерации отчёта нужно запустить скрипт `megaplan_report`.  \n\nСкрипту требуется следующая входная инф-ия:\n* Сервер Мегаплана, к кот. нужно подключиться\n* Имя пользователя\n* Пароль\n* Временной период, за кот. нужны данные, НАЧАЛО. Запрашивается при запуске. Если не вводить, то используется начало месяца.\n* Временной период, за кот. нужны данные, КОНЕЦ. Запрашивается при запуске. Если не вводить, то используется дата/время запуска скрипта.\n* Путь к папке, в кот. положить сгенерированный отчёт. По умолчанию, отчёт кладётся в текущую рабочую директория (директорию, из кот. вызван скрипт).\n\n**Замечание**  \nРез-т работы скрипта сильно зависит от того, какая учётная запись Мегаплана используется. \nДля получения отчёта по деятельности всех сотрудников нужно запускать скрипт с учётной записью Директора предприятия.\n\n\n## Запуск скрипта с передачей входной инф-ии через командную строку\n\nСправку по параметрам скрипта можно получить, выполнив в консоли команду `megaplan_report -h`  \n\nПример команды запуска скрипта генерации отчёта (пароль изменён):  \n`megaplan_report --server=mp388616.megaplan.ru --user=theduster3@yandex.ru --password=****** --start=13.02.2018 --end=03.03.2018 --outdir=D:/Temp`\n\n\n## Запуск скрипта с использованием конфигурационного файла\n\nСкрипт можно запускать проще. Для этого нужно сохранить параметры доступа к Мегаплану в конф.файле.  \nДля этого запустите в консоли команду `megaplan_config`. Сохранив параметры доступа, \nвы можете использовать их неограниченное кол-во раз.  \nЕсли нужно будет поменять параметры доступа, запустите повторно `megaplan_config`.  \n\nДля генерации отчёта в консоли зайдите в папку, в кот. вы хотите сохранить отчёт, и просто запустите команду `megaplan_report`  \nСкрипт спросит вас о временном периоде. Вы можете не отвечать (просто Enter), тогда будут использованы параметры по умолчанию.  \n\n\n# Обновление скриптов\n\nДля обновления не нужно ничего удалять.  \nВ консоли выполнить команду: `npm install -g megaplan-reports`  \nПри этом в консоли будет напечатан номер новой установленной версии программы. \n\n\n# Удаление установки\n\nВ консоли выполнить команду: `npm uninstall -g megaplan-reports`\n\n \n# Обратная связь\n\nПо возникающим вопросам можно обратиться: \n* по электронной почте: zangular@yandex.ru\n* по телефону: +7-920-293-36-56\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazakharo%2Fmegaplan_reports","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fazakharo%2Fmegaplan_reports","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fazakharo%2Fmegaplan_reports/lists"}