IntegrityDocs
Creates a set of HTML pages documenting the PTC Integrity Lifecycle Manager configuration.
Version
12.2: Created for Integrity 10.9/11.x/12.x and with full support of latest Firefox / Chrome / IE
Purpose
IntegrityDocs exports the current Integrity Server configuration from W&D, and creates HTML pages. Each section under Workflows&Documents will become one node within the report tree. Each section starts with an "Overview" page, and then each element can be reviewed in more detail by drilling down.
Use Cases
Document the current Integrity LM configuration status
Validate and compare the Integrity LM configuration status
Present the Integrity LM configuration status without the need to have direct Integrity access
Install
In IntegrityClient folder
Put the "IntegrityDocs.jar" into your <IntegrityClient>/lib folder
Put the "IntegrityDocs.bat" directly into your <IntegrityClient> folder
Check and update the IntegrityDocs.bat file with the correct Integrity Client installation location, for example:
SET IC_HOME=C:\Program Files\ILMClient11
In case of any performance issue based on too many data in Integrity, you can also disable certain object types from beeing scanned, such as
--noIMProjects: disable Workflows & Documents Main Projects scan and output
--noSIProjects: disable Config Management Main Projects scan and output
--noTypes: disable Types scan and output
--noQueries: disable Queries scan and output
--noTriggers: disable Triggers scan and output
--noCharts: disable Charts scan and output
--noViewsets: disable Viewsets scan and output
--noGroups: disable Groups scan and output
--noDynGroups: disable DynGroups scan and output
--noStates: disable States scan and output
--noReports: disable Reports scan and output
--noFields: disable Fields scan and output
--noTestVerdicts: disable TestVerdict scan and output
--noTestResultFields: disable TestResultFields scan and output
You can add these parameters to the bat command itself or put them directly into IntegrityDocs.bat,
... ityDocs.jar" com.ptc.services.utilities.docgen.IntegrityDocs --noFields --noGroups
It's also possible to generate the output just for one or specific types, then the command will look like this
... ityDocs.jar" com.ptc.services.utilities.docgen.IntegrityDocs Defect Project
How to run
execute the IntegrityDocs.bat in your IntegrityClient folder
connect to the Integrity environment you like to scan
then review the outcome
Version Info
11.0.0: Added 12 additional object types to the existing Types and Triggers, complete code review
11.0.1: You can sort the Overview tables by clicking at the light green headings
11.0.2: Added Main Project for W&D
11.0.2: Reports now previewable and downloadable
11.0.3: Edit-In-Word Templates download now possible (links provided in the Type form)
11.0.3: Added Main Project for CM
12.1: Minor compatibility changes only
12.2: Minor Compatibility changes only
Development Environment
PTC Integrity LM 11.0 to 12.2 (also 10.9 is still fine)
Netbeans 8
Java 1.8
Known Limitations
the search does not work yet
none of the SI or MKS Domain object is exported (primarily because of the expected high data volume)
the "deploy" reporting is no more supported since 10.5 or so
Related Tools
Integrity-LM-Administration-Configuration-Reports
View full tip
