ノードを選択して連結することによってフローを設計します。フローは特定のポリシーを実装するサービスを定義します。フローでノードを使用するには、parasoft パレットからシートにノードをドラッグします。

このセクションの内容:

Parasoft ノード

Extension Designer には、Parasoft の機能に特化したノードがあらかじめ用意されています。

Component	Component ノードは、再利用できるフロントエンドの Web コンポーネントを作成するために使用します。Component ノードと Parameters ノードは Endpoint ノードから呼び出され、フロンドエンドコンポーネントを作成するために設定する必要があります。あらかじめプログラムされたサンプルの Component ノードを Extension Designer ライブラリからインポートできます。詳細については「Extension Designer によるカスタム DTP ウィジェットの作成」を参照してください。
Parameters	Parametersノードは、再利用できるフロントエンドの Web コンポーネントを作成するために使用します。Parameters ノードと Component ノードは Endpoint から呼び出され、フロンドエンドコンポーネントを作成するために設定する必要があります。あらかじめプログラムされたサンプルの Parameters ノードを Extension Designer ライブラリからインポートできます。詳細については「Extension Designer によるカスタム DTP ウィジェットの作成」を参照してください。
Endpoint	このノードは、フルスタックな Web コンポーネントを作成するために必要なすべての機能をカプセル化するサービスエンドポイントを公開します。Endpoint ノードは Component ノードと Parameters ノードを参照します。Endpoint ノードが機能するためには、これらのノードを設定する必要があります。サービスでは、同じフローの複数のインスタンスを実装できます。ただし、フローが Endpoint ノードを含む場合、UUID が異なっていなければなりません。そうでない場合、フローの 1 番目のインスタンスだけが読み込まれます。UUID は手動で変更できます。また、UUID を削除して [UUID] フィールドを空にしてノードを再保存することもできます。 [UUID] フィールドで何も指定せずにノードを保存すると、そのインスタンス固有の UUID が新たに生成されます。以下の種類のエンドポイントを公開するよう Endpoint ノードを設定できます。 General: General エンドポイントは UI コンポーネントを持ちません。全般的なリクエスト/レスポンスシナリオ (たとえば cURL コマンドによるフローのトリガー) に使用できます。 Parameter Values: Parameter エンドポイントは、作成中のウィジェットにあるドロップダウンメニューの内容をコントロールするために使用されます。「Parameter ノードの設定」を参照してください。 Practice: Practice エンドポイントは、Policy Center Practice ウィジェットを表示するように設定された Component ノードを指します。 Report: Report エンドポイントは、ドリルダウンレポートを表示するよう設定された Component ノードとそれに関連する Parameters ノードを指します。 Widget: Widget エンドポイントは、ウィジェットを表示するよう設定された Component ノードとそれに関連する Parameters ノードを指します。
Profile Search	Profile Search ノードは、フローで使用するためにモデルプロファイルを収集します。 [Additional attributes] セクションでさらに検索パラメーターを指定して、高度な検索を実行できます。レポートスキーマに追加属性を設定している場合、追加属性に一致するキーと値のペアを検索パラメーターに追加して、個々のレポートプロファイルを探すことができます。ここで作成したキーと値のペアでは、ノードに渡される msg オブジェクトの mustache 表記の値 ( {{property}} ) を使用することもできます。
PC REST API	全般的な目的のノードであり、Policy Center REST API をリクエストします。ブラウザーで以下の URL を開くと、Policy Center REST API ドキュメントが表示され、利用できるエンドポイントについて調べることができます。 http://<HOST>:<PORT>/apidoc
DTP REST API	全般的な目的のノードであり、DTP REST API をリクエストします。DTP のエンドポイントについては「REST API」を参照してください。 DTP REST API ノードに "requesting" メッセージが表示され続ける場合があるかもしれません。エラーメッセージについては $DTP_SERVICES_HOME/logs/<service UUID>.log ファイルまたは $DTP_SERVICES_HOME/logs/main.log ファイルを確認してください。ほとんどの場合、この問題は膨大なペイロードをサービスが DTP REST API に送ろうとすることで発生します。ペイロードを削減または分割して、複数の接続を行ってデータをポストしてください。
DTP Server Info	このノードは、Extension Designer の構成ページで設定されている DTP Server の情報を収集します (「DTP Enterprise Pack の設定」を参照)。
DTP Store Metrics	このノードを使用すると、新しいメトリクスタイプを定義し、新しいメトリクスの結果を DTP に送信してカスタムメトリクスを保管できます。
Get User	このノードは DTP ユーザー情報を取得します。
Database	このノードを使用すると、Enterprise Pack データベースとやり取りできます。このノードを使用して、フローの実行とサービスの再開をまたがってデータを保持することができます。
Event In	このノードは、Extension Designer のイベントブローカーから MQTT イベントをサブスクライブするために使用します。
Event Out	このノードは Extension Designer イベントをパブリッシュします。
Mail	このノードは、Extension Designer の [構成] タブで定義された SMTP メールサーバーを使って電子メールを送信できます。「DTP Enterprise Pack の設定」を参照してください。
i18n	このノードはローカライズ情報を格納します。

function ノード

function ノードは Parasoft 固有のノードではありませんが、Extension Designer のほとんどすべてのフローで重要な役割を果たします。function ノードに JavaScript を追加して、独自のロジックを作成できます。function ノードは function パレットにあります。

function ノードには有用なライブラリがあらかじめ用意されています。

lodash

function ノードに以下の行を追加すると、lodash を初期化してその機能を利用できます。

var _ = context.global.lodash;

lodash ユーティリティライブラリの詳細については https://lodash.com/docs を参照してください。

moment

moment ユーティリティライブラリは、フローの中で日付と時刻を操作するために使用します。function ノードに以下の行を追加すると、moment を初期化してその機能を利用できます。

var moment = context.glboal.moment;

moment ユーティリティライブラリの詳細については https://momentjs.com/docs/moment を参照してください。

os

node.js のこのモジュールは、OS 固有の情報を検出します。function ノードに以下の行を追加すると、os を初期化してその機能を利用できます。

var os = context.global.os;

os ユーティリティライブラリの詳細については https://nodejs.org/api/os.html を参照してください。

function ノードの詳細については、以下のリンク先の情報を参照してください。https://nodered.org/docs/writing-functions

ノードマーカー

入力ノード		ノードは左から右にデータを処理します。左側にある白い四角形は、そのノードがメッセージオブジェクトから入力を受け取ることができることを表します。ノードの説明に、期待される入力 "msg" 形式についての記述が表示されます。
出力ノード		右側にある白い四角形は、そのノードがペイロードデータを出力できることを表します。右側にアイコンが複数ある場合、複数のデータセットをノードが出力できることを意味します。
入力と出力の両方があるノード		左と右の両方に四角形がある場合、そのノードはメッセージオブジェクトを受け取り、ペイロードデータを出力できます。期待される入力と出力の詳細については、各ノードのオンラインドキュメントを参照してください (ノードを選択し、[処理ノードの仕様] タブで説明を参照します)。
設定が足りないノード		赤い三角形は、すべての必須フィールドが適切に設定されていないことを表します。ノードをダブルクリックすると、どのフィールドでさらに設定が必要かが分かります (該当するフィールドは赤い枠で強調されます)。適切にノードを更新してください。
保存されていないノード		青い丸は、ノードがまだサーバーに保存されていないことを表します。青い丸のノードがある場合、[デプロイ] ボタンがアクティブになります。

ノードの編集

ノードを編集するには、ノードをダブルクリックし、表示されたダイアログでコントロールを使って必要な設定を行います。ノードの機能によって、編集コントロールが異なります。

[処理ノードの仕様] タブに、ノードについての説明が表示されます。多くのノードには必須フィールドがあります。まだ設定していない必須フィールドは赤で強調されます。必須フィールドをすべて設定していない状態でノードを保存すると、ノードに赤い三角形が表示されます。

mustache 表記

function ノード、REST API ノード、および他のノードでは、「mustache」と呼ばれる二重の中括弧 ( {{ }} ) を使ってメッセージ変数を表すことができます。

例

以下のコードをノードに追加した場合:

Hello {{name}}.Today is {{date}}

以下のメッセージが受信されます。

{
	name: "Fred",
	date: "Monday"
	payload: ...
}

ペイロードは以下のようになります。

Hello Fred.Today is Monday

また、一部のノードは 3 重の mustache 表記を使用することもあります。これは、エスケープされない HTML を表現するために使用されます。たとえば: {{{something}}}

入力/出力フィールド

多くのノードには入力フィールドと出力フィールドがあります。入力/出力フィールドには常に接頭辞として "msg." が付きます。この接頭辞は、(フィールドの目的によって) 入力または出力として使用される msg オブジェクトのプロパティを設定するためにフィールドが使用されることを表します。

入力および出力プロパティを持つ最も一般的なノードとして、たとえば DTP REST API ノードがあります。

GET メソッドを選択すると、DTP REST API ノードは [Response] フィールドだけを提供します。この [Response] フィールドは、API からのレスポンスが書き込まれる "msg" オブジェクトのプロパティを定義するために使用します。出力プロパティを定義するための手法が提供されているため、さまざまなリソースからのデータの管理が簡略化されます。追加データを取得するためにデータを移動したり再構成したりする function ノードをさらに追加する必要はありません。

デプロイされたスライスでの不明ノードの対応

不明のノードまたは認識されないノードがあると、デプロイしたフローが適切に機能しません。この状況が発生するのは、たとえば、インストールするアーティファクトが、インストールされいないアーティファクトに依存する場合などです。

デプロイしたスライスに不明のノードまたは認識されないノードがある場合、以下のいずれかの操作を行います。

PIE Slice Designer からそのスライスを削除します。
不明ノードがあるアーティファクトをインストール/再インストールします。

この操作による変更を有効にするには、サービスを再開します。新しいノードは、サービスを開始したときに初めて認識されます。

ベストプラクティスとして、アーティファクトマネージャーからアーティファクトをアンインストールする際は、アーティファクトの削除によって破損するスライスも必ず削除してください。

Page tree

ノードの使用