版本 3.1.23.4
创建已安排的方案
创建已安排的方案,定期重复呈现外观或信息中心。
如需创建已安排的方案,您必须为以下字段提供值:name
和 look_id
、dashboard_id
、lookml_dashboard_id
或 query_id
以及 cron_tab
或 datagroup
以及至少一个 schedule_plan_destination
已安排的方案必须至少定义一个 schedule_plan_destination。
设置 look_id
后,必须提供 require_no_results
、require_results
和 require_change
。
如果 create_scheduled_plan
失败并显示 422 错误,请务必查看响应中的错误消息,这将会准确说明缺少哪些字段或不兼容的值。
提供外观或信息中心数据的查询会在拥有已安排方案的用户帐号环境中运行。
当 run_as_recipient
为 false
或未指定时,为外观或信息中心提供数据的查询在拥有预定方案的用户帐号环境中运行。
当 run_as_recipient
为 true
且所有电子邮件收件人都是 Looker 用户帐号时,查询将在每个收件人的上下文中运行,因此不同的收件人可能会看到来自计划或呈现的同一界面或信息中心的数据。如需了解详情,请参阅以收件人身份运行。
管理员可以指定用户 ID,代表其他用户创建和修改计划。非管理员用户不得为其他用户创建或修改计划。
电子邮件权限:
如需详细了解安排定期发送电子邮件所需的权限,以及 Looker 针对防止将电子邮件发送到未经授权的电子邮件目的地而采取的保护措施,请参阅针对定期查看的电子邮件网域许可名单。
已排定的方案的目标位置必须指定要生成的数据格式并将其发送到该目标位置。
格式:
格式 |
说明 |
json |
这个 JSON 对象包含一个 data 属性,该属性包含一个 JSON 对象数组,每行一个无元数据。 |
json_detail |
行数据以及描述查询的字段、数据透视表、表计算和其他方面的元数据 |
内嵌 json |
除了 data 属性是包含 JSON 转义行数据的字符串之外,与 JSON 格式相同。其他属性用于描述数据操作,此格式主要用于将数据发送到网络钩子,这样网络钩子无需对 JSON 行数据进行重新编码,即可将其传递到最终目的地。 |
csv |
以英文逗号分隔的值,带有标题 |
txt |
使用标头制表符分隔值 |
html |
简单 HTML |
XX |
MS Excel 电子表格 |
所见即所得 PDF |
以平铺布局呈现的信息中心,用于生成 PDF 文档 |
汇编_pdf |
以单列布局呈现的信息中心,用于生成 PDF 文档 |
所见即所得 |
以平铺布局呈现的信息中心,用于生成 PNG 图片 |
|
|
有效格式因目的地类型和来源对象而异。例如,wysiwyg_pdf
仅对信息中心有效。
请求
POST//scheduled_plans
展开 HTTPBody 定义...
展开 SchedulePlan 定义...
user_id
整数
此安排的方案拥有的用户 ID
run_as_recipient
布尔值
是否以收件人身份运行时间表(仅适用于电子邮件收件人)
已启用
布尔值
是否启用了 SchedulePlan
Lookml_dashboard_id
字符串
LookML 信息中心的 ID
过滤条件_字符串
字符串
用于运行外观或信息中心的查询字符串
信息中心过滤条件
字符串
(已弃用)filter_string 字段的别名
要求结果
布尔值
如果运行信息中心或外观返回结果,则应进行传送
required_no_results
布尔值
如果信息中心外观未返回结果,则应传送消息
要求更改
布尔值
如果自上次运行后数据发生更改,则应发生传送
发送全部结果
布尔值
将运行无限制查询并发送所有结果。
Crontab
字符串
何时运行 Vixie-Style Crontab 规范
数据组
字符串
数据组的名称;如果指定,将在数据组触发时运行(不能与 Cron 字符串配合使用)
timezone
字符串
解读指定 crontab 的时区(默认为 Looker 实例时区)
运行一次
布尔值
相关方案是否应该仅运行一次(通常用于测试)
添加链接
布尔值
此 SchedulePlan 中是否应包含返回 Looker 的链接
custom_url_base
字符串
预定实体的自定义网址域名
custom_url_params
字符串
已安排的实体的自定义网址路径和参数
show_custom_url
布尔值
是否显示自定义链接,而不是标准 Looker 链接
pdf_paper_size
字符串
PDF 应采用适合页面大小的格式。有效值为“letter”、“legal”、“tabloid”、“a0”、“a1”、“a2”、“a3”、“a4”、“a5”。
pdf_landscape
布尔值
PDF 的格式是否为横向格式
color_theme
字符串
信息中心的配色方案(如适用)
long_tables
布尔值
是否将表格展开至完整长度
inline_table_width
整数
渲染内嵌表可视化时的像素宽度
创建时间
lock
字符串
SchedulePlan 的创建日期和时间
更新时间
lock
字符串
SchedulePlan 的上次更新日期和时间
位用户
lock
此 SchedulePlan 的所有者
next_run_at [下一步运行时间]
lock
字符串
SchedulePlan 的下一次运行时间(如果运行一次,则为 null)
上次运行时间
lock
字符串
SchedulePlan 的上次运行时间
可以
lock
对象
当前用户可以对此对象执行的操作
响应
200:已安排的方案
user_id
整数
此安排的方案拥有的用户 ID
run_as_recipient
布尔值
是否以收件人身份运行时间表(仅适用于电子邮件收件人)
已启用
布尔值
是否启用了 SchedulePlan
Lookml_dashboard_id
字符串
LookML 信息中心的 ID
过滤条件_字符串
字符串
用于运行外观或信息中心的查询字符串
信息中心过滤条件
字符串
(已弃用)filter_string 字段的别名
要求结果
布尔值
如果运行信息中心或外观返回结果,则应进行传送
required_no_results
布尔值
如果信息中心外观未返回结果,则应传送消息
要求更改
布尔值
如果自上次运行后数据发生更改,则应发生传送
发送全部结果
布尔值
将运行无限制查询并发送所有结果。
Crontab
字符串
何时运行 Vixie-Style Crontab 规范
数据组
字符串
数据组的名称;如果指定,将在数据组触发时运行(不能与 Cron 字符串配合使用)
timezone
字符串
解读指定 crontab 的时区(默认为 Looker 实例时区)
展开 SchedulePlanDestination 定义...
已安排计划的 ID
整数
您拥有的已安排方案的 ID
格式
字符串
要发送到指定目的地的数据格式。支持的格式因目的地而异,但包括:“txt”“csv”“inline_json”“json”“json_detail”“xlsx”“html”“wysiwyg_pdf”“compiled_pdf”“wysiwyg_png”
apply_formatting
布尔值
值的格式是否正确?(包含货币符号、数字分隔符等)。
apply_vis
布尔值
是否对结果应用可视化选项。
地址
字符串
收件人地址。对于电子邮件(例如“user@example.com”)。对于网络钩子,例如“https://examle.domain/path”。对于 Amazon S3,例如“s3://bucket-name/path/”。对于 SFTP,例如“sftp://host-name/path/”。
Looker_recipient
lock
布尔值
收件人是否为当前实例的 Looker 用户(仅适用于电子邮件收件人)
类型
字符串
地址类型(“email”、“webhook”、“s3”或“sftp”)
参数
字符串
包含外部调度参数的 JSON 对象。对于 Amazon S3,这需要 access_key_id 和区域的键和值。对于 SFTP,您需要提供用户名的键和值。
Secret_parameters
字符串
(只写)包含外部调度的 Secret 参数的 JSON 对象。对于 Amazon S3,这需要 secret_access_key 的键和值。对于 SFTP,这需要密码的密码键和值。
消息
字符串
要包含在定期发送的电子邮件中的可选消息
运行一次
布尔值
相关方案是否应该仅运行一次(通常用于测试)
添加链接
布尔值
此 SchedulePlan 中是否应包含返回 Looker 的链接
custom_url_base
字符串
预定实体的自定义网址域名
custom_url_params
字符串
已安排的实体的自定义网址路径和参数
show_custom_url
布尔值
是否显示自定义链接,而不是标准 Looker 链接
pdf_paper_size
字符串
PDF 应采用适合页面大小的格式。有效值为“letter”、“legal”、“tabloid”、“a0”、“a1”、“a2”、“a3”、“a4”、“a5”。
pdf_landscape
布尔值
PDF 的格式是否为横向格式
color_theme
字符串
信息中心的配色方案(如适用)
long_tables
布尔值
是否将表格展开至完整长度
inline_table_width
整数
渲染内嵌表可视化时的像素宽度
创建时间
lock
字符串
SchedulePlan 的创建日期和时间
更新时间
lock
字符串
SchedulePlan 的上次更新日期和时间
位用户
lock
此 SchedulePlan 的所有者
展开 UserPublic 定义...
可以
lock
对象
当前用户可以对此对象执行的操作
first_name(名字)
lock
字符串
名字
last_name(姓氏)
lock
字符串
姓氏
display_name
lock
字符串
要显示的全名(仅在设置了 first_name 和 last_name 的情况下可用)
头像
lock
字符串
头像图片的网址(可能是通用网址)
next_run_at [下一步运行时间]
lock
字符串
SchedulePlan 的下一次运行时间(如果运行一次,则为 null)
上次运行时间
lock
字符串
SchedulePlan 的上次运行时间
可以
lock
对象
当前用户可以对此对象执行的操作
422:验证错误
展开 ValidationErrorDetail 定义...
示例