为 Looker Marketplace 开发自定义可视化

本页介绍了如何创建可添加到 Looker Marketplace 并供其他 Looker 用户访问的自定义可视化图表类型。您还可以直接在项目中创建自定义可视化图表，而无需将其提供给其他 Looker 客户。

请注意，您必须是 Looker 合作伙伴网络的成员或 Looker 客户，才能向 Looker Marketplace 提交内容。

Looker Marketplace 是可用于查找、部署和管理多种类型的 Looker 内容（例如 Looker Blocks™、应用、可视化图表和其他插件）的中心位置。

启用 Looker Marketplace 功能后，Looker 客户可以安装 Looker Marketplace 插件，其中包括要添加到 Looker 的原生可视化库的可视化图表类型。

如需开发自定义可视化图表并通过 Looker Marketplace 将其提供给所有 Looker 客户，请按以下步骤操作：

  1. 开发可视化图表。
  2. 为可视化创建 Looker 项目。
  3. 将 Looker 项目推送到 Git 代码库。
  4. 测试可视化图表的功能。
  5. 将您的可视化图表提交到 Looker。

开发可视化类型

确定您要开发的可视化图表类型。（确认此可视化图表尚未在市场中列出，也未作为原生 Looker 可视化图表列出。）

使用 JavaScript 环境中的 Looker Visualization API 在 JavaScript 中开发自定义可视化图表。

为可视化创建 Looker 项目

创建一个 Looker 项目来表示您的自定义可视化图表。该项目应包含以下文件：

  • LICENSE 文件：使用以下文本列出用于分发可视化图表的许可：

    This Looker visualization is distributed with the following license:...

  • README.md 文件：提供可视化图表的说明、运作方式和任何其他信息。

  • JavaScript (.js) 文件：包含您用于生成可视化图表的 JavaScript 代码的浓缩版本。借助 Marketplace，JS 文件会包含在项目中，以便进行适当的版本控制和软件包管理。

  • 清单 (manifest.lkml) 文件：指定 id（唯一标识符）和 label（此可视化图表的 Looker 界面中显示）。例如：

    constant: vis_id {
        value: "default_id"
        export: override_optional
    }
    constant: vis_label {
        value: "default_label"
        export: override_optional
    }
    visualization: {
        id: "@{vis_id}"
        label: "@{vis_label}"
        file: "my_local.js"
        sri_hash: "my_sri_hash"
        dependencies: []
    }
  • 商品详情 (marketplace.json) 文件：用于为自定义可视化配置 Marketplace 商品详情，并包含用于说明可视化在 Marketplace 中的显示方式的标签、image_uri 的位置、用于说明可视化用例的标语，还定义了用户在安装过程中输入的 Marketplace 字段常量。例如：
{
  "label": "Gauge Visualization",
  "category_label": "plug-ins",
  "branding": {
    "image_uri": "https://marketplace-api.looker.com/visualization-screenshots/gauge_icon.png",
    "tagline": "Use the Gauge visualization to display a measure and progress to a goal."
  },
   "constants": {
        "vis_label": {
            "label": "Visualization Label",
            "description": "This label will appear in the visualization selector in the Looker Explore UI."
        },
        "vis_id": {
            "label": "Visualization Id",
            "description": "This must be a unique ID across all visualizations.",
            "value_constraint": "visualization"
        }
    }
}

将项目推送到 Git

将可视化图表 LookML 托管在可公开访问的 GitHub 代码库中。假设您是在 Looker 项目中创建的此可视化图表，请按以下步骤将其推送到新的代码库：

  1. 创建一个公开可访问的 GitHub 代码库。
  2. 将 Looker 项目的代码库网址设置为 GitHub 代码库的网址。
  3. 按照 Looker 中的 Git 提示验证、提交代码并将其部署到生产环境。

测试可视化功能

将新可视化图表应用于 Looker 实例中的相应探索或数据分析，以便对其进行测试：

  1. 前往相应 Look 或“探索”。
  2. 如果您当前处于某个外观页面，请点击修改以修改该外观。
  3. 点击“可视化图表类型”菜单中的三点状菜单，打开可视化图表下拉列表。
  4. 选择您的自定义可视化图表。
  5. 点击保存以保存对外观的更改。请注意可能受此次变更影响的所有信息中心。

Looker 要求在 Looker Marketplace 中提供的可视化图表中使用以下函数：

函数 必填
支持深入挖掘可视化内容 是
能够继承 Looker 的调色板 是
对浏览器和屏幕尺寸的响应能力 是
一致的字体系列：font-family：Helvetica、Arial、sans-serif 是
字体大小 是
能够在可视化图表配置面板中切换值标签和轴标签 是
对汇总数据进行可视化 是（如果适用）
使用 updateAsync 函数或 is update function 基于用户互动情况更新可视化 是
清晰的错误消息（例如，此可视化图表需要 1 个维度和 2 项指标） 是
可视化图表配置面板中的所有选项都会对可视化图表产生明显变化 是
默认使用字段的 value 格式 是（如适用）
查询返回无结果时会抛出错误 是

提交可视化内容以供审核

当可视化内容可以提交后，请按照向 Looker Marketplace 提交内容中的说明为可视化内容创建证明文件，将可视化内容提交给 Looker 团队以供审核，并将可视化内容发布到 Looker Marketplace。