---
title: Web サービス メソッド
slug: neurons-for-itsm/admin-user-help/jpn/latest/mSok-web
createdAt: 2026-10-29T01:28:25.775Z
---

このセクションでは、使用できる サービス マネージャ Web サービス メソッドを一覧表示します。 これらのメソッドは JavaScript に基づいています。

:::ExpandableHeading
## クイック アクション スクリプトと外部ビジネス オブジェクト スクリプトを使用した Web サービス メソッドの使用について

クイック アクション スクリプトでは、次の Web サービス メソッドがサポートされています。

- URLからWebサービスを取得
- Webサービスを取得する
- クイックアクションの実行
- 作成する
- 得る
- 検索
- Webリクエストの実行
- HtmlEncode
- HtmlDecode
- 16進数からバイト数
- バイトから文字列へ
- ロードXML
- 文化情報を取得
- タイムゾーン情報を取得する
- ハッシュ
- キー付きハッシュ

外部ビジネス オブジェクト スクリプトでは、次の Web サービス メソッドがサポートされています。

- URLからWebサービスを取得
- Webサービスを取得する
- 戻りデータの設定
- 条件の戻りデータの設定
- 得る
- 検索
- Webリクエストの実行
- すべての熱データを同期する
- すべての熱データを関連データと同期する
- 熱データの同期
- 熱データを関連データと同期する
- HtmlEncode
- HtmlDecode
- 16進数からバイト数
- バイトから文字列へ
- ロードXML
- 文化情報を取得
- タイムゾーン情報を取得する
- ハッシュ
- キー付きハッシュ
:::

::::ExpandableHeading
## HeatContext変数について

### 変数

:::Paragraph{indent="1"}
ヒートコンテキスト
:::

### 説明

:::Paragraph{indent="1"}
このコンテキスト変数は、 **SetReturnData** および同期スクリプトで使用できます。 このオブジェクトには、スクリプトが実行される理由に関する情報が含まれています。
:::

### パラメータ

| ロケール         | 「en-US」などのロケール識別子が含まれます。 スクリプトがユーザーアクションの結果として呼び出される場合は、ユーザーセッションに関連付けられたロケールが含まれます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| テナントID       | テナント識別子。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ビジネスオブジェクト   | スクリプトが関連付けられているビジネス オブジェクトに関する情報。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| UIビジネスオブジェクト | スクリプトが検証リスト ビジネス オブジェクトに関連付けられている場合、その検証リスト ビジネス オブジェクトの選択リストがワークスペースで使用されると、その選択リストにはワークスペースに関連付けられたビジネス オブジェクトが含まれます。 たとえば、選択リストが **Incident** ワークスペースで参照されている場合、その選択リストには **Incident** ビジネス オブジェクトに関する情報が含まれます。                                                                                                                                                                                                                                                                                                                                                                                                 |
| ピックリスト       | 選択リストの値を取得するためにスクリプトが呼び出される場合は、選択リストの詳細が含まれます。 選択リストが検証プロバイダーの選択リストであり、サービス カタログで使用されている場合、以下の引数には検証パラメータ名とその値が含まれます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| 引数           | 外部ソースから最新のデータを取得するためにスクリプトが呼び出されると、次の情報が取得されます。<br />リスト: 次の情報を保持するオブジェクトが含まれます。<br />- **FieldFilter**: ユーザーがリストワークスペースにフィルターを定義している場合。<br />- **DefinitionName**: このスクリプトの呼び出しの原因となったリストの名前。<br />- **SearchInfo**: リストが保存された検索を使用してデータを入力する場合、これにはその構造で定義されている検索条件が含まれます。<br />- **DependentInfo**: リストが依存する子タブの一部である場合、これには親ビジネス オブジェクトとその他の情報との関係に関する情報が含まれます。 例としては、MasterObjectTableRef、MasterObjectId、RelationshipTag、DependentRel2Name などがあります。<br />ExecuteScript() を使用して別のスクリプトからスクリプトが呼び出されると、この関数の **Arguments** パラメータに渡された値が含まれます。<br />スクリプトが呼び出されてサービス カタログに検証プロバイダーの選択リストが入力されると、検証パラメータ情報が含まれます。 |


::::

:::ExpandableHeading
## 致命的

### 方法

致命的

### 説明

致命的なメッセージをサーバー ログに書き込みます。

### 意味

```bash
console.fatal(文字列ログメッセージ)
```

### パラメータ

| ログメッセージ | ログに記録されるメッセージ文字列。 |
| ------- | ----------------- |

### 例

次のスクリプトを使用して致命的なメッセージをログに記録できます。

```bash
console.fatal("これは致命的なメッセージです!");
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## エラー

### 方法

エラー

### 説明

エラー メッセージをサーバー ログに書き込みます。

### 意味

```bash
console.error(文字列 ログメッセージ)
```

### パラメータ

| ログメッセージ | ログに記録されるメッセージ文字列。 |
| ------- | ----------------- |

### 例

次のスクリプトを使用してエラー メッセージをログに記録できます。

```bash
console.error("これはエラーメッセージです!")
```

```bash
```
:::

:::ExpandableHeading
## 警告

### 方法

警告

### 説明

警告メッセージをサーバー ログに書き込みます。

### 意味

```bash
console.warn(文字列ログメッセージ)
```

### パラメータ

| ログメッセージ | ログに記録されるメッセージ文字列。 |
| ------- | ----------------- |

### 例

次のスクリプトを使用して警告メッセージをログに記録できます。

```bash
console.warn("これは警告メッセージです!")
```

```bash
```
:::

:::ExpandableHeading
## 情報提供

### 方法

情報提供

### 説明

情報メッセージをサーバー ログに書き込みます。

### 意味

```bash
console.info(文字列ログメッセージ)
```

### パラメータ

| ログメッセージ | ログに記録されるメッセージ文字列。 |
| ------- | ----------------- |

### 例

次のスクリプトを使用して情報メッセージをログに記録できます。

```bash
console.info("これは情報メッセージです!");
```

```bash
```
:::

:::ExpandableHeading
## デバッグ

### 方法

デバッグ

### 説明

デバッグ メッセージをサーバー ログに書き込みます。

### 意味

```bash
console.debug(文字列 logMessage)
```

### パラメータ

| ログメッセージ | ログに記録されるメッセージ文字列。 |
| ------- | ----------------- |

### 例

次のスクリプトを使用してデバッグ メッセージをログに記録できます。

```bash
console.debug("これはデバッグメッセージです!");
```

```bash
```
:::

:::ExpandableHeading
## ログ

### 方法

ログ

### 説明

ログ メッセージをサーバー ログに書き込みます。

### 意味

```bash
console.log(文字列ログメッセージ)
```

### パラメータ

| ログメッセージ | ログに記録されるメッセージ文字列。 |
| ------- | ----------------- |

### 例

次のスクリプトを使用してログ メッセージを記録できます。

```bash
console.log("これはログメッセージです!");
```

```bash
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## URLからWebサービスを取得

### 方法

URLからWebサービスを取得

### 説明

Web サービスを呼び出す Web サービス インスタンス オブジェクトを取得します。

### 意味

```bash
オブジェクト GetWebServiceFromUrl(文字列 serviceUrl、文字列 serviceName、文字列 userName、文字列 password)
```

```bash
オブジェクト GetWebServiceFromUrl(文字列 serviceUrl、文字列 serviceName、文字列 userName、文字列 password、文字列 wsdlPath)
```

### パラメータ

| サービスURL | Web サービスが配置されている URL。                                                                                                                                     |
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| サービス名   | Web サービスの名前。                                                                                                                                              |
| ユーザ名    | Web サービス インスタンスを取得するために必要な資格情報のユーザ名。                                                                                                                      |
| パスワード   | ユーザ名に関連するパスワード。                                                                                                                                           |
| wsdlパス  | Web サービスが WSDL ドキュメントのクエリをサポートしていない場合、このパラメータには Web サービスの WSDL が利用可能な場所が含まれます。<br /><br />これは、 **WSDL およびスクリプト リポジトリ** ワークスペースにリストされている WSDL ドキュメントの名前です。 |

### 戻り値の型

メソッドを呼び出すことができる Web サービス インスタンスであるオブジェクトを返します。

### 例

