---
title: 外部データ ソースでの Web サービスの使用
slug: neurons-for-itsm/admin-user-help/jpn/latest/ptrp-web
createdAt: 2026-10-29T01:28:14.145Z
---

このトピックでは、スクリプトとデータの関連付けなど、新しいビジネス オブジェクトの外部データと Web サービスのサポートについて説明します。

:::hint{type="info"}
このトピックは既存のビジネス オブジェクトには適用されません。 ここで説明するプロセスを使用するには、新しいビジネス オブジェクトを作成し、その新しく作成されたビジネス オブジェクトにプロセスを適用する必要があります。
:::

- [外部データの操作について](docId\:ptrpRLY-lzta6CnzKN7FT)
- [DSM を外部データ ソースとして使用することについて](docId\:ptrpRLY-lzta6CnzKN7FT)
- [前提条件](docId\:ptrpRLY-lzta6CnzKN7FT)
- [外部データ接続の作成](docId\:ptrpRLY-lzta6CnzKN7FT)
- [トラブルシューティング](docId\:ptrpRLY-lzta6CnzKN7FT)
- [例: Web サービスを使用して外部データにアクセスするための外部ビジネス オブジェクトの作成](docId\:ptrpRLY-lzta6CnzKN7FT)

### 外部データの操作について

多くの場合、顧客は DSM や SalesForce.com など サービス マネージャ外部のシステムにデータを持っており、それを サービス マネージャと統合する必要があります。 サービス マネージャリリース 2015.2 より前では、顧客はそのデータをインポートする必要がありましたが、データがインポートされると、そのデータは古くなってしまいました。 また、インポートされたデータが非常に大きくなり、 サービス マネージャ データベースのサイズが不必要に増加する可能性があります。

この新しいプロセスを使用すると、実際にデータを サービス マネージャにインポートしなくても、他のシステムのデータにアクセスできるようになります。 このアクセスは Web サービスを使用して実現されます。

このプロセスでは、Web サービスとスクリプトを使用して、他のアプリケーションから サービス マネージャへのデータのマッピングを作成できます。 これにより、統合するデータと使用する形式を選択したり、さまざまなプロパティを持つ外部データを使用したりできます。 スクリプトから、サービス呼び出しを行って外部アプリケーションと通信し、データを取得して サービス マネージャに取り込むことができます。

外部アプリケーションのデータは サービス マネージャのデータとは異なる形式である可能性があり、 サービス マネージャ に必要なフィールドよりも多くのフィールドが存在する可能性があります。 マッピングは 1 対 1 である必要はありません。 インポートする外部データを選択し、マッピングを構成できます。 たとえば、外部アプリケーションのデータには 100 個のフィールドがあるかもしれませんが、 サービス マネージャ は 10 個のフィールドのみを処理する必要があります。 サービス マネージャ これらの 10 個のフィールドのみをインポートし、 サービス マネージャのビジネス オブジェクト内の関連フィールドにマップできます。

### DSM を外部データ ソースとして使用することについて

サービス マネージャで動作する最も一般的な外部データ ソースの 1 つは、Desktop and Server Management (DSM) です。 このトピックのプロセスに従うことで、 サービス マネージャ と DSM 間の統合を改善できます。

DSM とのより便利な統合を実現するには、 サービス マネージャ が DSM に保存されているデータを表示できる必要があります。 効果を上げるには、DSM で行われた変更が サービス マネージャ に自動的に反映されるように実行する必要があります。 サービス マネージャ が DSM にアクセスする方法は、Web サービス経由です。

新しい DSM 統合の詳細については、「 [新しい DSM 統合の構成](docId\:h-BqohttZEJwS_mSUIybk)」を参照してください。

### 前提条件

このプロセスを実行するには、次の知識が必要です。

- サービス マネージャとそのデータベースに関する知識。
- 外部アプリケーションとそのデータベースに関する知識。
- スクリプトの作成と Web サービスの使用のためのプログラミング スキルと JavaScript の知識。

### 外部データ接続の作成

外部データ ソースを操作するには、次の手順に従います。

1. 外部ビジネス オブジェクトを作成します。

