--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # スクリプト化済みサービス # スクリプト済み SOAP Web サービス {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分 Scripted SOAP Web Services により、ServiceNow 管理者はカスタム受信 SOAP Web Services を作成できます。 SOAP Web サービスの入力パラメーターと出力パラメーターを定義し、JavaScript を使用して操作を実行できます。この機能は非常に強力ですが、実装と保守が簡単なため、 [可能な限りダイレクト Web サービス](https://servicenow-prod.fluidtopics.net/893H7wLIHWB0DoK8vLzYtg "適切なアクセス制御リストが設定されている場合は、システム内の任意のテーブルでダイレクト Web サービスを使用できます。") または [SOAP Web サービスインポートセット](https://servicenow-prod.fluidtopics.net/mckzMXtX1gc1VjnGtJIkIw "Web サービスインポートセットは、インポートセットテーブルに Web サービスインターフェイスを提供して、ダイレクト Web サービスおよび Scripted SOAP Web Services を補完します。") を使用してください。 ## セキュリティ スクリプト化された SOAP Web サービスには、すべての SOAP Web サービスと同じ基本セキュリティオプションがあります。SOAP Web Services のセキュリティの詳細については、「 [SOAP Web Services のセキュリティ](https://servicenow-prod.fluidtopics.net/pGjwqz6ayTi1GunjWl0WuQ#c_SOAPWebService__SOAP-web-services-security)」を参照してください。 システムに [厳格なセキュリティ](https://servicenow-prod.fluidtopics.net/pGjwqz6ayTi1GunjWl0WuQ "Simple Object Access Protocol (SOAP) は、HTTP 経由で Web サービスにアクセスするための XML ベースのプロトコルです。") が適用される場合、HTTP 認証ユーザーは、スクリプト化された Web サービスを実行するための [soap_script](https://servicenow-prod.fluidtopics.net/pGjwqz6ayTi1GunjWl0WuQ "Simple Object Access Protocol (SOAP) は、HTTP 経由で Web サービスにアクセスするための XML ベースのプロトコルです。") ロールを持っている必要があります。 ## WSDL {#c_ScriptedWebServices__section_px4_kjf_f3b} すべての ServiceNow テーブルとインポートセットは、テーブルスキーマと使用可能な操作を記述する Web サービス定義言語 (WSDL) XML ドキュメントを動的に生成します。 ## WSDL コンプライアンスの強制 {#c_ScriptedWebServices__section_ay4_vff_f3b} WSDL で定義されている順序で出力値をリストするように応答を強制することができます。 スクリプト化された SOAP Web サービスを作成すると、生成される WSDL は \[入力パラメーター\] 関連リストと \[出力パラメーター\] 関連リストに基づきます。スクリプト化されたサービスによって送信される実際の SOAP 応答は、 スクリプトによって決定されます。この動作により、スクリプトは WSDL で定義されている順序とは異なる順序で出力値を返す可能性があります。 関連リストで定義されている出力パラメーターの順序を強制するには、\[ WSDL コンプライアンス \] チェックボックスをオンにします。このチェックボックスをオンにすると、Web サービスは、WSDL の順序に合わせてスクリプトによって返されたパラメーターを並べ替えます。 注: 追加の応答パラメーターがスクリプトによって返されても、\[応答パラメーター\] 関連リストで定義されていない場合、それらのパラメーターは、\[ WSDL コンプライアンス \] が選択されているときに応答から除外されます。 {#c_ScriptedWebServices__table_ump_jgf_f3b__entry__2} | パラメーター | 順序 | |-|-| | Param 1 | 200 | | Param 2 | 300 | | パラメーター 3 | 100 | [表 : 1. \[出力パラメーター\] 関連リスト] {#c_ScriptedWebServices__table_ump_jgf_f3b} 定義された出力パラメーターの値を設定するスクリプトは次のとおりです。このスクリプト例では、パラメーターが \[出力パラメーター\] 関連リストで定義されている順序とは異なる順序で設定されていることに注意してください。関連リストで定義されていない追加のパラメーター param4 にも注意してください。 Response.param1 = 1; Response.param4 = 4; Response.param3 = 3; \[WSDL コンプライアンス\] チェックボックスが false の場合、スクリプトによって生成される SOAP 応答は次のとおりです。 1 4 3 \[ WSDL コンプライアンス \] チェックボックスが true の場合、スクリプトによって生成される SOAP 応答は次のとおりです。 3 1 ## スタティック WSDL {#c_ScriptedWebServices__section_yfd_p2f_f3b} 一部の Web サービスクライアントでは、特定の WSDL 形式を介してインスタンスへの SOAP アクセスが必要です。この必須形式は、標準の ServiceNow WSDL 形式とは異なる場合があります。このような場合は、必要な形式に一致する静的 WSDL を作成できます。 ## グローバル変数 着信 SOAP 要求のカスタム処理を容易にするために、スクリプトコンテキストで次のグローバル変数を使用できます。 * soapRequestDocument:着信 SOAP エンベロープを表す Java org.w3c.dom.Document オブジェクト。 * soapRequestXML:受信 SOAP エンベロープ XML を表す文字列オブジェクト。 * request:受信 SOAP エンベロープのマップされた値 (入力パラメーター名にマップされた) を含む Javascript オブジェクト。 * response:応答値をカスタマイズできる Javascript オブジェクト。「[応答のカスタマイズ](https://servicenow-prod.fluidtopics.net/sHuDmtLqoHR9lgR2Vm7jdg "次の例に従って、SOAP 応答の XML ペイロードをカスタマイズおよび制御します。")」を参照してください {#c_ScriptedWebServices__ul_qxr_xw2_f3b} * **[新しい Scripted SOAP Web Service の作成](https://servicenow-prod.fluidtopics.net/RoUDC5iXMZ0h1AvUCOoe1Q)** 新しい Scripted SOAP Web Service を作成するには、次の例に従ってください。 * **[応答をカスタマイズ](https://servicenow-prod.fluidtopics.net/sHuDmtLqoHR9lgR2Vm7jdg)** 次の例に従って、SOAP 応答の XML ペイロードをカスタマイズおよび制御します。 * **[スタティック WSDL を使用した Scripted SOAP Web Service の作成](https://servicenow-prod.fluidtopics.net/V4WOArPPwMkE8ObTIdK38Q)** スタティック WSDL を使用して Scripted SOAP Web Service を作成するには、次の例に従ってください。