addDependsOnRelationship

Class: padv.Process
Namespace: padv

Create dependency between two tasks or subprocesses

Syntax

addDependsOnRelationship(process,Source=sourceTaskOrSubprocess,Dependency=predecessorTaskOrSubprocess)
addDependsOnRelationship(___,Name=Value)


Description

addDependsOnRelationship(process,Source=sourceTaskOrSubprocess,Dependency=predecessorTaskOrSubprocess) specifies that in the process, the source depends on the dependency. The source task or subprocess does not run until after the predecessor task or subprocess runs completely and has a status.

addDependsOnRelationship(___,Name=Value) specifies additional characteristics of the relationship by using one or more Name=Value arguments. For example, addDependsOnRelationship(p1,Source=t2,Dependency=t1,WhenStatus=["Pass","Fail"]) specifies that in process p1, task t2 depends on task t1 and that task t2 can only run after t1 runs completely and has a passing or failing task status.

Input Arguments

process — Process

padv.Process object

Process, specified as a padv.Process object.

Example: padv.Process("p1")

sourceTaskOrSubprocess — Task or subprocess that depends on completion of predecessor task or subprocess

string | padv.Task object | padv.Subprocess

Task or subprocess that depends on the completion of a predecessor task or subprocess, specified as either the:

• Task name, specified as a string

• Task instance, specified as a padv.Task object

• Subprocess name, specified as a string

• Subprocess instance, specified as a padv.Subprocess object

Example: "TaskB"

Example: padv.Task("TaskB")

Example: padv.builtin.task.AnalyzeModelCode()

predecessorTaskOrSubprocess — Predecessor task or subprocess that must run before source task or subprocess

string | padv.Task object | padv.Subprocess

Predecessor task or subprocess that must run before the source task or subprocess, specified as either:

• Task name, specified as a string

• Task instance, specified as a padv.Task object

• Subprocess name, specified as a string

• Subprocess instance, specified as a padv.Subprocess object

Example: "TaskA"

Example: padv.Task("TaskA")

Example: padv.builtin.task.GenerateCode()

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.

Example: addDependsOnRelationship(p1,Source=t2,Dependency=t1,WhenStatus=["Pass","Fail"])

IterationArtifactMatching — Option to control which predecessor task iterations run

true or 1 (default) | false or 0

Option to control which predecessor task iterations run, specified as a numeric or logical 1 (true) or 0 (false):

• true — The build system runs only iterations that the predecessor and source have in common.

• false — The build system runs all predecessor task iterations. This behavior is useful when you have a task that creates new project artifacts and a task that runs on each artifact in the project. The second task depends on all project artifacts generated by the first task.

For example, suppose you have two tasks: TaskA and TaskB:

• TaskA runs on ModelA and ModelB.

• TaskB runs only on ModelB and depends on TaskA.

If you run TaskB and:

• IterationArtifactMatching is true, TaskA runs only on ModelB.

  

• IterationArtifactMatching is false, TaskA runs on both ModelA and ModelB.

  

Data Types: logical

Override — Replace existing relationship

false or 0 (default) | true or 1

Replace existing relationship, specified as a numeric or logical 0 (false) or 1 (true).

By default, if you define multiple relationships between the same tasks or subprocesses, the build system only uses the most recent relationship and ignores previous relationships. Setting the Override argument as 1 (true) makes sure that the current relationship replaces any existing relationship between the tasks or subprocesses.

Data Types: logical

WhenStatus — Option to control when the source task or subprocess runs

"Pass" (default) | "Fail" | "Error" | ["Pass","Fail"] | ["Pass","Fail","Error"] | ...

Option to control when the source task or subprocess runs, specified as either "Pass", "Fail", "Error", or a combination of those options.

For example, you can specify ["Pass","Fail"] to instruct the build system to only run the source if the predecessors pass or fail. By default, the source only runs if the predecessors pass.

Examples

Add Tasks and Subprocesses Inside Process

In your process model, you can define multiple processes for different workflows and environments. A process consists of the tasks and subprocesses that you add to your padv.Process process by using the addTask and addSubprocess methods. To specify the relationships between tasks inside a specific process, use the addDependsOnRelationship and addRunsAfterRelationship methods.

Open the Process Advisor example project.

processAdvisorExampleStart

The model AHRS_Voter opens with the Process Advisor pane to the left of the Simulink^® canvas.

In the Process Advisor pane, click the Edit process model button to open the processmodel.m file for the project.

Replace the contents of the processmodel.m file with the following example code. The code:

• Defines two processes, processA and processB

• Adds example tasks and subprocess to the processes by using the addTask and addSubprocess methods

• Defines task relationships inside a specific process by using the addDependsOnRelationship and addRunsAfterRelationship methods

function processmodel(pm)
    % This function defines a process model for a project by setting up processes,
    % subprocesses, and tasks within those processes.

    arguments
        pm padv.ProcessModel
    end

    % --- Processes ---
    % Add processes to process model
    processA = pm.addProcess("A");
    processB = pm.addProcess("B");

    % --- Tasks ---
    % Create example tasks
    task1 = padv.Task("task1");
    task2 = padv.Task("task2");
    task3 = padv.Task("task3");
    taskA1 = padv.Task("taskA1");
    taskA2 = padv.Task("taskA2");
    taskB1 = padv.Task("taskB1");
    taskB2 = padv.Task("taskB2");

    % --- Subprocesses ---
    % Add subprocesses to parent process
    subprocessA = processA.addSubprocess("subprocessA"); % Add to process A
    subprocessB = processB.addSubprocess("subprocessB"); % Add to process B

    % --- Add Tasks to Processes ---
    processA.addTask(task1); % Add task1 to process A
    processA.addTask(task2); % Add task2 to process A
    processB.addTask(task1); % Reuse task1 in process B
    processB.addTask(task3); % Add task3 to process B

    % --- Add Tasks to Subprocesses ---
    subprocessA.addTask(taskA1); % Add taskA1 to subprocessA under process A
    subprocessA.addTask(taskA2); % Add taskA2 to subprocessA under process A
    subprocessB.addTask(taskB1); % Add taskB1 to subprocessB under process B
    subprocessB.addTask(taskB2); % Add taskB2 to subprocessB under process B

    % --- Add Relationships Between Tasks ---
    % In processA, task2 should run after task1
    processA.addRunsAfterRelationship(...
        Source = task2,...
        Predecessor = task1);
    % In processA, taskA2 depends on taskA1
    processA.addDependsOnRelationship(...
        Source = taskA2,...
        Dependency = taskA1);

end

In Process Advisor, refresh by clicking Refresh Tasks.

You can select which process you want to use from the Process gallery in the toolstrip. By default, processes appear in the order that you define them in the process model.

If you point to the run button for taskA2 in process A, Process Advisor highlights the dependency between taskA2 and taskA1.