Skip to Content
Last modified by root_xwiki on 2025/10/30 07:12
From version 1.2
edited by root_xwiki
on 2025/10/30 07:10
Change comment: There is no comment for this version
To version 1.1
edited by root_xwiki
on 2025/10/30 06:22
Change comment: There is no comment for this version

Summary

Details

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