```bash
var serviceInstance = GetWebServiceFromUrl("http://wsf.cdyne.com/WeatherWS/Weather.asmx", "Weather", null, null);
```

```bash
```

```bash
var serviceInstance = GetWebServiceFromUrl("http://www.webservicex.net/uszip.asmx", "USZip", null, null);
```

```bash
```

```bash
var serviceInstance = GetWebServiceFromUrl("http://sap.local:8000/sap/bc/srt/rfc/sap/ict_service_desk_api/100/ict_service_desk_api/ict_service_desk_api", "ICT_SERVICE_DESK_API", null, null, 'Name of SAP WSDL document in the repository');
```

```bash
```

```bash
var serviceInstance = GetWebServiceFromUrl(null, "USZip", null, null, "http://www.webservicex.net/uszip.asmx?wsdl");
```

```bash
```

```bash
var serviceInstance = GetWebServiceFromUrl('http://www.webservicex.net/uszip.asmx', "USZip", null, null, "http://www.webservicex.net/uszip.asmx?wsdl");
```

```bash
```
:::

:::ExpandableHeading
## Webサービスを取得する

### 方法

Webサービスを取得する

### 説明

Web サービスを呼び出すために必要な Web サービス インスタンス オブジェクトを取得します。

### 意味

```bash
GetWebService(文字列サービス参照名、文字列サービス名)
```

### パラメータ

| サービス参照名 | サービス参照の名前。 名前はスクリプトごとに一意である必要があります。 スクリプト内のサービス アドレス URL を識別します。 |
| ------- | ---------------------------------------------------------------- |
| サービス名   | Web サービスの名前。                                                     |

### 戻り値の型

メソッドを呼び出すことができる Web サービス インスタンスであるオブジェクトを返します。

### 例

```bash
var serviceReferenceName = "TestIntegration";
```

```bash
var wsdlAddress = "TestIntegration.TestIntegration.Address";
```

```bash
var userId = "TestIntegration.TestIntegration.Login";
```

```bash
var pwd = "TestIntegration.TestIntegration.Password";
```

```bash
var serviceName = "FRSHEATIntegration";
```

```bash
var serviceInstance = GetWebService (TestIntegration, FRSHEATIntegration);
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## 呼び出しメソッド

### 方法

呼び出しメソッド

### 説明

指定された Web サービス メソッドを呼び出します。

### 意味

```bash
オブジェクト service.InvokeMethod(文字列 methodName, オブジェクト[] 引数);
```

```bash
オブジェクト service.InvokeMethod(文字列 methodName、オブジェクト arguments);
```

### パラメータ

| メソッド名 | 呼び出す Web メソッドの名前。                                      |
| ----- | ------------------------------------------------------ |
| 引数    | Web メソッドの入力パラメータ。 位置引数の配列、またはパラメータの名前と値を含むオブジェクトのいずれか。 |

### 戻り値の型

Web サービス呼び出しの結果をオブジェクトとして返します。

### 例

```bash
```

```bash
var serviceInstance = GetWebServiceFromUrl("http://www.webservicex.net/uszip.asmx", "USZip", null, null);
```

```bash
var xmlDoc = serviceInstance.InvokeMethod("GetInfoByState", [ state ]);
```

```bash
var xmlDoc = serviceInstance.InvokeMethod("GetInfoByState", { 'USState' : state });
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## Cookie値を取得する

### 方法

Cookie値を取得する

### 説明

ユーザ名とパスワードを認証するときに使用される、Cookie 内の認証トークンにアクセスします。

### 意味

```bash
GetCookieValue(文字列 URL、文字列名)
```

### パラメータ

| メールアドレス | アクセスされている Cookie に関連付けられた URL。 |
| ------- | ------------------------------ |
| 名前      | 値を取得する必要がある Cookie の名前。        |

### 戻り値の型

認証トークンの値を返します。

### 例

次のスクリプトを使用して、AuthToken という Cookie を取得できます。

```bash
var wsdlAddress = "SunRise.WebServiceXSunRise.Address";
```

```bash
var userId = "SunRise.WebServiceXSunRise.Login";
```

```bash
var pwd = "SunRise.WebServiceXSunRise.Password";
```

```bash
var serviceCall = "SunSetRiseService";
```

```bash
var serviceInstance = GetWebServiceFromUrl(wsdlAddress, serviceCall, userId,pwd);
```

```bash
var result = serviceInstance.InvokeMethod(methodCall, paramValues);
```

