Skip to Content
Last modified by root_xwiki on 2025/10/30 07:12
From version 1.3
edited by root_xwiki
on 2025/10/30 07:11
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,264 +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 -Создайте файл 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 -
263 263  == Параметры подключения к Active Directory ==
264 264  
265 265  **LDAP сервер:** corp.tcax.ru