Adapt to fixes in utils module

Author: emahler

prosuite/doc/api/_sources/samples.rst.txt

@@ -13,7 +13,7 @@ start the verification of a specific quality specification.
 
 .. code-block:: python
 
-    service = prosuite.verification.service(host_name='localhost', port_nr=5151)
+    service = prosuite.verification.Service(host_name='localhost', port_nr=5151)
     service.verify(specification=my_specification)
 
 
@@ -169,7 +169,7 @@ Verification using XML Specification
 
     import prosuite
 
-    service = prosuite.verification.service(host_name='arcgis_server', port_nr=5151)
+    service = prosuite.verification.Service(host_name='arcgis_server', port_nr=5151)
 
     xml_file = "\\share\QA\specifications\road_specification.qa.xml"
     sde_file = "\\share\connection_files\production_QA_version.sde"
@@ -314,7 +314,7 @@ credentials on a non-windows platform, see `the gRPC Python docs <https://grpc.g
     ssl_credentials = prosuite.utils.get_ssl_channel_credentials()
 
     # if channel_credentials are passed to the Verification constructor, a secure channel will be established.
-    service = prosuite.verification.service(host_name='localhost', port_nr=5151, channel_credentials=ssl_credentials)
+    service = prosuite.verification.Service(host_name='localhost', port_nr=5151, channel_credentials=ssl_credentials)
 
 
 Define a WKB perimeter
@@ -360,7 +360,7 @@ Optionally, change advanced verification parameters, such as the Verification ti
     import prosuite
 
     xml_file = 'C:/temp/road_specification.qa.xml'
-    service = prosuite.verification.service(host_name='localhost', port_nr=5151)
+    service = prosuite.verification.Service(host_name='localhost', port_nr=5151)
     
     xml_spec = prosuite.XmlSpecification(
         specification_file=xml_file, specification_name="Produktionsunterstuetzung",
@@ -402,7 +402,7 @@ In this example, an XML specification is used.
     # Wait for the process to start, initialize the ArcGIS license and the communication channl
     time.sleep(10)
 
-    service = prosuite.verification.service(host_name='LOCALHOST', port_nr=5151)
+    service = prosuite.verification.Service(host_name='LOCALHOST', port_nr=5151)
 
     xml_file = "C:/Data/specifications/road_specification.qa.xml"
     workspace = "C:/Data/TopographicData.gdb"
@@ -733,6 +733,56 @@ Use case: Run a DDX-based quality verification, but only on features that match
 - The DDX specification is reused as-is, no modification in the Data Dictionary is required.
 - Works with PostgreSQL/PostGIS views or other SQL-based sources supported by the QA microservice.
 
+**Export transformed datasets using `QaExportTables`**
+
+**Use case:** After applying SQL-based transformers like `TrMakeTable`, you may want to inspect the intermediate results in a file geodatabase. This is helpful for understanding which features are being passed into QA checks.
+
+.. code-block:: python
+   :linenos:
+
+   import prosuite
+   import os
+
+   service = prosuite.Service(host_name='localhost', port_nr=5151)
+
+   # Load the model and base dataset
+   model = prosuite.Model("MyModel", r"C:\\Data\\MyDatabase.gdb")
+   roads = prosuite.Dataset("v_roads", model)
+
+   # Apply an SQL filter via TrMakeTable
+   sql = """
+    SELECT object_id, change_column, type_column, geom
+    FROM schema_name.source_view
+    WHERE object_id NOT IN (
+        SELECT other.object_id
+        FROM schema_name.reference_table other
+        WHERE other.object_id = schema_name.source_view.object_id
+        AND other.status_column = 'some_terminated_status'
+    )
+    AND (
+        change_column = 'some_terminated_status' OR change_column = 'active_status'
+    )
+    """
+   filtered_roads = prosuite.Transformers.tr_make_table_1(roads, sql, object_id_field="object_id")
+
+   # Define a basic QA condition
+   condition = prosuite.Conditions.qa_min_length_0(filtered_roads, limit=10.0, is3_d=False)
+
+   # Create specification and add the condition
+   spec = prosuite.Specification(name="Check Active Roads")
+   spec.add_condition(condition)
+
+   # Export transformed dataset to GDB for inspection
+   export_gdb = r"C:\\temp\\qa_export\\transformed_data.gdb"
+   spec.add_condition(
+       prosuite.Conditions.qa_export_tables_0([filtered_roads], export_gdb)
+   )
+
+   # Run verification
+   for response in service.verify(specification=spec, output_dir=r"C:\\temp\\qa_export"):
+       print(response.message_level)
+       print(response.message)
+
 Custom Names for Conditions and Transformers
 ============================================
 

prosuite/doc/api/genindex.html

@@ -136,10 +136,10 @@ <h2 id="A">A</h2>
 </li>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.AllowedLineInteriorIntersections">AllowedLineInteriorIntersections (class in prosuite.factories.enums)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.PolygonPart.AllRings">AllRings (prosuite.factories.enums.PolygonPart attribute)</a>
 </li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="prosuite.datatypes.html#prosuite.datatypes.expected_case.ExpectedCase.ALLUPPER">ALLUPPER (prosuite.datatypes.expected_case.ExpectedCase attribute)</a>
 </li>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.ExpectedCase.AllUpper">AllUpper (prosuite.factories.enums.ExpectedCase attribute)</a>
@@ -160,6 +160,8 @@ <h2 id="A">A</h2>
         <li><a href="prosuite.factories.html#prosuite.factories.enums.MonotonicityDirection.Any">(prosuite.factories.enums.MonotonicityDirection attribute)</a>
 </li>
       </ul></li>
+      <li><a href="prosuite.html#prosuite.utils.append_timestamp_to_basepath">append_timestamp_to_basepath() (in module prosuite.utils)</a>
+</li>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.PolylineConversion.AsIs">AsIs (prosuite.factories.enums.PolylineConversion attribute)</a>
 
       <ul>
@@ -390,15 +392,19 @@ <h2 id="G">G</h2>
 </li>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.GeometryComponent">GeometryComponent (class in prosuite.factories.enums)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="prosuite.html#prosuite.quality.Specification.get_conditions">get_conditions() (prosuite.quality.Specification method)</a>
 </li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="prosuite.html#prosuite.data_model.Model.get_dataset_by_name">get_dataset_by_name() (prosuite.data_model.Model method)</a>
 </li>
       <li><a href="prosuite.html#prosuite.quality.XmlSpecification.get_specification_names">get_specification_names() (prosuite.quality.XmlSpecification static method)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.get_ssl_channel_credentials">get_ssl_channel_credentials() (in module prosuite.utils)</a>
 </li>
       <li><a href="prosuite.html#prosuite.quality.Parameter.get_string_value">get_string_value() (prosuite.quality.Parameter method)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.get_value_or_default">get_value_or_default() (in module prosuite.utils)</a>
 </li>
       <li><a href="prosuite.html#prosuite.quality.Parameter.get_where_clause">get_where_clause() (prosuite.quality.Parameter method)</a>
 </li>
@@ -532,10 +538,10 @@ <h2 id="L">L</h2>
 </li>
       <li><a href="prosuite.html#prosuite.verification.MessageLevel.level_70000">level_70000 (prosuite.verification.MessageLevel attribute)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.LineCapStyle">LineCapStyle (class in prosuite.factories.enums)</a>
 </li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.GeometryComponent.LineEndPoint">LineEndPoint (prosuite.factories.enums.GeometryComponent attribute)</a>
 </li>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.GeometryComponent.LineEndPoints">LineEndPoints (prosuite.factories.enums.GeometryComponent attribute)</a>
@@ -545,6 +551,10 @@ <h2 id="L">L</h2>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.LineMSource">LineMSource (class in prosuite.factories.enums)</a>
 </li>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.GeometryComponent.LineStartPoint">LineStartPoint (prosuite.factories.enums.GeometryComponent attribute)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.load_file_as_string">load_file_as_string() (in module prosuite.utils)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.load_json_file">load_json_file() (in module prosuite.utils)</a>
 </li>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.BoundaryLoopErrorGeometry.LoopPolygon">LoopPolygon (prosuite.factories.enums.BoundaryLoopErrorGeometry attribute)</a>
 </li>
@@ -674,6 +684,8 @@ <h2 id="O">O</h2>
 <table style="width: 100%" class="indextable genindextable"><tr>
   <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="prosuite.html#prosuite.verification.InvolvedTable.object_ids">object_ids (prosuite.verification.InvolvedTable attribute)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.objectify_xml">objectify_xml() (in module prosuite.utils)</a>
 </li>
       <li><a href="prosuite.html#prosuite.verification.VerificationParameters.objects_to_verify">objects_to_verify (prosuite.verification.VerificationParameters attribute)</a>
 </li>
@@ -1645,6 +1657,14 @@ <h2 id="T">T</h2>
       <li><a href="prosuite.factories.html#prosuite.factories.enums.SearchOption.Tile">Tile (prosuite.factories.enums.SearchOption attribute)</a>
 </li>
       <li><a href="prosuite.html#prosuite.verification.VerificationParameters.tile_size">tile_size (prosuite.verification.VerificationParameters attribute)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.to_bool">to_bool() (in module prosuite.utils)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.to_float">to_float() (in module prosuite.utils)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.to_int">to_int() (in module prosuite.utils)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.to_spatial_reference_xml">to_spatial_reference_xml() (in module prosuite.utils)</a>
 </li>
       <li><a href="prosuite.factories.html#prosuite.factories.transformers.Transformers.tr_combined_filter_0">tr_combined_filter_0() (prosuite.factories.transformers.Transformers class method)</a>
 </li>
@@ -1691,6 +1711,12 @@ <h2 id="T">T</h2>
       <li><a href="prosuite.html#prosuite.data_model.TransformedDataset.transformer_descriptor">transformer_descriptor (prosuite.data_model.TransformedDataset attribute)</a>
 </li>
       <li><a href="prosuite.factories.html#prosuite.factories.transformers.Transformers">Transformers (class in prosuite.factories.transformers)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.try_get_from_oe">try_get_from_oe() (in module prosuite.utils)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.try_get_from_str_dict">try_get_from_str_dict() (in module prosuite.utils)</a>
+</li>
+      <li><a href="prosuite.html#prosuite.utils.try_get_lxml_attrib">try_get_lxml_attrib() (in module prosuite.utils)</a>
 </li>
       <li><a href="prosuite.datatypes.html#prosuite.datatypes.non_linear_segment_type.NonLinearSegmentType.type_list">type_list (prosuite.datatypes.non_linear_segment_type.NonLinearSegmentType attribute)</a>
 </li>