--- 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 --- # プローブアクティビティを作成する # プローブアクティビティを作成する {#ariaid-title1} * リリースバージョン: Yokohama * * 更新日 2025年01月30日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：4分 ターゲット ホスト上で特定の情報を返すように構成されたプローブを実行するアクティビティを作成します。 ## 始める前に 必要なロール：activity_creator または workflow_admin ## このタスクについて アクティビティテンプレートのプロセスフローの使用手順については、「[カスタムアクティビティを作成する](https://servicenow-prod.fluidtopics.net/edsmpnP6ixAb8otUf3QAfg "カスタム テンプレートを使用して、ワークフローエディターでさまざまなタイプのカスタムアクティビティを作成および更新できます。")」を参照してください。 ## 手順 1. [カスタムアクティビティ](https://servicenow-prod.fluidtopics.net/edsmpnP6ixAb8otUf3QAfg "カスタム テンプレートを使用して、ワークフローエディターでさまざまなタイプのカスタムアクティビティを作成および更新できます。")を作成します。 このアクションにより、テンプレートを使用してカスタムアクティビティが作成されます。 2. [一般的なプロパティ](https://servicenow-prod.fluidtopics.net/sGlDz~awf9LAqxmmckTzIA "次の一般プロパティ フィールドは、すべてのアクティビティデザイナーテンプレートに共通です。")を設定し、[入力変数を作成](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#CreateInputVariables "アクティビティデザイナーの [入力] フォームで、アクティビティに渡す変数を作成します。")した後、プローブ実行コマンドを構成します。 | オプション | 説明 | | [入力変数をマップする](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#t_MapAnInputVariable "入力変数を作成した後、[実行コマンド] フォームのフィールドにその入力変数をマップします。") | 作成した変数を使用して、オーケストレーションが実行するコマンドを設定します。 | | プローブ | システム内のプローブのリストから選択した、このアクティビティで実行するプローブ | | ターゲットホスト | このアクティビティのターゲットサーバーのホスト名または IP アドレス。 | | パラメーター | 使用する MID サーバー (機能別)。 | | 必要な MID サーバー機能 | このプローブでホストに渡す名前と値のペア。これらのパラメーターは手動で作成することも、入力変数をパラメーター フィールドにドラッグ アンド ドロップして値を割り当てることもできます。 | |-|-| {#t_CreateAProbeActivity__choicetable_bf3_bpv_vz} 注: テストペイロードのパラメーター値を、\[出力\] タブの変数に自動的にマッピングできます。「[出力変数を自動マッピングする](https://servicenow-prod.fluidtopics.net/H5szOU~CdbJIOFsdYZzNdQ "テストペイロードのパラメーター値を、[出力] タブの変数に自動的にマッピングできます。")」を参照してください。 ## 次のタスク * [自動マッピング](https://servicenow-prod.fluidtopics.net/H5szOU~CdbJIOFsdYZzNdQ "テストペイロードのパラメーター値を、[出力] タブの変数に自動的にマッピングできます。")を使用して出力および解析ルールを生成する * 自動マッピングを使用しない場合は、手動で[出力変数を作成](https://servicenow-prod.fluidtopics.net/8VMx5hDk1zBhXX8PdOseTQ#t_CreateAnOutputVariable "デザイナーの [出力] フォームには、オブジェクトとアレイのデータ構造を作成するための変数ビルダが含まれています。")し、[解析ルールを作成](https://servicenow-prod.fluidtopics.net/WcjbpLvpo7gVqPKWISlRNQ#t_CreateAParsingRule "カスタムアクティビティで定義された出力変数に、外部ホストまたはエンドポイントでの入力テストから返されたペイロード データを取り込みます。")できる {#t_CreateAProbeActivity__ul_u45_vbq_xz} ## プローブ テンプレート実行パラメーター {#ariaid-title2} 実行パラメーターを使用して、\[前処理\] フォームで入力プロセス スクリプトを作成します。 コマンド フィールドの説明については、「[プローブ実行コマンドを設定する](https://servicenow-prod.fluidtopics.net/1qGPPezQv9srin8ub~kl4g#t_MapProbeVariablesToExecutionCmd "作成した変数を使用して、オーケストレーションがターゲットで実行するコマンドを設定します。")」を参照してください。 注: この表のすべての変数で `executionParam.` プリフィックスを使用する必要があります。 {#r_ProbeTemplateExecutionParameters__table_pwj_qdc_dr__entry__4} | 名前 | 変数 | タイプ | 使用法 | |-|-|-|-| | プローブ | プローブ | 参照 | MID サーバープローブの sys_id。 | | ソース | ソース | 文字列 | 意図したターゲット ホスト | | パラメーター | parameters | JS オブジェクトの配列 | `executionParam.` プリフィックスを付けて表現した JavaScript オブジェクトの配列。parameters 配列に名前と値のペアをさらに追加するには、値を既存の配列に追加します。次の構文を使用して JavaScript オブジェクトを作成し、それを `executionParam.parameter` 配列に追加します。これにより、メッセージに追加のパラメーターが割り当てられます。 var newParameter = {"name":"parameterName","value":"parameterValue"}; executionParam.parameters.push(newParameter); | | MidCapabilities | midCapabilities | 文字列 (コンマ区切り) | 必要な MID サーバー機能のリスト。 | | 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. プローブアクティビティ実行パラメーター] {#r_ProbeTemplateExecutionParameters__table_pwj_qdc_dr} ## プローブ テンプレートの後処理パラメーター {#ariaid-title3} これらのパラメーターを使用して、後処理スクリプトを作成します。 {#r_PbTmpltPstPPrm__table_xlq_3n5_cr__entry__4} | 名前 | 変数 | タイプ | 使用法 | |-|-|-|-| | ペイロード | ペイロード | 文字列 | プローブから返された生のペイロードが含まれます。 | | 出力 | 出力 | 文字列 | プローブから返された出力データが含まれます。 | | EccSysId | eccSysId | 文字列 | ECC キュー入力メッセージに関連付けられた参照 ID が含まれます。 | [表 : 2. プローブ後処理パラメーター] {#r_PbTmpltPstPPrm__table_xlq_3n5_cr} ## プローブ実行コマンドを設定する {#ariaid-title4} 作成した変数を使用して、オーケストレーションがターゲットで実行するコマンドを設定します。 ### 始める前に \[実行コマンド\] ステージに進む前に、\[入力\] フォームで必要な入力変数を作成します。 必要なロール：activity_creator、admin 注: MID サーバーとターゲット間のアクティビティ接続は、ワークフロー コンテキストでアクティビティを実行しなくてもテストできます。詳細は、「[テスト テンプレート出力](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#test-template-inputs "カスタムアクティビティの入力パラメーターは、ワークフロー コンテキスト内でアクティビティを実行しないで、その開発中にテストできます。")」を参照してください。 ### 手順 1. 入力のリストから変数をドラッグし、コマンド フィールドにドロップします。 システムによって、コマンドの正しい構文で変数がフォーマットされます。 図 : 1. プローブ実行コマンド 2. 表に示されたフィールドに入力します。 {#t_MapProbeVariablesToExecutionCmd__table_m3w_qzb_dr__entry__2} | フィールド | 説明 | |-|-| | 入力 | 入力変数ビルダー。[入力変数を作成する](https://servicenow-prod.fluidtopics.net/EdYKCS6jB0~8LVv2H_rDTw#CreateInputVariables "アクティビティデザイナーの [入力] フォームで、アクティビティに渡す変数を作成します。")を実行して、使用可能なフィールドにマップします。 | | プローブ | システム内のプローブのリストから選択した、このアクティビティで実行するプローブ。 | | ターゲットホスト | このアクティビティのターゲットサーバーのホスト名または IP アドレス。 | | 必要な MID サーバー機能 | 使用する MID サーバー (機能別)。 | | パラメーター | このプローブでホストに渡す名前と値のペア。これらのパラメーターは手動で作成することも、入力変数をパラメーター フィールドにドラッグ アンド ドロップして値を割り当てることもできます。 | [表 : 3. プローブ実行コマンド フィールド] {#t_MapProbeVariablesToExecutionCmd__table_m3w_qzb_dr} 3. \[保存\] をクリックします。 4. \[続行\] をクリックして、\[出力\] ステージに進みます。 {#t_MapProbeVariablesToExecutionCmd__steps_gpt_msl_s5}