:::Paragraph{indent="1"}
a. 必ず「 **外部** 」をチェックし、「 **外部オブジェクト同期** 」セクションに情報を入力してください。 「[ビジネスオブジェクトの作成](docId\:yvlXX31Z1OPk59iqDsIv7)参照してください。
:::

:::Paragraph{indent="1"}
b. 外部ビジネス オブジェクトを検証ビジネス オブジェクトにする場合は、作成時に「 **純粋な検証オブジェクト**」をクリックしてください。
:::

2. （オプション。 (検証ビジネス オブジェクトを作成した場合のみ) 作成した外部ビジネス オブジェクトを使用する選択リストを作成します。

:::Paragraph{indent="1"}
選[選択リストの作成](docId\:HwBP3xGShwMK-Zw-xlOKZ)参照してください。 ただし、選択リストの制約はすべて AND か、すべて OR のいずれかである必要があります。 制約タイプを混在させたり、ネストされた制約を使用したりすることはできません。
:::

:::Paragraph{indent="1"}
選択リストにアクセスするたびに、アプリケーションはそれが同期された外部ビジネス オブジェクトであるかどうかを確認します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
同期された外部ビジネス オブジェクトの場合、アプリケーションは外部データがローカルで使用可能かどうかを確認します。
外部データが存在しない場合、または外部データのいずれかが古い場合、アプリケーションはスクリプトをトリガーして更新されたデータを取得し、選択リストに入力します。 データが存在し、古くない場合、アプリケーションはスクリプトをトリガーしません。
:::

:::Paragraph{listStyleType="disc" indent="2"}
同期された外部ビジネス オブジェクトでない場合、アプリケーションはスクリプトをトリガーして、選択リストに入力するデータを取得します。
:::

3. スクリプトを外部ビジネス オブジェクトに関連付けます。 ビジネス オブジェクトの使用例ごとにスクリプトは 1 つだけ存在できます。 (使用例には、フォーム、リスト、レポート、ワークスペースなどがあります)。このプロセスは、「 [Web サービス スクリプト統合の操作](docId\:hhhJuSsFVItbqW4Jj-JBb)」の情報に基づきます。

:::Paragraph{indent="1"}
a. 新しい外部ビジネス オブジェクト統合を追加します。 詳細については、「 [送信外部ビジネスオブジェクト統合の追加](docId\:kGsEJKGO4jQzsyn0wHcBN) 」を参照してください。
:::

:::Paragraph{indent="1"}
b. 新しい外部ビジネス オブジェクト統合を追加する一環として、サービス参照を作成します。 サ[受信サービス参照の追加](docId\:kGsEJKGO4jQzsyn0wHcBN)参照してください。
:::

4. この新しい外部ビジネス オブジェクトのトップレベルタブを作成します。
5. オプションで、スクリプトをトリガーするクイックアクションを作成できます。 クイック アクションを作成するには、「 **Web サービスの実行** 」クイック アクション テンプレートを使用します。 「[Webサービスクイック アクションを実行する](docId\:TOTy8htGnJTovW0FQknls)参照してください。

### トラブルシューティング

- [ログの表示](docId\:ptrpRLY-lzta6CnzKN7FT)
- [キャッシュの更新](docId\:ptrpRLY-lzta6CnzKN7FT)

### ログの表示

サービス マネージャリリース 2015.2 からは、 **スクリプト**と呼ばれる新しいログ タイプが追加されました。 詳細については、「 [ログの操作](docId\:xcmL6P-H4jWva4tQw70ZH) 」を参照してください。

ログの情報をモニターに表示するには、コードの末尾に次のスニペットを追加します。

```bash
コンソールログ();
コンソールのデバッグ();
コンソール.error();
```

C:\\\Logs\\\AppServer.log でログを確認することもできます。

### キャッシュの更新

また、「 **キャッシュ管理** ワークスペース」に移動し、「 **外部同期としてマークされたビジネス オブジェクト** フィールドで、外部ビジネス オブジェクトを選択することもできます。 既存のレコードをすべて古いものとしてマークするには、「 **同期されたデータを無効にする** 」をクリックします。 これにより、次回データにアクセスするときに、アプリケーションは強制的に外部アプリケーションにアクセスしてデータを取得します。

