外部データ ソースでの Web サービスの使用
このトピックでは、スクリプトとデータの関連付けなど、新しいビジネス オブジェクトの外部データと Web サービスのサポートについて説明します。
このトピックは既存のビジネス オブジェクトには適用されません。 ここで説明するプロセスを使用するには、新しいビジネス オブジェクトを作成し、その新しく作成されたビジネス オブジェクトにプロセスを適用する必要があります。
- 前提条件
外部データの操作について
多くの場合、顧客は 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 統合の構成」を参照してください。
前提条件
このプロセスを実行するには、次の知識が必要です。
- サービス マネージャとそのデータベースに関する知識。
- 外部アプリケーションとそのデータベースに関する知識。
- スクリプトの作成と Web サービスの使用のためのプログラミング スキルと JavaScript の知識。
外部データ接続の作成
外部データ ソースを操作するには、次の手順に従います。
- 外部ビジネス オブジェクトを作成します。
a. 必ず「 外部 」をチェックし、「 外部オブジェクト同期 」セクションに情報を入力してください。 「ビジネスオブジェクトの作成参照してください。
b. 外部ビジネス オブジェクトを検証ビジネス オブジェクトにする場合は、作成時に「 純粋な検証オブジェクト」をクリックしてください。
- (オプション。 (検証ビジネス オブジェクトを作成した場合のみ) 作成した外部ビジネス オブジェクトを使用する選択リストを作成します。
選選択リストの作成参照してください。 ただし、選択リストの制約はすべて AND か、すべて OR のいずれかである必要があります。 制約タイプを混在させたり、ネストされた制約を使用したりすることはできません。
選択リストにアクセスするたびに、アプリケーションはそれが同期された外部ビジネス オブジェクトであるかどうかを確認します。
- 同期された外部ビジネス オブジェクトの場合、アプリケーションは外部データがローカルで使用可能かどうかを確認します。 外部データが存在しない場合、または外部データのいずれかが古い場合、アプリケーションはスクリプトをトリガーして更新されたデータを取得し、選択リストに入力します。 データが存在し、古くない場合、アプリケーションはスクリプトをトリガーしません。
- 同期された外部ビジネス オブジェクトでない場合、アプリケーションはスクリプトをトリガーして、選択リストに入力するデータを取得します。
- スクリプトを外部ビジネス オブジェクトに関連付けます。 ビジネス オブジェクトの使用例ごとにスクリプトは 1 つだけ存在できます。 (使用例には、フォーム、リスト、レポート、ワークスペースなどがあります)。このプロセスは、「 Web サービス スクリプト統合の操作」の情報に基づきます。
a. 新しい外部ビジネス オブジェクト統合を追加します。 詳細については、「 送信外部ビジネスオブジェクト統合の追加 」を参照してください。
b. 新しい外部ビジネス オブジェクト統合を追加する一環として、サービス参照を作成します。 サ受信サービス参照の追加参照してください。
- この新しい外部ビジネス オブジェクトのトップレベルタブを作成します。
- オプションで、スクリプトをトリガーするクイックアクションを作成できます。 クイック アクションを作成するには、「 Web サービスの実行 」クイック アクション テンプレートを使用します。 「Webサービスクイック アクションを実行する参照してください。
トラブルシューティング
ログの表示
サービス マネージャリリース 2015.2 からは、 スクリプトと呼ばれる新しいログ タイプが追加されました。 詳細については、「 ログの操作 」を参照してください。
ログの情報をモニターに表示するには、コードの末尾に次のスニペットを追加します。
コンソールログ();
コンソールのデバッグ();
コンソール.error();C:\\Logs\\AppServer.log でログを確認することもできます。
キャッシュの更新
また、「 キャッシュ管理 ワークスペース」に移動し、「 外部同期としてマークされたビジネス オブジェクト フィールドで、外部ビジネス オブジェクトを選択することもできます。 既存のレコードをすべて古いものとしてマークするには、「 同期されたデータを無効にする 」をクリックします。 これにより、次回データにアクセスするときに、アプリケーションは強制的に外部アプリケーションにアクセスしてデータを取得します。
例: Web サービスを使用して外部データにアクセスするための外部ビジネス オブジェクトの作成
Webサービス統合の作成
以下は、Web サービスを使用して、ユーザーが国名を入力し、アプリケーションが国コードを返すようにする例です。
- ビジネス オブジェクト ワークスペースに移動し、新しいスタンドアロン ビジネス オブジェクトを作成します。 (詳細については、スタンドアロンビジネスオブジェクトの作成を参照してください)。
a. ビジネス オブジェクト名と表示名には、「 WSCountry」と入力します。
b. 外部を確認してください。
c. 同期済みをチェックし、 更新間隔 パラメータを 10に設定し、 存続時間 パラメータを 60に設定します。
d. チェック 純粋な検証オブジェクト。
- フィールド タブに移動します。 (詳細については、「フィールドの作成 」を参照してください。)
a. ISOCode という新しいテキスト フィールドを追加します。これは、Unicode テキスト、変数、最大 128 で、 Uniqueをオンにし、 Nullableをオフにします。
b. Unicode テキスト、変数、最大 64 の 名前 という別のテキスト フィールドを追加します。 一意をオンにし、 Null 可能をオフにします。
- 詳細 タブに戻ります。
a. 外部主キー フィールドで、 ISOCodeUniqueを選択します。
b. 「UI の自動生成 」をクリックすると、 WSCountry 外部ビジネス オブジェクトに関連付けられた新しいフォームが自動的に作成されます。
- 選択リスト タブに移動します。
a. 新規追加...をクリックします。
b. リスト名と表示名には、「 WSCountry」と入力します。
c. リスト データの取得元 フィールドから WSCountry を選択し、 表示フィールド 、 値フィールド、および 並べ替えフィールドフィールドから 名前 を選択します。
- ロールと権限 ワークスペースに移動します。
a. 管理者 をクリックし、次に トップレベル タブ タブをクリックします。 [新しいタブの追加] をクリックし、 [オブジェクト ワークスペース]をクリックします。
b. 名前 フィールドに WSCountry と入力し、 オブジェクト フィールドで WSCountry を選択し、 レイアウト フィールドで WSCountry.Autogenerated を選択します。
- スケジュールされたジョブ ワークスペースに移動します。
a. 新しい時間スケジュールを追加します。
a. 名前を付けて、開始時間、終了時間、開始日、終了日を設定し、 Recurr Every フィールドを 1 に設定します。
- Web サービス接続 (ベータ版) ワークスペースに移動します。
a. 新しい外部 BO 統合をクリックします。
b. 次のページで、 外部 BO 名 フィールドで WSCountry を選択します。
c. 次のページの「 サービス参照 」フィールドで、「 新規追加...」を選択します。 サービス参照 フィールドに、 国情報サービスと入力します。
d. サービス アドレス フィールドに、 http://webservices.oorsprong.org/websamples.countryinfo/CountryInfoService.wso?WSDLと入力します。
e. ListOfCountryNamesByCode メソッドを選択します。
f. 次の内容を スクリプト フィールドに貼り付けます。
// 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");- 次へ をクリックし、 スケジュール リストで WSCountryを選択します。
- 次へ をクリックし、次に 公開 今すぐ実行をクリックします。
統合のデモのための サービス申請の作成
- 申請項目 ワークスペースに移動し、新しい申請項目を作成します。
a. サービスとして「 Demo Service 」を選択し、名前として「 WSCountry 」と入力します。 任意のカテゴリを選択してください。
b. Country というドロップダウン フィールドと ISOCodeというテキスト フィールドを追加します。
c. Country フィールドを編集し、 Pick List: Noneの下で、 WSCountry 選択リスト (検証リスト) を選択します。 プロパティの下で、 一意の ID フィールドを WSCountryComboに設定します。
d. ISOCode フィールドを編集し、 Default Valueの下で Expression を選択し、 Triggered by フィールドでは WSCountryを選択します。
e. 「 次へ 」を 2 回クリックします。
f. 新しい組織単位を追加するには、[ 追加 ] をクリックします。 組織単位を選択します。 ステータス を 公開済みに変更します。
- セルフサービス ユーザーとしてログインします。 サービス カタログ ワークスペースに移動します。
- WS_Country 申請項目をクリックして、それが開くことを確認します。
