Continuous Integration

XStudio client comes with a tool called XContinuousIntegration.
  • On Windows platforms, you can find it in the bin folder. The executable is named xcontinuousintegration.exe
  • On MacOSX and linux platforms, the executable is named xcontinuousintegration (without extension)

Goal

XContinuousIntegration is aimed at being called by automatic build machines. Once a build has been run successfully, the build server can automatically trigger the creation and the start of a campaign session in XStudio. This way, after you overnight build has completed you can automatically run your automated test suites without having to attend.

This is even more convenient when we speak about continuous integration. In this case, each time a commit will occur on the versioning system, a build will be generated and the tests executed.

Usage

To Trigger the creation and the execution of a campaign session, the build server will just have to call the XContinuousIntegration with the appropriate arguments which are... 

Usage: xcontinuousintegration.exe --campaignId <campaignId>
                                  --agents <agentId>:<nbInstances>:<sync>,...
                                  --sutId <sutId>
                                  --configurations <categoryId>:<configurationId>,...
								  
Options:
	--sessionName       <sessionName>
	--operatorId        <userId>
	--ccEmailUserIds    <userId>,...
	--monitoringAgentId <agentId>
	--monitoringConfId  <monitoringConfId>
	--ifParentFailed    <action>
	--ifParentUnknown   <action>
	--outputFormat      <outputFormat>

Where:
	<sync> can take the following values: 0=None,
                                              1=Synchronization on tests,
                                              2=Synchronization on test cases,
                                              3=In a row
												
	<action> can take the following values: 'EXECUTE', 
                                                'SET_AS_FAILED'
                                                'DO_NOT_EXECUTE'
																								
	<outputformat> can take the following values: 'NONE', 
                                                      'BAMBOO'

Integration with third-party systems

XStudio can be integrated in ANY continuous integration environment as it just consists in executing a simple command after a build is completed.
However, the continuous integration system may even better integrate with XStudio if it can retrieve the results.





Bamboo can parse any test output that conforms to the standard JUnit XML format. You have just to specify the option --outputformat BAMBOO in the command line and a JUnit XML report will be additionally generated so that Bamboo can parse it and retrieve the results.

You can refer to Atlassion's tutorial on how to configure an external command in Bamboo.

Atlassian also have a page describing the JUnit XML format if you're interested.