LinkBuildToDocs
The LinkBuildToDocs command associates a software build object with a document. An iteration bump is created for the software build object. The objects associated in the document are obtained by querying the software build.
Command-Line Syntax
java —jar RBMWebServiceCore.jar —ServiceName LinkBuildToDocs —ContainerType —ContainerName —BuildObjectName —BuildObjectLocation —DocumentType —DocumentName —DocumentLocation [—DocContainerType] [—DocContainerName] [-Revision]
Argument
Description
—ContainerType
One of LIBRARY, PRODUCT, or a PROJECT.
—ContainerName
Name of the container.
—BuildObjectName
Name of the software build object.
—BuildObjectLocation
Location of the software build object in the specified container.
—DocumentType
One of SWDocument, SWBuild, or SWConfdata.
—DocumentName
Name of the document.
—DocumentLocation
Location of the software document or the software configuration data objects in the specified container.
—DocumentContainerType
One of LIBRARY, PRODUCT, or a PROJECT. If you do not specify the container type of the document, the container type of the software build object is used.
—DocumentContainerName
Name of the container. If you do not specify the container type of the document, the container type of the software build object is used.
—Revision
Build revision ID. If no revision is specified, the latest iteration is used.
Configuration File Template
<service>
<ServiceName>LinkBuildToDocs</ServiceName>
<ContainerType>...</ContainerType>
<ContainerName>...</ContainerName>
<BuildObjectName>...</BuildObjectName>
<BuildObjectLocation>...</BuildObjectLocation>
<DocumentType>...</DocumentType>
<DocumentName>...</DocumentName>
<DocumentLocation>...</DocumentLocation>
<DocContainerType>...</DocContainerType>
<DocContainerName>...</DocContainerName>
<Revision>...</Revision>
</service>
Examples
To associate a software document at Test Folder with a software build object of build revision A at Test Folder in GOLF_CART container of a product, type:
java —jar RBMWebServiceCore.jar —ServiceName LinkBuildToDocs —ContainerType PRODUCT —ContainerName GOLF_CART —BuildObjectName TestSWBld3 —BuildObjectLocation Test Folder —DocumentType SWDocument —DocumentName TestSWDoc1 —DocumentLocation Test Folder —Revision A
* 
On command completion, the version of TestSWBld3 is incremented.
To associate a software document at Test Folder in TestLibrary container of a library with a software build object at Test Folder in the TestLibrary container of a library, type:
java —jar RBMWebServiceCore.jar —ServiceName LinkBuildToDocs —ContainerType PRODUCT —ContainerName GOLF_CART —BuildObjectName TestSWBld3 —BuildObjectLocation Test Folder —DocumentType SWDocument —DocumentName TestSWDoc1 —DocumentLocation Test Folder —DocContainerType LIBRARY —DocContainerName TestLibrary
Was this helpful?