Develop > CSA Content SDK > Build Your First Capsule > Understanding Automatic Document Generation Feature

Automatic Document Generation Feature

As part of the Capsule Packager of Content utilities, Automatic Document Generation feature is now provided for generating a brief document about each Content Capsule. This utility provides you with details about your chosen capsule before its installation. The packager tool uses content-as-a-source to generate a file name usecaseInfo.xml, as mentioned in Create Capsule Definition File and uses the tags defined in this file to create a PDF document for your reference.

You can also customize this document by editing the XSLT file (Style sheet for XML Document). Before you begin to customize the document to suit your preference, you must know the following:

  • Find the CsaCapsule.xsl and whiteLabel.xsl (without HPE branding) files available under /xsd directory of the Content SDK.
  • Provide the complete path to the XSLT file within the <xsltFilePath></xsltFilePath> tag of capsule.xml file. For more information on XML file, see Capsule File Example from Create Capsule Definition File.
  • Two types of editable XSLT files are provided:
    1. XSLT file with HPE Template: This template can be used, if you wish to generate a document having HPE branding elements like logo and border. Locate the logo.png file available under /xsd directory of the Content SDK, and then provide the path to the logo image as mentioned in the capsule.xml file. See, Create Capsule Definition File.
    2. XSLT file without HPE Template (White-labeled): This template can be used, if you wish to generate a document without having HPE branding elements like logo and border or to generate a document having your own logo.
    3. Note: For generating a document using your own logo, keep the size of the logo image to 200*82 px (pixels) and provide its correct path as mentioned in the capsule.xml file described in the previous section.

  • By default, the generated document is placed inside the Capsule ZIP file as part of Packager.
  • The auto generated document can be seen either by unzipping the Capsule file or by entering the following commands at the command prompt using Installer jar file.
  •  java -jar "InstallerjarName" "capsule_name.zip" " -d"

    or

    java -jar "InstallerjarName" "capsule_name.zip" " -doc"