アナリティクス スクリプト
スクリプトは Analytics でのみ実行されるように制限されていません。 標準のスクリプトは、アナリティクス スクリプトに変換すると、HighBond プラットフォーム上のロボット アプリまたは Analytics Exchange でスケジュールおよび実行できるようになります。 アナリティクス スクリプトは、ACL の独立型コンポーネントである［分析アプリ］ウィンドウで実行します。
アナリティクス スクリプトとは
アナリティクス スクリプトまたは「アナリティクス」は、アナリティクス ヘッダーを持つ標準のスクリプトです。 アナリティクス ヘッダーは、ロボットで、AX Server や分析アプリ ウィンドウでスクリプトの実行を可能にする一連の宣言タグです。 アナリティクス ヘッダーには、即時、または予定時刻のいずれかに、無人でのアナリティクス スクリプトの実行を可能にする、ユーザーが事前に設定する入力パラメーターが含まれます。
ヒント
アナリティクス スクリプトは、より容易に開発を行える環境がサポートされる Analytics で開発およびテストされるのが普通です。 AX Client を使用し、AX Server に保管されている既存のアナリティクス スクリプトに簡単なアップグレードを行います。
分析アプリとは
分析アプリは Analytics プロジェクトであり、Analytics Exchange または分析アプリ ウィンドウで使用するパッケージです。 分析アプリには、1 つまたは複数のアナリティクスのスクリプトや、データ テーブルと解釈も搭載されています。
メモ
分析アプリは通常、組織の社内スクリプトの専門家によって、または Galvanize コンサルタントとの取り決めによって、作成されるか開発されます。
標準のスクリプトをアナリティクス スクリプトに変換する
アナリティクス スクリプトは標準のスクリプトとして作成を開始します。 標準のスクリプトを AX Server のロボット、または分析アプリ ウィンドウで実行するには、それをアナリティクス スクリプトに変換する必要があります。
- Analytics でスクリプトを作成してテストします。
- 該当するアナリティクス ヘッダー タブを追加し、スクリプトをアナリティクス スクリプトにします。
- アナリティクス スクリプトを AX Server または分析アプリ ウィンドウで実行できるようにパッケージ化します。 ロボットでは、アナリティクス スクリプトを実行できるようにパッケージ化することはできません。
詳細については、アナリティクス スクリプトの開発を参照してください。
アナリティクス ヘッダーの追加
アナリティクス ヘッダーは、スクリプトの先頭行から始まるコメント ブロック内で定義されます。 スクリプトがアナリティクス スクリプトであることをアナリティクス ヘッダーに宣言することが、最低限必要です。
COMMENT //ANALYTIC 欠落している小切手の識別 このアナリティクス スクリプトは、欠落している小切手番号を検出します。 END
詳細については、アナリティクス ヘッダーを使った作業を参照してください。
補助スクリプトの概要
補助スクリプトは、アナリティクス スクリプトと連動するように設計されている、アナリティクス ヘッダーがない標準のスクリプトです。 一般的な設計では、アナリティクス スクリプトは DO SCRIPT コマンドを使用して、1 つ以上の補助スクリプトを呼び出します。 補助スクリプトが完了すると、処理は実行し続けるアナリティクス スクリプトに戻ります。
補助スクリプトはサブスクリプト、セカンダリスクリプト、ユーティリティ スクリプト、ヘルパー スクリプトとも呼ばれます。 補助スクリプトの使用は必須ではありません。 補助スクリプトでは、条件付き、再利用可能、または親アナリティクス スクリプトを含めるために拡張できるスクリプト ロジックのブロックを区分することができます。
補助スクリプトの制限
補助スクリプトはさまざまな方法で使用できますが、アナリティクス ヘッダーは存在しないため、次の 2 つの制限事項が適用されます。
- 入出力タグがない 入出力アナリティクス タグを指定できません。このため、補助スクリプト自体では、入出力パラメーターを作成できません。 必要なパラメーターはすべて、親アナリティクス スクリプトのアナリティクス ヘッダーで作成する必要があります。
- 直接実行できない ユーザーは補助スクリプトを直接スケジュールまたは実行できません。 直接呼び出すか、別の補助スクリプトから間接的に呼び出すかには関係なく、補助スクリプトはアナリティクス スクリプトからのみ呼び出すことができます。
アナリティクス スクリプトの配布と実行
組織で使用される Galvanize 製品およびコンポーネントによっては、アナリティクス スクリプトを配布および実行するには、複数のオプションがあります。
| アプリ/製品/コンポーネント | アナリティクス スクリプトを配布、実行する方法 |
|---|---|
| ロボット |
|
| AX Server |
これらのモジュールのいずれか：
|
| 分析アプリ ウィンドウ |
|
アナリティクス スクリプトを実行する環境の判別
スクリプトを、Analytics、Analytics Exchange または分析アプリ ウィンドウで実行できるアナリティクス スクリプトを作成するには、スクリプト実行時にランタイム環境を判別する必要があります。 この情報を使用することで、スクリプトが実行される場所に応じてどのコマンドを実行すべきかを決定できます。
スクリプトが実行される場所を判定するには、FTYPE( ) 関数を使用します。
FTYPE("ax_main") = "b"
スクリプトが Analytics Exchange または分析アプリ ウィンドウで実行される場合には、この式は true（T）として評価されます。 Analytics で実行されるスクリプトの場合には、この式は false（F）として評価されます。 詳細については、FTYPE( ) 関数を参照してください。
AX Server でスクリプトを実行しているユーザーの識別
AX Server でアナリティクス スクリプトを実行する場合、システム変数 AXRunByUser を使って、同じスクリプトを現在実行しているユーザーの名前（形式：<ドメイン>\<ユーザー名>）を指定することができます。
EXTRACT FIELDS TIME() AS "時刻", DATE() AS "日付", AXRunByUser AS "現在のユーザー" TO R_RunRecord APPEND
メモ
AXRunByUser は、アナリティクス スクリプトを AX Server で実行しているときにのみ使用できます。 この変数は、Analytics でスクリプトを実行しているときには認識されません。
