本页采用了机器翻译。点击此处可查看英文原文。

systemcomposer.activity.Activity

活动图模型中的活动

自 R2026a 起

全页展开

    说明

    Activity 对象表示活动图模型中的根活动。

    创建对象

    使用 systemcomposer.createActivity 函数创建一个活动图模型。使用 systemcomposer.activity.Model 对象的 Activity 属性获取根活动。

    adModel = systemcomposer.createActivity('myActivity');
ad = get(adModel,'Activity');

    属性

    全部展开

    活动名称，指定为字符向量。该活动的名称源自其所属的父活动或模型名称。

    示例: activity

    数据类型: char

    如果该活动是子活动，则包含该活动的动作节点，其类型为 systemcomposer.activity.Action 对象。

    活动内的活动节点，指定为 systemcomposer.activity.ActivityNode 对象的数组。

    在活动内定义的流，指定为 systemcomposer.activity.Flow 对象的数组。

    参数名称是否在画布上显示，指定为 1 (true) 或 0 (false)。

    数据类型: logical

    父活动图模型，指定为 systemcomposer.activity.Model 对象。

    Simulink® 句柄，指定为双精度类型。

    此属性对于多个 Simulink 工作流以及使用 Requirements Toolbox™ 编程接口而言是必不可少的。

    示例: handle = get(object,'SimulinkHandle')

    数据类型: double

    统一唯一标识符，指定为字符向量

    示例: '91d5de2c-b14c-4c76-a5d6-5dd0037c52df'

    数据类型: char

    唯一外部标识符，指定为字符向量。外部 ID 在元素的整个生命周期以及所有保留 UUID 的操作中都会被保留。

    数据类型: char

    对象函数

    addParameter在活动图中创建新的参数节点
    addProperty为构造型定义自定义属性
    changeStereotype将当前应用的构造型更改为其构造型层次结构中的新构造型
    destroy移除模型元素
    getEvaluatedPropertyValue从元素中获取属性的计算值
    getFlow从活动图获取流
    getNode获取活动图中的活动节点
    getNodes获取活动图中的活动节点
    getParameter从活动图获取参数节点
    getParameters获取给定方向上的所有参数节点
    getProperty获取与应用于元素的构造型相对应的属性值
    getPropertyValue获取架构属性值
    getStereotypes获取应用于模型元素的构造型
    hasProperty查找元素是否具有属性
    removeStereotype从配置文件中删除构造型
    setProperty设置与应用于元素的构造型相对应的属性值
    addNode在活动图中创建新的活动节点
    applyStereotype将构造型应用于模型元素
    hasStereotype查找元素是否已应用构造型

    示例

    全部折叠

    打开实时脚本

    本示例演示了如何通过编程方式创建活动图。活动图描述系统行为，它通过受控动作序列对从输入到输出的令牌流进行建模。您可以使用活动图来构建系统的概念模型，通过动作或决策可视化功能流，并了解系统组件之间是如何相互交互的。如需进一步了解如何绘制活动图，请参阅绘制简单的活动图。

    在此示例中，您将创建一个活动图，以说明下单、检查库存可用性以及在商品缺货时取消订单的各个步骤。

    Activity diagram for shopping process.

    创建新活动图

    使用 systemcomposer.createActivity 函数创建一个名为 AuthorActivity 的新活动图。

    activityName = 'AuthorActivity';
adModel = systemcomposer.createActivity(activityName,true);
activity = adModel.Activity;

    添加初始节点和动作节点

    使用 addNode 函数添加一个初始节点和所需的动作节点。 

    init1 = addNode(activity,'init1','initial');
action1 = addNode(activity,'Place Order','action');   
action2 = addNode(activity,'Authorize Payment','action');  
action3 = addNode(activity,'Check Inventory','action');  
action4 = addNode(activity,'Cancel Order','action');  
action5 = addNode(activity,'Fulfill Order','action');

    定义动作节点的行为并添加引脚

    使用 setBehaviorType 函数 . 为动作节点添加行为类型。对于行为类型为 MATLAB 的动作节点，您可以通过 BehaviorDefinition 属性指定 MATLAB® 函数。 

    setBehaviorType(action1,'MATLAB');
action1.BehaviorDefinition = 'PlaceOrder';
setBehaviorType(action2,'Activity');
setBehaviorType(action3,'MATLAB');
action3.BehaviorDefinition = 'CheckInventory';

    您可以使用 addNode 函数在动作节点上添加引脚。有关引脚的详细信息，请参阅Pin。 

    outPin1 = addPin(action1,'order','out');
inPin1 = addPin(action2,'order1','in');
outPin2 = addPin(action2,'order2','out');
inPin2 = addPin(action3,'order3','in');
outPin3 = addPin(action3,'order4','out');
inPin1.IsStreaming = true;
outPin2.IsStreaming = true;

    创建嵌套活动

    您可以为行为类型为 Activity 的动作节点创建一个嵌套活动。 

    childActivity = action2.ChildActivity;
childAction1 = addNode(childActivity,'Enter Card Details','action');
childAction2 = addNode(childActivity,'Authenticate Details','action');

    添加控制节点

    添加一个连接节点或分支节点，以及一个合并节点或决策节点。有关控制节点的详细信息，请参阅systemcomposer.activity.ControlNode。 

    jfork = addNode(activity,"jfork","joinfork"); 
decMerge1 = addNode(activity,"decMerge1","mergedecision");
decMerge2 = addNode(activity,"decMerge2","mergedecision");

    添加流终止节点和活动终止节点

    添加一个流终止节点和一个活动终止节点。 

    ffinal = addNode(activity,"ffinal","flowfinal");
afinal = addNode(activity,"afinal","activityfinal");

    连接流

    将流连接起来，以完成活动图。您可以为从决策节点输出的流创建守护表达式。

    flow1 = connect(init1,action1);
flow2 = connect(outPin1,jfork);
flow3 = connect(jfork,inPin1);
flow4 = connect(jfork,inPin2);
flow5 = connect(outPin2,decMerge1);
flow6 = connect(outPin3,decMerge2);
flow7 = connect(decMerge2,action5);
flow8 = connect(decMerge2,action4);
flow9 = connect(decMerge1,action5);
flow10 = connect(decMerge1,action4);
flow11 = connect(action4,ffinal);
flow12 = connect(action5,afinal);

    为从决策节点输出的数据流创建 guard 表达式。 

    flow7.Guard = 'token == 1';
flow8.Guard = 'token == 0';

    您可以使用 Simulink.BlockDiagram.arrangeSystem 函数来优化活动图模型的布局。

    Simulink.BlockDiagram.arrangeSystem('AuthorActivity');

    详细信息

    全部展开

    版本历史记录

    在 R2026a 中推出

    另请参阅

    函数

    对象

    工具

    模块

    主题