Skip to main content
Version: 2.6.0

Change Object

Definition​

With this Teststep type, objects from a previous Teststep are changed in-memory.

note

Note that a Change teststep can be used on a single object or on a list of objects, and that attribute values and associations specified in the teststep, will be applied to all objects!

To save the changes to the database, add a Persist step.

Domain model Access​

Domain model access rights apply if the Test Case that the teststep is in, has Apply Security enabled.

Upon executing a Change teststep, MTA will check if the Execution user has Write rights on the Domain Model through the configured User Roles.

If the necessary rights are not found in the Domain Model, an error will be shown on the Test Run, and the Test Run will stop.

To circumvent domain model access rights it is possible to use a Microflow teststep.

Add a Change Object Teststep​

There are two options to add a Change Object teststep. The first option is quicker:

Option 1:

  • Navigate to the Test Suite and select the Test Case that you want to create a Teststep in.
  • Click on the button on the Teststep that returns the object(s) that you want to change, and choose " Change output".

Option 2:

  1. Navigate to the Test Suite and select the Test Case that you want to create a Teststep in.
  2. Click " Add" and Click " Change teststep" to add a Change Object Teststep.
  3. Select an entity. You can search by name.
  4. Select the previous Teststep that returns the object(s) that you want to change. This could be a Create, Change or Retrieve Teststep but also a Microflow Teststep that returns an object or a list of objects.

Setting values​

info

Binary attributes are not supported by MTA.

Include or exclude an Attribute Value​

  • Toggle the checkbox next to the attribute to include or exclude it.

Note that not including an Attribute Value in a Change Object Teststep will leave the value unchanged for that attribute. Including an Attribute Value but not entering a value will make the value empty for all datatypes except the String datatype. A String attribute will be given the zero-length value ('').

Set a fixed Attribute Value​

  • Click on the right of the attribute, indicating a fixed value should be set.
  • Enter or select a value for the attribute.

Note: For datetime values you can either specify a date, or calculate the date with an offset from the current datetime.

Use a former Teststep to set an Attribute Value​

  • Click on the right of the attribute, indicating a former Teststep should be used to set the value.
  • Select the Teststep and (if the Teststep returns an Object) find the Attribute that should provide the value.

Assign associations​

  • Click " Add" for each association that you want to set.
  • Use the " Set empty" button to clear the association.

Note that multiple values can only be set for both way reference set (many to many) associations.

Generate assignments from database​

You can choose to fill all the attributes and associations using existing values in the database, by clicking " Fill teststep with data" and then "Fill with stored data". This will fill the attributes with values based on a random Object retrieved from the database, and fill associations where the that Object is the owner.

note

Because of performance reasons, the amount of associations retrieved is limited to 3.

Generate random values​

You can choose to fill attributes with random data, by clicking " Fill teststep with data" and then "Fill attributes with random values".