49.5. 外部コンポーネント
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 は components ディレクトリーの manifest.json ファイルをチェックします。manifest.json には、1 つ以上の name テキストパラメーターが含まれている必要があります。
表49.3 manifest.json ファイルの説明
| パラメーター | 説明 |
|---|---|
|
| Components セクションに表示されるコンポーネントの名前。 |
|
| Components セクションに表示されるコンポーネントのアイコン。 |
|
| コンポーネントがデータセットを必要としないことを示すフラグ。 |
|
|
パラメーターの一覧は |
manifest.json ファイルのサンプル
{
"name": "Heat Map Experiment",
"icon": "fa fa-bell-o",
"parameters": [
{
"name": "svg",
"type": "text",
"defaultValue": "",
"label": "SVG XML",
"category": "SVG Content"
},
{
"name": "svgUrl",
"type": "text",
"defaultValue": "",
"label": "SVG URL",
"category": "SVG URL"
}
,
{
"name": "ksProcessId",
"type": "text",
"defaultValue": "",
"label": "Process ID",
"category": "Kie Server"
}
]
}
49.5.1. 外部コンポーネントの作成
以下の手順では、外部コンポーネントを作成してページに追加する方法を説明します。
手順
コンポーネントディレクトリーの下のコンポーネントを親ディレクトリーとともに設定します。
たとえば、コンポーネント 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=trueBusiness Central で、Menu → Design → Pages に移動します。
外部コンポーネント は、Components ペインで利用できます。
- Components ペインで、External Components を展開し、必要なコンポーネントタイプをエディターのキャンバスにドラッグします。
- Save をクリックします。