计划 notebook 任务
您可以创建任务以计划自动运行 notebook。 每次根据您所设置的计划运行 notebook 时,站点都会打开一个新容器并在无用户控制的情况下运行 notebook。
您可以从 notebook 编辑器的 任务 窗格中创建一个或多个已计划任务以运行 notebook。 您可以将其计划为在将来运行一次或定期运行(可在每分钟一次到每五个月一次之间随意选择)。
如果要准备自动运行的笔记本(例如定期操作),则需要注意一些事项。
准备 notebook
笔记本编辑器有一个 参数 选项,允许您为笔记本配置输入和输出参数。 输入参数对应于 Notebook 的输入变量,您希望具体化计划任务或 Web 工具。 运行计划任务时,输入参数会插入到 notebook 顶部的 notebook 中,类似于全局变量。 这允许您创作通用 Notebook 并在运行时修改输入变量的值。
创作笔记本时,使用 参数 选项具体化并配置变量。 有关如何为 notebook 设置输入参数的信息,请参阅“将 Notebook 发布为 Web 工具”主题的 配置输入参数 部分。
默认情况下,任务参数会插入到笔记本开头的单元格中。 或者,您可以单击菜单中的 查看 > 激活命令选项板 ,然后搜索并打开 编辑笔记本元数据 ,此选项可编辑单元格和笔记本元数据,从而为名为 injected-parameters 的单元格创建标签。 默认情况下,任务参数被插入到 injected-parameters 标签之后的单元格中。
内容注意事项
除了可以插入的参数单元格外,计划 notebook 操作不支持用户与 notebook 之间进行交互。 避免在 notebook 运行时添加需要用户交互的内容,例如单击地图上的某个点。
如上所述,必须将要在自动运行时添加的所有凭据或新变量插入参数单元格中。 确保笔记本中不包含会阻止笔记本完成的内容。
注:
创作 Notebook 时,使用工作空间目录中目录和文件的完整路径。
例如,使用 /arcgis/home/test.gdb 而非 home/test.gdb 。
创建任务
准备好 Notebook 后,您可以创建任务以计划其运行情况。 您可以使用 Notebook 编辑器中的 任务 窗格创建一个或多个任务以自动运行 Notebook,并指定任务的计划。
要创建任务,请完成以下步骤:
如果还没有保存笔记本,则请创建一个标题并保存笔记本。
任务 按钮在 notebook 编辑器的顶部功能区中变为可用状态。
请单击 创建任务 以打开对话框。
注:
您也可以通过笔记本项目页面上的 任务 选项卡来创建任务。
在 标题 文本框中提供一个标题以描述您的任务计划,例如 Weekly data cleaning run 。
如果尚未配置笔记本的参数,并且您希望在任务运行笔记本的过程中将参数添加到笔记本,则请在 参数 部分中提供这些参数,然后单击 添加 将参数添加至工作流。
如果您之前使用 参数 选项设置了输入参数,则会自动为任务填充这些参数。 您可以添加、删除或更新任何特定于此任务的参数。 这样做不会更改使用参数选项配置的 Notebook 的默认参数。
在 密钥 设置中提供一个密钥,在 值 设置中为每个参数提供配对值。
单击 下一步 转至 设置任务计划详细信息 页面。
在此页面上,您可以指定此任务的特定计划。 将基于 web 浏览器的本地时区来存储指定的计划。
提示:
当您更改 重复类型 的值时,以下选项将发生更改以适应该选择内容。 例如,如果选择 月 ,则会出现 月份中的天 框,您可以指定要运行任务的月份中的某一天或日期范围。
可以选择展开 高级 部分以输入任务可以运行的最大分钟数。
在 高级 部分中,如果您添加了参数,将显示 将参数保存至笔记本 切换按钮。 (可选)可打开此按钮以将包含新参数的已插入单元格保存到运行的笔记本。
(可选)在 高级 部分中,打开 完成时更新笔记本 切换按钮以使用每次运行的结果更新笔记本。
当您对标题、可选参数和任务计划感到满意时,单击 创建任务 。
该任务随即激活,并根据您设置的计划运行笔记本。
对于多个计划(例如,插入了不同的参数),您可以使用相同的工作流为笔记本创建更多任务。
使用现有任务
为笔记本创建任务后,您可以随时查看任务的详细信息并进行编辑或删除。 可以在笔记本编辑器的 任务 窗格或笔记本项目页面的 任务 选项卡上对任务进行更改。 在这两个位置中,您可以查看 notebook 的所有任务及各个任务的创建时间、上次修改时间和当前状态。
要使用现有任务,请完成以下步骤:
在 notebook 编辑器的顶部功能区上,单击 任务 。
在 计划任务 部分,查找您想要使用的任务。
单击任务旁边的 操作
,然后执行以下任意操作:单击 详细信息 以查看任务每次运行的结果。 Notebook 预览将与每次任务运行的详细信息一起存储。
注:
笔记本预览不会包含笔记本中地图微件的渲染。 地图微件仅在笔记本中渲染,不会在计划任务结果随附的静态预览中渲染。
单击 编辑 以更改标题、参数或任务计划。
单击 暂停 可暂停活动任务,单击 恢复 可恢复该任务。
单击 删除 以移除任务。
注:
删除任务的同时也会删除该任务的运行历史记录。 要保留活动任务的历史记录,请考虑暂停任务以停止进一步运行。
更改 notebook 的所有权将同时更改该 notebook 任务的所有权。 任务将以非活动状态转移到新用户。 新所有者可以在笔记本编辑器的 任务 窗格或者笔记本项目页面的 任务 选项卡上启用这些任务。