除了公开嵌入之外,您还可以私下嵌入 Looks、探索和信息中心,因此必须使用 Looker 登录机制、Google OAuth 或 OpenID Connect 进行身份验证。如果用户未通过身份验证,您可以选择显示错误消息或显示登录屏幕。
登录和访问私密嵌入内容的用户需要遵守会话 管理面板中的设置,这些设置可决定他们能保持登录状态的时间、用户能否通过多个浏览器登录,以及是否可在一段时间后退出。
如果您需要更高级或可自定义的嵌入解决方案,请查看我们的单点登录 (SSO) 嵌入文档页面。
生成嵌入网址
如需为信息中心、Look 或“探索”可视化图表生成并复制嵌入网址,请从信息中心的三点状菜单中选择获取嵌入网址,或者从探索或Look 界面上“探索”操作齿轮图标。Looker 会显示获取嵌入网址窗口。
获取嵌入网址窗口包含以下元素:
- 嵌入网址字段显示完整的私有嵌入网址。
- 在将主题背景应用于信息中心网址字段,如果您要生成信息中心或“探索”嵌入网址并且您的实例启用了自定义主题背景,则可以选择要添加到嵌入网址的主题。在查看嵌入的信息中心或“探索”时,系统将会应用该主题。
- 通过在网址中包含当前参数开关,您可以选择是否将当前参数(例如过滤器值)应用于嵌入网址。如果启用这些参数,系统会在查看嵌入内容时应用这些参数。
- 点击复制链接按钮,将完整的嵌入网址复制到剪贴板。
生成并复制嵌入网址后,您可以将该网址粘贴到新的浏览器窗口或标签页中,预览嵌入的内容。您还可以使用此网址在 iframe 中嵌入内容。
预览嵌入的内容
将您的嵌入网址粘贴到浏览器中,以预览嵌入内容的行为和外观。
在 iframe 中查看嵌入的内容
将嵌入网址放到 iframe 中。例如:
<iframe
src="https://instance_name.cloud.looker.com/embed/dashboards/1"
width="1000"
height="2000"
frameborder="0">
</iframe>
然后,根据需要嵌入 iframe。
更改信息中心的嵌入式外观
查看网址中包含 /embed
的信息中心会显示该信息中心嵌入时的显示方式。
默认情况下,嵌入式面板会使用 Looker 实例的默认主题背景来显示。您可以通过多种方式更改嵌入式信息中心的外观,具体取决于您使用的信息中心类型:
- 对于任何类型的信息中心,您都可以在嵌入网址中指定其他主题背景名称,以更改用于显示信息中心的主题。
- 对于任何类型的信息中心,您都可以使用
_theme
网址参数来更改各个信息中心的主题元素。 - 对于 LookML 信息中心,您还可以通过
embed_style
参数修改信息中心的嵌入外观。
使用 theme
网址参数、修改嵌入设置选项或 embed_style
参数时,系统只会对应用该参数、选项或参数的信息中心进行更改。如果您想自定义多个嵌入式信息中心的外观,请改用主题。
部分显示设置会覆盖其他显示设置。如需了解详情,请参阅为嵌入式信息中心和“探索”创建和应用主题文档页面。
为私密嵌入启用登录屏幕
如果您想向尚未登录的用户显示登录屏幕,可以将参数 allow_login_screen=true
添加到您的嵌入网址。例如:
<iframe src="https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
^^^^^^^^^^^^^^^^^^^^^^^
如果您不添加此参数,系统就会向尚未登录的用户显示 401 错误。