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