行为
Action 图
使用顺序、并行、决策、循环和退出结构对功能流建模,包括在动作之间传递的项、它们使用的资源以及执行它们的资产,然后进行仿真。
本页内容
概述
Action 图显示父 Action 是如何执行的。它是 LML 行为图,仿真器运行的正是它所显示的内容。
该图显示:
- 子 Action,按其运行顺序排列;
- 流程在何处分成并行路径或备选路径,以及在何处循环;
- 从一个 Action 传递到另一个 Action 的 Input/Output(I/O);
- 每个 Action 使用的 Resource;
- 执行工作的资产。
该图是模型的视图,而不是绘图。您添加、移动或删除的每个形状都会更改项目中的实体和关系。每次更改都可通过一次撤销撤回。
同一流程还驱动功能流程框图(FFBD)、SysML 活动图和时间线图。在其中任何一个中编辑流程,其他图都会随之更新。
概念
流程
流程从左侧的绿色开始胶囊运行到右侧的红色结束胶囊。箭头连接其间的元素。每个元素是以下之一:
| 元素 | 形式 | 含义 | 实体 |
|---|---|---|---|
| Action(串行步骤) | 带编号和名称的蓝色圆角框 | 在前一个元素结束时开始的步骤 | 根的一个子 Action(decomposed by) |
| 并行 | 标有 parallel 的分叉条和一个闭合条 | 同时运行的两个或更多分支。所有分支完成后流程继续。 | 无 |
| SYNC | 标有 SYNC、右侧带尖角的块,以及一个闭合条 | 带有自身实体的并行分支。其 Duration 是一个超时,会停止未完成的分支。 | 名为“Sync Action”的 Action(控制类型 SYNC) |
| OR | 标有 OR、左侧带尖角的块,以及一个闭合圆 | 一个判断:只运行一个分支 | 名为“Or Action”的 Action(控制类型 OR) |
| LOOP | 一个入口圆、循环主体、标有 LOOP 的块,以及一个虚线返回箭头 | 当继续条件成立时,主体重复执行。每一轮之前检查该条件。 | 名为“Loop Action”的 Action(控制类型 LOOP) |
| EXIT | 标有 EXIT 的红色框 | 到达时结束所在的 LOOP(或其所在的流程) | 无 |
分支是 Parallel、SYNC 或 OR 内部的一条路径。每个分支都是自己的序列,可以包含任何元素,包括更多结构。LOOP 包含一个序列,称为其主体。
OR、SYNC 和 LOOP 是带有自身实体的结构。该实体像步骤一样是根的子项,因此结构可以带有名称、脚本以及(对于 SYNC)超时。结构不是步骤:它们从不显示为 Action 框,时间线等视图也会跳过它们。
流程周围的条目
| 项 | 形式 | 关系 | 含义 |
|---|---|---|---|
| Input/Output | 流程上方的平行四边形。触发 Action 时为绿色,否则为灰色。 | Action generates I/O;Action receives I/O | 在 Action 之间传递的信息、数据或物料 |
| 父 Input/Output | 标有 parent input(开始左侧)或 parent output(结束右侧)的平行四边形 | 根 Action receives 或 generates 它 | 父 Action 的接口。在没有子 Action 使用它时以虚线绘制。 |
| Resource | 流程下方的紫色六边形 | Action consumes、produces 或 seizes Resource,并带有 Amount | Action 消耗、归还或产生的数量 |
| 执行 Asset | ⟂ 以及 Action 名称下方的 Asset 名称 | Asset performs Action | 执行该 Action 的人或物。在资产打开时显示。 |
| 执行者 | ⟂ 以及 Parallel 或 SYNC 分支上的 Asset 名称 | Asset performs 该分支上的每个 Action | 整个分支的执行者。每次编辑时都保持同步。 |
对仿真而言有两个重要术语:
- Trigger:设置了 Trigger(默认)的接收 I/O 会使接收它的 Action 等到该 I/O 存在为止。
- 可选:关闭了 Trigger 的接收 I/O。Action 不等待它就开始。
Resource 线标有关系和数量,例如 consumes 1.5。只被占用的 Resource 以较浅的颜色绘制。
如何使用
何时使用及原因
在有了一组功能之后、将其分配给物理架构之前,构建 Action 图。这些功能通常来自对需求进行的功能分析。
该图回答以下问题:
- 功能按什么顺序运行,哪些并行运行?
- 系统在何处做出判断?
- 每个功能需要什么、产生什么?
- 整个序列需要多长时间?
每个分解层级使用一个图。从顶层运行场景开始,例如任务时间线或用例。然后为每个需要自身细节的功能添加一个图。
该图是可执行的。将其与仿真器结合使用,可在硬件存在之前尽早检查时间和资源需求。
从零开始构建流程
创建图:
- 打开导航栏底部的图。
- 点击+ 新建图。
- 在图类型下,选取 Action 图(位于行为组中,标记为 LML)。
- 在根中输入新 Action 的名称,例如
Run Nominal Imaging Pass。(稍后在属性面板中为其指定编号,例如OPS。) - 点击创建。
您会看到开始和结束,以及提示将元素拖到此处或点击 + Action。
按顺序添加步骤:
- 点击 + 添加 ▾ → + Action ▾ → 新建 Action…。
- 在添加 Action中输入名称。
- 点击确定(或按 Enter)。
您会在流程中看到一个带编号的 Action 框。编号从父级的编号延续:OPS.1、OPS.2,依此类推。新 Action 是根的子项。
- 保持新 Action 处于选中状态,对下一步重复步骤 1 到 3。+ Action 总是插入到所选元素之后。
添加同时运行的步骤:
- 选择并行步骤开始之前的那一步。
- 点击 + 添加 ▾ → + Sync。
您会看到一个带两个空分支的 SYNC。
- 点击分支线以选择它。
- 点击 + 添加 ▾ → + Action ▾ → 新建 Action…,向该分支添加一个步骤。
- 如果需要第三个分支,请点击 + 分支。
当您不需要超时、名称或脚本时,使用 + 添加 ▾ → + Action ▾ → 并行分支(无实体)代替 + Sync。
添加判断:
- 选择判断之前的步骤。
- 点击 + 或。
- 输入问题,例如
Contact in view?。您会看到两个分支 Yes 和 No,各为 50%。
- 选择该 OR,并在属性面板中设置守卫名称和概率。
重复一个步骤:
- 选择该步骤。
- 点击 + 添加 ▾ → + 循环。
- 输入循环名称。
您会看到该步骤被包裹在一个运行两次的循环中。
- 在属性面板中设置迭代次数或其他条件。
设置持续时间并检查结果:
- 选择一个 Action。
- 在属性面板的进度组中填写 Duration。
- 要为多个 Action 设置相同的 Duration,请 Shift+点击它们,然后在属性面板中设置 Duration (N Actions)。
- 点击工具栏中的图检查徽章(✓ 检查,或 ⚠ 和一个数字)。
属性面板列出没有 Duration 的 Action 和未连接的条目。
从选项板拖动构建流程
左侧的选项板包含结构和条目类型。将它们拖到画布上,而不是使用工具栏。
- 将 Action 拖到流程的任意一条线上。当条目位于有效位置上方时,放置线会突出显示。
您会在该位置看到一个“New Action”。属性面板中它的名称字段已被选中,可直接输入。
- 输入名称。
- 以同样的方式将 Parallel、或、Sync、循环或退出拖到线上。
- 将 Input/Output 拖到一个 Action 上。这会创建一个由该 Action 生成的 I/O。将其放到空白画布上可放置一个未连接的 I/O。
- 将 Resource 拖到一个 Action 上。这会创建一个由该 Action 消耗的 Resource(Amount 1)。将其放到空白画布上可放置为未连接状态。
- 将执行者拖到 Parallel 或 SYNC 的分支线上,然后选择 Asset。
现在该 Asset 执行该分支上的每个 Action。
要复用模型中已有的条目:
- 在添加或查找…中输入名称。在项目中列出匹配的 Action、Input/Output、Resource 和 Asset。
- 将匹配项拖到图上:
- 将 Action 拖到线上;
- 将 I/O 或 Resource 拖到 Action 或画布上;
- 将 Asset 拖到 Parallel 或 SYNC 的分支线上。
使用键盘时,让选项板条目获得焦点并按 Enter 或 Space。结构会添加到主流程末尾。Input/Output 和 Resource 会放到视图中心。
连接 Input/Output 和 Resource
通过将一个形状的手柄拖到另一个形状来连接条目。
将一个 I/O 从一个 Action 传递到另一个 Action:
- 选择第一个 Action。
您会在其上方看到一个绿色手柄。
- 将手柄拖到第二个 Action 上。
悬停时,目标框会显示为两半。
- 在 Trigger(上半部分)上释放可创建触发输入,在可选(下半部分)上释放可创建可选输入。
Holarch 创建一个新的 Input/Output。第一个 Action 生成它,第二个 Action 接收它。新 I/O 会被选中,其名称字段可直接输入。
- 输入 I/O 名称。
Action 的手柄也可以拖到其他位置:
- 拖到现有 Input/Output 上:该 Action 生成它。
- 拖到 Resource 上:该 Action 产生它(Amount 1)。
- 拖到空白画布上:Holarch 为该 Action 创建一个新输出。
让 Action 接收现有的 I/O:
- 选择该 Input/Output。
- 将其手柄(位于形状下方)拖到 Action 上。
- 在 Action 上释放,然后在连接选择器中选择 Input(触发器)或 Input(可选)。
如果该 Action 已接收该 I/O,则只会更改其 Trigger 设置。
让 Action 使用 Resource:
- 选择该 Resource。
- 将其手柄(位于形状上方)拖到 Action 上。
- 在消耗(上半部分)或占用(下半部分)上释放。
在消耗和占用之间切换会保留数量。
设置资源关联的数量:
- 选择该 Action。
- 在属性面板的追溯部分中,在 consumes、produces 或 seizes 下找到该 Resource,然后点击属性。
- 编辑关系属性 Amount。
手动放置 I/O 和 Resource:
- 将 Input/Output 或 Resource 形状拖到所需位置。位置随图一起保存。
- 点击其属性面板中的重置位置,使其回到使用它的 Action 上方或下方的自动布局。
- 选择排列 ▾ → 重置 Input/Output 和 Resource 的位置可重置全部。
分配执行者
为一个 Action 分配 Asset:
- 选择该 Action,然后选择打开方式 ▾ → 条目视图。(在图上,performed by 在属性面板中被锁定,因为它由图管理。)
- 在追溯部分中,用 + → 关联现有…添加 performed by。
- 选取该 Asset。
为 Parallel 或 SYNC 的整个分支分配 Asset,有两种方式:
- 将执行者从“添加”面板拖到分支线上。
- 选择 Parallel 或 SYNC,然后点击属性面板中该分支旁边的 + Asset。
打开工具栏中的资产,可在每个 Action 名称下方显示执行者。
分解和向下钻取
为一个 Action 设置自己的子流程:
- 选择该 Action。
- 点击分解。
该 Action 自己的 Action 图会打开。
- 在那里构建其子流程。
- 点击页眉中的▲ 父级返回。
您也可以通过双击已分解的 Action 或点击其分解图标来打开子流程。
将多个步骤分组到一个新的子 Action 中:
- Shift+点击同一条线上相邻的两个或更多元素。
- 点击分解(分组)。
这些元素移入一个名为“New Action”的新子 Action,并拥有自己的流程。您会看到提示消息已分组到新的子 Action。请在属性面板中为其命名。,并且名称字段已被选中。
- 输入新名称。
将子流程展平回此图:
- 选择一个已分解的 Action。
- 点击展平(在工具栏或属性面板中)。
其子流程在此图中替换它。
- 选择保留 Action可将清空的 Action 保留在模型中(在此图之外),或选择删除条目将其删除。
在仿真器中,已分解的 Action 运行其子流程。不使用它自己的 Duration。
仿真和确认
- 首次运行之前打开图检查徽章,并修正其列出的问题。
您会看到仿真器将视为缺失的内容:
- 没有 Duration 的 Action 按 0 仿真。
- 没有 Action 生成的 I/O 会让其接收者一直等待(死锁)。
- 列出没有被任何对象使用的 Resource。
- 修正检查报告的问题。
- 点击 ▶ 仿真 ▾,选择离散事件观察一次定时运行,或选择蒙特卡洛进行多次运行。
仿真器会以此 Action 为根打开。
- 运行仿真。
永远等待的运行会报告为死锁。仿真器的状态显示原因,日志标签页会列出它:
- 等待 I/O …(从未生成)
- 等待 …(从不可用)
修正图并再次运行。例如,将触发输入改为可选输入。
实例:CubeSat EO-1 成像过程
演示项目包含 Action 图 OPS Run Nominal Imaging Pass。
- 使用管理项目 → 项目文件 ▾ → 新建演示项目创建演示项目。
- 从行为 → Action 图打开该图。
流程如下运行:
- 三个步骤按顺序运行:
- OPS.1 Transmit Imaging Plan(Ground Station,三角分布 4–9 分钟,最可能值 6);
- OPS.2 Receive Imaging Plan(UHF Transceiver,1 分钟);
- OPS.3 Load Command Schedule(C&DH,2 分钟)。
- 一个 Parallel 同时运行 OPS.4 Rotate to Target(ADCS,正态分布 3 ± 0.5 分钟)和 OPS.5 Prepare Camera(Payload Camera,5 分钟)。两者都以 Command Schedule 作为触发器接收。
- 一个名为 Each target 的 LOOP 将 OPS.6 Capture Image Strip 和 OPS.7 Encode and Store Image 运行四次(Continue (×4))。
- 一个名为 Contact in view? 的 OR 选择下一步:
- Yes (75%):OPS.8 Transmit Image Data;
- No (25%):OPS.9 Hold Data Onboard。
- 最后一个 Parallel 在为电池充电(OPS.10)的同时,由地面接收并处理数据(OPS.11、OPS.12)。
该流程使用两个 Resource:
- Battery Charge(Wh,初始 62,最小 23,最大 77)。OPS.4 (1.5)、OPS.5 (0.8)、OPS.6 (2)、OPS.7 (0.3) 和 OPS.8 (6) 消耗它。OPS.10 (30) 产生它。
- Data Storage(GB)。OPS.7 (2.5) 产生它,OPS.8 (8) 消耗它。
Image Data Package 是 OPS.11 的可选输入。因此,没有通信联系的过程不会使地面段死锁。
尝试以下更改:
- 选择该 OR,将 Yes 改为 60,No 改为 40。
分支标签显示 Yes (60%) 和 No (40%)。属性面板显示 Total 100%。
- 选择该 LOOP,并将迭代次数设为 6。
循环文字显示 Continue (×6)。
- 选择 ▶ 仿真 ▾ → 蒙特卡洛并运行。
每个过程的目标越多,消耗的电池电量越多。摘要栏和分布标签页显示更长的过程时间。
- 打开资产可查看每个执行者。
- 选择排列 ▾ → 生成 Asset 图。
Holarch 创建 Asset“Run Nominal Imaging Pass performers”。其子项是执行 Asset,每个在其中两个之间传递的 I/O 都有对应的 Conduit。其 Asset 图会打开。
提示和良好做法
- Action 用动词 + 宾语命名(Capture Image Strip),I/O 用名词命名(Image Strip)。OR 守卫以 OR 问题的答案命名。
- 每个图保持在大约七到十二个元素。用分解(分组)将细节分组到子 Action 中。
- 默认使用 Parallel(无实体)。仅在需要超时、名称或脚本时使用 SYNC。
- 概率模式下的 OR 合计必须为 100%。概率未知时,选择无(运行时询问或随机)。仿真器随后会询问,或蒙特卡洛使用等概率。
- 仿真之前为每个叶 Action 设置 Duration。时间有变化时使用分布,例如
=norm.dist(40,6)Seconds。 - 当 Action 可以在没有某个接收 I/O 的情况下开始时,将该 I/O 设为可选。否则,从不产生它的分支会使运行死锁。
- 在根的属性面板(排列 ▾ → 图设置)中使用重新编号子项…,并将子项顺序设为流程顺序,以按流程顺序为子项编号。
常见错误
| 现象 | 原因 | 修正 |
|---|---|---|
| 请将该结构拖放到流程线上。 | 结构或 Action 在形状或空白画布上释放 | 在元素之间的箭头上释放它 |
| 分支概率合计为 90 %。请将其调整为合计 100 %。 | OR 概率合计不正确 | 更正百分比,或添加一个分支 |
| 仿真永不结束(死锁) | 某个 Action 等待一个在此路径上没有任何对象生成的触发 I/O | 将该输入设为可选,或在每条路径上都生成它 |
| 某个 Action 在仿真中不占用时间 | 没有 Duration,或该 Action 已分解(改为运行其子流程) | 设置其 Duration,或为其子项添加持续时间 |
| 某个步骤似乎消失了 | 它已从图中移除,但仍保留在模型中 | 在添加或查找…中输入其名称,然后将其拖回到线上 |
| 生成 Asset 图报告No Action here has a performer… | 没有 Action 带有 performed by Asset,也没有分支带有执行者 | 先分配执行者 |
与其他功能的关联方式
- 输入来源:功能分析创建功能(子 Action)及其流程。需求通过 satisfied by 到达 Action。Asset 和 Resource 来自架构。
- 输出到仿真器:时间、成本、资源水平、Asset 利用率和需求检查。请参阅仿真。
- 输出到同一流程的其他视图:FFBD 和活动图。
- 输出到派生视图:
- 时间线图(根据开始时间和 Duration 生成进度);
- 序列图(生命线是执行 Asset,消息是 I/O);
- 生成 Asset 图(物理上下文和 Conduit);
- N² 图(功能之间的 I/O);
- IDEF0(输入和输出)。
- 可追溯性:属性面板的追溯部分显示每个 Action 的需求(satisfies)。RVTM 和可追溯性矩阵读取相同的关系。
编辑器
Action 图使用共享的图编辑器(请参阅图)。它有一行工具栏、左侧的选项板、画布以及右侧的属性面板。
页面标题区
- 图类型选择器:以适用于 Action 的另一种图类型显示同一个根 Action。这些类型包括 Hierarchy、Spider、Tree、Risk、Timeline、Action、Sequence、Use Case、N2、IDEF0、ICOM (A0)、Activity 和 FFBD。
- ▲ 父级:打开父 Action 的 Action 图。仅当根有父 Action 时显示。
工具栏
工具栏是一行分组。插入组中的添加项(+ Action ▾、+ Sync、+ 或、+ 循环、+ 退出、+ 分支、+ I/O)位于一个 + 添加 ▾ 列表中:它们作用于所选位置(其后、其周围、其分支上),而左侧的添加面板通过拖动或 Enter 添加。在列表中,↓ 和 ↑ 在添加项之间移动,Esc 关闭列表。窗口较窄时,条目会移入 ⋯(更多操作);+ 添加 ▾ 保留在该行中,只有分解和 ▶ 仿真 ▾ 保持完整长度。选择形状会打开属性面板,而不会移动工具栏的按钮。
| 组 | 控件 | 功能 |
|---|---|---|
| 模式 | 平移 | 拖动背景可移动视图(默认)。 |
| 模式 | 框选 | 在 Action 图上只选择注释。用 Shift+点击选择流程元素。 |
| 插入 | + 添加 ▾ | 打开下方添加项的列表(“在所选位置添加”)。 |
| 插入 | + Action ▾ | 新建 Action…会询问名称(默认 New Action)。现有 Action…选取一个不是根、不是其祖先、也不在此图中的 Action。并行分支(无实体)添加并行分支。插入到所选内容之后、所选分支的末尾或流程末尾。 |
| 插入 | + Sync | 添加带两个空分支的 SYNC。 |
| 插入 | + 或 | 询问判断名称(一个问题)(默认 Or Action),然后添加一个带 Yes 和 No 分支、各 50% 的 OR。 |
| 插入 | + 循环 | 询问循环名称(重复条件)(默认 Loop Action)。选择了元素时,会将该元素包裹在循环中(将所选元素放入 LOOP)。否则添加一个空循环(添加空 LOOP)。新循环运行 2 次迭代。 |
| 插入 | + 退出 | 在所选内容之后添加 EXIT。 |
| 插入 | + 分支 | 向所选的 Parallel、SYNC 或 OR(或其分支被选中的那个)添加一个分支。OR 的概率会重新平均分配。否则禁用。 |
| 插入 | + I/O | 选择了一个 Action 时,选取接收的 Action(从“…”到…的 Input/Output),然后命名新 I/O。第一个 Action 生成它,第二个 Action 将其作为触发器接收。 |
| 编辑 | 撤销、重做 | ⌘Z / Ctrl+Z, ⇧⌘Z / Ctrl+Shift+Z. |
| 编辑 | 连接… | 用键盘将所选形状连接到另一个形状,选项与拖动其手柄相同(请参阅键盘和屏幕阅读器)。 |
| 编辑 | ◀, ▶ | 将所选元素在其序列中向左或向右移动一个位置。 |
| 编辑 | 移除 | 从图中移除所选内容;Shift+点击会删除实体(请参阅删除和移除)。 |
| 视图 | −、缩放 %、+、⤢ | 缩小、输入缩放级别(10–400%)、放大、使图适合窗口。 |
| 视图 | 带 ‹ › 的搜索图 | 突出显示名称、编号、描述、ID 或属性值匹配的 Action、I/O 和 Resource。↓ / ↑(或 ‹ ›)在匹配项之间移动;Enter 选择当前匹配项。 |
| 视图 | 内容 | 图内容:以文本形式显示形状、连接和关系。 |
| 视图 | 配置 | 在属性面板中显示根和图类型,以便就地切换其中任一项(请参阅配置:根和类型)。 |
| 视图 | 排列 ▾ | 请参阅下文的排列 ▾。 |
| 视图 | 图检查徽章 | 孤立项和循环以及 Action 图检查(请参阅消息),列在属性面板中并带有显示。 |
| 视图 | I/O、Resource、资产、父 I/O | 显示或隐藏 Input/Output、Resource、执行 Asset 和父 Input/Output。该选择随图一起保存,并成为新 Action 图的默认设置。 |
| 类型操作 | 分解 / 分解(分组) | 选择了一个 Action:打开其子 Action 图。多个元素:将它们分组到一个新的子 Action 中。 |
| 类型操作 | 展平 | 用其子流程替换所选的已分解 Action。 |
| 类型操作 | 打开 | 打开所选实体或根的条目视图。 |
| 类型操作 | ▶ 仿真 ▾ | 离散事件或蒙特卡洛:以此根打开仿真器。 |
| 输出 | 导出… | 图 (PNG)(可选透明背景和缩放比例)、图 (SVG)、图 (HTML)、图 (Word)、图(打印)。 |
| 更多 | ⋯ | 溢出的条目,然后是打开条目视图、所有图、Action 图帮助和删除图…。 |
排列 ▾
| 项 | 功能 |
|---|---|
| 恢复默认值 | 清除手动设置的 I/O 和 Resource 位置。 |
| 显示 / 隐藏 | 隐藏 Resource、隐藏所有 Input/Output、隐藏父项的 Input/Output、隐藏执行 Asset和隐藏选项板;当该部分隐藏时,每项显示为显示 …(例如显示执行 Asset)。 |
| 重置 Input/Output 和 Resource 的位置 | 将每个已移动的 I/O 和 Resource 恢复到自动布局。 |
| 生成 Asset 图 | 创建“root performers”,请参阅生成 Asset 图。 |
| 以 FFBD 打开 | 将同一流程作为功能流程框图打开。 |
| 图设置 | 属性面板中的根及重新编号子项…(旧编号 → 新编号;子项顺序为大纲或流程,来自项目偏好设置 → 编号;一次撤销即可全部撤回)。 |
| 隐藏“添加”面板 / 显示“添加”面板 | 在每个图中隐藏左侧边栏(选项板和注释)。 |
生成 Asset 图
排列 ▾ → 生成 Asset 图根据流程的执行者构建其物理上下文。
- 它创建 Asset“root performers”。该 Asset 执行根 Action。
- 新 Asset decomposed by 每个执行 Asset。执行者来自根以下所有层级的 performed by 和分支执行者。
- 对于每一对其 Action 交换 I/O 的 Asset,它会复用或创建一个 Conduit。Conduit 命名为“A to B”,当 I/O 双向传递时命名为“A / B”,并且它 transfers 这些 I/O。
- 然后它打开 Asset 图。
调色板
添加面板(提示拖到线或形状上,或按 Enter)列出:
| 项 | 放置位置 | 创建 |
|---|---|---|
| Action | 一条线 | 一个新 Action“New Action” |
| 并行 | 一条线 | 并行分支(无实体) |
| 或 | 一条线 | 一个带 Yes/No 分支的 OR Action 实体 |
| Sync | 一条线 | 一个 SYNC Action 实体 |
| 循环 | 一条线 | 一个 LOOP Action 实体(主体为空,2 次迭代) |
| 退出 | 一条线 | 一个 EXIT |
| Input/Output | 一个 Action,或任意位置 | 一个名为“I/O”的新 I/O,放到 Action 上时由该 Action 生成 |
| Resource | 一个 Action,或任意位置 | 一个名为“Resource”的新 Resource,放到 Action 上时被消耗(Amount 1) |
| 执行者 | Parallel 或 SYNC 分支线 | 询问 Asset(此分支的执行者),该 Asset 随后执行该分支 |
在添加或查找…中输入名称:创建提供将“名称”创建为 Action、Or、Sync、Loop、Input/Output 或 Resource,在项目中列出匹配的 Action、Input/Output、Resource 和 Asset(最多 60 个;不含根和结构实体)。将一行拖入,或在其上按 Enter。
选项板下方是所有图共享的注释部分。“添加”面板标题中的 × 会隐藏它。排列 ▾ → 显示选项板可将其恢复。
画布手势
| 手势 | 结果 |
|---|---|
| 点击形状 | 选择它;属性面板会显示它 |
| Shift+点击 | 在所选内容中添加或移除一个元素 |
| 点击一条线 | 选择它所属的分支(在主线上则清除选择) |
| 点击背景 | 清除选择 |
| 将 Action 或结构拖到一条线上 | 将其(连同其中的所有内容)移到那里 |
| 拖动 I/O 或 Resource | 自由放置 |
| 拖动绿色手柄 | 连接(请参阅连接 Input/Output 和 Resource) |
| 双击 Action | 已分解时打开其子 Action 图,否则打开其条目视图 |
| 双击 I/O 或 Resource | 打开其条目视图 |
| 点击分解图标 | 打开子 Action 图 |
| 拖动背景 | 平移 |
| 滚动 / ⌘ / Ctrl+滚动 | 平移 / 以指针为中心缩放 |
每种形状显示的内容
- Action 框:编号(顶部)、名称,以及下方的一行。该行显示 Duration(例如 1 minute),或在资产打开时显示执行 Asset。
- 左下角紫色的 { }:该 Action 或结构有仿真脚本。
- 右上角的分解图标:该 Action 有自己的子流程。点击图标可打开它。
- OR 分支标签:守卫名称及其概率(Yes (75%))或条件(Low [< 20]、[else])。
- Parallel 和 SYNC 分支标签:分支名称及其执行者。
- 返回箭头下方的循环文字:Continue (×4)、Continue (50%)、Continue while Battery Charge > 20、Continue (script) 或 Continue (ask)。Exit 标记出口。
- 结构名称:以斜体显示在 OR、SYNC 和 LOOP 块旁边。
属性面板
右侧的属性面板显示所选内容。显示什么取决于您选择了什么。
Action、Input/Output、Resource 或 Asset:共享的实体面板。它包含:
- 带有类、编号和名称的标题,以及打开方式 ▾(条目视图以及此实体的所有其他图);
- 定义:编号、名称和描述;
- 形状:下表中的额外操作,以及位置和大小;
- 属性组(工作流、进度等),然后是追溯、讨论和详细信息。
此图管理的关系在“追溯”部分中被锁定,使图和模型保持一致。它们是 consumed by、decomposed by、generated by、performed by、produced by、received by 和 seized by。
| 所选内容 | 额外操作 |
|---|---|
| Action | Action 图、编辑脚本…、展平(已分解时)、移除和删除条目… |
| 已移动的 Input/Output 或 Resource | 重置位置 |
| 分解为子 I/O 的父 I/O | 显示父项的 Input/Output会显示其子项来代替它;隐藏父项的 Input/Output会恢复原状 |
| 任意 | 移除和删除条目… |
选择了 OR(面板 OR (Decision)):
- 判断名称:OR 实体的名称。
- 判断类型:概率、资源数量、脚本或无(运行时询问或随机)。
- Resource(仅限资源数量):比较其数量的 Resource。
- 分支:每个分支一个守卫名称。根据类型,每个分支还有一个概率(0–100 %),或一个运算符(
==、!=、>、<、>=、<=、else)和一个值。 - 合计行:显示 Total 100%,或警告分支概率合计为 N %。请将其调整为合计 100 %。
- 编辑脚本…/添加脚本…(脚本类型):onEnd() 返回要执行分支的守卫名称。
- “无”类型说明:使用“Prompt”判断时,仿真器会询问走哪条路径;自动运行时,它会随机选取一个分支。
- + 添加分支、打开条目。
选择了 SYNC:
- 名称。
- 时间限制:可选。超过此时间后 SYNC 结束,并停止仍在运行的分支。
- 说明N 个分支并发运行;全部完成后流程继续。
- 每个分支一行:分支名称和 + Asset。设置 Asset 后,该行显示 ⟂ Asset 名称和用于移除它的 ×。
- 编辑脚本…/添加脚本…、+ 添加分支、打开条目。
选择了 Parallel:与 SYNC 相同,但没有实体字段。
选择了一个分支:已选择分支 N — + Action 会添加到其中。
选择了 LOOP:
- 名称(条件)。
- 当满足时重复:迭代次数、概率、资源数量、脚本或无(运行时询问或随机)。
- 按条件:迭代次数(最少 1)、继续的概率 (%),或 Resource 加上 当数量满足时继续,并带有运算符和值。
- 脚本说明:每次执行前都会调用 onEnd();返回 true 会再次运行循环体。
- “无”说明:使用“Prompt”判断时,仿真器会询问迭代次数;自动运行时,它随机运行 0–2 轮。
- 编辑脚本…/添加脚本…、说明循环体中的 EXIT 会提前停止循环。、打开条目。
选择了 EXIT:到达时停止外层 LOOP 或此流程。
选择了多个元素:已选择 N 个元素、Duration (N Actions)(实时字段:更改会在每个所选 Action 上设置 Duration,作为一个撤销步骤;当它们的持续时间不同时保持为空)、分解(分组到新的子 Action)和移除。
图如何映射到 LML
| 在图上 | 在模型中 |
|---|---|
| 图的根 | 父 Action |
| Action 框 | 子 Action:父项 decomposed by 子项 |
| OR、SYNC、LOOP 块 | 带控制类型的子 Action,decomposed by 父项 |
| 顺序、分支、循环 | 随父项保存的流程结构(子项运行的顺序) |
| 从 Action 到 I/O 的线 | Action generates Input/Output |
| 从 I/O 到 Action 的线 | Action receives Input/Output,带有关系属性 Trigger(Yes = 触发,No = 可选) |
| Action 与 Resource 之间的线 | consumes、produces 或 seizes,各带属性 Amount |
| ⟂ Asset | Asset performs Action(反向 performed by)。关系属性 Amount 是该 Action 占用的该 Asset 的数量。 |
| 框上的 Duration | Action 的 Duration 属性(一个数字或一个分布,带单位) |
| 子流程 | 子 Action 自己的 Action 图 |
此图上各类的属性:
- Action:Start(日期和时间)、Duration(值或分布,加上 Seconds、Minutes、Hours、Days、Weeks、Months 或 Years)和 Percent Complete。
- Resource:Units、Initial Amount、Minimum Amount 和 Maximum Amount。
- Input/Output:大小、单位、类型和值。
仿真脚本
脚本可添加仅靠图无法表达的行为,例如计算得出的持续时间,或基于模型值的判断。
编辑脚本:
- 选择一个 Action、OR、SYNC 或 LOOP。
- 点击编辑脚本…(Action)或编辑脚本…/添加脚本…(OR、SYNC、LOOP)。
- 点击添加 onStart()、添加 prompt()、添加 onEnd() 或添加 duration(),插入一个空的钩子函数。
- 编写代码。Tab 插入两个空格。
- 点击保存。空脚本会移除脚本。
钩子:
onStart()在元素开始时运行。prompt(p)为用户构建一个问题:p.setTitle()、p.addEnumInput(title, name, choices, default)、addTextInput、addNumberInput、addBooleanInput。onEnd(response)在结束时运行。OR 返回要执行的分支名称。LOOP 返回true以再次运行主体。- 当 Action 的 Duration 为
=script()时,duration()返回其持续时间。
脚本可以调用:
Sim.getEntityByName(n),Sim.getAmount(name),Sim.setResourceByName(name, v);Sim.getCurrentTime(),Sim.getCurrentCost();print(x);globals.put(k, v)/globals.get(k).
顶层变量在整个运行期间保留。Math.random 使用该运行的带种子生成器。完整的 API、沙箱和信任提示请参阅仿真。
删除和移除
Delete 或移除会立即将所选内容从图中移除并保留实体;说明已从图中移除。提供撤销和删除条目…。⇧Delete / Shift+Delete 或删除条目…会先询问,然后同时删除实体。两者中任一项都可通过一次撤销撤回(请参阅移除和删除)。
| 所选内容 | “移除”从图中移除 | ⇧Delete / Shift+Delete 还会删除 |
|---|---|---|
| Action、OR、SYNC 或 LOOP | 该元素及其内部的元素 | 该元素的实体 |
| Parallel 或 EXIT | 该结构及其内部的元素 | 其内部的实体 |
| 一个分支 | 该分支及其元素;移除最后一个分支或循环主体会移除整个结构 | 该分支上的实体 |
| 多个元素 | 所有所选元素 | 它们的实体 |
| Input/Output、Resource 或 Asset | 它与此处所显示 Action 的关联 | 该实体 |
| 执行者(属性面板中的 ×) | 移除执行者:“名称”执行此分支上的 N 个 Action。是否同时移除这些 performed by 关系? | 保留关系、移除关系 |
移除还会移除该 Action 到根的 decomposed by 关联,因此它不再是子项。实体及其其他关系保留。
键盘快捷键
| 按键 | Action |
|---|---|
| Delete 或 Backspace | 将所选内容从图上移除(实体保留) |
| ⇧Delete / Shift+Delete | 确认后,从项目中删除所选实体 |
| Esc | 清除选择 |
| Shift+点击 | 添加到所选内容或从中移除 |
| ⌘Z / Ctrl+Z / ⇧⌘Z / Ctrl+Shift+Z | 撤销 / 重做 |
| 在选项板条目上按 Enter 或 Space | 插入它(结构插入主流程末尾,I/O 和 Resource 放在中心) |
| ⌘ / Ctrl+滚动 | 缩放 |
| 在缩放字段中按 Enter | 应用输入的缩放级别 |
| 在搜索图中按 ↓ / ↑ | 下一个 / 上一个匹配项;Enter 选择它,Esc 清除搜索 |
选项和设置
- 显示/隐藏(工具栏开关和排列 ▾):I/O、Resource、资产、父 I/O 和选项板。按图保存,并在此浏览器中记住,作为新 Action 图的默认设置。默认:I/O、Resource、父 I/O 和选项板打开;资产关闭。
- I/O 和 Resource 位置:按图保存。用重置位置或重置 Input/Output 和 Resource 的位置重置。
- 缩放和位置:按图保存。图打开时会适合窗口,但不小于 70%。
- 只读显示:具有查看者角色的人看到的图没有工具栏编辑组、选项板、手柄或选择面板。他们可以平移、缩放、搜索和导出。
消息
| 留言 | 含义 |
|---|---|
| 请将该结构拖放到流程线上。 | 结构和 Action 只能插入到箭头上。 |
| 元素不能放在自身内部。请将其拖放到外部。 | 您将一个结构放到了它自己的分支内,或尝试添加根或其某个祖先。 |
| “名称”已在此图中。 | 该 Action 已在流程中。 |
| 选择 Parallel、SYNC 或 OR 以添加分支 | + 分支需要选择其中之一(或其某个分支)。 |
| 请先选择产生该 Input/Output 的 Action | + I/O 需要选择一个 Action。 |
| 选择要分解的 Action,或按住 Shift 点击多个以分组 | 分解需要一个 Action(而不是结构)。 |
| 无法分组:这些元素位于不同的分支上。请选择同一序列中的元素。 | 被分组的元素必须位于同一序列中。 |
| 无法分组:这些元素不相邻。请选择前后相接的元素。 | 被分组的元素必须是连续的。 |
| 已分组到新的子 Action。请在属性面板中为其命名。 | 分解(分组)成功。 |
| 选择一个有子图的 Action 以展平 | 展平需要一个有子流程的 Action。 |
| 子图为空。请先添加 Action 再展平。 | 子 Action 没有子项。 |
| 无法展平:子控制流格式错误。 | 子流程引用了已删除的实体;请打开它进行修复。 |
| 无法展平此组:其某个子项已出现在此层级。 | 展平会使一个 Action 出现两次。 |
| 迭代次数必须为 1 或更大。请输入至少为 1 的整数。 | 小于 1 的迭代次数会被拒绝。 |
| 分支概率合计为 N %。请将其调整为合计 100 %。 | 更正 OR 概率。 |
| “名称”现在执行此分支上的 Action。 | 已设置执行者。 |
| 此处没有 Action 有执行者。请将 Action 关联到 Asset(performed by),或将执行者拖放到分支上。 | 生成 Asset 图没有可放置的内容。 |
| 已创建“名称 performers”,包含 N 个 Asset 和 M 个 Conduit。 | 生成 Asset 图成功。 |
| 将元素拖到此处或点击 + Action | 流程为空。 |
| 此 Action 已删除。 | 根已被删除。 |
| 图检查徽章上的 ✓ 检查 | 检查未发现任何问题。 |
| … 与此图上的其他任何内容都没有关系。… 请连接或移除它。 | 图检查的发现项(孤立项和循环),并附原因:Input/Output“名称”未被此图中的任何 Action 生成或接收。、Resource“名称”未被此图中的任何 Action 消耗、产生或占用。或Action“名称”没有 Duration(按 0 仿真)。 |
| 分解形成了循环:… 请移除其中一个 decomposed by 关系。 | 某个 Action(间接地)是它自己的子项。 |
| 仅查看:请向所有者申请编辑权限。 | 您在此项目中的角色是查看者。 |
限制
- 每个父 Action 一个流程。
- 一个 Action 在给定流程中只能出现一次。使用 LOOP 来重复它。
- 添加或查找…列出项目中的前 60 个匹配项。输入更多名称以缩小范围。
- OR 概率是 0 到 100 的整数百分比。
- 循环迭代次数是至少为 1 的整数。
- 仿真中的持续时间永远不会为负:采样到的负值会重新抽取。
- 框选只选择注释。对流程元素使用 Shift+点击。