Integration with Tricentis Tosca

Overview

Specific TBox Modules for TDO are available to allow interaction from within a Tosca Test Case to the Test Data Orchestrator

Release Notes

Requirements

Tricentis Tosca Commander 14.2 and above

Installation

Please order the TDO Addon DLL (Infometis.TestDataOrchestrator.dll) form our Service Desk, we require the Tosca Version you are using. The Tosca Subset can be downloaded here:

Copy the Infometis.TestDataOrchestrator.dll into the TBOX_HOME Folder, which is usually: C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\TBox\

Import the Subset into your Tosca workspace.

TDO Module for Items

This module allows the following operations for TDO Items:

CreateItem, UpdateItem, Find, LockItem, UnlockItem, DeleteItem

Description of the Module attributes

Attribute name	Description	Details
Configuration → JiraBaseURL	The BaseUrl of the Jira-Server
Configuration → JiraProjectKey	The Key of the Jira project
Configuration → Username	Jira Username
Configuration → Password	Jira Password
Item Key	Internal Key of an item
Task	Defines what operation the teststep should perform for an Item	CreateItem, UpdateItem, Find, LockItem, UnlockItem, DeleteItem
Environment	Environment in which the Item Task is performed
Type	Type in which the Item Task is performend
Data structure → attributes	Expandable list of attributes. Used for Find and UpdateItem Task.
Result Buffers → attributes	Expandable list of attributes, used for Find Task. The attribute name represents the name of the buffer which should be filled with the found item value. the attribute value represents the TDO attribute name from which to get the value for the buffer.

Operations for Items

Create an Item

CreateItem

The following Teststepvalues need to be filled. The teststep will create a buffer called TDO_ITEM_KEY. This contains the internal key for further use in UpdateItem or DeleteItem teststeps

Attribute name	Input Value	Example
Configuration → JiraBaseURL	The BaseUrl of the Jira-Server	https://yourcompany.atlassian.net
Configuration → JiraProjectKey	The Key of the Jira project	ABC
Configuration → Username	Jira Username	user1
Configuration → Password	Jira Password	yourpassword
Item Key	N/A
Task	CreateItem	CreateItem
Environment	Environment in which the Item Task is performed	UAT
Type	Type in which the Item Task is performend	Addresses
Data structure → attributes	for each attribute: attribute name = TDO Type attribute attribute value = value of the Item attribute
Result Buffers → attributes	N/A

Here is an example of a TDO Item Expert Module Teststep:

Updates an Item

UpdateItem

The following Teststepvalues need to be filled:

Attribute name	Input Value	Example
Configuration → JiraBaseURL	The BaseUrl of the Jira-Server	https://yourcompany.atlassian.net
Configuration → JiraProjectKey	The Key of the Jira project	ABC
Configuration → Username	Jira Username	user1
Configuration → Password	Jira Password	yourpassword
Item Key	The internal key of the item you would like to update. This value was automatically put into the buffer TDO_ITEM_KEY when using the TDO CreateItem or FindItem task	{B[TDO_ITEM_KEY]}
Task	UpdateItem	UpdateItem
Environment	Environment in which the Item Task is performed	UAT
Type	Type in which the Item Task is performend	Addresses
Data structure → attributes	for each attribute: attribute name = TDO Type attribute attribute value = value of the Item attribute
Result Buffers → attributes	N/A

Find Items

Find

Attribute name	Input Value	Example
Configuration → JiraBaseURL	The BaseUrl of the Jira-Server	https://yourcompany.atlassian.net
Configuration → JiraProjectKey	The Key of the Jira project	ABC
Configuration → Username	Jira Username	user1
Configuration → Password	Jira Password	yourpassword
Item Key	N/A
Task	FindItem	FindItem
Environment	Environment in which the Item Task is performed	UAT
Type	Type in which the Item Task is performend	BusinessPartner
Data structure → attributes	for each attribute: attribute name = TDO Type attribute you would like to search in attribute value = value of the Item attribute you would like to search for	attribute name = Type attribute value = legal (see screenshot below)
Result Buffers → attributes	the attribute name needs to be set to the name of the buffer the attribute value needs to be set to the name of the TDO value you would like	Name = TDO_Test Value = Key (see screenshot below)

Lock an Item

LockItem

Attribute name	Input Value	Example
Configuration → JiraBaseURL	The BaseUrl of the Jira-Server	https://yourcompany.atlassian.net
Configuration → JiraProjectKey	The Key of the Jira project	ABC
Configuration → Username	Jira Username	user1
Configuration → Password	Jira Password	yourpassword
Item Key	item key of the item you would like to lock	{B[TDO_ITEM_KEY]}
Task	FindItem	CreateItem
Environment	Environment in which the Item Task is performed	UAT
Type	Type in which the Item Task is performend	BusinessPartner
Data structure → attributes	for each attribute: attribute name = TDO Type attribute you would like to search in attribute value = value of the Item attribute you would like to search for	attribute name = Type attribute value = legal (see screenshot below)
Result Buffers → attributes	the attribute name needs to be set to the name of the buffer the attribute value needs to be set to the name of the TDO value you would like	Name = TDO_Test Value = Key (see screenshot below)

Unlock Item

UnlockItem

Delete Item

DeleteItem