计划 notebook 任务

您可以创建任务以计划自动运行 notebook。 每次根据您所设置的计划运行 notebook 时，站点都会打开一个新容器并在无用户控制的情况下运行 notebook。

您可以从 notebook 编辑器的任务窗格中创建一个或多个已计划任务以运行 notebook。 您可以将其计划为在将来运行一次或定期运行（可在每分钟一次到每五个月一次之间随意选择）。

如果要准备自动运行的 notebook（例如定期操作），则需要注意一些事项。

准备 notebook

Notebook 编辑器有一个参数功能，允许您为 Notebook 配置输入和输出参数。 输入参数对应于 Notebook 的输入变量，您希望具体化计划任务或 Web 工具。 运行计划任务时，输入参数将插入到 notebook 顶部的 notebook 中，类似于全局变量。 这允许您创作通用 Notebook 并在运行时修改输入变量的值。

创作 Notebook 时，使用参数功能具体化并配置变量。 有关如何为 notebook 设置输入参数的信息，请参阅“将 Notebook 发布为 Web 工具”主题的配置输入参数部分。

默认情况下，任务参数被加入到 Notebook 开头的单元格中。 或者，您可以单击菜单中的查看 > 激活命令选项板，然后搜索并打开编辑笔记本元数据，此选项可编辑单元格和笔记本元数据，从而为名为 injected-parameters 的单元格创建标签。 默认情况下，任务参数被加入到 injected-parameters 标签之后的单元格中。

内容注意事项

除了可以插入的参数单元格外，计划 notebook 操作不支持用户与 notebook 之间进行交互。 避免在 notebook 运行时添加需要用户交互的内容，例如单击地图上的某个点。

如上所述，必须将要在自动运行时添加的所有凭据或新变量插入参数单元格中。 确保 notebook 中不包含会阻止 notebook 完成的内容。

注：

创作 Notebook 时，使用工作空间目录中目录和文件的完整路径。

例如，使用 /arcgis/home/test.gdb 而非 home/test.gdb。

创建任务

准备好 Notebook 后，您可以创建任务以计划其运行情况。 您可以使用 Notebook 编辑器中的任务窗格创建一个或多个任务以自动运行 Notebook，并指定任务的计划。

1. 如果还没有保存 notebook，则请创建一个标题并保存 notebook。

   任务按钮在 notebook 编辑器的顶部功能区中变为可用状态。

2. 请单击创建任务以打开对话框。

   注：

   您也可以通过 notebook 项目详细信息页面上的任务选项卡来创建任务。

3. 在标题文本框中提供一个标题以描述您的任务计划，例如 Weekly data cleaning run。
4. 如果之前尚未配置 notebook 的参数，并且在 notebook 任务运行过程中您希望将参数添加到 notebook 中，则请在参数部分中提供这些参数。 在密钥设置中提供一个密钥，在值设置中为每个参数提供配对值，然后单击添加参以保存参数。

   如果您之前使用参数选项设置了输入参数，则会自动为任务填充这些参数。 您可以添加、删除或更新任何特定于此任务的参数。 这样做不会更改使用参数选项配置的 Notebook 的默认参数。

5. 单击下一步移至设置任务计划详细信息页面。

   在这里，您可以指定此任务的特定计划。

   提示：

   当您更改重复类型的值时，以下选项将发生更改以适应该值。 例如，如果您选择重复类型周，则一周的每一天都会出现这些复选框。

6. 可以选择展开高级部分以输入任务可以运行的最大分钟数。
7. 在高级部分中，如果您添加了参数，将显示将参数保存到 notebook 开关按钮。 （可选）可打开此按钮以将包含新参数的已插入单元格保存到运行的 notebook。
8. 在高级部分中，如果您想要使用每次运行的结果更新 notebook，打开在完成时更新 notebook 开关按钮。
9. 当您对标题、可选参数和任务计划感到满意时，请单击创建任务。

   该任务随即激活，并根据您设置的计划运行 Notebook。

如果您希望设置多个计划，且有可能插入不同的参数，则可以使用相同的工作流为 notebook 创建更多任务。

使用现有任务

为 notebook 创建任务后，您可以随时查看任务的详细信息并进行编辑或删除。 可以在 notebook 编辑器的任务窗格或 notebook 项目页面的任务选项卡中对任务进行更改。 在这两个位置中，您可以查看 notebook 的所有任务及各个任务的创建时间、上次修改时间和当前状态。

1. 在 notebook 编辑器的顶部功能区上，单击任务。
2. 在计划任务部分，查找您想要使用的任务。
3. 单击任务旁边的操作 ，然后执行以下任意操作：
   • 单击详细信息以查看任务每次运行的结果。 Notebook 预览将与每次任务运行的详细信息一起存储。

     注：

     Notebook 预览不会包含 notebook 中地图微件的渲染。 地图微件仅在 notebook 中渲染，不会在计划任务结果随附的静态预览中渲染。

   • 单击编辑以更改标题、参数或任务计划。
   • 单击暂停以暂停活动的任务。 暂停时，单击恢复以恢复任务。
   • 单击删除以移除任务。

     注：

     删除任务的同时也会删除该任务的运行历史记录。 要保留活动任务的历史记录，请考虑暂停任务以停止进一步运行。

更改 notebook 的所有权将同时更改该 notebook 任务的所有权。 任务将以非活动状态转移到新用户。 新所有者可以在 notebook 编辑器的任务窗格或者 notebook 项目页面的任务选项卡中启用这些任务。