sltest.testsequence.addStepBefore

Add test sequence step before existing step

Syntax

sltest.testsequence.addStepBefore(blockPath,newStep,stepPath,Name,Value)

Description

sltest.testsequence.addStepBefore(blockPath,newStep,stepPath,Name,Value) adds a step to a Test Sequence block specified by blockPath. The new step is named newStep and inserted immediately before the step named stepPath. Step properties are specified by Name,Value.

Examples

Create a New Test Step

This example creates a test step, step1, in a Test Sequence block before the step SetLowPhi, which is in the second level of hierarchy under the top-level step APEngagement_AttitudeLevels.

Open the Model and the Test Harness

rollModel = 'RollAutopilotMdlRef';
testHarness = 'RollReference_Requirement1_3';

open_system(rollModel);
sltest.harness.open([rollModel '/Roll Reference'],testHarness)

Create a New Local Variable Named h

sltest.testsequence.addSymbol...
   ('RollReference_Requirement1_3/Test Sequence',...
   'h','Data','Local');

Add a Step Named step1 and Set the Value of h to 5

sltest.testsequence.addStepBefore...
   ('RollReference_Requirement1_3/Test Sequence',...
   'AttitudeLevels.APEngage_LowRoll.step2',...
   'AttitudeLevels.APEngage_LowRoll.SetLowPhi',...
   'Action','h = 5;')

Input Arguments

blockPath — Test Sequence block path or handle

string | character vector

Path to a Test Sequence block, including the block name, specified as a string or character vector. Instead of the block path, you can use a block handle.

Example: 'FanSpeedTestHarness/Test Sequence'

newStep — New test step name or handle

character vector

Name of a new test step in the Test Sequence block, specified as a character vector. It is added before stepPath and must have the same parent step as stepPath.

Example: 'newStep'

Example: 'topStep.midStep.newStep'

stepPath — Test step name and hierarchy level

character vector

Path of the step in the Test Sequence block, specified as a character vector. The path includes the step location in the Test Sequence hierarchy, using . to separate hierarchy levels. If the Test Sequence block is using scenarios, add the scenario name that contains the step to the beginning of the step path, for example, Scenario_2.SystemHeatingTest.InitializeHeating.

Example: 'SystemHeatingTest.InitializeHeating'

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: 'Action','out = square(et)','IsWhenStep',false,'Description','This step produces a square wave.' specifies a test step to produce a square wave.

Action — Test step actions

character vector

The test step action programming. To add a line, create the step actions using the sprintf function and the new line operator \n.

Example: 'Action','out = square(et)'

IsWhenStep — Specifies standard or When decomposition step

false (default) | true

Specifies whether the step is a standard transition type or a When decomposition transition

Example: 'IsWhenStep',true

WhenCondition — When decomposition step switch condition

character vector

Specifies the condition that activates a When decomposition child step. To activate the When step, enter a valid logical expression.

Example: 'WhenCondition','a >= 1'

Description — Description for the test step

character vector

Test step description, specified as a character vector.

Example: 'Description','This step produces a high-frequency square wave.'

Version History

Introduced in R2016a