JavaScriptの基本

Oracle Clinical One Platformでルールを使用する前に、JavaScriptの基本を理解しておく必要があります。高度なプログラミング・スキルは必要ありませんが、JavaScriptの関数と変数の理解は成功のために重要です。

JavaScriptは、Web開発で最もよく使用される、広く使用されているプログラミング言語です。この言語は学習しやすく、基本的な表現とより複雑なロジックを持つ言語の両方を開発するために使用できます。この言語を使用して、Oracle Clinical One Platformでカスタム・ルールを作成します。ルール式内で、JavaScript関数(コードのブロック)および提供されたヘルパー関数を変数、定数、演算子および様々なメソッドとともに呼び出して、特定のタスクを実行できます。

JavaScriptの基本を理解することは、このドキュメントの範囲外です。JavaScriptの概念と基本的なプログラミング方法を理解するのに役立つ、Web (W3schoolsなど)には多くの優れたリソースがあります。

JavaScript関数

関数は、特定のタスクを実行するように設計されたコードのブロックです。ルールの関数を使用して、様々なタスクを実行できます。ルールを記述する場合は、ルール・インタフェースからこれらの関数を呼び出します。Oracle Clinical One Platformの一部として提供されるネイティブJavaScript関数または特別なヘルパー関数を使用できます。

  • ネイティブJavaScript関数は、標準のJavaScriptプログラミングに含まれる関数です。これらの関数は、Oracle Clinical One Platformに固有ではなく、JavaScriptプログラマに精通しています。パラメータを使用してコードを起動でき、記述するコードのブロックがルール式内で表示されます。

    ルールをプログラミングする前に、Oracle Clinical One PlatformでJavasScriptを使用するための制限および使用上の注意事項を理解してください。ガイダンスについては、Javascriptの使用に関するヒントを参照してください。

  • Oracleヘルパー関数も特定のパラメータを使用して呼び出され、ヘルパー関数によって値が返されます。ヘルパー関数の戻り値はルール式で使用でき、ルールのロジックでこの値を使用してアクションを実行できます。ただし、これらの関数内のコードはルール・インタフェースでは表示されません。各関数の詳細は、ルール・ヘルパー関数のリファレンスを参照してください。

JavaScript変数

JavaScript関数を操作する場合は、変数を使用してデータを渡します。変数は、ルールで使用する値を保持するために使用される単なるコンテナです。ルールの一部として変数を宣言および定義する必要があります。

ノート:

ルールを記述する場合は、フォームに入力されたデータから直接取得した値を保持する変数と、コード内に生成された値を格納するためにルール・コード内に作成できる変数という2つのタイプの変数を考慮する必要があります。フォーム変数はルール・エディタの上部で定義され、フォーム値によって移入されます。コードで使用される変数は、コード自体で定義されます。

ルール検証

ルール・インタフェースは、ルール・コードを追加するための簡単な方法を提供し、構文検証を含みます。ただし、ルールで使用されている構文が有効なJavaScriptであることを確認するために、この検証が使用されることに注意してください(つまり、閉じカッコや必須セミコロンを忘れたなどのコーディング・エラーは発生していません)。

ルールに必要なロジックを理解および定義することは、JavaScriptの知識のレベルにかかわらず、難しいプロセスです。ルール・ロジックの検証はシステムによって提供されないため、ルールを検証し、ルールが期待どおりに機能していることを確認することが重要です。ルール・ロジックの作成を支援するために、ヘルパー関数参照の一部として多数の例とルール例のライブラリを提供します。これらの例を見ると、複雑なタスクのJavaScriptルール式を記述するときに使用するロジックおよび関数をよりよく理解できます。これらの例は、独自のカスタム・コードのベースとしても使用できます。これにより、開発時間を大幅に短縮できます。

ノート:

ルール検証は、本番にデプロイする前に、必ずテスト・モードで行う必要があります。実行時に必ずルールの動作を確認する必要があります。