JavaScriptの基本

Oracle Clinical One Platformでルールを使用する前に、JavaScriptについて基本的な理解が必要です。高度なプログラミング・スキルは必要ありませんが、JavaScriptの関数と変数を理解することは成功に不可欠です。

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

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

JavaScript関数

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

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

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

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

JavaScript変数

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

注意:

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

ルール検証

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

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

注意:

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