```bash
var authToken = serviceInstance.GetCookieValue('/', 'AuthToken');
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## クイックアクションの実行

### 方法

クイックアクションの実行

### 説明

特定のクイックアクションを実行します。

このメソッドは、オプションの引数を使用して、指定された RecID に影響を与える指定されたビジネス オブジェクトで定義された特定のクイック アクションを実行します。

### 意味

```bash
ExecuteQuickAction(文字列アクション名)
```

```bash
ExecuteQuickAction(文字列 actionName、文字列 tableRef、文字列 recId)
```

### パラメータ

| アクション名 | クイックアクションの名前。          |
| ------ | ---------------------- |
| テーブル参照 | レコードが作成されるテーブルのテーブル参照。 |
| 受信ID   | データが必要なレコードの RecID。    |

### 例

アプリケーションは、**インシデント**ビジネス オブジェクトの現在のオブジェクト コンテキストで**インシデント所有者への問題回避策通知**クイック アクションを実行します。

```bash
ExecuteQuickAction("インシデント所有者への問題回避策通知");
```

アプリケーションは、指定されたインシデントに対して、インシデント所有者 **の** 問題回避策通知クイック アクションを実行します。ここで、IncidentRecId は、ターゲット インシデントの RecID で初期化されるスクリプト変数です。

```bash
ExecuteQuickAction("インシデント所有者への問題回避策通知", "インシデント
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## スクリプトの実行

### 方法

スクリプトの実行

### 説明

指定された外部ビジネス オブジェクトに関連付けられたスクリプトを実行します。

### 意味

```bash
ExecuteScript(文字列 boDesignerName、オブジェクト引数)
```

### パラメータ

| boデザイナー名 | 外部ビジネス オブジェクトの名前。                                                   |
| -------- | ------------------------------------------------------------------- |
| 引数       | b**oDesignerName&#x20;**&#x30D1;ラメータによって指定された外部ビジネス オブジェクトの入力パラメータ。 |

### 戻り値の型

S**etReturnData&#x20;**&#x57;eb メソッドを使用して返される JSON オブジェクト。

### 例

```bash
var boDesignerName = RELATED_BO_FRS_WS_DSM_SOFTWAREREVISION_DESIGNER_NAME;
```

```bash
var arguments = { Requester: { BOName: CURRENT_CONTEXT_BO_DESIGNER_NAME } };
```

```bash
var scriptReturn = ExecuteScript(boDesignerName, arguments);
```

```bash
```

```bash
```
:::

:::ExpandableHeading{customAnchorSlug="SetRetur"}
## 戻りデータの設定

### 方法

戻りデータの設定

### 説明

この値を使用して、選択リストのデータまたは別の同期スクリプトから呼び出されたデータを返します。

このメソッドを複数回呼び出すと、アプリケーションは最後の呼び出しで設定された値を使用します。

### 意味

```bash
SetReturnData(オブジェクト)
```

```bash
SetReturnData(オブジェクト[] jsonObject)
```

### パラメータ

| jsonオブジェクト | E**xecuteScript&#x20;**&#x57;eb メソッドを使用して別のスクリプトから呼び出された場合、これはスクリプトが呼び出し元のスクリプトに返す JSON データです。<br />選択リストのレコードを取得するために呼び出された場合、これはキーと値のペアの配列になります。 例えば：<br />`関数 State(名前、コード)`<br />`{`<br />`this.Name = 名前;`<br />`this.Code = コード;`<br />`}` |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |

### 戻り値の型

選択リストの場合、戻り値の型は、外部ビジネス オブジェクトで定義されたフィールドを含むオブジェクトの配列です。

同期スクリプトの場合、戻り値の型は任意の型にすることができます。

### 例

```bash
// http://www.webservicex.net/uszip.asmx
```

```bash
関数 ZipInfo(市、州、郵便番号、エリアコード、タイムゾーン)
```

```bash
{
```

```bash
this.City = 都市;
```

```bash
this.State = 状態;
```

```bash
zip ファイルを解凍します。
```

```bash
this.AreaCode = エリアコード;
```

```bash
this.TimeZone = タイムゾーン;
```

```bash
}
```

```bash
関数 getCities(state)
```

```bash
{
```

```bash
if (!状態)
```

```bash
return [];
```

```bash
var serviceInstance = GetWebService("USZip", "USZip");
```

```bash
var xmlDoc = serviceInstance.InvokeMethod("GetInfoByState", [ state ]);
```

```bash
var list = xmlDoc.ChildNodes;
```

```bash
if (!リスト)
```

```bash
return [];
```

```bash
var cities = {};
```

```bash
var count = list.Count;
```

```bash
(i = 0; i < count; i ) の場合
```

```bash
{
```

```bash
試す {
```

```bash
var node = list[i];
```

```bash
var info = new ZipInfo(node["CITY"].InnerText, node["STATE"].InnerText, node["ZIP"].InnerText,
```

```bash
node["AREACODE"].InnerText、node["TIMEZONE"].InnerText);
```

```bash
都市[info.City.toUpperCase()] = 情報;
```

```bash
} catch (error)
```

```bash
{
```

```bash
console.log("都市の処理中にエラーが発生しました。");
```

```bash
}
```

```bash
}
```

```bash
var result = [];
```

```bash
(都市内の都市)
```

```bash
result.push(cities[city]);
```

```bash
結果を返します。
```

```bash
}
```

```bash
var state = null;
```

```bash
if (!!HeatContext.PickList)
```

```bash
{
```

```bash
試す {
```

```bash
状態 = HeatContext.PickList.Constraint.Conditions[0].Value;
```

```bash
} catch (error) {
```

```bash
コンソールにログ出力します。
```

```bash
}
```

```bash
// 選択リストにこのデータを返します
```

```bash
条件に一致するデータを設定します。 [] : getCities(state), { State : state});
```

```bash
}
```

```bash
そうでない場合 (!!HeatContext.Arguments !!HeatContext.Arguments.Synchronize !!HeatContext.Arguments.State)
```

```bash
{ state = HeatContext.Arguments.State;
```

```bash
HeatData を同期します (HeatContext.BusinessObject.DesignerName、["State", "City"]、getCities(state)、{ State : state});
```

```bash
}
```

```bash
そうでない場合 (!!HeatContext.Arguments !!HeatContext.Arguments.State)
```

```bash
{
```

```bash
// ExecuteScript を通じて呼び出されると、指定された州の都市のリストが返されます。
```

```bash
状態 = HeatContext.Arguments.State;
```

```bash
SetReturnData(!state ? [] : getCities(state));
```

```bash
}
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## 条件の戻りデータの設定

### 方法

条件の戻りデータの設定

### 説明

選択リストのデータを返します。

このメソッドを複数回呼び出すと、アプリケーションは最後の呼び出しで設定された値を使用します。

### 意味

```bash
SetReturnDataForCondition(オブジェクト[] レコード、オブジェクト whereCondition)
```

### パラメータ

| 記録 | 選択リストのレコードを取得するために呼び出された場合、これはキーと値のペアの配列になります。 例えば：<br />`関数 State(名前、コード)`<br />`{`<br />`this.Name = 名前;`<br />`this.Code = コード;`<br />`}`                 |
| -- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 条件 | 操作対象となるデータの範囲を定義します。 たとえば、 [戻りデータの設定](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/mSok-web#SetRetur)の例では、外部ソースからデータが取得される現在の状態コードです。 |

### 戻り値の型

外部ビジネス オブジェクトで定義されたフィールドを含むオブジェクトの配列。

### 例

S[戻りデータの設定](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/mSok-web#SetRetur)例を参照してください。

```bash
```
:::

:::ExpandableHeading
## 作成する

### 方法

作成する

### 説明

サービス マネージャに新しいレコードを作成します。

### 意味

```bash
DbObject 作成(文字列テーブル参照)
```

### パラメータ

| テーブル参照 | レコードが作成されるテーブルのテーブル参照。 |
| ------ | ---------------------- |

### 例

次のスクリプトを使用して新規インシデントを作成できます。

```bash
var newIncident = Create('Incident#');
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## 得る

### 方法

得る

### 説明

指定されたテーブル参照からレコード ID を使用して、既存のレコードのオブジェクトを取得します。

### 意味

```bash
Get(文字列テーブル参照、文字列recId)
```

```bash
Get(文字列テーブル参照、文字列フィールド名、オブジェクト値)
```

### パラメータ

| テーブル参照 | レコードが作成されるテーブルのテーブル参照。                        |
| ------ | --------------------------------------------- |
| 受信ID   | データが必要なレコードの RecID。                           |
| フィールド名 | 現在のビジネス オブジェクト内のフィールドの名前。                     |
| 価値     | f**ieldName&#x20;**&#x30D1;ラメータで指定されたフィールドの値。 |

### 例

次のスクリプトを使用して、 **CurrentUserRecId** という組み込み関数を呼び出して、現在のユーザーの姓などのデータを読み取ります。

```bash
var employee = Get('Employee#', '$(CurrentUserRecId())')
```

```bash
var lastName = employee.Fields['LastName'];
```

次の例では、インシデント番号が 100001 のインシデントを取得します。

```bash
Get("インシデント
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## アップデート

### 方法

アップデート

### 説明

レコードを更新します。

### 意味

```bash
更新(オブジェクトデータ)
```

### パラメータ

| データ | このメソッドが呼び出されるレコード オブジェクト (DbObject) で更新されるキーと値のペアを含む JSON のようなオブジェクト (\{\<key1>: '\<value>'€™, \<key2>: '\<value2>'™, ...})。 |
| --- | ---------------------------------------------------------------------------------------------------------------------------- |

### 例

このメソッドを使用して、レコードを編集または更新できます。 たとえば、2 つのフィールドを編集するには、次のスクリプトを使用します。このスクリプトは、現在のインシデントの番号と RecID を取得し、 **Impact** と **Symptom**という 2 つのフィールドを更新します。

```bash
var incident = Get('Incident#', '$(RecId)');
```

```bash
インシデント.更新({
```

```bash
影響度: 「中」、
```

```bash
詳細: 「問題」
```

```bash
});
```

もう 1 つの使用例としては、ドメイン アカウントがロックされるたびに、フィールドが自動入力された新規インシデントを自動的に作成することが挙げられます。 例えば、以下のスクリプトは新しいインシデントを作成し、その後、そのインシデントを新しいフィールド値で更新し、詳細に「ドメインアカウントがロックされている」と明確に記述します。

```bash
var newIncident = Create('Incident#');
```

```bash
新規インシデント.更新({
```

```bash
カテゴリ: 「アカウントロックアウト」、
```

```bash
影響度: 「中」、
```

```bash
プロファイルリンクレコードID: '$(CurrentUserRecId())',
```

```bash
サービス: 「デスクトップ サービス」
```

```bash
ステータス: 「アクティブ」、
```

```bash
件名: 「Windowsにログインできません」
```

```bash
詳細: 「顧客が3回以上Windowsにログインできず、ドメインアカウントがロックされています」
```

```bash
緊急度: 「中」
```

```bash
});
```

```bash
```
:::

:::ExpandableHeading
## リンクを追加

### 方法

リンクWebサービス

### 説明

Web サービスは、2 つの異なるビジネス オブジェクトをリンクするために使用されます。

### 意味

```bash
AddLink(文字列 tableRef、文字列 id、文字列 otherTableRef、文字列 otherId、文字列 relationshipTag)
```

### パラメータ

| 文字列テーブル参照  | ビジネス オブジェクト名。                  |
| ---------- | ------------------------------ |
| 文字列ID      | ビジネス オブジェクト レコード ID。           |
| その他のテーブル参照 | リンクするビジネス オブジェクト名。             |
| 文字列その他のID  | リンクする必要があるビジネス オブジェクト レコード ID。 |
| 文字列関係タグ    | 2 つのビジネス オブジェクトの関係。            |

### 例

**インシデントと変更のリンク:**

```bash
AddLink('インシデント
```

**問題をインシデントにリンクする:**

```bash
AddLink('インシデント
```

### 更新フィールド

### 方法

更新フィールド

### 説明

レコードのフィールドを更新します。

### 意味

```bash
UpdateField(文字列フィールド名、文字列フィールド値)
```

### パラメータ

| フィールド名 | 更新するフィールドの名前。 |
| ------ | ------------- |
| フィールド値 | フィールドの値。      |

### 例

次のスクリプトを使用して、 **件名** フィールドを編集します。

```bash
incident.UpdateField('Subject', '新しいレコードを開いてください');
```


:::

::::ExpandableHeading{customAnchorSlug="Search"}
## 検索

### 方法

検索

### 説明

検索条件なしでコレクションを取得します。

### 意味

```bash
検索(文字列テーブル参照)
```

```bash
検索(文字列 tableRef、文字列 savedSearch)
```

```bash
検索(文字列 tableRef、オブジェクト simpleSearch)
```

### 返品

2 セットの機能を提供するオブジェクトを返します。

:::Paragraph{listStyleType="disc" indent="2"}
最初の関数セットは、検索動作を作成、結合、カスタマイズします。
:::

:::Paragraph{listStyleType="disc" indent="3"}
現在のビジネス オブジェクトにアクセスしたり、関連アイテムを結合したりするには、 **RelatedItems** プロパティを使用します。 結合条件を構築するには、 **RelatedItems** を通じてリレーションシップ名を使用します。
:::

:::Paragraph{listStyleType="disc" indent="3"}
関連するビジネス オブジェクトに条件を追加するには、 **Where(object simpleSearch)** を使用します。
:::

:::Paragraph{listStyleType="disc" indent="3"}
検索関数に個別の動作を追加するには、 **Distinct()** を使用します。
:::

:::Paragraph{listStyleType="disc" indent="3"}
取得する必要があるレコードの数を制限するには、 **Top(nRecords)** を使用します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
2 番目の関数セットは、検索操作の結果を列挙します。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**TableRef**: 検索結果のビジネス オブジェクト名。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**First()**: 最初のビジネス オブジェクトを返します。結果が空の場合は 'null' を返します。 返されるビジネス オブジェクトには、フィールドとその値のオブジェクトである **Fields** というプロパティがあります。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**現在**: **MoveNext()** が true を返す場合、現在のビジネス オブジェクトを返します。 返されるビジネス オブジェクトには、フィールドとその値のオブジェクトである **Fields** というプロパティがあります。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**MoveNext()**: 存在する場合はカーソルを次のビジネス オブジェクトに移動し、true を返します。 それ以外の場合は、アクセスするビジネス オブジェクトがもう存在しないことを示す false を返します。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**Reset()**: カーソルを結果リストの先頭にリセットします。
:::

:::Paragraph{listStyleType="disc" indent="3"}
**Close()**: 結果セットを閉じて、検索で使用されたリソースを解放します。
:::

:::hint{type="info"}
結果の処理を開始する前に、検索条件と動作を完全に定義する必要があります。 結果の処理を開始したら、結果セット全体を処理する必要があります。 そうしないと、さらにデータベース操作を行うとエラーが発生し、例外がスローされる可能性があります。 結果セットを完全に処理するには、 **MoveNext()** 関数を使用してすべてのビジネス オブジェクトを列挙し、false を返すまで続けるか、 **Close()** 関数を呼び出します。•
:::

### パラメータ

| テーブル参照 | 結果が取得されるテーブルのテーブル参照。 |
| ------ | -------------------- |
| 保存済み検索 | 保存された検索の名前。          |
| シンプル検索 | 追加の検索フィルター。          |

### 例

検索条件なしでコレクションを取得するには、次のスクリプトを使用します。

```bash
検索('インシデントステータス
```

以下は、コレクションを取得するスクリプトの別の例です。

```bash
検索('インシデント
```

```bash
ステータス: 「アクティブ」、
```

```bash
プロファイルリンクレコードID: '$(CurrentUserRecId())'
```

```bash
});
```

番号 10424 のインシデントを取得するには、次のいずれかのスクリプトを使用します。

```bash
• var インシデント = Get('インシデント
```

```bash
• var インシデント = Get('インシデント
```

```bash
• var incident = Search('Incident#', { IncidentNumber : 10424 }).First();
```

これは別の例です:

```bash
var incident = null;
```

```bash
var result = Search('Incident#', { Status: 'Active' });
```

```bash
(result.MoveNext()) の間 {
```

```bash
var obj = result.Current;
```

```bash
if (obj.Fields["IncidentNumber"] == 100) {
```

```bash
インシデント = obj;
```

```bash
壊す;
```

```bash
}
```

```bash
}
```

```bash
結果.Close();
```

関係に基づいてレコードを検索するには、次のスクリプトを使用します。 この例では、スクリプトは指定されたインシデントのタスクを取得します。

```bash
var tasks = Get('Incident#', '$(RecId)')
```

```bash
.RelatedItems['Task#Assignment.Rev3'];
```

```bash
```

```bash
var votes = Search('Change#', {Status: 'Scheduled'})
```

```bash
.RelatedItems['FRS_Approval#.']
```

```bash
.RelatedItems['FRS_ApprovalVoteTracking#.'];
```

```bash
```

```bash
```

```bash
```
::::

:::ExpandableHeading
## どこ

### 方法

どこ

### 説明

条件を満たすオブジェクトのコレクションをフィルタリングします。 W**here&#x20;**&#x30E1;ソッドを S**earch&#x20;**&#x30E1;ソッドとともに使用します。  参照: [検索](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/mSok-web#Search)および [アップデート](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/mSok-web#Update)

### 意味

```bash
DbObjectCollection Where(文字列条件)
```

### パラメータ

| 状態 | 出力の基準となる条件式。 |
| -- | ------------ |

### 例

タスクのステータスが「拒否」であるレコードを選択するには、次のスクリプトを使用します。

```bash
var rejectingItems = Search('Task#Assignment')
```

```bash
.Where({ステータス: '拒否'})
```

検証済みのフィールドのセットを使用してレコードを検索するには、次のスクリプトを使用します。 この例では、スクリプトは拒否ステータスのタスクを持つチーム メンバーを取得します。

```bash
var rejectingTeams = Search('Task#Assignment')
```

```bash
.Where({Status: 'Rejected'}) // タスクのステータスが拒否されたレコードを選択
```

```bash
.RelatedItems['Owner => Employee#']
```

```bash
.RelatedItems['Team => StandardUserTeam#']
```

```bash
.Distinct() // 重複のない一意のレコードを選択します
```

```bash
.Top(20); // 上位20件のレコードを選択する
```

```bash
```

```bash
```
:::

::::ExpandableHeading
## Webリクエストの実行

### 方法

Webリクエストの実行

### 説明

HTTP Web 申請を実行し、要求の応答を返します。

### 意味

```bash
ExecuteWebRequest(文字列メソッド、文字列 URL、文字列 postData、オブジェクト設定);
```

```bash
ExecuteWebRequest(文字列メソッド、文字列URL、byte[] postData、オブジェクト設定);
```

### パラメータ

| 方法      | GET、POST、HEAD、DELETE などの有効な HTTP リクエスト メソッド。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| メールアドレス | クエリ文字列値を含む HTTP リクエスト URL。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| 投稿データ   | リクエストの一部として送信される、適切にフォーマットされ、文字列または byte\[] でエンコードされた投稿データが含まれます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| 設定      | オプション。 JSON オブジェクトが含まれます。 メンバーも任意です。<br />**ヘッダー**: 顧客ヘッダーを含む追加の HTTP リクエスト ヘッダーを含む JSON オブジェクト。 例えば：<br />`{`<br />`「ホスト」:「www.example.com」、`<br />`「リファラー」:「」,`<br />`「ユーザーエージェント」:「HEATSM スクリプト」、`<br />`"Content-Type" : "application/x-www-form-urlencoded"`<br />`}`<br />**クッキー**: JSON オブジェクトであり、オプションです。 渡された場合、Cookie 名がプロパティ名として使用され、その値がプロパティ値として使用されます。 例えば：<br />`{`<br />`"CookieName" : "CookieValue"`<br />`}`<br />**SkipServerCertificateValidation**: HTTPS 要求呼び出し中に証明書エラーを処理する方法を制御するブール値。<br />**ServerCertificateHash**: オプション。 文字列値。 指定すると、証明書のハッシュ値がこの値と一致する場合に証明書エラーがスキップされます。<br />**AllowAutoRedirect**: リクエスト呼び出しのリダイレクトを自動的に処理し、リダイレクト要求の応答を返します。<br />**ユーザ名**: オプション。 資格情報のユーザ名。<br />**パスワード**: オプション。 資格情報のパスワード。 |

### 返品

HTTP リクエスト呼び出しからの応答を返します。 この戻り値は、次のプロパティを含む JSON オブジェクトです。

:::Paragraph{listStyleType="disc" indent="2"}
**StatusCode**: 応答ステータスコードの数値。 h[ttps://msdn.microsoft.com/en-us/library/system.net.httpstatuscode(v=vs.110).aspxを](https://msdn.microsoft.com/en-us/library/system.net.httpstatuscode\(v=vs.110\).aspx)参照してください。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**StatusDescription**: ステータス コードの説明。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**CharacterSet**: 応答データの文字セット名。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**ContentType**: 応答コンテンツのタイプ。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**ContentLength**: 応答コンテンツの長さ。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**前回の変更**: 応答の最後に変更されたヘッダー。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**クッキー**: 応答に関連するクッキーを含む JSON オブジェクト。
:::

:::Paragraph{listStyleType="disc" indent="2"}
**データ**: 文字列 (テキスト コンテンツの場合) または byte\[] (テキスト以外のコンテンツの場合)。
:::

### 例

```bash
```

```bash
// REST API をラップする JavaScript オブジェクト
```

```bash
```

```bash
関数 CustomService(ホスト、ユーザ名、パスワード)
```

```bash
{
```

```bash
'use strict';
```

```bash
// プライベートメンバー
```

```bash
var Host = host;
```

```bash
var UserName = userName;
```

```bash
var Password = password;
```

```bash
var Cookies = null;
```

```bash
var SessionInfo = null;
```

```bash
var getWWWFormUrlEncodedData = function (obj)
```

```bash
{
```

```bash
var encoded = '', separator = '';
```

```bash
(var キー in obj)
```

```bash
{
```

```bash
var value = obj[key];
```

```bash
var encodedKey = HeatUtility.HtmlEncode(key.toString());
```

```bash
if (typeof 値 === 'undefined' || null == 値)
```

```bash
エンコード = セパレーター エンコードキー;
```

```bash
そうでない場合 (配列のインスタンスの値)
```

```bash
{
```

```bash
(var i = 0; i < 値.長さ; i ) の場合
```

```bash
{
```

```bash
エンコード = セパレーター エンコードキー '=' HeatUtility.HtmlEncode(value[i] '');
```

```bash
セパレータ = '';
```

```bash
}
```

```bash
}
```

```bash
それ以外
```

```bash
エンコード = セパレーター エンコードキー '=' HeatUtility.HtmlEncode(value.toString());
```

```bash
セパレータ = '';
```

```bash
}
```

```bash
エンコードされた値を返します。
```

```bash
};
```

```bash
var getRequestSettings = function ()
```

```bash
{
```

```bash
戻る {
```

```bash
ヘッダー: {},
```

```bash
クッキー: クッキー、
```

```bash
SkipServerCertificateValidation: true、
```

```bash
ユーザ名: null、
```

```bash
パスワード: null、
```

```bash
自動リダイレクトを許可: false
```

```bash
};
```

```bash
};
```

```bash
var getJsonRequestSettings = function ()
```

```bash
{
```

```bash
戻る {
```

```bash
ヘッダー: { 'Content-Type': 'application/json' },
```

```bash
クッキー: クッキー、
```

```bash
SkipServerCertificateValidation: true、
```

```bash
ユーザ名: null、
```

```bash
パスワード: null、
```

```bash
自動リダイレクトを許可: false
```

```bash
};
```

```bash
};
```

```bash
var isAuthenticated = function ()
```

```bash
{
```

```bash
!!SessionInfo !!SessionInfo.tenantID を返します。
```

```bash
};
```

```bash
var login = function ()
```

```bash
{
```

```bash
var url = Host + '/patchweb/tenant/v1/login?' + getWWWFormUrlEncodedData({ username: UserName, password: Password });
```

```bash
var response = ExecuteWebRequest('GET', url, null, getRequestSettings());
```

```bash
if ((レスポンス != null) (response.StatusCode == 200) (response.ContentType == 'application/json'))
```

```bash
{
```

```bash
クッキー = response.Cookies;
```

```bash
var sessionInfo = JSON.parse(response.Data);
```

```bash
if (!!セッション情報 !!セッション情報.テナントID)
```

```bash
{
```

```bash
セッション情報 = セッション情報;
```

```bash
true を返します。
```

```bash
}
```

```bash
}
```

```bash
false を返します。
```

```bash
};
```

```bash
var getAllEndPoints = function (groups)
```

```bash
{
```

```bash
if (!isAuthenticated())
```

```bash
throw 'ログインに失敗したか、ログインしてください。';
```

```bash
var url = Host + '/patchweb/patchmanagement/v1/' + SessionInfo.tenantID + '/endpointpatchstates?groups=' + HeatUtility.HtmlEncode(groups);
```

```bash
var response = ExecuteWebRequest('GET', url, null, getRequestSettings());
```

```bash
if ((レスポンス != null) (response.StatusCode == 200) (response.ContentType == 'application/json'))
```

```bash
JSON.parse(response.Data) を返します。
```

```bash
console.error(応答);
```

```bash
};
```

```bash
// パブリック関数
```

```bash
this.isAuthenticated = isAuthenticated;
```

```bash
this.login = ログイン;
```

```bash
this.getAllEndPoints = getAllEndPoints;
```

```bash
}
```

```bash
var service = new CustomService('https://www.example.com', 'userName', 'password');
```

```bash
サービスにログインします。
```

```bash
（サービスが認証されている場合）{
```

```bash
var endpoints = service.getAllEndPoints('default,excluded');
```

```bash
console.debug(エンドポイント);
```

```bash
}
```

```bash
それ以外
```

```bash
console.error('ユーザーuserNameのログインに失敗しました。');
```

```bash
```

```bash
```
::::

::::ExpandableHeading{customAnchorSlug="Synchron"}
## すべての熱データを同期する

### 方法

すべての熱データを同期する

### 説明

次の操作を実行して、提供されたレコードをアプリケーション内のビジネス オブジェクトのすべてのレコードと同期します。

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコードに見つからない、アプリケーション (ビジネス オブジェクト) 内のレコードをすべて削除します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコード内で見つかったが、アプリケーションにまだ存在しないレコードを (ビジネス オブジェクトの) アプリケーションに挿入します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコードに対して、アプリケーション内のレコード (ビジネス オブジェクトのレコード) を更新します。
:::

### 戻り値の型

この関数は、レコードの RecID の配列を返します。

### 意味

```bash
object[] SynchronizeAllHeatData(string designerName, string[] primaryKey, object[] records)
```

### パラメータ

| デザイナー名  | 同期されるビジネス オブジェクトの名前。                |
| ------- | ----------------------------------- |
| プライマリキー | 各レコードを一意に識別するフィールドの配列。              |
| 記録      | フィールドとそれに対応する値を含む JSON キーと値のペアのリスト。 |

### 例

```bash
関数 State(名前、コード)
```

```bash
{
```

```bash
this.Name = 名前;
```

```bash
this.Code = コード;
```

```bash
}
```

```bash
var result = [];
```

```bash
result.push(new State('Alabama', 'AL'));
```

```bash
result.push(new State('Montana', 'MT'));
```

```bash
result.push(new State('Alaska', 'AK'));
```

```bash
result.push(new State('Nebraska', 'NE'));
```

```bash
result.push(new State('Arizona', 'AZ'));
```

```bash
result.push(new State('Nevada', 'NV'));
```

```bash
result.push(new State('Arkansas', 'AR'));
```

```bash
result.push(new State('New Hampshire', 'NH'));
```

```bash
result.push(new State('California', 'CA'));
```

```bash
result.push(new State('New Jersey', 'NJ'));
```

```bash
result.push(new State('Colorado', 'CO'));
```

```bash
result.push(new State('New Mexico', 'NM'));
```

```bash
result.push(new State('Connecticut', 'CT'));
```

```bash
result.push(new State('New York', 'NY'));
```

```bash
result.push(new State('Delaware', 'DE'));
```

```bash
result.push(new State('North Carolina', 'NC'));
```

```bash
result.push(new State('Florida', 'FL'));
```

```bash
result.push(new State('North Dakota', 'ND'));
```

```bash
result.push(new State('Georgia', 'GA'));
```

```bash
result.push(new State('Ohio', 'OH'));
```

```bash
result.push(new State('Hawaii', 'HI'));
```

```bash
result.push(new State('Oklahoma', 'OK'));
```

```bash
result.push(new State('Idaho', 'ID'));
```

```bash
result.push(new State('Oregon', 'OR'));
```

```bash
result.push(new State('Illinois', 'IL'));
```

```bash
result.push(new State('Pennsylvania', 'PA'));
```

```bash
result.push(new State('Indiana', 'IN'));
```

```bash
result.push(new State('Rhode Island', 'RI'));
```

```bash
result.push(new State('Iowa', 'IA'));
```

```bash
result.push(new State('South Carolina', 'SC'));
```

```bash
result.push(new State('Kansas', 'KS'));
```

```bash
result.push(new State('South Dakota', 'SD'));
```

```bash
result.push(new State('Kentucky', 'KY'));
```

```bash
result.push(new State('Tennessee', 'TN'));
```

```bash
result.push(new State('Louisiana', 'LA'));
```

```bash
result.push(new State('Texas', 'TX'));
```

```bash
result.push(new State('Maine', 'ME'));
```

```bash
result.push(new State('Utah', 'UT'));
```

```bash
result.push(new State('Maryland', 'MD'));
```

```bash
result.push(new State('Vermont', 'VT'));
```

```bash
result.push(new State('Massachusetts', 'MA'));
```

```bash
result.push(new State('Virginia', 'VA'));
```

```bash
result.push(new State('Michigan', 'MI'));
```

```bash
result.push(new State('Washington', 'WA'));
```

```bash
result.push(new State('Minnesota', 'MN'));
```

```bash
result.push(new State('West Virginia', 'WV'));
```

```bash
result.push(new State('Mississippi', 'MS'));
```

```bash
result.push(new State('Wisconsin', 'WI'));
```

```bash
result.push(new State('Missouri', 'MO'));
```

```bash
result.push(new State('Wyoming', 'WY'));
```

```bash
if (!!HeatContext.PickList)
```

```bash
{
```

```bash
// 選択リストにこのデータを返します
```

```bash
SetReturnData(結果);
```

```bash
}
```

```bash
そうでない場合 (!!HeatContext.Arguments !!HeatContext.Arguments.WebService)
```

```bash
{
```

```bash
(HeatContext.Arguments.WebService.Synchronize == '選択済み') の場合
```

```bash
{
```

```bash
// 指定された結果リスト/配列で使用可能なレコードのみを同期します。
```

```bash
// こことデータベース内に存在するすべてのレコードが更新されます。
```

```bash
// ここに存在し、データベースに存在しないレコードは挿入されます
```

```bash
HeatData を同期します (HeatContext.BusinessObject.DesignerName、['コード']、結果)。
```

```bash
}
```

```bash
そうでない場合 (HeatContext.Arguments.WebService.Synchronize == 'All')
```

```bash
{
```

```bash
// 指定された結果リスト/配列で使用可能なレコードのみを同期します。
```

```bash
// こことデータベース内に存在するすべてのレコードが更新されます。
```

```bash
// ここに存在し、データベースに存在しないレコードは挿入されます
```

```bash
// データベース内のレコードのうちこのリストに含まれていないものは削除されます
```

```bash
SynchronizeAllHeatData(HeatContext.BusinessObject.DesignerName、['コード']、結果);
```

```bash
}
```

```bash
そうでない場合 (HeatContext.Arguments.WebService.Synchronize == 'Clear')
```

```bash
{
```

```bash
// 指定されたリストが空なので、データベース内のすべてのレコードが削除されます。
```

```bash
すべてのHeatDataを同期します(HeatContext.BusinessObject.DesignerName、['コード']、[]);
```

```bash
}
```

```bash
}
```

```bash
```

```bash
```
::::

::::ExpandableHeading{customAnchorSlug="Synchron2"}
## すべての熱データを関連データと同期する

### 方法

すべての熱データを関連データと同期する

### 説明

次の操作を実行して、提供されたレコードを、アプリケーション内のビジネス オブジェクトおよび関連するビジネス オブジェクトのすべてのレコードと同期します。

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコードに見つからないアプリケーション内のレコード (ビジネス オブジェクトおよび関連するビジネス オブジェクト) を削除します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコード内で見つかったが、アプリケーションにまだ存在しないレコード (ビジネス オブジェクトおよび関連するビジネス オブジェクト) をアプリケーションに挿入します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコードに対して、アプリケーション内のレコード (ビジネス オブジェクトおよび関連するビジネス オブジェクト) を更新します。
:::

### 戻り値の型

この関数は、レコードの RecID の配列を返します。

### 意味

```bash
object[] SynchronizeAllHeatDataWithRelated(string designerName, string[] primaryKey, object[] records, object keysOfRelatedObjects)
```

### パラメータ

| デザイナー名      | 同期されるビジネス オブジェクトの名前。                                                   |
| ----------- | ---------------------------------------------------------------------- |
| プライマリキー     | 各レコードを一意に識別するフィールドの配列。                                                 |
| 記録          | フィールドとそれに対応する値を含む JSON キーと値のペアのリスト。                                    |
| 関連オブジェクトのキー | 次のように構築される JSON オブジェクト:<br />\{<br />リレーションシップ名: 文字列\[] プライマリキー<br />} |

### 例

```bash
関数 getExternalData(ctx)
```

```bash
{
```

```bash
```

```bash
// 外部ソースからデータを取得するためのコード
```

```bash
```

```bash
return [];
```

```bash
}
```

```bash
関数 ToHeatRecords(softwareList, sofrwareType, schemaTagToSoftwareType)
```

```bash
{
```

```bash
var arrFinalizedSoftwareList = [];
```

```bash
var isOptionalSoftware = (sofrwareType == 'OptionalSoftware');
```

```bash
(ソフトウェアリスト内の変数項目)
```

```bash
{
```

```bash
var srcObject = softwareList[item];
```

```bash
var dsmSoftwareGUID = srcObject.UniqueKey.UniqueId;
```

```bash
var softwareRevision = '';
```

```bash
var isLastReleasedRev = false;
```

```bash
var uninstallSupported = false;
```

```bash
var reinstallSupported = false;
```

```bash
(srcObject.PropGroupList 内の var idx) の場合
```

```bash
{
```

```bash
var tmpObjPropGrp = srcObject.PropGroupList[idx];
```

```bash
(tmpObjPropGrp.PropertyList の var idx2) の場合
```

```bash
{
```

```bash
var tmpObjProp = tmpObjPropGrp.PropertyList[idx2];
```

```bash
if (tmpObjProp.Tag == 'ソフトウェアリビジョン')
```

```bash
ソフトウェアリビジョン = tmpObjProp.InternalValue;
```

```bash
if ((tmpObjProp.Tag == 'IsLastReleasedRev') (tmpObjProp.InternalValue === true))
```

```bash
isLastReleasedRev = true;
```

```bash
if ((tmpObjProp.Tag == 'SupportsUninstall') (tmpObjProp.InternalValue === true))
```

```bash
アンインストールサポート = true;
```

```bash
if ((tmpObjProp.Tag == 'SupportsReinstall') (tmpObjProp.InternalValue === true))
```

```bash
再インストールサポート = true;
```

```bash
}
```

```bash
}
```

```bash
```

```bash
// ソフトウェア リビジョンとヒート ソフトウェア (FRSDSMSOFTWARE) を作成/更新します
```

```bash
```

```bash
var relatedObjList = {
```

```bash
'FRS_WS_DSM_SoftwareContainsFRS_WS_DSM_SoftwareRevision': [{
```

```bash
DSMソフトウェアID: srcObject.ID、
```

```bash
DSMソフトウェアGUID: dsmソフトウェアGUID、
```

```bash
DSM作成日: srcObject.CreationDate、
```

```bash
DSMModifiedDate: srcObject.ModificationDate、
```

```bash
グループタイプ: srcObject.GroupType、
```

```bash
ソフトウェア名: srcObject.Name、
```

```bash
親コンテナID: srcObject.ParentContID、
```

```bash
リビジョン: softwareRevision、
```

```bash
スキーマタグ: srcObject.SchemaTag、
```

```bash
ソフトウェアタイプ: ソフトタイプ、
```

```bash
最終リリース日: 最終リリース日、
```

```bash
アンインストール不可: uninstallSupported、
```

```bash
再インストール可能: reinstallSupported
```

```bash
}],
```

```bash
'FRS_WS_DSM_SoftwareContainsFRS_DSM_Software': {
```

```bash
ソフトウェアパッケージがリリースされているかどうか: true
```

```bash
}
```

```bash
};
```

```bash
```

```bash
// ソフトウェア パッケージの作成/更新
```

```bash
```

```bash
var finalizedSoftware = {
```

```bash
フィールド: {
```

```bash
DSMソフトウェアGUID: dsmソフトウェアGUID、
```

```bash
HEATSMソフトウェアタイプ: ソフトウェアタイプ
```

```bash
},
```

```bash
関連: relatedObjList
```

```bash
};
```

```bash
var softType = (!!srcObject.SchemaTag && !!schemaTagToSoftwareType[srcObject.SchemaTag]) ? schemaTagToSoftwareType[srcObject.SchemaTag].SoftwareType : 'Undefined';
```

```bash
if (isLastReleasedRev) {
```

```bash
FinalizedSoftware.Fields.Name = srcObject.Name;
```

```bash
finalizedSoftware.Fields.IsOptionalSoftware = isOptionalSoftware;
```

```bash
finalizedSoftware.Fields.SchemaTag = srcObject.SchemaTag;
```

```bash
最終化されたソフトウェア.Fields.SoftwareType = softType;
```

```bash
finalizedSoftware.Fields.LastReleasedSoftwareID = srcObject.ID;
```

```bash
}
```

```bash
arrFinalizedSoftwareList.push(finalizedSoftware);
```

```bash
}
```

```bash
arrFinalizedSoftwareList を返します。
```

```bash
}
```

```bash
```

```bash
関数 GetSoftwareGUID(ソフトウェアリスト)
```

```bash
{
```

```bash
if (Object.prototype.toString.call(softwareList) !== '[オブジェクト配列]')
```

```bash
null を返します。
```

```bash
var array = [];
```

```bash
(var i = 0; i < softwareList.length; i ) の場合
```

```bash
配列.push(softwareList[i].Fields.DSMSoftwareGUID);
```

```bash
return array;
```

```bash
}
```

```bash
```

```bash
関数 SynchronizeHeatSM(isAll, sofrwareType, schemaTagToSoftwareType)
```

```bash
{
```

```bash
if (すべて)
```

```bash
{
```

```bash
var arrFinalizedSoftwareList = [];
```

```bash
Array.prototype.push.apply(arrFinalizedSoftwareList、ToHeatRecords(getExternalData('AvailableSoftware')、'AvailableSoftware'、schemaTagToSoftwareType));
```

```bash
Array.prototype.push.apply(arrFinalizedSoftwareList、ToHeatRecords(getExternalData('OptionalSoftware')、'OptionalSoftware'、schemaTagToSoftwareType));
```

```bash
return SynchronizeAllHeatDataWithRelated('FRS_WS_DSM_Software', ['DSMSoftwareGUID'], arrFinalizedSoftwareList,
```

```bash
```

```bash
{
```

```bash
'FRS_WS_DSM_SoftwareContainsFRS_WS_DSM_SoftwareRevision': ['DSMSoftwareGUID'],
```

```bash
'FRS_WS_DSM_SoftwareContainsFRS_DSM_Software': []
```

```bash
});
```

```bash
}
```

```bash
```

```bash
それ以外
```

```bash
{
```

```bash
var arrFinalizedSoftwareList = ToHeatRecords(getExternalData(sofrwareType), sofrwareType, schemaTagToSoftwareType);
```

```bash
var arrDSMSoftwareGUIDList = GetDSMSoftwareGUID(arrFinalizedSoftwareList);
```

```bash
return SynchronizeHeatDataWithRelated('FRS_WS_DSM_Software', ['DSMSoftwareGUID'], arrFinalizedSoftwareList,
```

```bash
```

```bash
{
```

```bash
'FRS_WS_DSM_SoftwareContainsFRS_WS_DSM_SoftwareRevision': ['DSMSoftwareGUID'],
```

```bash
'FRS_WS_DSM_SoftwareContainsFRS_DSM_Software': []
```

```bash
},
```

```bash
```

```bash
{
```

```bash
DSMソフトウェアGUID: arrDSMソフトウェアGUIDList
```

```bash
});
```

```bash
```

```bash
}
```

```bash
```

```bash
}
```
::::

::::ExpandableHeading
## 熱データの同期

### 方法

熱データの同期

### 説明

次の操作を実行して、アプリケーション内のビジネス オブジェクトについて、提供されたレコードを特定の条件を満たすすべてのレコードと同期します。

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコードに見つからない、アプリケーション内のレコード (ビジネス オブジェクトの特定の条件を満たすもの) を削除します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコード内で見つかったが、アプリケーション内にまだ存在しないレコード (ビジネス オブジェクトの特定の条件を満たすレコード) をアプリケーションに挿入します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコードに対して、アプリケーション内のレコード (ビジネス オブジェクトの特定の条件を満たすレコード) を更新します。
:::

### 戻り値の型

この関数は、レコードの RecID の配列を返します。

### 意味

```bash
object[] SynchronizeHeatData(string designerName, string[] primaryKey, object[] records, object syncDataCondition)
```

### パラメータ

| デザイナー名  | 同期されるビジネス オブジェクトの名前。                |
| ------- | ----------------------------------- |
| プライマリキー | 各レコードを一意に識別するフィールドの配列。              |
| 記録      | フィールドとそれに対応する値を含む JSON キーと値のペアのリスト。 |
| 同期データ条件 | データをいつ同期するかを指定します。                  |

### 例

S[すべての熱データを同期する](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/mSok-web#Synchron)例を参照してください。
::::

::::ExpandableHeading
## 熱データを関連データと同期する

### 方法

熱データを関連データと同期する

### 説明

次の操作を実行して、アプリケーション内のビジネス オブジェクトおよび関連するビジネス オブジェクトについて、提供されたレコードを特定の条件を満たすすべてのレコードと同期します。

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコードに見つからない、アプリケーション内のレコード (ビジネス オブジェクトおよび関連するビジネス オブジェクトの特定の条件を満たすもの) を削除します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコード内で見つかったが、アプリケーション内にまだ存在しないレコード (ビジネス オブジェクトおよび関連するビジネス オブジェクトの特定の条件を満たすもの) をアプリケーションに挿入します。
:::

:::Paragraph{listStyleType="disc" indent="2"}
提供されたレコードに対して、アプリケーション内のレコード (ビジネス オブジェクトおよび関連するビジネス オブジェクトについて、特定の条件を満たすレコード) を更新します。
:::

### 戻り値の型

この関数は、レコードの RecID の配列を返します。

### 意味

```bash
object[] SynchronizeHeatDataWithRelated(string designerName, string[] primaryKey, object[] records, object keysOfRelatedObjects, object syncDataCondition)
```

### パラメータ

| デザイナー名      | 同期されるビジネス オブジェクトの名前。                                                   |
| ----------- | ---------------------------------------------------------------------- |
| プライマリキー     | 各レコードを一意に識別するフィールドの配列。                                                 |
| 記録          | フィールドとそれに対応する値を含む JSON キーと値のペアのリスト。                                    |
| 関連オブジェクトのキー | 次のように構築される JSON オブジェクト:<br />\{<br />リレーションシップ名: 文字列\[] プライマリキー<br />} |
| 同期データ条件     | データをいつ同期するかを指定します。                                                     |

### 例

S[すべての熱データを関連データと同期する](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/mSok-web#Synchron2)例を参照してください。
::::

:::ExpandableHeading
## HtmlEncode

### 方法

HeatUtility.HtmlEncode

### 説明

渡されたパラメータ文字列にある ?、、 \<, >などの HTML 特殊文字をエンコードします。 詳細については、 [https://msdn.microsoft.com/en-us/library/73z22y6h(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/73z22y6h\(v=vs.110\).aspx) を参照してください。

### 返品

エンコードされた HTML 文字列。

### 意味

```bash
文字列 HeatUtility.HtmlEncode(文字列 s);
```

### パラメータ

| S | エンコードされる HTML 特殊文字を含む文字列。 |
| - | ------------------------- |

### 例

```bash
HeatUtility.HtmlEncode ("<script>安全ではありません</script>");
```
:::

:::ExpandableHeading
## HtmlDecode

###

### 方法

HeatUtility.Htmlデコード

### 説明

渡されたパラメータ文字列にある ?、、 \<, >などの HTML 特殊文字をデコードします。 詳細については、 [https://msdn.microsoft.com/en-us/library/7c5fyk1k(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/73z22y6h\(v=vs.110\).aspx) を参照してください。

### 返品

デコードされた HTML 文字列。

### 意味

```bash
文字列 HeatUtility.HtmlDecode(文字列 s);
```

### パラメータ

| S | デコードする HTML 特殊文字を含む文字列。 |
| - | ----------------------- |

### 例

```bash
HeatUtility.HtmlDecode ("lt;scriptgt;unsafelt;/scriptgt;");
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## 16進数からバイト数

### 方法

HeatUtility.HexToBytes

### 説明

16 進数でエンコードされたバイト ストリームをバイトに変換します。

### 返品

16 進数から変換されたバイト。

### 意味

```bash
byte[] HeatUtility.HexToBytes(文字列 16進数);
```

### パラメータ

| 16進数 | 16 進文字を含む文字列。 |
| ---- | ------------- |

### 例

```bash
HeatUtility.HexToBytes("0123456789ABCDEFabcdef");
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## バイトから文字列へ

### 方法

HeatUtility.BytesTo 文字列

### 説明

バイト ストリームを文字列に変換します。 詳細については、 [https://msdn.microsoft.com/en-us/library/744y86tc(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/744y86tc\(v=vs.110\).aspx) を参照してください。

### 返品

バイトから変換された文字列。

### 意味

```bash
文字列 HeatUtility.BytesToString(byte[] データ、文字列エンコーディング);
```

### パラメータ

| データ      | エンコードされたバイトのストリーム。                                          |
| -------- | ----------------------------------------------------------- |
| エンコーディング | エンコードされた形式。 ASCII、UTF7、UTF8、UTF16、UTF16BE、UTF32 のいずれかになります。 |

### 例

```bash
HeatUtility.BytesToString([48, 49, 50, 51, 52, 53, 54, 55, 56, 57], 'UTF8');
```

```bash
```

```bash
```

```bash
```
:::

::::ExpandableHeading
## ロードXML

### 方法

HeatUtility.LoadXml

### 説明

指定された XML テキストから XML ドキュメント オブジェクトを作成します。 詳細については、 [https://msdn.microsoft.com/en-us/library/system.xml.xmldocument.loadxml(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/system.xml.xmldocument.loadxml\(v=vs.110\).aspx) を参照してください。

### 返品

:::Paragraph{indent="1"}
指定された XML 文字列から作成された XML ドキュメント オブジェクト。
:::

### 意味

```bash
XmlElement HeatUtility.LoadXml(string xml);
```

### パラメータ

| テキスト | 文字列形式の XML。 |
| ---- | ----------- |

### 例

```bash
HeatUtility.LoadXml("<Books><Book name="Author Name"Publisher="Some publisher"></Book></Books>");
```

```bash
```

```bash
```
::::

:::ExpandableHeading
## 文化情報を取得

### 方法

HeatUtility.GetCultureInfo

### 説明

指定されたカルチャ ID またはロケール ID のカルチャ インスタンスを取得します。 詳細については、 [yck8b540(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/yck8b540\(v=vs.110\).aspx) または [w4deeh00(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/w4deeh00\(v=vs.110\).aspx) を参照してください。

### 返品

指定されたカルチャまたはロケールの CultureInfo オブジェクト。

### 意味

```bash
文化情報 HeatUtility.GetCultureInfo(文字列 ID);
```

```bash
CultureInfo HeatUtility.GetCultureInfo(int lcid);
```

### パラメータ

| ID | 文化 ID。 例は、us en-US です。   |
| -- | ------------------------ |
| 液晶 | 文化ロケール ID。 例は 0x0409 です。 |

### 例

```bash
HeatUtility.GetCultureInfo("en-US");
```

```bash
HeatUtility.GetCultureInfo(0x0409);
```

```bash
HeatUtility.GetCultureInfo(1033);
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## タイムゾーン情報を取得する

### 方法

HeatUtility.GetTimeZoneInfo

### 説明

指定された Microsoft Windows タイム ゾーンまたは IANA タイム ゾーンのタイム ゾーン情報を取得します。  詳細については、 [system.timezoneinfo.findsystemtimezonebyid(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/system.timezoneinfo.findsystemtimezonebyid\(v=vs.110\).aspx) を参照してください。

### 返品

指定されたタイムゾーンの TimeZoneInfo オブジェクト。 TimeZoneInfo オブジェクトには、 **TImezones&#x20;**&#x30EF;ークスペースからのデータが含まれています。 タ[日付、時刻、タイムゾーンの操作](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/xSg4WyUyrPq_-q6Gqctql)ワークスペースの詳細については、「 日**付、時刻、およびタイムゾーンの操作 」**&#x3092;参照してください。

### 意味

```bash
TimeZoneInfo HeatUtility.GetTimeZoneInfo(文字列 ianaOrWindowsTimeZone);
```

### パラメータ

| ianaまたはWindowsタイムゾーン | Microsoft Windows または IANA のタイム ゾーン。 |
| -------------------- | ------------------------------------ |

### 例

```bash
HeatUtility.GetTimeZoneInfo("太平洋標準時");
```

```bash
HeatUtility.GetTimeZoneInfo("アメリカ/ロサンゼルス");
```

```bash
```

```bash
```
:::

:::ExpandableHeading
## ハッシュ

### 方法

HeatUtility.ハッシュ

### 説明

指定されたアルゴリズムを使用して、指定された文字列テキストのハッシュ値を生成します。  詳細については、 [https://msdn.microsoft.com/en-us/library/wet69s13(v=vs.110).aspx](https://msdn.microsoft.com/en-us/library/wet69s13\(v=vs.110\).aspx) を参照してください。

### 返品

生成されたハッシュ値。

### 意味

```bash
byte[]HeatUtility.Hash(文字列ハッシュアルゴリズム、文字列データ);
```

```bash
byte[]HeatUtility.Hash(文字列ハッシュアルゴリズム、byte[]データ);
```

### パラメータ

| ハッシュアルゴリズム | 使用するハッシュ アルゴリズム。 |
| ---------- | ---------------- |
| データ        | ハッシュされるデータ。      |

### 例

```bash
HeatUtility.Hash("SHA1","このメッセージは署名が必要です。");
```

```bash
HeatUtility.Hash("SHA1", [100, 101,102,103, 104, 105, 200]);
```

```bash
```

```bash
```
:::

::::ExpandableHeading
## キー付きハッシュ

### 方法

HeatUtility.KeyedHash

### 説明

:::Paragraph{indent="1"}
指定されたアルゴリズムとキーを使用して、指定された文字列テキストのハッシュ値を生成します。  詳細については、 [https://msdn.microsoft.com/library/s5zz2x4d(v=vs.100).aspx](https://msdn.microsoft.com/library/s5zz2x4d\(v=vs.100\).aspx) を参照してください。
:::

### 返品

生成されたハッシュ値。

### 意味

```bash
byte[]HeatUtility.KeyedHash(文字列ハッシュアルゴリズム、byte[]キー、文字列データ);
```

```bash
byte[]HeatUtility.KeyedHash(文字列ハッシュアルゴリズム、byte[]キー、byte[]データ);
```

### パラメータ

| ハッシュアルゴリズム | 使用するハッシュ アルゴリズム。 |
| ---------- | ---------------- |
| 鍵          | キーを含むバイトの配列。     |
| データ        | ハッシュされるデータ。      |

### 例

```bash
HeatUtility.KeyedHash ("HMACSHA1, [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16], "このメッセージには署名が必要です。");
```

```bash
HeatUtility.KeyedHash ("HMACSHA1、[1、2、3、4、5、6、7、8、9、10、11、12、13、14、15、16]、[100、101、102、103、104、105、200]);
```
::::