### 例: Web サービスを使用して外部データにアクセスするための外部ビジネス オブジェクトの作成

- [Webサービス統合の作成](docId\:ptrpRLY-lzta6CnzKN7FT)
- [統合のデモのための サービス申請の作成](docId\:ptrpRLY-lzta6CnzKN7FT)

### Webサービス統合の作成

以下は、Web サービスを使用して、ユーザーが国名を入力し、アプリケーションが国コードを返すようにする例です。

1. ビ**ジネス オブジェクト&#x20;**&#x30EF;ークスペースに移動し、新しいスタンドアロン ビジネス オブジェクトを作成します。 (詳細については、[スタンドアロンビジネスオブジェクトの作成](docId\:yvlXX31Z1OPk59iqDsIv7)を参照してください)。

:::Paragraph{indent="1"}
a. ビジネス オブジェクト名と表示名には、「 **WSCountry**」と入力します。
:::

:::Paragraph{indent="1"}
b. 外**部を**確認してください。  
:::

:::Paragraph{indent="1"}
c. **同期済み**をチェックし、 **更新間隔** パラメータを **10**に設定し、 **存続時間** パラメータを **60**に設定します。
:::

:::Paragraph{indent="1"}
d. チェック **純粋な検証オブジェクト**。
:::

2. フ**ィールド&#x20;**&#x30BF;ブに移動します。 (詳細については、「[フィールドの作成](docId\:JRWNcSwxtwBwBg7-ltHe2) 」を参照してください。)

:::Paragraph{indent="1"}
a. I**SOCode&#x20;**&#x3068;いう新しいテキスト フィールドを追加します。これは、Unicode テキスト、変数、最大 128 で、 U**niqueを**オンにし、 N**ullableを**オフにします。
:::

:::Paragraph{indent="1"}
b. Unicode テキスト、変数、最大 64 の **名前** という別のテキスト フィールドを追加します。 **一意**をオンにし、 **Null 可能**をオフにします。
:::

3. 詳**細&#x20;**&#x30BF;ブに戻ります。

:::Paragraph{indent="1"}
a. 外**部主キー&#x20;**&#x30D5;ィールドで、 I**SOCodeUniqueを**選択します。
:::

:::Paragraph{indent="1"}
b. 「**UI の自動生成&#x20;**」をクリックすると、 W**SCountry&#x20;**&#x5916;部ビジネス オブジェクトに関連付けられた新しいフォームが自動的に作成されます。
:::

4. 選**択リスト&#x20;**&#x30BF;ブに移動します。

:::Paragraph{indent="1"}
a. **新規追加...**&#x3092;クリックします。
:::

:::Paragraph{indent="1"}
b. リスト名と表示名には、「 **WSCountry**」と入力します。
:::

:::Paragraph{indent="1"}
c. **リスト データの取得元&#x20;**&#x30D5;ィールドから **WSCountry&#x20;**&#x3092;選択し、 **表示フィールド&#x20;**、 **値フィールド、**&#x304A;よび **並べ替えフィールドフィールド**から **名前&#x20;**&#x3092;選択します。
:::

5. ロ**ールと権限&#x20;**&#x30EF;ークスペースに移動します。

:::Paragraph{indent="1"}
a. 管**理者&#x20;**&#x3092;クリックし、次に ト**ップレベル タブ&#x20;**&#x30BF;ブをクリックします。 **\[新しいタブの追加]** をクリックし、 **\[オブジェクト ワークスペース]**&#x3092;クリックします。 
:::

:::Paragraph{indent="1"}
b. 名**前&#x20;**&#x30D5;ィールドに W**SCountry&#x20;**&#x3068;入力し、 オ**ブジェクト&#x20;**&#x30D5;ィールドで W**SCountry&#x20;**&#x3092;選択し、 レ**イアウト&#x20;**&#x30D5;ィールドで W**SCountry.Autogenerated&#x20;**&#x3092;選択します。
:::

6. ス**ケジュールされたジョブ&#x20;**&#x30EF;ークスペースに移動します。

:::Paragraph{indent="1"}
a. 新しい時間スケジュールを追加します。
:::

