55.6. 外部组件
在 Business Central 中,您可以在页面中添加外部组件。组件默认是禁用的。要启用外部组件,请将 dashbuilder.components.enable 系统属性的值更改为 true。
外部组件位置设置并使用 dashbuilder.components.dir 系统属性进行配置。此系统属性的默认值为 /tmp/dashbuilder/components。您必须使用父目录(用作组件 ID)在 components 目录下设置组件。例如,如果组件 ID 是 mycomp,并且组件目录为 /tmp/dashbuilder/components,则组件基础目录为 /tmp/dashbuilder/components/mycomp。
Business Central 检查组件目录中的 manifest.json 文件。manifest.json 必须至少包含一个 名称 文本参数。
表 55.3. manifest.json 文件描述
| 参数 | 描述 |
|---|---|
|
| 组件部分下显示的 组件名称。 |
|
| 组件部分下显示 的组件 图标。 |
|
| 表示组件不需要数据集的标记。 |
|
|
参数列表使用 |
manifest.json 文件示例
{
"name": "Heat Map Experiment",
"icon": "fa fa-bell-o",
"parameters": [
{
"name": "svg",
"type": "text",
"defaultValue": "",
"label": "SVG XML",
"category": "SVG Content"
"mandatory": true
},
{
"name": "svgUrl",
"type": "text",
"defaultValue": "",
"label": "SVG URL",
"category": "SVG URL"
"mandatory": true
}
,
{
"name": "ksProcessId",
"type": "text",
"defaultValue": "",
"label": "Process ID",
"category": "Kie Server"
"mandatory": true
}
]
}
55.6.1. 创建外部组件
以下流程描述了如何在页面中创建和添加外部组件:
流程
使用父目录在 components 目录下设置组件。
例如,如果组件 ID 是
mycomp,并且组件目录为/tmp/dashbuilder/components,则组件基础目录为/tmp/dashbuilder/components/mycomp。-
在组件目录中创建
manifest.json文件。 -
使用 HTML 内容创建
index.html文件。 -
在终端应用中,导航到
EAP_HOME/bin。 要启用外部组件,请将
dashbuilder.components.enable系统属性的值设置为true:$ ~/EAP_HOME/bin/standalone.sh -c standalone-full.xml -Ddashbuilder.components.dir={component directory base path} -Ddashbuilder.components.enable=true启动 Business Central,进入 Menu → Design → Pages。
外部组件在组件 窗格中 可用。
- 在 Components 窗格中,展开 External 组件,并将所需的组件类型拖到 canvas。
- 点击 Save。