---
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


---

# ダイレクトサービス

# ダイレクト Web サービス {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：6分

適切なアクセス制御リストが設定されている場合は、システム内の任意のテーブルでダイレクト Web サービスを使用できます。

サポートされている受信メッセージの形式は、ドキュメントスタイルのリテラル XML SOAP ドキュメント (ドキュメント/リテラル) です。直接 Web サービスの WSDL 説明と XML スキーマを取得するには、相対 URL \<tablename\>.do? をポイントします。WSDL。たとえば、オンラインデモシステムでインシデントテーブルの WSDL を取得するには、 https://\<instance name\>.service-now.com/incident.do?WSDL URL を使用します。

## 拡張クエリパラメーター {#c_DirectWebServices__section_nj5_kfy_23b}

拡張クエリパラメーターを使用すると、 get、 getKeys、および getRecords 関数を使用する場合に、SOAP クエリの戻り結果をフィルタリングおよび変更できます。  
注:  
拡張クエリ要素名の先頭には 2 つのアンダースコア文字が付きます。
{#c_DirectWebServices__table_xwm_4fy_23b__entry__3}

| パラメーター | 説明 | 例 |
|-|-|-|
| __encoded_query | 返された結果のフィルタリングに使用するエンコードされたクエリ文字列を指定します。エンコードされたクエリー文字列の形式は、 `sysparm_query` URL パラメーターで指定できる値に似ています。RSS フィードジェネレーターの例のエンコードされたクエリの構築例を参照してください。 | `<__encoded_query>active=true^category='hardware'</__encoded_query>` |
| __order_by | 返された結果を指定されたフィールドで並べ替えるように指示します。 | `<__order_by>priority</__order_by>` |
| __order_by_desc | 返された結果を、指定されたフィールドで降順に並べ替えるように指示します。 | `<__order_by_desc>opened_date</__order_by_desc>` |
| __exclude_columns | 結果セットから除外するカンマ区切りのフィールド名のリストを指定します。 | `<__exclude_columns>sys_created_on、sys_created_by、caller_id、priority</__exclude_columns>` |
| __limit | 返されるレコードの数を制限します。 | `<__limit>100</__limit>` |
| __first_row | セットの先頭からこのレコード数だけ結果をオフセットするように指示します。`__last_row`と一緒に使用すると、結果のウィンドウを照会する効果があります。結果には最初の行の番号が含まれます。 | `<__first_row>250</__first_row>` |
| __last_row | セットの先頭からこのレコード数、または指定された場合は `__start_row` 値によって結果を制限するように指示します。`__first_row` と一緒に使用すると、結果のウィンドウを照会する効果があります。結果は最後の行番号より小さく、最後の行は含まれません。 | `<__last_row>500</__last_row>` |
| __use_view | 返される結果を制限および展開するために使用するフォームビューを名前で指定します。フォームビューに caller_id.email などの詳細参照フィールドが含まれている場合は、このフィールドも結果に返されます。 | `<__use_view>soap_view</__use_view>` |
[表 : 1. 利用可能な拡張クエリパラメーター]

{#c_DirectWebServices__table_xwm_4fy_23b}

## 直接 Web サービス名前空間 {#c_DirectWebServices__section_lc1_lgy_23b}

## 各テーブルに一意の名前空間を指定する {#c_DirectWebServices__section_hb2_kgy_23b}

glide.wsdl.definition.use_unique_namespace プロパティにより、各テーブルのダイレクト Web サービス WSDL が一意の targetNamespace 属性を持つようになります。このプロパティはデフォルトでは true です。この場合、テーブルのダイレクト Web サービス WSDL でtargetNamespace値 http://www.service-now.com/\<table name\> を使用する必要があります。false の場合 (またはプロパティが存在しない場合)、すべてのテーブルで同じtargetNamespace値の http://www.service-now.com が使用されます。また、すべてのテーブルが同じ操作名を共有するため、Web サービスクライアントが複数の ServiceNow Web サービスを消費しようとしても、複数のテーブル間で要求を区別できません。一意の targetNamespace 値を使用すると、Web サービスクライアントは複数のテーブル間で要求を区別できます。

たとえば、インシデントテーブルのダイレクト Web サービス WSDL は、次の targetNamepsace 値を使用します。

    <wsdl:definitions xmlns:soapenc= "http://schemas.xmlsoap.org/soap/encoding/"xmlns:wsdl = "http://schemas.xmlsoap.org/wsdl/"xmlns:http = "http://schemas.xmlsoap.org/wsdl/http/"xmlns:tns = "http://www.service-now.com/incident"xmlns:xsd = "http://www.w3.org/2001/XMLSchema"xmlns:mime = "http://schemas.xmlsoap.org/wsdl/mime/"xmlns:soap = "http://schemas.xmlsoap.org/wsdl/soap/"targetNamespace = "http://www.service-now.com/incident" ><wsdl:types><xsd:schema elementFormDefault = "unqualified"targetNamespace = "http://www.service-now.com/incident" >

## 名前空間要件の設定 {#c_DirectWebServices__section_yvp_mgy_23b}

ServiceNow の WSDL スキーマは、デフォルトで elementFormDefault="unqualified" の属性を宣言します。この属性は、ローカルに宣言された要素をインスタンスドキュメント内の targetNamepsace で修飾する必要があるかどうかを示します。この属性の値が 修飾されていない場合は、ローカルに宣言された要素を targetNamepsaceで修飾しないでください。この属性の値が 修飾されている場合は、ローカルに宣言された要素を targetNamepsaceで修飾する必要があります。

ただし、これは、WSDL から生成されたクライアント (.NET、Axis2、webMethods など) が埋め込みスキーマを処理する方法とは互換性がありません。その結果、スキーマ名前空間が削除され、Web サービス応答が解析不可能になります。

この互換性の問題を克服するために、 glide.wsdl.schema.UnqualifiedElementFormDefault と呼ばれるブールプロパティが導入されています。このプロパティのデフォルト値は true です。これを false に設定すると、WSDL から生成されたクライアントは、Web サービス呼び出しの戻り値を解析できます。このプロパティは、次の Web サービスプロパティページを使用して変更できます システムのプロパティWeb サービス.

## 重複するサービス名を許可する {#c_DirectWebServices__section_ytf_qjv_bdb}

デフォルトでは、動的に生成された WSDL からのサービス名は一意で、次の形式になります。

    ServiceNow_<table name>

重複するサービス名を許可するために、アドミニストレーターは glide.wsdl.unique_service_name プロパティを false に設定できます。プロパティが存在しない場合は作成します。
* **[フォームを使用したクエリ応答の制限または拡張](https://servicenow-prod.fluidtopics.net/OXzot_k~vuWMVZAFFvvu6Q)**   
  場合によっては、SOAP クエリが返すフィールド値の数を制限する必要があります。
* **[参照変数の表示値を返す](https://servicenow-prod.fluidtopics.net/1E9LnRMY4flAjAgff2YGsQ)**   
  get または getRecords 関数を使用してレコードをクエリすると、インスタンスは、そのレコードに関連付けられたすべてのフィールドを返します。多くの場合、これらのフィールドは、別のテーブルのレコードのsys_idを含む参照フィールドです。
* **[ターゲットインスタンスからの値のクリア](https://servicenow-prod.fluidtopics.net/pGkWNLzE0fzQuLPya2r8KA)**   
  SOAP パラメーターを介して空の値を渡して、ターゲットインスタンスのそれぞれの値をクリアすることができます。
* **[ダイレクト Web サービスを使用したジャーナルエントリーの取得](https://servicenow-prod.fluidtopics.net/OPqV_IVRPpXZPJjWcsqRzw)**   
  ジャーナルフィールドの内容を取得するには、sys_journal_field テーブルに対して 2 回目の SOAP 要求を行い、問題のレコードの適切なジャーナルレコードを取り出します。
* **[ダイレクト Web サービスを使用した選択肢フィールドの取得](https://servicenow-prod.fluidtopics.net/~9t47YrYFBFgnYwY7uZfBw)**   
  選択肢フィールドを取得または設定するには、\[ラベル\] ではなく \[値\] の選択肢を使用します。
* **[すべての SOAP 呼び出しにわたる HTTP セッションの保持](https://servicenow-prod.fluidtopics.net/nDjHH31ZwvoAwCl7mCcMZA)**   
  SOAP クライアントが短時間に多数の呼び出しを行う場合は、すべての SOAP 呼び出しに対して単一の HTTP セッションを再利用することができます。
* **[SOAP ダイレクト Web サービス API 関数](https://servicenow-prod.fluidtopics.net/5IGqhJhAtng1jew8PSdmow)**   
  標準の SOAP API は、ターゲットのリソースで実行できる、グローバルに定義された小さな関数のセットです。

**関連概念**   

* [SOAP Web Services](https://servicenow-prod.fluidtopics.net/pGjwqz6ayTi1GunjWl0WuQ "Simple Object Access Protocol (SOAP) は、HTTP 経由で Web サービスにアクセスするための XML ベースのプロトコルです。")