polyapi 5.9.16__tar.gz → 5.9.17__tar.gz

{polyapi-5.9.16 → polyapi-5.9.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polyapi
-Version: 5.9.16
+Version: 5.9.17
 Summary: Wrapper for Polymatica API
 Home-page: https://slsoft.ru/products/polymatica/
 Author: Polymatica Rus LLC

{polyapi-5.9.16 → polyapi-5.9.17}/polyapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: polyapi
-Version: 5.9.16
+Version: 5.9.17
 Summary: Wrapper for Polymatica API
 Home-page: https://slsoft.ru/products/polymatica/
 Author: Polymatica Rus LLC

{polyapi-5.9.16 → polyapi-5.9.17}/polyapi.egg-info/SOURCES.txt

@@ -46,4 +46,9 @@ polymatica/graph/types/pools.py
 polymatica/graph/types/pools_3d.py
 polymatica/graph/types/radar.py
 polymatica/graph/types/sankey.py
-polymatica/graph/types/surface.py
+polymatica/graph/types/surface.py
+tests/__init__.py
+tests/conftest.py
+tests/const.py
+tests/test_create_sphere.py
+tests/test_update_cube.py

{polyapi-5.9.16 → polyapi-5.9.17}/polyapi.egg-info/top_level.txt

@@ -1 +1,2 @@
 polymatica
+tests

{polyapi-5.9.16 → polyapi-5.9.17}/polymatica/business_scenarios.py

@@ -1214,6 +1214,14 @@ class BusinessLogic:
     def put_dim_filter_by_value(
         self, value: str, dim_id: str, clear_filter: bool = False
     ):
+        """
+       Установка фильтра по значению элемента.
+       В первом вызове метода необходимо выставить clear_filter=True, иначе фильтр не применится.
+       :param value: (str) Значение, по которому происходит фильтрация.
+       :param dim_id: (str) ID размерности, по которой производится фильтрация.
+       :param clear_filter: (bool) снять ли все отметки перед наложением фильтра, по умолчанию False.
+       :return: (dict) результат выполнения команд (("filter", "apply_data"), ("filter", "set")).
+       """
         if clear_filter:
             self.execute_olap_command(
                 command_name="filter", state="filter_all_flag", dimension=dim_id
@@ -1246,14 +1254,14 @@ class BusinessLogic:
         query = self.olap_command.collect_request(command1, command2)
 
         try:
-            self.exec_request.execute_request(query)
+            result = self.exec_request.execute_request(query)
         except Exception as e:
             return self._raise_exception(PolymaticaException, str(e))
 
         self.update_total_row()
         self.func_name = "put_dim_filter_by_value"
 
-        return
+        return result
 
     @timing
     def put_dim_filter(
@@ -1577,7 +1585,7 @@ class BusinessLogic:
         :param module: (str) название/идентификатор OLAP-модуля, в котором нужно переименовать группу фактов;
             если модуль указан, но такого нет - сгенерируется исключение;
             если модуль не указан, то берётся текущий (активный) модуль (если его нет - сгенерируется исключение).
-        :return: (dict) результат команды ("fact", "rename").
+        :return: (dict) результат команды ("fact", "tree_rename_group_request").
         :call_example:
             1. Инициализируем класс БЛ: bl_test = BusinessLogic(login="login", password="password", url="url")
             2. Вызов метода:
@@ -1811,28 +1819,49 @@ class BusinessLogic:
         log("End download file")
 
     @timing
-    def export(self, path: str, file_format: str) -> Tuple[str, str]:
+    def export(self, path: str, file_format: str, mode: str = "standard") -> Tuple[str, str]:
         """
-        Экспортировать мультисферу в файл в заданную директорию. Если указанной директории не сущестует - она будет
+        Экспортировать мультисферу в файл в заданную директорию. Если указанной директории не существует - она будет
         создана. Непосредственно имя файла будет сгенерировано автоматически.
         :param path: (str) директория, в которой нужно сохранить файл; также, директория не может быть пустой
             (т.е. не может содержать пустую строку или None).
-        :param file_format: (str) формат сохраненного файла: "csv", "xls", "json".
-        :return (str): file_name - название файла.
-        :return (str): path - директория файла.
+        :param file_format: (str) формат сохраненного файла: "csv", "xlsx", "ods", "json".
+        :param mode: (str) режим экспорта. Возможные значения: standard — для выбора стандартного режима,
+            сохраняющего текущий порядок строк и столбцов в выгружаемом OLAP-модуле; fast — для выбора ускоренного
+            режима, не сохраняющего текущий порядок строк и столбцов. Необязательный аргумент.
+            Значение по умолчанию — standard.
+        :return (Tuple[str, str]): (file_name, path) - название файла, путь к файлу
         """
         # проверки
         try:
-            self.checks(self.func_name, file_format, path)
+            self.checks(self.func_name, file_format, path, mode)
         except Exception as e:
             return self._raise_exception(ValueError, str(e), with_traceback=False)
 
+        # загружаем форматы фактов и преобразуем их для запроса
+        measure_formats = self.get_measure_format()
+        measure_precisions = []
+        measure_units = []
+        for measure_name, measure_format in measure_formats.items():
+            measure_id = self.get_measure_id(measure_name)
+            measure_precision = measure_format.get("precision", 2)
+            measure_unit = measure_format.get("measureUnit", "")
+            measure_precisions.append({"key": measure_id, "value": int(measure_precision)})
+            measure_units.append({"key": measure_id, "value": measure_unit})
+
+        # преобразуем другие параметры для корректности запроса
+        file_format = "xls" if file_format == "xlsx" else file_format
+        disable_sorting = True if mode == "fast" else False
+
         # начать экспорт данных и дождаться загрузки
         self.execute_olap_command(
             command_name="xls_export",
             state="start",
             export_format=file_format,
             export_destination_type="local",
+            disable_sorting=disable_sorting,
+            facts_precision=measure_precisions,
+            measure_units=measure_units,
         )
         need_check_progress = True
         while need_check_progress:
@@ -1850,11 +1879,11 @@ class BusinessLogic:
                     "code", -1
                 ), status_info.get("message", "Unknown error!")
                 log(f"Export data: status: {status_code}, progress: {progress_value}")
-            except Exception:
+            except Exception as e:
                 # если упала ошибка - не удалось получить ответ от сервера: возможно, он недоступен
                 return self._raise_exception(
                     ExportError,
-                    "Failed to export data! Possible server is unavailable.",
+                    f"Failed to export data! Possible server is unavailable. Error: {e}",
                 )
 
             # анализируем статус загрузки
@@ -1882,24 +1911,22 @@ class BusinessLogic:
 
         # имя файла в результате команды ('xls_export', 'check') приходит только после полной загрузки файла
         # формируем название нужного файла
-        format_map = {"csv": ["csv"], "xls": ["xls", "xlsx"], "json": ["json"]}
-        server_f_name = self.h.parse_result(result=progress_data, key="file_name")
-        download_file_name = server_f_name.replace(":", "-")
-        download_file_name = (
-            download_file_name[:-8]
-            if download_file_name.split(".")[-1] not in format_map.get(file_format)
-            else download_file_name
-        )
+        server_file_name = self.h.parse_result(result=progress_data, key="file_name")
+        download_file_name = self.h.parse_result(result=progress_data, key="file_name_hint")
 
         # скачивание файла
         self._download_file(
-            f"{self.resources_url}/{server_f_name}", path, download_file_name
+            f"{self.resources_url}/{server_file_name}", path, download_file_name
         )
 
         # проверка что файл скачался после экспорта
-        assert download_file_name in os.listdir(
-            path
-        ), f'File "{download_file_name}" not in path "{path}"!'
+        if download_file_name not in os.listdir(path):
+            return self._raise_exception(
+                ExportError, 
+                f'File "{download_file_name}" was not found in directory "{path}" after download. '
+                f'Please check file permissions, available disk space, and directory access rights.',
+                with_traceback=False
+            )
         return download_file_name, path
 
     @staticmethod
@@ -2607,7 +2634,7 @@ class BusinessLogic:
         :param user_password: (str) пароль пользователя, под которым запускается сценарий;
             не нужно указывать, если требуется запустить сценарий под пользователем, по-умолчанию не имеющим пароля,
             например, временный пользователь.
-        :param units: (int) число выгружаемых строк мультисферы (по-умолчанию 500).
+        :param units: (int) число выгружаемых строк мультисферы (по-умолчанию 1000).
         :return: (tuple) данные мультисферы и данные о колонках мультсферы (аналогично методу "get_data_frame").
         :call_example:
             1. Инициализируем класс БЛ: bl_test = BusinessLogic(login="login", password="password", url="url")
@@ -2730,7 +2757,7 @@ class BusinessLogic:
         иначе будут возвращаться неполные данные.
         ВАЖНО: генерация строк не учитывает промежуточные и общие итоги (тоталы) по строкам и колонкам.
         :param units: (int) количество подгружаемых строк; ожидается целое положительное число больше 0;
-            по-умолчанию 100.
+            по-умолчанию 1000.
         :param show_all_columns: (bool) установка показа всех колонок датафрейма.
         :param show_all_rows: (bool) установка показа всех строк датафрейма.
         :return: (DataFrame, DataFrame) данные мультисферы и колонки мультисферы в формате DataFrame.
@@ -4086,9 +4113,13 @@ class BusinessLogic:
                     опционально также может быть задан порт подключения, в таком случае он должен идти после указания
                     хоста через двоеточие (например, "10.18.0.132:5433", "polymatica.database1.ru:5433");
                     в случае, если порт явно не указан, подразумевается порт по-умолчанию 5432.
+                    Для источника данных JDBC в этом поле необходимо указать DSN в формате,
+                    например, jdbc:mysql://192.111.11.11:3306/database. Если database стандартный, то возможно
+                    подключение и без указания его в DSN.
                 "login" - логин пользователя.
                 "passwd" - пароль пользователя.
-                "database" - имя базы данных.
+                "database" - имя базы данных. Для источника данных JDBC указывать "database" не надо, оно указывается
+                    после хоста в строке DSN (см. описание поля "server")
                 "sql_query" - запрос, который необходимо выполнить на сервере.
             Пример задания параметра:
                 {
@@ -4115,7 +4146,13 @@ class BusinessLogic:
             при этом второе значение должно быть больше первого. Формат значений времени: "DD.MM.YYYY". Все остальные
             значения, если они будут переданы, будут игнорироваться. Актуально только для интервального обновления.
         :param encoding: (str) кодировка, например UTF-8; обязательна для csv-источника.
-        :param delayed: (bool) создать мультисферу при первом обновлении (как аналогичный чек-бокс на интерфейсе).
+        :param delayed: (bool) параметр, определяющий, будет ли отложено создание мультисферы.
+            Если False, то не будет, и мультисфера будет автоматически создана.
+            Если True: если настроено расписание обновлений (schedule в update_params),
+            то импорт данных мультисферы начнется при первом срабатывании заданного расписания,
+            а если расписание не настроено, то импорт данных мультисферы начнется при следующем
+            принудительном обновлении (через метод manual_update_cube или через веб-интерфейс).
+            По умолчанию False.
         :param modified_records_params: (dict) параметры обновления для типа "обновление измененных записей".
             Поля, передаваемые в словарь:
                 "modified_records_key" - поле, которому осуществляется сопоставление данных (имя размерности).
@@ -4197,7 +4234,12 @@ class BusinessLogic:
             modified_records_params = dict()
         else:
             copy.deepcopy(modified_records_params)
-            if modified_records_params.get("version") != 0:
+            algo_version = modified_records_params.get("version")
+            if algo_version is None:
+                modified_records_params["version"] = 1
+            elif algo_version not in (0, 1):
+                self.logger.warning(f"Param 'modified_records_algo_version' must be 0 or 1, "
+                               f"not {algo_version}. Changed to 1")
                 modified_records_params["version"] = 1
 
         # проверки
@@ -4392,7 +4434,7 @@ class BusinessLogic:
                         "datetime",
                     ):
                         error_msg = (
-                            f'Dimension "{interval_dim}" has type "{current_type}", '
+                            f'Dimension "{increment_dim}" has type "{current_type}", '
                             f'one of types is expected: ["uint8", "uint16", "uint32", '
                             f'"uint64", "double", "date", "time", "datetime"]!'
                         )
@@ -4584,7 +4626,13 @@ class BusinessLogic:
             используется для замены файла в источнике. Можно заменять на файл того же типа, что и был,
             например "csv" на "csv". В пути файла обязательно должно быть расширение, например, ".csv".
         :param separator: (str) разделитель столбцов. Обязателен для csv-источника (при замене источника).
-        :param delayed: (bool) создать мультисферу при первом обновлении (как аналогичный чек-бокс на интерфейсе).
+        :param delayed: (bool) параметр, определяющий, будет ли отложено обновление мультисферы.
+            Если False, то не будет, и мультисфера будет автоматически обновлена.
+            Если True: если настроено расписание обновлений (schedule в update_params),
+            то мультисфера обновится при первом срабатывании заданного расписания, а если расписание не настроено,
+            то мультисфера обновится при следующем принудительном обновлении
+            (через метод manual_update_cube или через веб-интерфейс).
+            По умолчанию False.
         :param increment_dim: (str) название размерности, необходимой для инкрементального обновления.
         :param interval_dim: (str) название размерности для интервального обновления; размерность должна иметь
             один из следующих типов: date, datetime.
@@ -4673,7 +4721,12 @@ class BusinessLogic:
             modified_records_params = dict()
         else:
             copy.deepcopy(modified_records_params)
-            if modified_records_params.get("version") != 0:
+            algo_version = modified_records_params.get("version")
+            if algo_version is None:
+                modified_records_params["version"] = 1
+            elif algo_version not in (0, 1):
+                self.logger.warning(f"Param 'modified_records_algo_version' must be 0 or 1, "
+                               f"not {algo_version}. Changed to 1")
                 modified_records_params["version"] = 1
         cubes_list = self.get_cubes_list()
         self.func_name = "update_cube"
@@ -5138,12 +5191,14 @@ class BusinessLogic:
         dim_elems = self.h.parse_result(res, dim_items_key)
 
         # вытащить идентификатор группировки размерности (если он есть у этого элемента)
+        # TODO: при доработке для использования метода с любым уровнем размерности вместо all_dims_ids[0] и
+        # dim_elems[0] использовать индекс соответствующего уровня
         try:
             for elem in dim_elems:
-                current_elem = elem[0]
-                if "value" in current_elem and current_elem["value"] == name:
-                    group_id = current_elem["group_id"]
-                    break
+                for current_elem in elem:
+                    if current_elem.get("type") == 3 and current_elem.get("value") == name:
+                        group_id = current_elem["group_id"]
+                        break
         except KeyError:
             msg = f'No grouped dimensions with name "{name}"!'
             return self._raise_exception(ValueError, msg)
@@ -5302,7 +5357,7 @@ class BusinessLogic:
             if position == "left":
                 total_dim_items = [lst[0].strip() for lst in data[1 + top_dims_count :]]
             else:
-                total_dim_items = [item.strip() for item in data[0][left_dims_count:-1]]
+                total_dim_items = [item.strip() for item in data[0][left_dims_count:]]
 
             # проверяем, все ли элементы размерности, указанные пользователем, есть в общем списке элементов
             # если текущий элемент есть - сохраняем его индекс, в противном случае - генерируем ошибку
@@ -6106,7 +6161,7 @@ class BusinessLogic:
 
         result = self.execute_olap_command(
             command_name="view",
-            state="select",
+            state="select_change",
             position=1,
             level=len(dim_values) - 1,
             line=line,
@@ -6133,7 +6188,7 @@ class BusinessLogic:
                 чтобы перед вызовом метода были развёрнуты все узлы мультисферы.
             3. Все тоталы (как промежуточные, так и итоговые) генератором выведены не будут вне зависимости от того,
                 включены они или нет.
-        :param units: (int) количество подгружаемых строк; по-умолчанию 100.
+        :param units: (int) количество подгружаемых строк; по-умолчанию 1000.
         :param convert_type: (bool) нужно ли преобразовывать данные из типов, определённых Полиматикой, к Python-типам;
             по-умолчанию False (т.е. не нужно).
         :param default_value: (Any) актуален только при convert_type = True;
@@ -7895,7 +7950,6 @@ class BusinessLogic:
                 },
                 ...
             ]
-            В случае, если мультисфер в сценарии нет, вернётся пустой список.
             В случае, если в мультисфере нет вынесенных размерностей, то в "used_dimensions"
                 будет пустой список.
         """
@@ -8161,14 +8215,29 @@ class BusinessLogic:
                 'is_composite': <value>,   # является ли размерность составной; для факта - None
                 'position': <value>,       # позиция размерности ("left"/"up"/"out"); для факта - None
                 'have_filter': <value>,    # наложен ли фильтр на размерность; для факта - None,
-                'visible': <value>,        # видимость факта; для размерности - None
+                'visible': <value>,        # видимость размерности (используется при расчете факта
+                                             по фиксированной размерности) или факта
                 'horizontal': <value>,     # включён ли горизонтальный расчёт для факта; для размерности - None
                 'is_calculated': <value>,  # является ли факт вычислимым; для размерности - None
-                'is_group': <value>,       # является ли факт группировкой других фактов; для размерности - None
+                'is_group': False,         # является ли факт группировкой других фактов; для размерности - None
                 'group_id': <value>,       # идентификатор группы, в которую ходит данный факт;
                                              если факт не входит ни в какую группу, то None;
                                              для размерности - None
-                'type': <value>            # тип факта; для размерности - None
+                'type': <value>,           # тип факта; для размерности - None
+                'level': <value>,          # уровень, на который вынесена размерность или уровень для установки
+                                             расчёта сложного вида факта по уровню
+                'is_shown': <value>,       # флаг скрытых размерностей или фактов, флаг, сообщающий о том, что
+                                             у пользователя не должно быть прямой возможности взаимодействовать
+                                             с этой размерностью или фактом
+                'level_fixed_dim': <value>,# идентификатор опорной размерности, по которой производится расчет
+                                             сложного факта. Для простого, относительного факта или сложного факта
+                                             с расчетом по уровню отображается значение '00000000';
+                                             для размерности - None
+                'is_level_fixed': <value>, # признак расчета по опорной размерности. Для сложного факта с расчетом
+                                             по опорной размерности — True. Для простого, относительного факта или
+                                             сложного факта с расчетом по уровню — False;
+                                             для размерности - None
+                'selected': <value>,       # выбран ли факт; для размерности - None
             }
             Группы фактов представляют собой словарь следующего формата:
             {
@@ -8176,13 +8245,22 @@ class BusinessLogic:
                  'type': 'group',          # тип: группа
                  'name': <value>,          # имя группы
                  'visibility': 'visible',  # видимость группы
+                 'is_group': True,         # признак группы
                  'nodes':                  # узлы (факты и группы), входящие в группу, в формате списка словарей
                             [
                                 {
-                                    'id': идентификатор узла,
+                                    'id': идентификатор узла - подгруппы,
+                                    'type': тип, для подгруппы - 'group',
+                                    'name': имя подгруппы,
+                                    'visibility': видимость подгруппы,
+                                    'nodes': узлы (факты и группы), входящие в подгруппу,
+                                             в формате списка словарей
+                                },
+                                {
+                                    'id': идентификатор узла - факта,
                                     'type': тип, для факта - 'measure',
                                     'measure': идентификатор самого факта,
-                                    group_id': идентификатор группы, в которую входит этот узел
+                                    'group_id': идентификатор группы, в которую входит этот узел
                                 },
                                 {...}
                             ]
@@ -8197,25 +8275,30 @@ class BusinessLogic:
         # получаем список размерностей и фактов
         dimensions, measures = self._get_dimensions_list(), self._get_measures_list()
         dim_base_dict = dict.fromkeys(
-            ["visible", "horizontal", "is_calculated", "is_group", "group_id", "type"],
-            None,
-        )
-        measure_base_dict = dict.fromkeys(
-            ["data_type", "is_composite", "position", "have_filter"], None
+            ["horizontal", "is_calculated", "is_group", "group_id", "type", "level_fixed_dim", "is_level_fixed",
+             "selected"], None,
         )
+        measure_base_dict = {
+            **dict.fromkeys(["data_type", "is_composite", "position", "have_filter"], None),
+            "is_group": False,
+        }
 
         # конфигурация размерностей
         for dimension in dimensions:
             current_dim_dict = {
                 "name": dimension.get("name"),
                 "id": dimension.get("id"),
-                "is_copy": dimension.get("base_id") != "00000000",
+                "is_copy": dimension.get("base_id") != EMPTY_ID,
                 "data_type": TYPES_MAP.get(
                     POLYMATICA_INT_TYPES_MAP.get(dimension.get("olap_type"))
                 ),
                 "is_composite": dimension.get("olap3_type") == 3,
                 "position": POSITION_MAP.get(dimension.get("position")),
                 "have_filter": dimension.get("haveFilter"),
+                "level": dimension.get("level"),
+                "visible": dimension.get("visible"),
+                "is_shown": dimension.get("is_shown"),
+
             }
             current_dim_dict.update(dim_base_dict)
             olap_config["dimensions"].append(current_dim_dict)
@@ -8226,24 +8309,30 @@ class BusinessLogic:
             nodes_list
         )
         for measure in measures:
+            node = nodes_dict_with_group[measure["id"]]
             current_measure_dict = {
                 "name": measure.get("name"),
                 "id": measure.get("id"),
-                "is_copy": measure.get("base_id") != "00000000",
+                "is_copy": measure.get("base_id") != EMPTY_ID,
                 "visible": measure.get("visible"),
                 "horizontal": measure.get("horizontal"),
                 "is_calculated": measure.get("olap3_type") == 3,
-                "is_group": measure.get("olap3_type") == 4,
-                "group_id": measure.get("fgroup_id"),  # deprecated
+                "group_id": node["group_id"],
                 "type": MEASURE_INT_STR_TYPES_MAP.get(measure.get("plm_type")),
+                "level": measure.get("level"),
+                "level_fixed_dim": measure.get("level_fixed_dim"),
+                "is_level_fixed": measure.get("is_level_fixed"),
+                "selected": measure.get("selected"),
+                "is_shown": measure.get("is_shown"),
             }
-            node = nodes_dict_with_group[measure["id"]]
-            current_measure_dict["group_id"] = node["group_id"]
+
             current_measure_dict.update(measure_base_dict)
             olap_config["measures"].append(current_measure_dict)
 
         # добавляем группы фактов в список фактов
         measures_groups = [node for node in nodes_list if node.get("type") == "group"]
+        for group_node in measures_groups:
+            group_node["is_group"] = True
         olap_config["measures"].extend(measures_groups)
         # меняем фокус на исходную мультисферу и возвращаем данные
         self.set_multisphere_module_id(current_ms_id)
@@ -8537,10 +8626,21 @@ class BusinessLogic:
         url: str,
         method: str,
         headers: dict,
-        cookies=None,
-        data=None,
-        json: dict = None,
+        cookies: Optional[dict] = None,
+        data: Optional[Union[dict, List[Tuple], bytes]] = None,
+        json: Optional[dict] = None,
     ):
+        """
+        Выполнить HTTP-запрос к API_v2 Аналитикс.
+
+        :param url: (str) URL-адрес стенда Аналитикс.
+        :param method: (str) HTTP-метод (например, "GET", "PATCH", "POST", "PUT", "DELETE").
+        :param headers: (dict) Заголовки HTTP-запроса.
+        :param cookies: (dict) Куки запроса; по умолчанию `{ "session": self.session_id }`.
+        :param data: (dict | list of tuples | bytes) Тело запроса.
+        :param json: (dict) Тело запроса в формате JSON.
+        :return: `requests.models.Response` — необработанный ответ библиотеки `requests`.
+        """
         if cookies is None:
             cookies = {"session": self.session_id}
 
@@ -8557,7 +8657,8 @@ class BusinessLogic:
     def switch_session(self, new_owner_uuid: str) -> int:
         """
         Переключить владельца сессии.
-        :param new_owner_uuid: (str) UUID_4 - идентификатор пользователя, который должен стать владельцем текущей сессии
+        :param new_owner_uuid: (str) uuid - идентификатор пользователя, который должен стать владельцем текущей сессии.
+            Можно получить uuid с помощью метода get_user_uuid(login).
         :return: (int) статус код:
             Статусы ответа:
             204 No Content - успешно.
@@ -8579,10 +8680,39 @@ class BusinessLogic:
         response = self.request_to_api_v2(
             url=url, method="PATCH", headers=headers, json=data
         )
-        assert response.status_code == 204, "Response status code != 204"
-
+        if response.status_code != 204:
+            response_reasons_mapping = {
+                400: "Bad Request (wrong uuid format).",
+                401: "Request from unauthorized user.",
+                403: "The current user does not have admin role.",
+                404: f"User with uuid {new_owner_uuid} not found.",
+                500: "Internal server error."
+            }
+            self.logger.error(f"Response status code != 204, session was not switched. "
+                              f"Reason: {response_reasons_mapping.get(response.status_code)}")
         return response.status_code
 
+    def get_user_uuid(self, login: str = None) -> str:
+        """
+        Метод для получения uuid пользователя. UUID используется в методе switch_session.
+        :param login: (str) логин пользователя, если не указан, то используется логин текущего пользователя.
+        :return: (str) uuid пользователя
+        """
+        user_uuid = None
+        if login is None:
+            login = self.login
+        users_result = self.execute_manager_command(command_name="user", state="list_request")
+        users_data = self.h.parse_result(result=users_result, key="users")
+        for user in users_data:
+            if user.get('login') == login:
+                user_uuid = user.get('uuid')
+        if user_uuid:
+            return user_uuid
+        else:
+            self._raise_exception(UserNotFoundError,
+                                  f'User "{login}" not found on server {self.base_url}',
+                                  with_traceback=False)
+
     @timing
     def cleanup_multisphere_data(
         self,
@@ -9023,7 +9153,7 @@ class GetDataChunk:
             3. Все тоталы (как промежуточные, так и итоговые) генератором выведены не будут вне зависимости от того,
                 включены они или нет.
         :param units: (int) количество подгружаемых строк; ожидается целое положительное число больше 0;
-            по-умолчанию 100.
+            по-умолчанию 1000.
         :param convert_type: (bool) нужно ли преобразовывать данные из типов, определённых Полиматикой, к Python-типам;
             по-умолчанию False (т.е. не нужно).
         :param default_value: (Any) актуален только при convert_type = True;

{polyapi-5.9.16 → polyapi-5.9.17}/polymatica/error_handler.py

@@ -483,19 +483,22 @@ class Validator:
         return base
 
     @staticmethod
-    def check_export(file_format, file_path):
+    def check_export(file_format, file_path, mode):
         """
         Проверка параметров для функции export.
         :param file_format: формат файла
         :param file_path: путь к файлу
+        :param mode: (str) режим экспорта
         :return: True, если проверка прошла успешно
         """
-        if file_format not in ["csv", "xls", "json"]:
+        if file_format not in ["csv", "xls", "xlsx", "ods", "json"]:
             raise ValueError(
-                f'Wrong file format: "{file_format}". Only .csv, .xls, .json formats allowed!'
+                f'Wrong file format: "{file_format}". Only .csv, .xlsx, .ods, .json formats allowed!'
             )
         if not file_path:
             raise ValueError("Empty file path!")
+        if mode not in ("standard", "fast"):
+            raise ValueError(f'Param mode must be "standard" or "fast", not {mode}')
         return True
 
     @staticmethod
@@ -858,18 +861,20 @@ class Validator:
         :param file_type: тип файла
         :param sql_params: параметры SQL
         """
-        if (file_type != "excel") and (file_type != "csv"):
+        if file_type not in ("excel", "csv"):
             if sql_params is None:
                 raise ValueError(
                     'If your sourse is sql: fill in param "sql_params"!\n\n'
                     'In other cases: it is wrong param "file_type": %s\n\nIt can be only:\n'
                     "excel OR csv" % file_type
                 )
-            if not (
-                {"server", "login", "passwd", "sql_query"} <= set(sql_params.keys())
-            ):
+            required_keys_jdbc = {"server", "login", "passwd", "sql_query"}
+            required_keys_sql = required_keys_jdbc | {"database"}
+            required_keys = required_keys_jdbc if file_type == "jdbc" else required_keys_sql
+            missing_keys = required_keys - set(sql_params.keys())
+            if missing_keys:
                 raise ValueError(
-                    "Please check the following params names in sql_params:\n-server\n-login\n-passwd\n-sql_query"
+                    f"Missing required sql_params: {', '.join(sorted(missing_keys))}"
                 )
 
     @staticmethod

{polyapi-5.9.16 → polyapi-5.9.17}/polymatica/graph/graph_interface.py

@@ -452,6 +452,21 @@ class IGraph:
             raise ValueError(error_msg)
 
         layer_id, graph_module_id = graph_module_ids[0]
+
+        # выгружаем текущие параметры графика
+        settings = self._base_bl.execute_manager_command(
+            command_name="user_iface",
+            state="load_settings",
+            module_id=graph_module_id,
+        )
+        current_module_settings = self._base_bl.h.parse_result(settings, "settings")
+        plot_name = current_module_settings.get('plotName')
+        current_state = current_module_settings['plotData'][plot_name]['state']
+
+        # подставляем текущее имя графика из настроек, если его не указали
+        if 'name' not in self._other:
+            self._other['name'] = current_state.get('title')
+
         # получаем идентификатор OLAP-модуля, на основе которого построен график
         layer_settings = self._base_bl.execute_manager_command(
             command_name="user_layer", state="get_layer", layer_id=layer_id