Process Model

You define your process by using a process model file. A process model file accepts one argument, a padv.ProcessModel object. You define your process by modifying the padv.ProcessModel object and related objects.

function processmodel(pm)

    arguments
        pm padv.ProcessModel
    end

end

The process model file for your project must:

Tasks

In the process model, you add the tasks that you want to perform as part of your process. A task represents an individual step in the process. Tasks can take artifacts as inputs, perform specific actions, generates assessments, and return artifacts as outputs.

You add tasks to your process by using the addTask object function on the padv.ProcessModel object.

You can add:

For example, to add the built-in task for checking modeling standards with Model Advisor, you pass the task name or task instance to the addTask object function. addTask returns a task object that you can use to reconfigure the task behavior for the current process.

function processmodel(pm)

    arguments
        pm padv.ProcessModel
    end

    % Add Task
    modelAdvisorTask = pm.addTask(padv.builtin.task.RunModelStandards);

end

In Process Advisor, the Tasks column shows the task and the artifacts that the task iterates over. By default, the built-in task RunModelStandards runs once for each model in the project. But you can reconfigure how often the task runs and other task behaviors.

For more information, see:

Queries

You can find and use artifacts in your project by using queries. A query can automatically find artifacts in your project based on search criteria like the artifact type, project label, file path, and other characteristics. You can use queries in your process model to automatically find the relevant artifacts for your tasks without needing to manually update a static list of files.

In Process Advisor, the Tasks column shows the artifacts that a task iterates over. When you point to task results in the I/O column, you can see the task inputs and input dependencies.

You can reconfigure a task to iterate over different artifacts or use different task inputs by specifying a different query for the associated task property:

For each task in your process, the build system runs the task IterationQuery to determine which artifacts the task iterates over. The build system then creates a task iteration, runs any additional queries the task needs, runs the task, and saves the task results. Although tasks iterate over artifacts, tasks do not automatically use those artifacts as inputs unless those artifacts are specified by the task input queries. For each task iteration, the build system runs the InputQueries to find the inputs for that specific task iteration. For each input, the build system runs the InputDependencyQuery to find additional dependencies that can impact if task results are up-to-date. The task automatically becomes outdated if you make a change to any of the task inputs or input dependencies.

You can specify these task properties and other process modeling properties by using:

For information on how to reconfigure tasks to use different artifacts, see Reconfigure Task Behavior.

Use Your Process

When you are ready to run your process, you do not manually run the process model file. Instead, you use the Process Advisor app or the runprocess function. The Process Advisor build system automatically loads your process model, analyzes your project, and creates your pipeline of tasks. For more information, see Automate and Run Tasks with Process Advisor and Programmatically Run Tasks.