Attach Documents
Some assets include file-related attributes that allow you to attach supporting document(s) such as programming guides, sample code and script files with the asset. When trying to attach a supporting document with an asset, CentraSite Control displays the available documents underneath their respective organization directory by default. If you want to change this (that is, simply display the documents by the side of its organization directory), you can do so by extending the CentraSite Control functionality via the extension point attachDocumentCommand.
To customize the document layout:
1. Locate the configuration file plugin.xml in the <RuntimeDir>\workspace\webapps\PluggableUI\CentraSiteControl directory.
2. Open the file and locate the entry:
<extension point="com.softwareag.cis.plugin.parameter"
id="isCustomAttachDocument" value="false" />
<extension point="com.centrasite.control.attachDocumentCommand"
id="AttachDocumentCustomCommand"
class="com.centrasite.control.extpt.AttachDocumentCustomCommand"
/>
Where com.centrasite.control.extpt.AttachDocumentCustomCommand is the name of the abstract base class that implements the interface.
3. To define your custom document layout, change false to true and restart Software AG Runtime. Similarly, if the document layout is already customized and you want to revert back to the standard layout, set the value to false and restart Software AG Runtime.
Usage | Use this to define a custom layout of the documents while attaching to an asset via the Attach Document dialog. |
Attributes |  com.centrasite.control.attachDocumentCommand id (default: name of implementing class) class |
Interface | See the sample code. |
Abstract base class | AbstractExtensionCommand |
Processing | When you click the appropriate button, this invokes the user-defined Adapter (layout) screen displaying all documents that are available for attaching to an asset. Create an instance of the class Execute |
Provided by | CentraSite Control |
Example | <extension
point="com.centrasite.control.attachDocumentCommand"
id="AttachDocumentCustomCommand"
class="com.centrasite.control.extpt.AttachDocumentCu
stomCommand" /> |
You can find sample code for defining the extension point in the files AttachDocumentCustomCommand.java, AttachFile.xml and AttachFileAdapter.java that are provided in the demo folder under the CentraSite installation folder.
