Check of Consistency Between Archive File and HELiOS Article

Plant Engineering > Part Data Tools > Part data synchronisation

PartDataAutosync.exe / DBPlantDataImport

In both PartDataAustoSync and DBPlantDataImport you can now get an overview of how the sub-types of an archive file (i.e. VAA or PAA) are displayed as linked articles in HELiOS.

For a concrete variant, there is usually a linkage structure that looks something like this:

 

So in the VAA file several sub-types are defined, which are identified by an article type, which in turn is mapped in HELiOS to the attribute HEL_TYPNAME.

When the VAA file is transferred to HELiOS, the following are created:

These articles together with the general type form the main section and are connected to each other by links. The articles are characterised by the fact that identifiers are stored for them, which can be found again in the VAA file. These are the Plant IDs.

In addition, further sub-sections may have been created with the HELiOS function Derive variant .. These are also linked to the document master, but have no unique identifiers. Instead, these items can be assigned to the sub-types via the item type.

To get an overview of the current state of this linkage structure before matching a variant, use the function Consistency check File <-> HELiOS. This function is available in the part data sync in the context menu of the file selection.

 

After executing the function, the file compare_file_to_HELiOS_protocol.txt. can be found in the HiCAD Temp directory. In addition, the Notepad opens automatic and displays the contents of the file. The content looks something like this:

09.01.2023 09:14:12:

File: A2RF1_100.vaa

 

General type: HELIOS:\\B00A137W6LK2UT00008TXJ_0

Status: Sub-section derived via HELiOS

Article types of sub-types for which no article exists:

300

Articles without article type: none

Articles with article type that does not exist in the archive:

HELIOS:\\B00A137W6LK2UT00008TXK_0

HELIOS:\\B00A137W6LK2UT00008TXN_0

Articles that could not be accessed: none

 

General type: HELIOS:\\B00A137W6LK2UT00008TXX_0

Status: Sub-section derived via HELiOS

Article types of sub-types for which no article exists:

300

Articles without article type:

HELIOS:\\B00A137W6LK2UT00003NR8_0

Articles with article type that does not exist in the archive:

HELIOS:\\B00A137W6LK2UT00008TXY_0

HELIOS:\\B00A137W6LK2UT00008TY1_0

Articles that could not be accessed: none

 

General type: HELIOS:\\B00DH4XULBEB5J000004FY_0

Status: Error: Main section with additional articles

Article types of sub-types for which no article exists:

300

Articles without article type: none

Articles with article type that does not exist in the archive:

HELIOS:\\B00DH4XULBEB5J000004G0_0

HELIOS:\\B00DH4XULBEB5J000004G3_0

Articles that could not be accessed: none

 

At the top of the file, the date and time of the check is shown, followed by the VAA file that was checked. Then follows one paragraph for each derived section. So in the above example there are three derivation sections. For each section, the article of the general type is first output as a HELiOS link. This is followed by the status of the section, i.e. main or sub-section.

Next, it is listed whether there are deviations from the ideal state in this section, such as:

 

During part data sync, it can happen that the main section is no longer available in the database, usually because articles were accidentally deleted. As of HiCAD 2023 SP2 (V 2802.0), the part data sync restores the main section if it was not found.

 

Please note:

The function Consistency check File <-> HELiOS also checks whether "orphaned" article masters exist for the IDs stored in a VAA and reports this::

23.02.2023 11:08:11:

File: QS-Rohr.vaa

Articles outside the link structure:

HELIOS:\\B00XIKCF0R3DD00000416M_0

HELIOS:\\B00XIKCF0R3DD00000416N_0

HELIOS:\\B00XIKCF0R3DD00000416O_0

HELIOS:\\B00XIKCF0R3DD00000416P_0

No articles linked to the document found

If you perform the part data sync in such a situation, the links for the main section are repaired, the consistency check reports afterwards:

23.02.2023 11:09:37:

File: QS-Rohr.vaa

Articles outside the link structure: none

General type: HELIOS:\\B00XIKCF0R3DD0000042BB_0

Status: Main section

Article types of sub-types for which no article exists: none

Articles without article type: keine

Articles with article type that does not exist in the archive: none

Articles that could not be accessed: none

Important: This kind of repair is only possible for the main section. The sub-sections are created purely on the HEL side and have no IDs that relate the items to the VAA.

Part Data Tools (PE)Plant Engineering FunctionsHELiOS