运行工作流
可以通过两种方式触发完整的工作流运行:在工作流层次结构中单击运行图标,或在特定工作流的操作菜单中选择 Run All。
也可以单击工作流表顶部的 Toggle Start/Stop 按钮。此切换按钮会停止正在运行的工作流,或启动工作流。
如果对已在运行的工作流单击运行,PlaidCloud 会提示该工作流正在运行,而不会启动第二次运行。
选择过账模式
Section titled “选择过账模式”每次运行都带有 ERP 过账模式。要在 PlaidCloud 中选择过账模式,请使用工作流右键菜单中的按过账模式运行,或工作流画布上的运行模式按钮;直接使用启动工作流或运行工作流时,请求的是实时模式,仍受下文所述项目上限的约束。通过运行 API 或助手启动运行时,也可以选择模式。
| 模式 | 效果 |
|---|---|
| 实时 | 过账步骤按以往方式正常过账。这是默认模式。 |
| 模拟 | 每个 ERP 过账步骤都会构建并验证其将要过账的内容,然后不提交任何内容,也从不连接 ERP。将要过账的分录会被记录下来,以便在实时运行之前进行审阅:过账凭证步骤的记录在过账登记簿中显示为将过账(请参阅向 ERP 系统过账凭证),系统自己的过账步骤的记录在 ERP 过账历史记录中并标记为模拟。 |
| 关闭 | 完全跳过过账步骤。 |
项目也有自己的过账模式上限,具有写入权限的任何成员都可以通过项目 API 或助手为未锁定的项目设置。该上限只会让运行更安全,绝不会更宽松:运行的有效模式取您所选模式与项目上限中限制更严格的一个,因此即使以实时模式启动运行,上限为模拟的项目仍保持模拟。
计划事件保留自己的过账模式,因此设置为模拟的计划每次触发时都以模拟方式运行。
该模式会贯穿运行涉及的所有内容。子工作流、宏,以及 Run Model、Conditional Run Model 和 Loop Model 步骤都会继承父运行的模式,停止后恢复的运行也是如此——模拟运行在其内部任何位置都无法进行真实过账。
授权项目过账
Section titled “授权项目过账”工作流运行以项目的身份而不是启动者的身份向 ERP 过账。运行过账之前,项目需要为其过账步骤使用的每个 ERP 连接和环境获得授权。没有授权时,步骤会失败并提示“This project isn’t authorized to post to connection …”,其中会指明连接和环境。Call SAP Financial Document Attachment、Call SAP Master Data Table RFC 和 Call SAP RFC 步骤不需要授权。
要授权项目,请打开其主页,在 ERP过账下选择 ERP 写入授权。每一行代表一个环境中的一个连接。勾选已授权即可允许项目在此处过账,取消勾选则停止。授权人和授权时间显示最近一次授权的人员和时间。
- 该按钮对项目的架构师和工作区管理员可见,但只有架构师可以更改授权,且仅限项目未锁定时。不是架构师的工作区管理员可以先将自己添加为架构师。
- 选择某一行进行授权或取消授权不会重新加载列表:滚动位置和您选择的列排序保持不变。窗口可以调整大小,关于公共项目的说明会完整换行显示。
- 要授权某个连接,您自己也需要拥有它的写入权限:您是其所有者,或者它按名称或通过您的某个安全组与您共享。设置为所有工作区成员的连接不算数。
- 设置为所有工作区成员的项目与其他项目一样进行授权。每个成员都是该项目的架构师,因此对某个连接具有写入权限的任何成员都可以为该项目授权此连接。一旦授权,任何成员都可以从该项目的工作流向该连接过账,窗口会在网格上方说明这一点。
- 使用表数据或维度成员创建、仅您私有的新副本,会保留源项目中您自己有权授予的授权;如果源项目为实时模式,副本将以模拟模式生成——请参阅副本中的 ERP 写入授权。任何其他副本,或从项目归档创建的项目,都没有任何授权。过账之前请先授权。
跟踪步骤状态
Section titled “跟踪步骤状态”工作流运行时,每个步骤都带有状态图标,显示其当前所处状态以及已运行的时长。将鼠标悬停在图标上可查看对应的消息。
| 状态 | 含义 |
|---|---|
| 等待中 | 步骤已排队,尚未开始。 |
| 运行中 | 步骤正在工作,其时长会持续增加。 |
| 已完成 | 步骤已成功完成。 |
| 警告 | 步骤已完成,但标记了值得在工作流日志中查看的内容。 |
| 错误 | 步骤失败。请参阅管理步骤错误。 |
| 已跳过 | 步骤被略过——已被禁用,或未满足其运行条件。请参阅跳过工作流中的步骤。 |
| 已继续 | 步骤失败,但设置为出错后继续,因此工作流继续执行。请参阅出错后继续。 |
| 已停止 | 运行在步骤完成之前被停止。 |
| 已放弃 | 步骤的执行被中断,因此永远不会完成。请恢复运行,或重新运行工作流。 |
打开的工作流视图会随运行进展自动刷新,因此无需重新加载页面,所看到的状态始终是最新的。
已放弃的步骤
Section titled “已放弃的步骤”当执行步骤的进程在运行中途消失时,该步骤会被标记为已放弃——最常见的原因是有人按下了停止,或平台维护中断了运行。步骤的时长不再增加,状态提示会说明发生了什么。
已放弃的步骤没有完成,也没有产生输出。它不是运行缓慢的步骤,也不是数据或配置的问题。
要继续这项工作,可以恢复运行——已放弃的步骤会再次运行——或者重新运行整个工作流。两种方式都是安全的。
已中断的步骤
Section titled “已中断的步骤”如果运行步骤的服务器在运行中途丢失,PlaidCloud 会在可以安全重复时自动重新运行该步骤:替换其输出的步骤最终得到的结果与一次干净的运行相同,因此无需检查任何内容。步骤的日志会在第二次尝试开始处显示一条警告:“Restarted: the server running this step stopped before it finished (e.g. out of memory or a restart); running it again from the start.”
无法安全重复的步骤不会被重新运行。它会失败一次,并给出已中断消息,因为再次运行可能会重复第一次尝试已写入的内容。输出名称或路径中包含 {date} 或 {date_iso} 的步骤被视为不能安全重复,因为重新运行时日期可能不同。要恢复,请检查步骤的目标中第一次尝试写入了什么,必要时进行清理,然后重新运行该步骤或恢复运行。
永远无法启动的步骤
Section titled “永远无法启动的步骤”步骤在等待工作进程时,其状态消息显示“Waiting for a worker… N min. No import worker has picked this step up yet.”(工作进程的类型与步骤相对应,例如导入或导出)。工作开始后,该消息会清除。
如果步骤的作业永远无法启动,该步骤会连同原因一起失败,而不是永远等待:
| 原因 | 大约在多久后失败 |
|---|---|
| 没有工作进程接手导入或维度步骤的作业 | 40 分钟 |
| 步骤的 pod 一直处于 Pending 状态 | 20 分钟 |
| 无法拉取步骤的镜像 | 5 分钟 |
| 没有为步骤创建 pod | 20 分钟 |
| 没有运行器接手连接器(Singer)同步 | 30 分钟 |
连接器同步消息会指明是哪个同步。如果工作进程启动了作业后又消失了,步骤同样会失败,并给出说明工作进程已停止的消息。导入和维度的消息会说明“Use Run from here to retry.”
停止响应的运行
Section titled “停止响应的运行”工作背后的进程消失后,运行绝不会一直停留在正在运行状态。如果运行工作流的服务器丢失,该运行会以失败结束。一次运行最长持续 12 小时:届时仍在运行的运行会失败,并显示“Run failed: still running at the 12-hour limit. Re-run the workflow.”
暂停、停止和恢复
Section titled “暂停、停止和恢复”工作流运行时,可以暂停它,使进行中的步骤完成而新步骤等待;也可以停止它,这会取消已排队的步骤以及仍在运行的任何导入或导出作业,连同导出正在读取的仓库查询。仍在排队的导入和维度步骤会被干净地取消,因此不会阻碍工作区中后续的导入和维度加载。停止还会停止工作流中已排队或正在运行的连接器(Singer)同步,因此工作流停止后同步不会继续运行。
一个宏可能同时在多处运行,由其他工作流调用,或由宏:并发运行步骤调用。停止该宏会停止它所有正在运行的副本。停止其中一个副本只会停止该副本及其启动的内容,而调用它的工作流会继续运行;Macro Concurrent 步骤放弃一个已停止响应的副本时也是如此。仅在其他工作流内部运行的宏会在工作流列表中显示为正在运行,并提供停止;打开它会显示每个步骤最近一次运行的状态、开始时间和结束时间。
恢复会让已暂停、已停止或失败的运行从中断处继续,而不是从头开始。只要工作流的上一次运行以暂停、停止或错误状态结束,就可以使用该功能。
“中断处”的含义取决于工作流的运行方式:
| 执行方式 | 恢复时 |
|---|---|
| 串行 | 从运行结束时正在运行的步骤重新开始,并从那里继续。如果该步骤位于某个组内,恢复会接手包含它的整个顶层组:组内已成功完成的步骤保持不动,其他步骤运行,运行在该组之后继续。 |
| 并行 | 重新运行每一个尚未成功完成的步骤,已完成的步骤保持不动。 |
| 高级(图) | 重新运行失败的节点以及仍在等待它的所有节点,已完成的节点保持不动。 |
调用另一个工作流的步骤——Run Model、Conditional Run Model 和 Loop Model——会恢复它们所调用的工作流,而不是重新启动,无论嵌套多少层。循环步骤会恢复被中断的迭代,并跳过已完成的迭代。
当恢复的工作流是作为另一个工作流的嵌套子级运行时(由父级中的 Run Model 步骤调用),PlaidCloud 会提供从链顶端恢复。单独恢复子工作流无法继续父级的编排,因此该选项会改为恢复顶层父级——即链的根——并从停止处继续整个链。恢复顶层工作流的行为不变。链顶端是在同一项目内确定的:跨入其他项目的链,会从项目内部分的顶端恢复。
恢复始终会继续原始运行。它会重新运行该运行中未成功完成的每一个步骤——失败或已放弃的步骤会被重新运行,而不是视为已完成——在此期间单独重新运行某个步骤,不会改变下一次恢复所接手的内容。子工作流也是如此:即使单独重新运行了它的某个步骤,恢复父级时仍会运行子工作流剩余的全部内容,而不只是那个步骤。
恢复的运行会作为新运行记录在工作流的运行历史记录中,其中只包含它重新运行的步骤。原始运行保留自己的历史记录条目。当一次运行多次调用同一个子工作流时,每次调用在子工作流的运行历史记录中都有自己的条目。循环步骤的各次迭代计为一次调用。