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

Summary

Details

Page properties
Content
... ... @@ -2,8 +2,291 @@
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 +
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 +
7 7  == Параметры подключения к Active Directory ==
8 8  
9 9  **LDAP сервер:** corp.tcax.ru