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 2.1
edited by root_xwiki
on 2025/10/30 07:12
Change comment: There is no comment for this version

Summary

Details

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