qe-api-client 2.7.0__py3-none-any.whl → 2.8.0__py3-none-any.whl

qe_api_client/api_classes/engine_generic_object_api.py

@@ -208,3 +208,21 @@ class EngineGenericObjectApi:
             return response["result"]
         except KeyError:
             return response["error"]
+
+
+    def get_properties(self, handle: int):
+        """
+        Retrieves the properties of a specific generic object.
+
+        Parameters:
+            handle (int): The handle identifying the generic object.
+
+        Returns:
+            dict: The properties of the generic object (qLayout). In case of an error, returns the error information.
+        """
+        msg = json.dumps({"jsonrpc": "2.0", "id": 0, "handle": handle, "method": "GetProperties", "params": {}})
+        response = json.loads(self.engine_socket.send_call(self.engine_socket, msg))
+        try:
+            return response["result"]["qProp"]
+        except KeyError:
+            return response["error"]

qe_api_client/engine.py

@@ -135,9 +135,9 @@ class QixEngine:
         # Define of the single dimension properties
         nx_info = self.structs.nx_info(obj_type="dimension")
         if dim_color is None:
-            coloring = self.structs.coloring()
+            coloring = self.structs.dim_coloring()
         else:
-            coloring = self.structs.coloring(base_color={"color": dim_color, "index": dim_color_index})
+            coloring = self.structs.dim_coloring(base_color={"color": dim_color, "index": dim_color_index})
 
         nx_library_dimension_def = self.structs.nx_library_dimension_def(grouping="N", field_definitions=[dim_def],
                                                                          field_labels=[dim_title],
@@ -213,7 +213,8 @@ class QixEngine:
 
 
     def create_master_measure(self, app_handle: int, mes_title: str, mes_def: str, mes_label: str = "",
-                              mes_desc: str = "", mes_tags: list = None):
+                              mes_desc: str = "", mes_tags: list = None, mes_color: str = None,
+                              mes_color_index: int = -1, gradient: dict = None):
         """
         Creates a master measure.
 
@@ -224,6 +225,8 @@ class QixEngine:
             mes_label (str, optional): The label of the measure.
             mes_desc (str, optional): The description of the measure.
             mes_tags (list, optional): The tags of the measure.
+            mes_color (str, optional): The color of the measure.
+            mes_color_index (int, optional): The index of the color of the measure.
 
         Returns:
             dict: The handle and Id of the measure.
@@ -233,8 +236,17 @@ class QixEngine:
 
         # Define of the measure properties
         nx_info = self.structs.nx_info(obj_type="measure")
+
+        if mes_color is None:
+            coloring = self.structs.mes_coloring()
+        else:
+            coloring = self.structs.mes_coloring(base_color={"color": mes_color, "index": mes_color_index})
+
+        if gradient is not None:
+            coloring.update({"gradient": gradient})
+
         nx_library_measure_def = self.structs.nx_library_measure_def(label=mes_title, mes_def=mes_def,
-                                                                     label_expression=mes_label)
+                                                                     label_expression=mes_label, coloring=coloring)
         gen_mes_props = self.structs.generic_measure_properties(nx_info=nx_info,
                                                                 nx_library_measure_def=nx_library_measure_def,
                                                                 title=mes_title, description=mes_desc, tags=mes_tags)
@@ -526,14 +538,25 @@ class QixEngine:
         # Determine the number of the columns and the rows the table has and splits in certain circumstances the table
         # calls
         no_of_columns = obj_layout['qHyperCube']['qSize']['qcx']
+
+        if no_of_columns == 0:
+            return 'The chart either contains no columns or has a calculation condition!'
+
         width = no_of_columns
         no_of_rows = obj_layout['qHyperCube']['qSize']['qcy']
         height = int(math.floor(10000 / no_of_columns))
 
         # Extract the dimension and measure titles and concat them to column names.
-        dimension_titles = [dim['qFallbackTitle'] for dim in obj_layout['qHyperCube']['qDimensionInfo']]
-        measure_titles = [measure['qFallbackTitle'] for measure in obj_layout['qHyperCube']['qMeasureInfo']]
-        column_names = dimension_titles + measure_titles
+        dimension_info = obj_layout['qHyperCube'].get('qDimensionInfo', [])
+        measure_info = obj_layout['qHyperCube'].get('qMeasureInfo', [])
+        column_info = dimension_info + measure_info
+
+        # Build the column mapping using qEffectiveInterColumnSortOrder
+        sort_order = sorted(obj_layout['qHyperCube']['qEffectiveInterColumnSortOrder'])
+        sort_order_positive = [x for x in sort_order if x >= 0]
+        column_names = []
+        for i in sort_order_positive:
+            column_names.append(column_info[i]["qFallbackTitle"])
 
         # if the type of the charts has a straight data structure
         if (obj_layout['qInfo']['qType'] in ['table', 'sn-table', 'piechart', 'scatterplot', 'combochart', 'barchart']
@@ -563,9 +586,10 @@ class QixEngine:
 
             # Supporting function to traverse all subnodes to get all dimensions
             def get_all_dimensions(node):
-                dimensions = [node['qText']]
-                # if 'qSubNodes' in node and node['qSubNodes']:
-                if node['qSubNodes']:
+                label = node.get('qText', '')  # Leerer String, falls nicht vorhanden
+                dimensions = [label]
+
+                if 'qSubNodes' in node and node['qSubNodes']:
                     sub_dimensions = []
                     for sub_node in node['qSubNodes']:
                         sub_dimensions.extend([dimensions + d for d in get_all_dimensions(sub_node)])
@@ -573,13 +597,25 @@ class QixEngine:
                 else:
                     return [dimensions]
 
-            # Gets the column headers for the pivot table
+            # Supporting function to get all column headers for the pivot table
+            def get_column_paths(node):
+                label = node.get('qText', '')
+                current_path = [label]
+
+                if 'qSubNodes' in node and node['qSubNodes']:
+                    paths = []
+                    for sub in node['qSubNodes']:
+                        for path in get_column_paths(sub):
+                            paths.append(current_path + path)
+                    return paths
+                else:
+                    return [current_path]
+
             col_headers = []
             nx_page_top = self.structs.nx_page(left=0, top=0, width=width, height=1)
-            hc_top = self.egoa.get_hypercube_pivot_data(obj_handle, '/qHyperCubeDef', nx_page_top)[
-                'qDataPages'][0]['qTop']
+            hc_top = self.egoa.get_hypercube_pivot_data(obj_handle, '/qHyperCubeDef', nx_page_top)['qDataPages'][0]['qTop']
             for top_node in hc_top:
-                col_headers.extend(get_all_dimensions(top_node))
+                col_headers.extend(get_column_paths(top_node))
 
             # Paging variables
             page = 0
@@ -610,6 +646,9 @@ class QixEngine:
 
             # Creates the Dataframe
             df = pd.DataFrame(data_values, index=row_index, columns=col_index)
+            index_levels = df.index.nlevels
+            df.index.names = column_names[:index_levels]
+            df = df.reset_index()
 
         # if the type of the charts has a stacked data structure
         elif obj_layout['qInfo']['qType'] in ['barchart'] and obj_layout['qHyperCube']['qStackedDataPages'] != []:

qe_api_client/structs.py

@@ -277,14 +277,18 @@ def nx_library_dimension_def(grouping: str = "N", field_definitions: list = None
 
 
 def nx_library_measure_def(label: str, mes_def: str, grouping: str = "N", expressions: list = None,
-                           active_expression: int = 0, label_expression:str = "", num_format: dict = None):
+                           active_expression: int = 0, label_expression:str = "", num_format: dict = None,
+                           coloring: dict = None):
+    if coloring is None:
+        coloring = {}
     if num_format is None:
         num_format = {}
     if expressions is None:
         expressions = []
     return {
         "qLabel": label, "qDef": mes_def,"qGrouping": grouping, "qExpressions": expressions,
-        "qActiveExpression": active_expression, "qLabelExpression": label_expression, "qNumFormat": num_format
+        "qActiveExpression": active_expression, "qLabelExpression": label_expression, "qNumFormat": num_format,
+        "coloring": coloring
     }
 
 
@@ -509,7 +513,7 @@ def color_map(colors: list = None, nul: dict = None, oth: dict = None, pal: str
     }
 
 
-def coloring(change_hash: str = None, color_map_ref: str = "", has_value_colors: bool = False, base_color: dict = None):
+def dim_coloring(change_hash: str = None, color_map_ref: str = "", has_value_colors: bool = False, base_color: dict = None):
     if base_color is None:
         base_color = {"color": "none", "index": 0}
     return {
@@ -520,6 +524,15 @@ def coloring(change_hash: str = None, color_map_ref: str = "", has_value_colors:
     }
 
 
+def mes_coloring(base_color: dict = None, _gradient: dict = None):
+    coloring = {}
+    if base_color is not None:
+        coloring.update({"baseColor": base_color})
+    if _gradient is not None:
+        coloring.update({"gradient": _gradient})
+    return coloring
+
+
 def color_map_properties(dim_id: str, prop_def:dict = None, extends_id: str = "", state_name: str = "",
                          _color_map: dict = None):
 
@@ -539,3 +552,17 @@ def value_color(value: str, color: str, index: int = -1):
         "value": value,
         "baseColor": {"color": color, "index": index}
     }
+
+
+def color(_color: str, index: int = -1):
+    return {"color": _color, "index": index}
+
+
+def gradient(colors: list = None, break_types: list = None, limits: list = None, limit_type: str = "percent"):
+    if colors is None:
+        colors = [color(_color="#332288"), color(_color="#117733")]
+    if break_types is None:
+        break_types = [False]
+    if limits is None:
+        limits = [0.5]
+    return {"colors": colors, "breakTypes": break_types, "limits": limits, "limitType": limit_type}

{qe_api_client-2.7.0.dist-info → qe_api_client-2.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qe-api-client
-Version: 2.7.0
+Version: 2.8.0
 Summary: Python client for the Qlik Engine JSON API
 Home-page: https://github.com/lr-bicc/qe-api-client
 Author: Rumen Vasilev
@@ -11,8 +11,10 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.6
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: websocket-client>=0.47.0
+Requires-Dist: websocket-client>=1.0.0
 Requires-Dist: pandas>=2.2.0
+Requires-Dist: numpy>=2.0.0
+Requires-Dist: uuid>=1.0
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier

{qe_api_client-2.7.0.dist-info → qe_api_client-2.8.0.dist-info}/RECORD

@@ -1,17 +1,17 @@
 qe_api_client/__init__.py,sha256=bypB4CIjpHtf5Pu_NwtJajC69zqQD7qB9jo8cCX0B54,23
-qe_api_client/engine.py,sha256=4pll0uoFPph5WgRufpP4OsYlypWKQhMfJQAaaWPWWUU,56738
+qe_api_client/engine.py,sha256=P98pUEbR86e-UDuI38lzIpRlpT1s93pAs5wNhJtxr5c,58380
 qe_api_client/engine_communicator.py,sha256=q6x7ix2Ev8yGmTTm7cf1vHcidOihKM0HjDXeJ-dZYjk,1133
-qe_api_client/structs.py,sha256=Gh7aGNLN58kYeBY-6Nb7yagQpHnd1f-IlfaE8aEF9ns,22621
+qe_api_client/structs.py,sha256=HuXUCPpHWrQgqilplRID213VAfhO7sefh3FCWfTguvA,23515
 qe_api_client/api_classes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 qe_api_client/api_classes/engine_app_api.py,sha256=qobuSdLV5I-DOXto0Qi5ckMG3q5Dll0Lto3TyjZSbso,37493
 qe_api_client/api_classes/engine_field_api.py,sha256=zCLIR7rmxqwIrJYK_-uHVEhMvBcEP2qofuX8ZPygqCA,5479
 qe_api_client/api_classes/engine_generic_dimension_api.py,sha256=oSZoRT-j4hsCVnUm1OSg7XZPWXhUzFLY_53kM0KwPHs,2122
 qe_api_client/api_classes/engine_generic_measure_api.py,sha256=uj4i_ykX9F9Dtk78fOidMBhzSP8vEucEfrB6MrLwgPI,1340
-qe_api_client/api_classes/engine_generic_object_api.py,sha256=iasoNYSSsBTr_S3ExoorfCip9fhy7sCQ_J-ru2JYal8,10130
+qe_api_client/api_classes/engine_generic_object_api.py,sha256=WTxRusRt2PGxmXsQQyGZ2M2JRyKTSSrV5TqpiykxDbA,10807
 qe_api_client/api_classes/engine_generic_variable_api.py,sha256=sWXZpE-GLfcMijmfORnDNrJ6lmXX3x5TRHlkEu_i0BQ,2027
 qe_api_client/api_classes/engine_global_api.py,sha256=G6QQHI36WOo7W25zg4Uz__gMSLC2ptNTvbBdElPzgZI,27535
-qe_api_client-2.7.0.dist-info/licenses/LICENSE,sha256=2bm9uFabQZ3Ykb_SaSU_uUbAj2-htc6WJQmS_65qD00,1073
-qe_api_client-2.7.0.dist-info/METADATA,sha256=5-VkSmGbK-92mrMlEqFgozK8FtbUfmpW1o5_zQZrLlA,2385
-qe_api_client-2.7.0.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-qe_api_client-2.7.0.dist-info/top_level.txt,sha256=m_43YagP8UtZgJHmZEfu0vlBNwt36M01-Qby2jByMnk,14
-qe_api_client-2.7.0.dist-info/RECORD,,
+qe_api_client-2.8.0.dist-info/licenses/LICENSE,sha256=2bm9uFabQZ3Ykb_SaSU_uUbAj2-htc6WJQmS_65qD00,1073
+qe_api_client-2.8.0.dist-info/METADATA,sha256=94Fddh_umm8FPjkp7Scj3VGheOLvjGPEiyzx_V3UGjI,2437
+qe_api_client-2.8.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+qe_api_client-2.8.0.dist-info/top_level.txt,sha256=m_43YagP8UtZgJHmZEfu0vlBNwt36M01-Qby2jByMnk,14
+qe_api_client-2.8.0.dist-info/RECORD,,

{qe_api_client-2.7.0.dist-info → qe_api_client-2.8.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.3.1)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any