- 追加された行はこの色です。
- 削除された行はこの色です。
RIGHT:[[目次>Hestia Hacks#SDKDevDuide]]|[[前>EISサンプル実装]]|[[次>チューニング]]
#freeze
RIGHT:[[目次>Hestia Hacks#SDKDevDuide]]|[[前>EISサンプル実装]]|[[次>サンプルスクリプト]]
随時更新予定
#contents
*概要 [#hcdescription]
Hestia Commanderはパートナー情報等のマネージメント機能に加えて、簡易EIS機能を持っています。以下にコンポーネントの関連概念図を示します。
#ref(hcfigure.png)
上図の通り、Hestia Commanderは Hestia SDK上に構築されており、SessionコンポーネントとScriptコンポーネントで構成されています。開発者は、Scriptコンポーネント上に独自のスクリプトを作成することによりプライベートプロセスを実装することができます。
開発者が作成するスクリプトでは、Sessionオブジェクトを扱う高水準関数を利用することが前提となっています。
*スクリプト実装 [#a0186adc]
ScriptコンポーネントはJBoss上のMBeanServerとして実装されています。開発者が作成するスクリプトは、サーバ上で継続的に動作するサーバコンポーネントとしても、シーケンシャル処理を一回処理して終了するような単独プログラムとしても動作することができます。
**スクリプトデプロイ [#u502b84a]
スクリプトの実体ファイルはデータベース上に格納されます。ディベロッパは、HestiaCommanderの''スクリプト編集''メニューからソースコードをインストールする必要があります。
**スクリプト状態遷移 [#m118d29b]
スクリプトは以下の3状態のいづれかのステータスを持ちます。
|状態|内容|h
|SessionState.STATE_ACTIVE|スクリプトがアクティブ状態であることを示します。スクリプトが明示的に終了するか異常終了しない限り、スクリプトはSTATE_ACTIVE状態をとり続け、定期的に再実行されます|
|SessionState.STATE_FINISH|スクリプトが正常終了した状態であることを示します|
|SessionState.STATE_ERROR|スクリプトの処理中に例外が発生し異常終了した状態であることを示します|
**変数 [#val]
外部よりスクリプトに渡すことのできる変数は、グローバル変数とスクリプト変数の2種類があります。グローバル変数はスクリプト起動時にScriptコンポーネントから前もって渡されるインスタンスで、スクリプト変数はカタログファイルによって定義され、ブラウザ画面から渡される変数です。
***グローバル変数 [#globalval]
|変数名|対応オブジェクト|概要|h
|svm|[[com.ados.hestia.scripts.ScriptSession:http://wiki.a-dos.com/hestiaapi/apidocs/com/ados/hestia/scripts/ScriptSession.html]]|スクリプト起動時にインスタンス化されるスクリプト自身のオブジェクトです。スクリプト自身の状態管理などを行います|
|sapi|[[com.ados.hestia.scripts.ScriptAPI:http://wiki.a-dos.com/hestiaapi/apidocs/com/ados/hestia/scripts/ScriptAPI.html]]|ScriptAPIはSessionオブジェクトを利用するための[[SessionProcessor:http://wiki.a-dos.com/hestiaapi/apidocs/com/ados/hestia/sdk/session/SessionProcessor.html]]オブジェクト取得、その他ユーティリティ機能を提供します。|
***スクリプト変数 [#scriptval]
HestiaCommanderのスクリプトソース変数画面からスクリプトへ渡す変数を定義できます。
以下に変数の概要を記します。
|フィールド名|説明|h
|Name|変数名。スクリプト側からは当変数名をもって参照します。|
|Description|変数の説明。スクリプト起動画面に表示されます。|
|Optional|必須定義。Yesを指定した場合、スクリプト起動時に当変数を省略することはできません。|
|Type|変数の型。Text List Binary Integerが指定可能です。|
|List of Values|定義済変数値リスト。:(セミコロン)で区切り複数値を設定することができます|
Jythonの文法では変数宣言時の明示的な型宣言はありませんが、スクリプト起動画面から指定された各型は以下のように変換されスクリプトに渡されます。
|カタログ定義型|スクリプト変数型|備考|h
|text|String||
|integer|int||
|binary|[[IStore:http://wiki.a-dos.com/hestiaapi/apidocs/com/ados/hestia/utils/io/IStore.html]]|IStoreはHestia SDKに含まれるストリームを含む抽象インターフェースです。スクリプトはIStoreからストリームを取り出して処理を行います|
![[ADOS]](ados/images/adostoplogo.gif "[ADOS]")
