HE04874: CATIA CAA API CATXPDMFILESERVICES::GETCONSISTENTSETOFITEMS() FAI LS TO RETURN THE DRAWING'S POINTED LINKS AFTER SETTING PDM PROPE

APAR status

• Closed as Permanent restriction.

Error description

• SCENARIO:-
  1.Build the given workspace.
  2.Launch the CATIA.
  3.Open the given  XPDM_TEST_DWG1.CATDrawing in CATIA
  4.Click on ???Set PDM Properties??? button ,Select
  ???XPDM_TEST_DWG1.CATDrawing??? document and select ???ENOVIA5??
  ? in
  the ???destination PDM??? list and select storage mode as
  ???Publications Exposed??? and then click on ???OK??? button.
  5.Go to Tools->Macro->Macros.
  6.Open the attached CATVBA file. Modify the CATVBA file as
  per the path of Drawing.
  7.Click on ???View->Immediate?????? in Visual basic editor. This
  
  will cause the immediate window to appear on the screen.
  8.Click on ???Tools->References ->Browse?????? button and Browse
  
  for the ???FWxPDMAutomationTypeLib.tlb??? library in
  ???\WSxPDMAPIFailuresCR2\intel_a\code\bin??? directory
  9.Make sure that ???CATIA V5 FWxPDMAutomationInterfaces Object
  Library??? is there in your ???Available References??? window.
  10.Execute the macro by clicking on ???Run->Run Sub/UserForm???.
  
  .
  PROBLEM:-
   ???Error: Failed to get GetConsistentSetOfItems
  .
  EXPECTED RESULT:-
  User is using CATxPDMFileServices::GetConsistentSetOfItems()
  API to get the linked documents given the drawing document.
  So this API should given the list of pointed documents i.e.
  Printing pointed documents info...
  Pointed Documents: [0]:
  C:\Temp\TestParts\XPDM_TEST_DWG1.CATDrawing
  Pointed Documents: [1]:
  C:\Temp\TestParts\XPDM_TEST_PART1.CATPart
  If you Click on CATIA ???File->Desk??? command ,CATIA shows that
  
  ???C:\Temp\TestParts\XPDM_TEST_DWG1.CATDrawing??? is linked to
  ???C:\Temp\TestPartsENOVIA5\XPDM_TEST_PART1.CATPart???.
  

Local fix

• empty
  

Problem summary

• SCENARIO:-
  1.Build the given workspace.
  2.Launch the CATIA.
  3.Open the given  XPDM_TEST_DWG1.CATDrawing in CATIA
  4.Click on ???Set PDM Properties??? button ,Select
  ???XPDM_TEST_DWG1.CATDrawing??? document and select ???ENOVIA5??
  ? in
  the ???destination PDM??? list and select storage mode as
  ???Publications Exposed??? and then click on ???OK??? button.
  5.Go to Tools->Macro->Macros.
  6.Open the attached CATVBA file. Modify the CATVBA file as
  per the path of Drawing.
  7.Click on ???View->Immediate?????? in Visual basic editor. This
  
  will cause the immediate window to appear on the screen.
  8.Click on ???Tools->References ->Browse?????? button and Browse
  
  for the ???FWxPDMAutomationTypeLib.tlb??? library in
  ???\WSxPDMAPIFailuresCR2\intel_a\code\bin??? directory
  9.Make sure that ???CATIA V5 FWxPDMAutomationInterfaces Object
  Library??? is there in your ???Available References??? window.
  10.Execute the macro by clicking on ???Run->Run Sub/UserForm???.
  
  .
  PROBLEM:-
   ???Error: Failed to get GetConsistentSetOfItems
  .
  EXPECTED RESULT:-
  User is using CATxPDMFileServices::GetConsistentSetOfItems()
  API to get the linked documents given the drawing document.
  So this API should given the list of pointed documents i.e.
  Printing pointed documents info...
  Pointed Documents: [0]:
  C:\Temp\TestParts\XPDM_TEST_DWG1.CATDrawing
  Pointed Documents: [1]:
  C:\Temp\TestParts\XPDM_TEST_PART1.CATPart
  If you Click on CATIA ???File->Desk??? command ,CATIA shows that
  
  ???C:\Temp\TestParts\XPDM_TEST_DWG1.CATDrawing??? is linked to
  ???C:\Temp\TestPartsENOVIA5\XPDM_TEST_PART1.CATPart???.
  

Problem conclusion

• THIS PROBLEM IS PERMANENT RESTRICTION IN CATIA
  Additional Closure Information:
  Incident Diagnosis:
  Customer is not able to use the CATxPDMFileServices on ENOVIA
  data.
  Reason:
  The CATxPDMFileServices works only for FILE data. This is
  clearly explained in the CAA
  encyclopedia.Many references, definitions are based on FILE
  concepts in the CAA article related
  to the API. A API documentation is done to explain the
  purpose of the API not to explain what it doesn't support.
  There will be no plan, no action in order to make this APIs
  working on ENOVIA data or any PDM data.
  The customer has to adapt its code and apply the follwing
  by-pass methodology.
  By-Pass:
  To consistently extract CATIA V5 data from ENOVIA, you have
  to use a dedicated API.
  Any other solution could lead to data inconsistency or link
  corruption.
  The API to use is: ExtractDocumentSetToFileDirectory .It
  extract a document from the vault with a its
  consistent set of pointed data which are automatically
  rerouted. Of course these kind of API can works only on
  ENOVIA vaulted data (publication exposed data). The CAA
  documentation is there:
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels