--- sourceDocument: Yokohama データと自動化 sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/yokohama/integrate-applications Release : - yokohama ft:locale : - ja-JP ft:publication_title : - Yokohama データと自動化 ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # JavaScript プローブアクティビティを作成する # JavaScript プローブアクティビティを作成する {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分 MID サーバーにサーバー側の JavaScript を実行するよう指示するために JavaScript プローブアクティビティを作成します。 ## 始める前に 必要なロール：activity_creator または workflow_admin ## このタスクについて JavascriptProbe アクティビティには、標準 Java ライブラリーに対する「パッケージ」コールと同じ機能があります。これにより、MID サーバー上の Java ライブラリーをより詳細に制御することができます。独自の JAR ファイルを MID サーバーにロードして、JavascriptProbe がそれらの Java ファイルに対するパッケージ コールを行うようにすることができます。 ## 手順 1. [カスタムアクティビティ](https://servicenow-prod.fluidtopics.net/edsmpnP6ixAb8otUf3QAfg "カスタム テンプレートを使用して、ワークフローエディターでさまざまなタイプのカスタムアクティビティを作成および更新できます。")を作成します。 このアクションにより、テンプレートを使用してカスタムアクティビティが作成されます。 2. [general properties](https://servicenow-prod.fluidtopics.net/sGlDz~awf9LAqxmmckTzIA "次の一般プロパティ フィールドは、すべてのアクティビティデザイナーテンプレートに共通です。") をセットアップして[入力変数を作成](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#CreateInputVariables "アクティビティデザイナーの [入力] フォームで、アクティビティに渡す変数を作成します。")した後で、JavaScript プローブアクティビティ実行コマンドを設定します。 | オプション | 説明 | | [入力変数をマップする](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#t_MapAnInputVariable "入力変数を作成した後、[実行コマンド] フォームのフィールドにその入力変数をマップします。") | 作成した変数を使用して、オーケストレーションが MID サーバー上で実行するコマンドを設定します。 | | スクリプトタイプ | 含めるスクリプトのタイプを選択します。使用可能なオプションは次のとおりです。 * カスタム JavaScript * MID サーバースクリプトの内容 {#t_CreateAJavaScriptProbeActivity__ul_klf_3tp_vz} | | スクリプト | このプローブで実行するカスタム JavaScript。 注: このフィールドは、選択されている \[スクリプト タイプ\] が \[カスタム JavaScript\] である場合に使用可能です。 | | MID サーバースクリプトの内容 | このプローブで実行する MID サーバーのスクリプト。 注: このフィールドは、選択されている \[スクリプト タイプ\] が \[MID サーバースクリプトの内容\] である場合に使用可能です。 | | ホスト別に MID サーバーを選択 | プローブが動作する MID サーバー。 | | 必要な MID サーバー機能 | 使用する MID サーバー (機能別)。 | | パラメーター | このプローブでホストに渡す名前と値のペア。これらのパラメーターは手動で作成することも、入力変数を \[パラメーター\] フィールドにドラッグして値を割り当てることもできます。 | |-|-| {#t_CreateAJavaScriptProbeActivity__choicetable_jlf_3tp_vz} 注: テストペイロードのパラメーター値を、\[出力\] タブの変数に自動的にマッピングできます。「[出力変数を自動マッピングする](https://servicenow-prod.fluidtopics.net/H5szOU~CdbJIOFsdYZzNdQ "テストペイロードのパラメーター値を、[出力] タブの変数に自動的にマッピングできます。")」を参照してください。 ## 次のタスク [出力変数を作成する](https://servicenow-prod.fluidtopics.net/8VMx5hDk1zBhXX8PdOseTQ#t_CreateAnOutputVariable "デザイナーの [出力] フォームには、オブジェクトとアレイのデータ構造を作成するための変数ビルダが含まれています。")、[解析ルールを作成する](https://servicenow-prod.fluidtopics.net/WcjbpLvpo7gVqPKWISlRNQ#t_CreateAParsingRule "カスタムアクティビティで定義された出力変数に、外部ホストまたはエンドポイントでの入力テストから返されたペイロード データを取り込みます。")、または[条件を作成する](https://servicenow-prod.fluidtopics.net/TdEXOwxWFmRAJGRDePSAoA "アクティビティの終了条件を [条件] 列に作成し、それぞれの順序を設定します。")のいずれかを行って、JavaScript プローブアクティビティの作成を終了します。テンプレート オプションの詳細については、「[カスタムアクティビティを作成する](https://servicenow-prod.fluidtopics.net/edsmpnP6ixAb8otUf3QAfg "カスタム テンプレートを使用して、ワークフローエディターでさまざまなタイプのカスタムアクティビティを作成および更新できます。")」のトピックを参照してください。 ## JavaScript プローブ テンプレートの実行パラメーター {#ariaid-title2} 実行パラメーターを使用して、アクティビティデザイナーの \[前処理\] フォームで入力プロセス スクリプトを作成します。 JavaScript プローブ コマンド フィールドの説明については、「[JavaScript プローブ実行コマンドを設定する](https://servicenow-prod.fluidtopics.net/NFltXS0dbzxVlvYjtYfiPg#t_MapJavaScriptVarsToExecutionComm "作成した入力変数を使用して、オーケストレーションが JavaScript プローブのターゲット ホストで実行するコマンドを設定します。")」の表を参照してください。 注: この表のすべての変数で `executionParam.` プリフィックスを使用する必要があります。 {#r_JvScrPrbTmpltExctnPrmtrs__table_pbn_kh5_cr__entry__4} | 名前 | 変数 | タイプ | 使用法 | |-|-|-|-| | スクリプトタイプ | script_type | 列挙 | 実行するスクリプトのタイプ。可能なタイプは次のとおりです。 * custom_javascript_typ * mid_script_include_type {#r_JvScrPrbTmpltExctnPrmtrs__ul_o1l_z35_cr} | | スクリプト | スクリプト | 文字列 | script_type が custom_javascript_type のときにカスタム JavaScript を実行するスクリプト。 | | MID スクリプトインクルード | mid_script_include | 参照 | script_type が mid_script_include_type のときに、MID サーバースクリプトに関連付けられた sys_id 参照。 | | ソース | ソース | 文字列 | スクリプトを実行するターゲット ホスト。 | | MidCapabilities | midCapabilities | 文字列 (コンマ区切り) | 必要な MID サーバー機能のリスト。 | | パラメーター | parameters | JavaScript オブジェクトの配列 | `executionParam.` プリフィックスを付けて表現した JavaScript オブジェクトの配列。parameters 配列に名前と値のペアをさらに追加するには、値を既存の配列に追加します。次の構文を使用して JavaScript オブジェクトを作成し、それを `executionParam.parameter` 配列に追加します。これにより、メッセージに追加のパラメーターが割り当てられます。 var newParameter = {"name":"parameterName","value":"parameterValue"}; executionParam.parameters.push(newParameter); | | ValueCapabilities | valueCapabilities | ハッシュマップの配列 | MID サーバーの選択に使用される機能値。詳細については、「[MID サーバーの機能](https://www.servicenow.com/docs/access?context=t_ConfigureCapabilities&version=yokohama&pubname=yokohama-servicenow-platform§ion=r_MIDServerCapabilities&ft:locale=en-US)」を参照してください。値によって割り当てられる追加の機能がある場合は、次の例を使用して MID サーバーの選択をカスタマイズします。 var valueCapability = {'NEW_MID_CAPABIILTY':'NEW_MID_CAPABILITY_VALUE'}; executionParam.valueCapabilities.push(valueCapability); | [表 : 1. JavaScript テンプレートの実行パラメーター] {#r_JvScrPrbTmpltExctnPrmtrs__table_pbn_kh5_cr} ## JavaScript プローブ テンプレートの後処理パラメーター {#ariaid-title3} これらのパラメーターを使用して、後処理スクリプトを作成します。 {#r_JvScrPrbTmpltPPPrmtrs__table_xlq_3n5_cr__entry__4} | 名前 | 変数 | タイプ | 使用法 | |-|-|-|-| | ペイロード | ペイロード | 文字列 | JavaScript プローブから返された生のペイロードが含まれます。 | | 出力 | 出力 | 文字列 | JavaScript プローブから返された出力データが含まれます。 | | EccSysId | eccSysId | 文字列 | ECC キュー入力メッセージに関連付けられた参照 ID が含まれます。 | | エラーメッセージ | errorMessages | 文字列 | JavaScript プローブから返されたエラーメッセージが含まれます。エラーメッセージが返されない場合、この値は null です。 | [表 : 2. JavaScript プローブの後処理パラメーター] {#r_JvScrPrbTmpltPPPrmtrs__table_xlq_3n5_cr} ## JavaScript プローブ実行コマンドを設定する {#ariaid-title4} 作成した入力変数を使用して、オーケストレーションが JavaScript プローブのターゲット ホストで実行するコマンドを設定します。 ### 始める前に \[実行コマンド\] ステージに進む前に、\[入力\] フォームで必要な入力変数を作成します。 必要なロール：activity_creator、admin 注: MID サーバーとターゲット間の JavaScript プローブ接続は、ワークフロー コンテキストでアクティビティを実行しなくてもテストできます。詳細は、「[テスト テンプレート出力](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#test-template-inputs "カスタムアクティビティの入力パラメーターは、ワークフロー コンテキスト内でアクティビティを実行しないで、その開発中にテストできます。")」を参照してください。 ### 手順 1. 入力のリストから変数をドラッグし、コマンド フィールドにドロップします。 システムによって、コマンドの正しい構文で変数がフォーマットされます。 図 : 1. JavaScript プローブ実行コマンド 2. 表に示されたフィールドに入力します。 {#t_MapJavaScriptVarsToExecutionComm__table_zmv_v25_cr__entry__2} | フィールド | 説明 | |-|-| | 入力 | 入力変数ビルダー。[入力変数を作成する](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#CreateInputVariables "アクティビティデザイナーの [入力] フォームで、アクティビティに渡す変数を作成します。")を実行して、使用可能なフィールドに[マップ](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#t_MapAnInputVariable "入力変数を作成した後、[実行コマンド] フォームのフィールドにその入力変数をマップします。")します。 | | スクリプトタイプ | 含めるスクリプトのタイプを選択します。使用可能なオプションは次のとおりです。 * カスタム JavaScript * MID サーバースクリプトの内容 {#t_MapJavaScriptVarsToExecutionComm__ul_akw_z25_cr} | | スクリプト | このプローブで実行するカスタム JavaScript。このフィールドは、選択されている \[スクリプト タイプ\] が \[カスタム JavaScript\] である場合に使用可能です。 | | MID サーバースクリプトの内容 | このプローブで実行する MID サーバーのスクリプト。このフィールドは、選択されている \[スクリプト タイプ\] が \[MID サーバースクリプトの内容\] である場合に使用可能です。 | | ホスト別に MID サーバーを選択 | プローブが動作する MID サーバー。 | | 必要な MID サーバー機能 | 使用する MID サーバー (機能別)。 | | パラメーター | このプローブでホストに渡す名前と値のペア。これらのパラメーターは手動で作成することも、入力変数を \[パラメーター\] フィールドにドラッグして値を割り当てることもできます。 | [表 : 3. JavaScript プローブ実行コマンド フィールド] {#t_MapJavaScriptVarsToExecutionComm__table_zmv_v25_cr} 3. \[保存\] をクリックします。 4. \[続行\] をクリックして、\[出力\] ステージに進みます。 {#t_MapJavaScriptVarsToExecutionComm__steps_jjb_jrk_r5}