Difference between revisions of "OS4X plugin os4xplugin hqm sealcheck"

From OS4X
Jump to navigation Jump to search
(New page: Category:Plugins == Purpose == Check every Siemens NX file of the job if it has a valid HQM seal contained. == Configuration == The plugin can be configured with these simple paramete...)
 
 
(2 intermediate revisions by the same user not shown)
Line 8: Line 8:
 
  DAIMLER_COMMON_NX100_06_2015
 
  DAIMLER_COMMON_NX100_06_2015
 
*Verbosity: for better debugging of special situation, you may increase the verbosity level from 0 to 2.
 
*Verbosity: for better debugging of special situation, you may increase the verbosity level from 0 to 2.
*Post script: in case of failure, the configured post script is being executed before the job fails. The post script has one parameter: the job's XML file, which was given to the plugin.
+
*Post script: in case of failure, the configured post script is being executed before the job fails. The parameters of the post script are described below.
 +
*Don't abort: if any file is not OK, the job normally aborts. If this option is enabled, all files are being checked (and the post-script mentioned above is being executed).
  
 
== Requirements ==
 
== Requirements ==
 
The NX file must be check with the HQM GUI in Siemens NX interactively. After successful check, the file must be saved.
 
The NX file must be check with the HQM GUI in Siemens NX interactively. After successful check, the file must be saved.
  
== Bevahiour ==
+
== Behaviour ==
 
The plugins follows these rules:
 
The plugins follows these rules:
 
*Check if file is a valid Siemens NX file. If this is not given, skip this file.
 
*Check if file is a valid Siemens NX file. If this is not given, skip this file.
Line 22: Line 23:
 
*(optional: check the exact configuration name of the HQM environment).
 
*(optional: check the exact configuration name of the HQM environment).
 
*Verify if the HQM seal is still valid (say: no changes are made after the last check). If this is not the case, the optional post script is being executed and the job fails.
 
*Verify if the HQM seal is still valid (say: no changes are made after the last check). If this is not the case, the optional post script is being executed and the job fails.
 +
 +
== Post script parameters ==
 +
In case of failure, the post script is being executed. You are free to implement any kind of logic in this step. The return code of the executable is being ignored. The parameters are:
 +
#The job's XML.
 +
#The absolute file of the file where the error occurs.
 +
#The check return value, given as string. The following return codes are available:
 +
*HQM_RC_SEAL_NOT_OK: The HQM seal check has a value which indicates that the last check was not successful.
 +
*HQM_RC_SEAL_TOO_OLD: The HQM seal is too old. A re-check of the file must be done.
 +
*HQM_RC_SEAL_NO_SEAL: No HQM test seal is contained in the file.
 +
*HQM_RC_SEAL_WRONG_NAME: The HQM test seal was produces with a different configuration name than configured.
 +
*HQM_RC_UNKNOWN: Any other error.
  
 
== License requirements ==
 
== License requirements ==

Latest revision as of 08:31, 20 November 2015

Purpose

Check every Siemens NX file of the job if it has a valid HQM seal contained.

Configuration

The plugin can be configured with these simple parameters:

  • Test configuration name: if the test configuration name is given, this name will be explicitely searched in the NX parameters. If another test seal name is found (i.e. when using a different than expected environment), the plugin will fail. Beware that the given configuration name is case-sensitive. Example:
DAIMLER_COMMON_NX100_06_2015
  • Verbosity: for better debugging of special situation, you may increase the verbosity level from 0 to 2.
  • Post script: in case of failure, the configured post script is being executed before the job fails. The parameters of the post script are described below.
  • Don't abort: if any file is not OK, the job normally aborts. If this option is enabled, all files are being checked (and the post-script mentioned above is being executed).

Requirements

The NX file must be check with the HQM GUI in Siemens NX interactively. After successful check, the file must be saved.

Behaviour

The plugins follows these rules:

  • Check if file is a valid Siemens NX file. If this is not given, skip this file.
  • Check if the file is an assembly. If this is the case, skip the file.
  • Check if the NX file is marked as "non release relevant", (namely model type: "NON_RELEASE_REL") skip this file.
  • Check the NX properties if a valid HQM seal check is contained in the NX file. If the properties don't exist, the optional post script is being executed and the job fails.
  • Verify if the seal check has a valid result. In case of non-OK results, the optional post script is being executed and the job fails.
  • (optional: check the exact configuration name of the HQM environment).
  • Verify if the HQM seal is still valid (say: no changes are made after the last check). If this is not the case, the optional post script is being executed and the job fails.

Post script parameters

In case of failure, the post script is being executed. You are free to implement any kind of logic in this step. The return code of the executable is being ignored. The parameters are:

  1. The job's XML.
  2. The absolute file of the file where the error occurs.
  3. The check return value, given as string. The following return codes are available:
  • HQM_RC_SEAL_NOT_OK: The HQM seal check has a value which indicates that the last check was not successful.
  • HQM_RC_SEAL_TOO_OLD: The HQM seal is too old. A re-check of the file must be done.
  • HQM_RC_SEAL_NO_SEAL: No HQM test seal is contained in the file.
  • HQM_RC_SEAL_WRONG_NAME: The HQM test seal was produces with a different configuration name than configured.
  • HQM_RC_UNKNOWN: Any other error.

License requirements

The plugin requires OS4X Enterprise as software license.

  • No HQM Batch license required.
  • No HQM GUI license is required.
  • No Siemens NX license is required.