Integration With Lifecycle Tools
provides a consistent integration with several lifecycle tools.
Agile Requirements Designerprovides a consistent integration with several lifecycle tools.
- Integrate With Blueprint StoryTellerNote:Blueprint StoryTeller integration is a Beta feature that enables you to import Processes and User Stories from StoryTeller intoAgile Requirements Designer. Export fromAgile Requirements Designerto StoryTeller is not supported.
The lifecycle tool integration offers the following capabilities:
Connect to a Lifecycle Tool
Each lifecycle tool in
Agile Requirements Designerhas its own connector option.
- Go toToolbox, Connectors,tool name.
- Enter the instance URL and your username and password.You can now browse content and run queries.Note:The integration only displays projects that you have configured.
You can customize default view settings and default behaviors for each lifecycle tool. Go to
to open the configuration dialog.
Configure Lifecycle Tool Projects
Configure the lifecycle integration before exporting or importing. Otherwise, the following error message appears:
It appears you have no correctly configured projects. Only correctly configured projects will be made visible.
Set up Configurationin the error message to directly open the "
General Configuration" Dialog to configure your entities.
To learn more about configuring projects, see Configure Lifecycle Tool Integration.
Import From a Lifecycle Tool to
Agile Requirements Designer
After you have configured the project, you use the Rich Text Importer to import test cases from lifecycle tools. Before you import test cases, format the descriptions in the lifecycle tool so that the rich text importer can parse them easily into blocks. The best practice is to have each test case step on a separate line. Each line then becomes a block in the
Agile Requirements Designerflow. You can fine-tune the formatting of the imported text directly in the Rich Text Importer dialog while importing. For more information, see Import Rich Text.
It is possible to map a work item to more than one level in
Agile Requirements Designer. For example, a TFS User Story can be mapped to Block and Flow. These work items are ambiguous and need to handled during import.
Follow these steps:
- Create a flow inAgile Requirements Designer.
- Go toToolbox, Connectors,, and enter the instance URL and your username and password.tool name
- Drag an object from the tree in the Connectors dock, and drop it on to the canvas. Dragging multiple selected objects is not supported.
- (If you import an ambiguous work item)Agile Requirements Designerprompts you to specify the import type. Click one of the import types:Block,Path, orFlow.
- Review how the Rich Text Importer parsed the description of the Parsed Blocks.If you are not happy with the result, reformat the imported text, or manually adjust blocks using theMerge Selectedbutton.
- If prompted, clickYesif you want to attach start and end blocks.
- If prompted, clickUpdateto re-layout the imported flow to make it better readable.The work items are imported.(For TFS, CA Agile Central (except folders), and JIRA only)Agile Requirements Designercreates an application link for imported Paths on the Path level. For imported Blocks, it creates an application link under the Block properties.
- (Optionally) Repeat and import more paths.
- Connect the imported blocks manually where needed, and define outputs to create a working flow.
Agile Requirements Designerto a Lifecycle Tool
After you have configured the project, you can use export items from
Agile Requirements Designerto a target place on the lifecycle tool's server side. The type of exported object depends on the target tool. The object types are Block, Path, and Flow.
Export is not supported for Blueprint StoryTeller.
Choose one of the following export options:
- If the integration you are using can export paths, choose the Export Path option from "Path Explorer".
- Define and save your paths.
- In the Toolbox Dock, clickConnectorsand select the lifecycle tool.
- In the Connectors Dock, provide your credentials to log in to the tool server.
- In thePath Explorer, go to theViewtab and click theExport Pathsicon. Select your lifecycle tool from the drop-down list.
- Select the target project and location to which you want to export the user stories and clickOK.
- Select the user stories that you want to export and the targetEntity Type. For example, "Issue: Test Case".
- In the dialog that appears, name the new user story, and clickOK.Agile Requirements Designervalidates your input.
- The user story is exported fromAgile Requirements Designerand imported to the lifecycle tool.
- If the integration you are using can export "Paths" or "Blocks", you can also choose the export buttons from the Connector panel.
- Open the Connector panel and log in to the lifecycle tool.
- Click the first button to export a Flow, and the second button to export a Block.Tip: Hover over a button to see a tooltip.
Not all integrations offer all export options. The drop-down options to select an
Entity Typeonly show correctly configured entity types for the
Agile Requirements Designerobject type that you are exporting. For example, if you export the object type "Paths" from within
Path Explorer, you only see entity types that you have previously correctly mapped as Paths.
Define Optional Export Options
You have several extra options in the dialog when exporting.
- Attached Images – Constructs and attaches images which are attached to the block itself.
- Path Image – Constructs and attaches the image of the test case in the flow.
- Expand SubFlow – If the Stored Path has subflows, it uses every block from the subflows.
- Include SubFlow – If a stored path has subflows, it does not use blocks from the subflow. The test case represents each subflow as a single step.
- Test Data – Constructs and attaches a CSV file of test data for this path. This export includes default test data variables. These variables are defined in the flow (and its subflows) properties but do not occur in the path being exported. The file name is truncated to 70 characters and has a_TestData.csvsuffix.Tip: To find the variables in flow properties, clickManage, Properties, Variables.
- Exclude Default Test Data Variables – Excludes default test data variables for the path being exported.
- Attach Automation – Constructs and attaches an automation script for a given layer.
- Flow Image – Constructs and attaches an image of the flow.
Define Default Export Options
For each possible export option (except attaching automation scripts), you can define defaults.
- OpenConfiguration, Connectors Options.
- Enable defaults available for the respective lifecycle tool.Example: If you always want to attach an image when exporting to JIRA, enable "Default Export Image".
- Default Export Include SubFlow
- Default Export Expand SubFlow
- Default Export Image
- Default Export Attached Images
- Default Export Test Data
- Default Export Test Scripts
- Default Block Export Type
- Default Path Export Type
- Default Flow Export Type
- Click Save.