Write Statistics and Log Error Records - EcoSys - 3.1 - Help - Hexagon

EcoSys Connect Help

Language
English
Product
EcoSys
Search by Category
Help
EcoSys Version
3.1

EcoSys Connect shows the number of records that succeeded or failed during a write operation. For SOAP Processors and SOAP Writers,

  1. In the Statistics section, you can define the following parameters:

    • Status Root Path – The path to read status information from the SOAP response

    • Status Success Condition – Defines the attribute in the SOAP response that contains the success condition. For EcoSys create/update operation, the condition would be getAttribute("successFlag")

    • Status Failure Condition – Defines the attribute in the SOAP response that contains the failure condition. For EcoSys create/update operations, the condition would be !getAttribute ("successFlag")

    • Statistics Enabled? – Turns on/off the collections of write statistics.

      Viewing the statistics and failure messages applies to SOAP Processors and SOAP Writers.

    • AggregateStatsSuccessAttributeName - Attribute name in the status response entity (relative to StatusRootPath ) containing total count of successfully processed entities

    • AggregateStatsFailureAttributeName - Attribute name in the status response entity (relative to StatusRootPath) containing total count of failed entities

    • StatusFailureEntityIdAttrributeName - Attribute name in the response status entity (relative to StatusRootPath) which contains ID of the failed entity.

      (Optional) If specified, it will be reported in the log.

    • StatusFailureEntityMessageAttributeName - Attribute name in the response status entity (relative to StatusRootPath) which contains error messages for the failed entity.

      (Optional) If specified, will be reported in the log.

      For Ecosys create/update operation, it is recommended to use a new attribute resultMessageString.

      Error logging is enabled only if either ID Attribute Name or Message Attribute Name above is not empty. In this case, StatusFailureCondition must not be empty (will be validated).

The following rules applies to the configuration to make sure it is consistent (when it is enabled):

  • You cannot have both Condition and AggregateAttributeName for the same outcome (failure/sucess).

  • You must define at least one Success or Failure condition for EcoSys to use stats.

For OData and OData Action, Statics is enabled by checkbox (no parameters needed).

Statistics can also be viewed in the Job Execution History screen.

For SQL Processor and Writer from Connect 2.0 supports Statistics for writing type queries. To enable statistics, check the option Statistics Enabled?.

 

Failed records

Using the write operation, you can view the detailed error of records that failed to be created in EcoSys in Job Execution History

Click Export Log History to export the log to excel.