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 は components ディレクトリーの manifest.json
ファイルをチェックします。manifest.json
には、1 つ以上の name
テキストパラメーターが含まれている必要があります。
パラメーター | 説明 |
---|---|
| 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" "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. 外部コンポーネントの作成
以下の手順では、外部コンポーネントを作成してページに追加する方法を説明します。
手順
コンポーネントディレクトリーの下のコンポーネントを親ディレクトリーとともに設定します。
たとえば、コンポーネント 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 ペインで利用できます。
- Components ペインで、External Components をデプロイメントし、必要なコンポーネントタイプをエディターのキャンバスにドラッグします。
- Save をクリックします。