Перейти к содержимому
Редактировал(а) root_xwiki 2025/10/30 07:12
От версии 1.1
отредактировано root_xwiki
на 2025/10/30 06:22
Изменить комментарий: К данной версии нет комментариев
К версии 1.3
отредактировано root_xwiki
на 2025/10/30 07:11
Изменить комментарий: К данной версии нет комментариев

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -2,8 +2,264 @@
2 2  
3 3  ----
4 4  
5 -= Инструкция по использованию программы "Массовое обновление пользователей Active Directory" =
5 += Инструкция по использованию программы "Массовое обновление пользователей Active Directory"
6 + =
6 6  
8 +Вы правы! Вот дополнение к инструкции с разделом установки зависимостей:
9 +
10 +----
11 +
12 +== 0. Установка программы и зависимостей ==
13 +
14 +== Системные требования ==
15 +
16 +* **Операционная система:** Windows 10/11, Linux, macOS
17 +* **Python:** версия 3.7 или выше
18 +* **Доступ к сети:** подключение к серверу corp.tcax.ru
19 +* **Права:** права администратора домена для полного функционала
20 +
21 +== Шаг 1: Установка Python ==
22 +
23 +Если Python не установлен:
24 +
25 +**Windows:**
26 +
27 +1. Скачайте установщик с [[https:~~/~~/www.python.org/downloads/>>url:https://www.python.org/downloads/]]
28 +1. Запустите установщик
29 +1. **Важно!** Поставьте галочку "Add Python to PATH"
30 +1. Нажмите "Install Now"
31 +
32 +**Linux (Ubuntu/Debian):**
33 +
34 +{{{
35 + }}}
36 +
37 +bash
38 +
39 +sudo apt update sudo apt install python3 python3-pip
40 +
41 +**Linux (CentOS/RHEL):**
42 +
43 +{{{
44 + }}}
45 +
46 +
47 +bash
48 +
49 +sudo yum install python3 python3-pip
50 +
51 +== Шаг 2: Установка зависимостей
52 +\\ ==
53 +
54 +Создайте файл requirements.txt со следующим содержимым:
55 +
56 +{{{
57 + }}}
58 +
59 +
60 +text
61 +
62 +PyQt5==5.15.10 pandas==2.1.3 openpyxl==3.1.2 ldap3==2.9.1
63 +
64 +Установите зависимости одной командой:
65 +
66 +**Windows:**
67 +
68 +{{{
69 + }}}
70 +
71 +text
72 +
73 +pip install -r requirements.txt
74 +
75 +**Linux/macOS:**
76 +
77 +{{{
78 + }}}
79 +
80 +bash
81 +
82 +pip3 install -r requirements.txt
83 +
84 +**Или установите пакеты по отдельности:**
85 +
86 +{{{
87 + }}}
88 +
89 +
90 +bash
91 +
92 +pip install PyQt5 pip install pandas pip install openpyxl pip install ldap3
93 +
94 +== Описание зависимостей ==
95 +
96 +|=Библиотека|=Версия|=Назначение
97 +|**PyQt5**|5.15.10|Графический интерфейс программы
98 +|**pandas**|2.1.3|Работа с Excel файлами и таблицами данных
99 +|**openpyxl**|3.1.2|Чтение и запись файлов Excel (.xlsx)
100 +|**ldap3**|2.9.1|Подключение и работа с Active Directory
101 +
102 +
103 +
104 +== Шаг 3: Проверка установки ==
105 +
106 +Запустите следующую команду для проверки:
107 +
108 +{{{
109 + }}}
110 +
111 +bash
112 +
113 +python -c "import PyQt5; import pandas; import openpyxl; import ldap3; print('Все зависимости установлены успешно!')"
114 +
115 +Если команда выполнилась без ошибок - всё готово к использованию!
116 +
117 +== Шаг 4: Запуск программы ==
118 +
119 +**Windows:**
120 +
121 +{{{
122 + }}}
123 +
124 +text
125 +
126 +python ad_bulk_update.py
127 +
128 +**Linux/macOS:**
129 +
130 +{{{
131 + }}}
132 +
133 +bash
134 +
135 +python3 ad_bulk_update.py
136 +
137 +== Возможные проблемы при установке ==
138 +
139 +== Проблема 1: "pip не является внутренней или внешней командой" ==
140 +
141 +**Решение:**
142 +
143 +{{{
144 + }}}
145 +
146 +bash
147 +
148 +python -m pip install -r requirements.txt
149 +
150 +== Проблема 2: Ошибка при установке PyQt5 ==
151 +
152 +**Решение для Linux:**
153 +
154 +{{{
155 + }}}
156 +
157 +
158 +bash
159 +
160 +sudo apt install python3-pyqt5 python3-pyqt5.qtwidgets
161 +
162 +== Проблема 3: Ошибка доступа (Permission denied) ==
163 +
164 +**Решение:**
165 +
166 +{{{
167 + }}}
168 +
169 +
170 +bash
171 +
172 +pip install ~-~-user -r requirements.txt
173 +
174 +== Проблема 4: Конфликт версий ==
175 +
176 +**Решение:** Используйте виртуальное окружение:
177 +
178 +**Windows:**
179 +
180 +{{{
181 + }}}
182 +
183 +
184 +text
185 +
186 +python -m venv venv venv\Scripts\activate pip install -r requirements.txt
187 +
188 +**Linux/macOS:**
189 +
190 +{{{
191 + }}}
192 +
193 +
194 +
195 +bash
196 +
197 +python3 -m venv venv source venv/bin/activate pip install -r requirements.txt
198 +
199 +== Структура файлов проекта ==
200 +
201 +После установки у вас должны быть следующие файлы:
202 +
203 +{{{
204 + }}}
205 +
206 +text
207 +
208 +ad_bulk_update/ ├── ad_bulk_update.py # Основной файл программы ├── requirements.txt # Список зависимостей ├── ad_bulk_update_config.json # Настройки (создается автоматически) ├── ad_columns_config.json # Настройки столбцов (создается автоматически) └── README.md # Данная инструкция
209 +
210 +== Создание исполняемого файла (опционально) ==
211 +
212 +Для создания .exe файла (Windows) без необходимости установки Python:
213 +
214 +1. Установите PyInstaller:
215 +
216 +{{{
217 + }}}
218 +
219 +
220 +bash
221 +
222 +pip install pyinstaller
223 +
224 +1. Создайте исполняемый файл:
225 +
226 +{{{
227 + }}}
228 +
229 +bash
230 +
231 +pyinstaller ~-~-onefile ~-~-windowed ~-~-name="AD Bulk Update" ad_bulk_update.py
232 +
233 +1. Готовый файл будет в папке dist/
234 +
235 +----
236 +
237 +== Быстрый старт (для опытных пользователей) ==
238 +
239 +{{{
240 + }}}
241 +
242 +bash
243 +
244 +# Клонирование или создание проекта mkdir ad_bulk_update cd ad_bulk_update # Создание requirements.txt echo "PyQt5==5.15.10 pandas==2.1.3 openpyxl==3.1.2 ldap3==2.9.1" > requirements.txt # Установка зависимостей pip install -r requirements.txt # Копирование файла ad_bulk_update.py (все 3 части кода) # Запуск python ad_bulk_update.py
245 +
246 +----
247 +
248 +== Обновление зависимостей ==
249 +
250 +Для обновления всех библиотек до последних версий:
251 +
252 +{{{
253 + }}}
254 +
255 +bash
256 +
257 +pip install ~-~-upgrade -r requirements.txt
258 +
259 +----
260 +
261 +**Примечание:** Рекомендуется использовать указанные версии библиотек для обеспечения стабильной работы программы. Более новые версии могут содержать изменения API, которые потребуют модификации кода.
262 +
7 7  == Параметры подключения к Active Directory ==
8 8  
9 9  **LDAP сервер:** corp.tcax.ru