使用已转换的 Alteryx 应用
PlaidCloud 会将 Alteryx 分析应用的问题转换为受控的工作流变量。用户可以在运行前设置这些变量,随后 PlaidCloud 会将这些值应用到公式、筛选器、文件路径、条件、宏参数以及下游步骤设置中。
App Runner 前端
Section titled “App Runner 前端”转换 Alteryx 分析应用(.yxwz)时,其界面也会随之生成一个已发布的 Panel “App Runner”——这是一个可用的输入表单,它收集与 Alteryx 问题相同的值,并用这些值运行已转换的工作流。该前端会在转换过程中自动生成;没有输入控件的应用会被跳过。
应用的问题会成为 App Runner 控件:文本、数值、日期、复选框、单选按钮、下拉列表、列表框、树、文件浏览和文件夹浏览。每个控件都会写入已转换步骤所读取的工作流变量,因此通过 App Runner 运行与手动设置变量所驱动的逻辑相同。未绑定到真实工作流变量的控件会显示一条可见的提示,而不是悄悄收集一个无处可用的值——请检查该控件并将其指向预期的变量。
表单按应用作者自己的分组方式布局——即作者构建应用时使用的选项卡和带标签的框——作者的说明文字(Alteryx 标签工具)会与其所描述的问题一起显示在表单上。应用在设计时已固定的问题,例如没有界面问题驱动的 Detour,则完全不会作为问题显示。
表单打开时显示工作流变量上已保存的值——除非有人保存了其他值,否则就是作者设置的默认值——没有已保存值的问题则为空白。如果已保存的值不再与问题的某个选项匹配,则会被忽略,而不是显示为过时的选中项。数值问题会强制执行作者设置的最小值、最大值和步长,因此限定在较小范围内的问题无法填写超出该范围的答案。
当已转换的工作流存在分支时,App Runner 会将分支显示为带标签的选项,因此运行所走的路径与 Alteryx 应用一样,在运行时选定。
文件和文件夹问题
Section titled “文件和文件夹问题”每个文件或文件夹问题都有一个浏览按钮,用于打开文档浏览器,这样您可以直接选取路径,而无需凭记忆输入。
- 浏览会列出您可以访问的文档账户,默认为应用自己的账户,并允许您在这些账户之间切换。
- 它会在该问题当前答案所指向的文件夹处打开;如果该问题尚无答案,则在账户的顶层打开。
- 顶部的导航路径可逐级返回上层。在列表中选择文件夹会将其打开;选择文件则会选中该文件。
- 在您点击之前,选择会显示它将填入的路径。在未高亮任何项目时,选择会采用您当前正在查看的文件夹——这就是选取账户顶层的方式。
- 如果无法列出某个文件夹,列表会说明并指出原因,并且选择不会填入您未曾看到的路径。如果列表在 20 秒内没有得到响应,则会提示该账户没有应答。
填写表单并点击运行。
您的答案随运行一起提交,并且仅对该次运行有效。它们绝不会保存到工作流中,因此一个人的答案不会影响另一个人的运行,并且运行应用也不需要更改工作流的权限——这对于限制行访问的项目很重要,因为在这类项目中只有其架构师才能进行更改。若要更改表单打开时显示的值,请按下文所述将其保存到工作流中。
答案会在运行开始之前检查。从未回答的选择题会在运行开始前使运行停止并指明具体问题,而不是在一次可能耗时将近一小时的运行进行到一半时才发现。
运行期间,表单会显示进度条、按工作流总步骤数统计的 N of M steps、已用时间,以及当前正在运行的步骤。暂停和停止仅在运行期间显示在运行旁边;运行暂停时,暂停会变为继续。
失败的步骤会在失败时立即在表单上指明,运行结束时,表单会引述每个失败步骤所报告的内容。您无需打开工作流就能找出运行停止的原因。因其之前的步骤失败而无法运行的步骤会单独显示为未运行而不是失败,并且它们仍计入进度条,因此进度条会走到终点。
如果您关闭页面或失去连接,运行会继续进行。在该运行仍在进行时再次打开应用,会显示进行中的运行及暂停和停止,而不是空闲的表单。
运行旁边的打开工作流链接会在新选项卡中于 PlaidCloud 中打开底层工作流——如果是 DAG 工作流,则在其画布上打开。即使表单自身对运行的视图已停止更新,它也能正常使用。
您仍然可以通过设置工作流变量直接运行工作流,如下所述;App Runner 是一种额外的、应用式的入口。
保持应用最新
Section titled “保持应用最新”App Runner 应用是一个 Panel 服务器应用,其 app.py、widget_map.py 和 requirements.txt 由 PlaidCloud 生成。当 PlaidCloud 更新 App Runner 时,您现有的应用会自动采用新版本:每个应用都会刷新为当前文件,并在 PlaidCloud 下次更新时重新构建,此外,每当您在应用屏幕上重新构建或编辑应用时也会如此。应用的设置及其工作流不受影响。
- 文件所在位置。 在托管的 PlaidCloud Git 连接上,App Runner 应用是工作区
apps仓库内以应用命名的一个文件夹,与您的其他 Panel 应用并列。拥有独立仓库的应用会自动移入其文件夹,旧仓库会被归档(保留为只读,绝不删除)。只有当应用自己的文件夹或仓库根目录的requirements.txt发生更改时,推送到apps才会重新构建应用。 - 已锁定的应用保持原样。 请解锁该应用并点击重新构建使其更新到最新。
- 对生成文件的手动编辑会被替换。 刷新时会将当前的
app.py、widget_map.py和requirements.txt写入并覆盖您的更改。应用的 Git 历史记录会保留早期版本。
已转换的输入类型
Section titled “已转换的输入类型”PlaidCloud 会将常见的 Alteryx 应用控件转换为有类型的工作流输入:
- 文本框转换为文本变量。
- 数值控件转换为数值变量。
- 日期控件转换为 ISO 日期变量。
- 复选框、单选按钮、下拉列表、列表框和树转换为受控的选择变量。
- 文件浏览控件转换为文档文件变量。
- 文件夹浏览控件转换为文档文件夹变量。
在 Alteryx 应用使用原始问题值的任何位置,已转换的工作流都会使用这些变量。
在运行前设置值
Section titled “在运行前设置值”运行已转换的应用工作流之前:
- 打开已转换的工作流。
- 检查工作流变量。
- 设置所需的文本、数值、日期、选择、文件和文件夹值。
- 确认文档文件和文件夹路径指向已导入的依赖项位置或其他经批准的文档路径。
- 运行工作流。
对于计划运行,请保存每次按计划运行时应使用的变量值。
条件、警告和错误
Section titled “条件、警告和错误”Alteryx 应用条件和错误检查会转换为 PlaidCloud 步骤条件。条件可以:
- 允许工作流继续。
- 发出警告消息。
- 在应用规则要求时,以明确的错误停止工作流。
- 将执行路由到不同的分支。
利用这一行为,可以在 PlaidCloud 中运行工作流的同时保留应用级验证。
文件和文件夹输入
Section titled “文件和文件夹输入”文件和文件夹问题使用文档路径:
- 文件输入从文档中选择一个文件。
- 文件夹输入选择一个文档文件夹。
- 导入的桌面依赖项存储在导入时所选的文档路径。
- 动态输入步骤可以使用变量在运行时解析最终的文档路径。
这使已转换的应用在不同用户和计划运行之间保持可移植。
当已转换的应用调用宏时,应用变量可以为宏参数提供值。PlaidCloud 通过宏输入和控制参数处理,将这些值传入生成的宏工作流。
并发的宏运行相互隔离,因此多个工作流运行可以使用同一个已转换的宏,而不会共享中间状态。
对于每个已转换的应用,请确认:
- 每个预期的问题都显示为工作流变量。
- 在配置了默认值的位置,默认值与原始应用一致。
- 受控列表包含预期的选项。
- 文件和文件夹变量指向文档路径。
- 条件产生预期的消息、警告或停止行为。
- 针对所选变量值,输出一致性检查通过。