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 TDO Item Expert 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	LockItem	LockItem
Environment	Environment in which the Item Task is performed	UAT
Type	Type in which the Item Task is performend	BusinessPartner
Data structure → attributes	N/A
Result Buffers → attributes	N/A

Unlock Item

UnlockItem

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 unlock	{B[TDO_ITEM_KEY]}
Task	LockItem	UnlockItem
Environment	Environment in which the Item Task is performed	UAT
Type	Type in which the Item Task is performend	BusinessPartner
Data structure → attributes	N/A
Result Buffers → attributes	N/A

Delete Item

DeleteItem

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 delete	{B[TDO_ITEM_KEY]}
Task	DeleteItem	DeleteItem
Environment	Environment in which the Item Task is performed	UAT
Type	Type in which the Item Task is performend	BusinessPartner
Data structure → attributes	N/A
Result Buffers → attributes	N/A

TDO Module for Environments

This module allows the following operations for TDO Environments:

Create, Update, Delete

Description of the TDO Environment Expert Module attributes

Attribute name	Description	Details
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
Task	Defines what operation the teststep should perform for an environment	Create, Update, Delete
Environment	Name of the Environment to be created	UAT
Environment Update	Upddated Name of the Environment
Description	Description of the Environment

Operations for Environments

Create Environmenet

Create

Attribute name	Description	Details
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
Task	Create	Create
Environment	Environment in which the Item Task is performed	APIEnvironment
Environment Update	N/A
Description	Description of the environment	Text about the environment

Update Environment

Update

Attribute name	Description	Details
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
Task	Update	Update
Environment	Environment in which the Item Task is performed	APIEnvironment
Environment Update	New name of the environment	API
Description	Description of the environment	Text about the environment

Delete Environment

Delete

Attribute name	Description	Details
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
Task	Delete	Delete
Environment	Environment in which the Item Task is performed	APIEnvironment
Environment Update	N/A
Description	N/A

TDO Module for Types

This module allows the following operations for TDO Types:

Create, Update, Delete

Description of the TDO Type Expert 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
Task	Defines what operation the teststep should perform for an environment	Create, Update, Delete
Type	Name of the Environment to be created
Type Update	Updated Name of the Type. Needed when you update the name of the Type
Attributes	List of attributes of the Type.

Operations for Types

Create Type

Create

Attribute name	Description	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
Task	Create	Create
Type	Name of the Type to be created	APIEnvironment
Type Update	N/A
Attributes	list of attributes to be created under thie type.	Name = Key Name= Status

Update Type

Update

Attribute name	Description	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
Task	Update	Create
Type	Name of the Type to be created	APIEnvironment
Type Update	Updated Name of the Type	API
Attributes	list of attributes to be created under thie type.	Name = Key Name= Status

Delete Environment

Delete

Attribute name	Description	Details
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
Task	Delete	Delete
Environment	Environment in which the Item Task is performed	APIEnvironment
Environment Update	N/A
Description	N/A