:::Paragraph{indent="1"}
a. 名前を付けて、開始時間、終了時間、開始日、終了日を設定し、 **Recurr Every** フィールドを 1 に設定します。
:::

7. W**eb サービス接続 (ベータ版)&#x20;**&#x30EF;ークスペースに移動します。

:::Paragraph{indent="1"}
a. 新**しい外部 BO 統合を**クリックします。
:::

:::Paragraph{indent="1"}
b. 次のページで、 **外部 BO 名** フィールドで **WSCountry** を選択します。
:::

:::Paragraph{indent="1"}
c. 次のページの「 **サービス参照** 」フィールドで、「 **新規追加...**」を選択します。 サ**ービス参照&#x20;**&#x30D5;ィールドに、 国**情報サービスと**入力します。
:::

:::Paragraph{indent="1"}
d. サ**ービス アドレス&#x20;**&#x30D5;ィールドに、 h**ttp\://webservices.oorsprong.org/websamples.countryinfo/CountryInfoService.wso?WSDLと**入力します。
:::

:::Paragraph{indent="1"}
e. L**istOfCountryNamesByCode&#x20;**&#x30E1;ソッドを選択します。
:::

:::Paragraph{indent="1"}
f. 次の内容を **スクリプト** フィールドに貼り付けます。


:::

```bash
// Webサービス呼び出し
console.info("Script starts: WS_Country - CountryInfoService - ListOfCountryNamesByCode");

var serviceCall = "CountryInfoService";
var serviceRef = "Country Info Service";
var serviceInstance = GetWebService(serviceRef, serviceCall);
var methodCall = "ListOfCountryNamesByCode";
var paramValues = [ null ];
var result = serviceInstance.InvokeMethod(methodCall, paramValues);

関数 GetCountries(isocode, name)
{
this.ISOCode = isocode;
this.Name = 名前;
}
var json = [];
(i=0; iの場合
{
json.push(新しいGetCountries(result[i].sISOCode、result[i].sName));
}
すべての熱データを同期します('WSCountry',['ISOCode'],json);
console.info("Script ends: WS_Country - CountryInfoService - ListOfCountryNamesByCode");
```

8. 次**へ&#x20;**&#x3092;クリックし、 ス**ケジュール リストで** W**SCountryを**選択します。
9. 次**へ&#x20;**&#x3092;クリックし、次に 公**開 今すぐ実行を**クリックします。

### 統合のデモのための サービス申請の作成

1. **申請項目&#x20;**&#x30EF;ークスペースに移動し、新しい申請項目を作成します。

:::Paragraph{indent="1"}
a. サービスとして「 **Demo Service** 」を選択し、名前として「 **WSCountry** 」と入力します。 任意のカテゴリを選択してください。
:::

:::Paragraph{indent="1"}
b. C**ountry&#x20;**&#x3068;いうドロップダウン フィールドと I**SOCodeと**いうテキスト フィールドを追加します。
:::

:::Paragraph{indent="1"}
c. C**ountry&#x20;**&#x30D5;ィールドを編集し、 P**ick List: Noneの**下で、 W**SCountry&#x20;**&#x9078;択リスト (検証リスト) を選択します。 プ**ロパティの**下で、 一**意の ID&#x20;**&#x30D5;ィールドを W**SCountryComboに**設定します。
:::

:::Paragraph{indent="1"}
d. I**SOCode&#xA0;**&#x30D5;ィールドを編集し、 D**efault Valueの**下で E**xpression&#x20;**&#x3092;選択し、 T**riggered by&#x20;**&#x30D5;ィールドでは W**SCountryを**選択します。
:::

:::Paragraph{indent="1"}
e. 「 **次へ** 」を 2 回クリックします。
:::

:::Paragraph{indent="1"}
f. 新しい組織単位を追加するには、\[ **追加** ] をクリックします。 組織単位を選択します。 ス**テータス&#x20;**&#x3092; 公**開済みに**変更します。
:::

2. セルフサービス ユーザーとしてログインします。 サ**ービス カタログ&#x20;**&#x30EF;ークスペースに移動します。
3. **WS\_Country&#x20;**&#x7533;請項目をクリックして、それが開くことを確認します。
