---
title: サービス申請を作成する
slug: neurons-for-itsm/admin-user-help/jpn/latest/-lfBWDFfg_wnai_gRdTE2
createdAt: 2026-10-29T01:28:25.126Z
---

Rest API を使用して サービス申請を作成できます。

**ベース URL:**

https\://\{tenant url}/api/rest/ServiceRequest/new

:::ExpandableHeading
## サービス申請の作成 - 例

サービス申請を作成する例を次に示します。

| メールアドレス                                 | https\://\{tenant url}/api/rest/ServiceRequest/new                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <font color="#ffffff">方法</font>         | 役職                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| ヘッダー名                                   | 認証: JWT トークン/セッション キー/REST API キー                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| <font color="#ffffff">リクエストペイロード</font> | クリックしてリクエストペイロードを表示<br />\{<br />"attachmentsToDelete": \[],<br />"attachmentsToUpload": \[],<br />「パラメータ」: \{},<br />"delayedFulfill": false,<br />"formName": "ServiceReq.ResponsiveAnalyst.DefaultLayout",<br />"saveReqState": 偽、<br />"serviceReqData": \{<br />「件名」: 「RESTAPI からの SR」、<br />「詳細」: 「テスト02」<br />},<br />"strCustomerLocation": "西",<br />"strUserId": "2F851094BFE5437C97D19871D1C539C7",<br />"サブスクリプションID": "0C1780F4EC814CB2B8E045325D8CFB66",<br />"ローカルオフセット": -330<br />}<br />これらのフィールドの値を取得する方法の詳細については、「 [フィールド値](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/-lfBWDFfg_wnai_gRdTE2#FieldValues) 」および「 [パラメータ](https://docs.ivanti.com/neurons-for-itsm/admin-user-help/jpn/latest/-lfBWDFfg_wnai_gRdTE2#Parameters)」を参照してください。<br />この例に示されているすべてのフィールドは必須であり、いずれかのフィールドが欠落している場合、API はエラーを返します。 ただし、Create Service Request API を実行すると、 `attachmentsToDelete` の値は空白になります。 |
| <font color="#ffffff">ステータスコード</font>   | 200                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| <font color="#ffffff">レスポンスペイロード</font> | クリックするとレスポンスペイロードが表示されます<br />\{ "IsSuccess": true,<br />"ErrorText": "",<br />"ServiceRequests": \[<br />\{<br />"bNew": true,<br />"strSubscriptionRecId": "0C1780F4EC814CB2B8E045325D8CFB66",<br />"strRequestRecId": "6730C50F527A481A81FFE15D7D60725F",<br />"strIssueRecId": null、<br />"strRequestNum": "10288",<br />"strName": "最小SR",<br />"strStatus": null,<br />"strStatusId": null,<br />"strService": null,<br />"strServiceId": null,<br />"strDetails": null、<br />"パラメータテンプレートパラメータID": \{},<br />"DateApproved": null,<br />"DateCancelled": null,<br />"DateCompleted": null<br />}<br />],<br />「無効なサービスリクエスト」: \{}<br />}                                                                                                                                                                                                                                                                                  |
:::

## フィールド値

Create Service Request API の実行に使用されるフィールドの値を取得する方法については、以下に詳しく説明します。

:::ExpandableHeading
## strCustomerLocation と strUserId

`strCustomerLocation `と `strUserIdの`値を取得するには、API を実行します - https\://\{tenant URL}/api/odata/businessobject/Frs\_CompositeContract\_Contacts?$filter=NetworkUserName eq '\{your user name}'

取得した応答から、 `Employee Location` の値は `strCustomerLocation` の値になり、 `RecID` の値は `strUserId` の値になります。
:::

:::ExpandableHeading
## サブスクリプションID

s`ubscriptionIdの`値を取得するには、API - https\://\{tenant URL}/api/rest/Template//\<User\_RecId>All を実行します。

これにより、サービス カタログに公開されているすべてのテンプレートが提供されます。 取得した応答から、 `strSubscriptionId` の値が `subscriptionId` の値になります。
:::

:::ExpandableHeading
## ローカルオフセット

l`ocaloffset `の値は、特定の場所の協定世界時からの分単位の差です。 たとえば、現在地がインドの場合、GMT/UTC は 5.30 時間、つまり 330 分なので、現在地の `localoffset` 値は `-330`になります。
:::

:::ExpandableHeading
## フィールド RecID

フィールドの `RecID` を取得するには、API - `https://{tenant url}/api/rest/ServiceRequest/PackageData/subscriptionId/strCustomerLocation`を実行します。

応答から、 `lstParamCategories/lstParameters` を探して展開します。 すべてのフィールドには `RecID`があります。フィールドを展開すると、その `RecID`が表示されます。

*フィールド RecID*

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/nd6G87vUA3WsEvtviQwfP_fieldrecid.png" position="flex-start" size="72" width="504" height="320" initialPath="../../Resources/Images/Configure/API/FieldRecID.png" githubPath="Admin-User-Jpn/Content/Resources/Images/Configure/API/FieldRecID.png" showCaption="false"}
:::

## パラメータ

パラメータの基本構造は次のとおりです。

「パラメータ」: \{

// \{パラメータ名}

"par-\{Parameter RecID}": "value",

}

::::ExpandableHeading
## 例

「パラメータ」: \{

// チェックボックス

"par-\{Parameter RecID}": "true",

// テキストフィールド

"par-\{Parameter RecID}": "Text Field",

// テキストエリア

"par-\{Parameter RecID}": "Text Area",

// 落ちる

"par-\{Parameter RecID}": "Scheduled",

"par-\{Parameter RecID}-recId": "\{Field RecID of Scheduled}",

// 時間フィールド

"par-\{Parameter RecID}": "\{system generated time}",

// 日時フィールド

"par-\{Parameter RecID}": "\{system generated time}",

// 選択リスト

"par-\{Parameter RecID}": "Active",

"par-\{Parameter RecID}-recId": "\{Field RecID of Active}"

}

*パラメータ付きのサンプル サービス申請*

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/mldCYrkP86y096sHQRzrl_parameters.png" position="flex-start" size="45" width="316" height="468" initialPath="../../Resources/Images/Configure/API/Parameters.png" githubPath="Admin-User-Jpn/Content/Resources/Images/Configure/API/Parameters.png" showCaption="false"}

:::hint{type="info"}
ドロップダウン リスト/選択リストと添付ファイルは、他のパラメータとは異なる動作をします。 詳細については、「ドロップダウンと選択リストと添付ファイル」を参照してください。
:::
::::

::::ExpandableHeading
## ドロップダウンと選択リスト

ドロップダウンとピックリストの場合は、値の RecID が必要になります。それを取得するには、次の API を実行します。

GET: /api/rest/ServiceRequest//ValidationList

ブラウザの代わりに Postman または同様のアプリを使用し、 **Content-Type** を **application/json**に設定します。

**例：**

1. 実行 - GET: /api/rest/ServiceRequest/ 6B5A00312E00430AAF8769D1A27326C6/ValidationList

:::Paragraph{indent="1"}
応答にはすべての値の Rec ID が含まれます。 たとえば、値 Alex の RecID は「026221D7927F4104810ABF14672FCC3」です。
:::

2. 以下のようにパラメータ XYZ に使用します。

「パラメータ」: \{

"par-A72D69AF2A9B420F874BA8A5A293EF17": "Alex",

"par-A72D69AF2A9B420F874BA8A5A293EF17-recId": "026221D7927F4104810ABF14672FCC3"

}
::::

::::ExpandableHeading
## 添付ファイル

サービス申請に添付ファイルをアップロードするには、添付ファイルのトークンが必要になります。

**トークンを取得するには、次の API を実行します。**

1. POST: api/rest/Attachment/newSR

:::Paragraph{indent="1"}
ブラウザの代わりに Postman または同様のアプリを使用し、リクエスト本文を **Form-data**として設定します。
:::

2. 応答からトークンをコピーします。

:::Paragraph{indent="1"}
*トークンを含むサンプルレスポンス*
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/BXGdWIEXzBT48KgcgTjq4_tokens.png" position="flex-start" size="100" width="833" height="204" initialPath="../../Resources/Images/Configure/API/tokens.png" githubPath="Admin-User-Jpn/Content/Resources/Images/Configure/API/tokens.png" showCaption="false" indent="1"}

**サービス申請でトークンを使用する:**

アップロードする添付ファイル: \[\["\{トークンID}", "
::::

## 失敗した応答

:::ExpandableHeading
## リクエスト本文が空です

シナリオ: リクエスト本文が空の サービス申請を作成しようとしています。

ヘッダー名:

**認証: セッションキー**

| <font color="#ffffff">コード</font>                | ISM\_4000                         |
| ----------------------------------------------- | --------------------------------- |
| 説明                                              | 無効なリクエストペイロード                     |
| メッセージ                                           | \{<br />「メッセージ本文は空にできません。」<br />} |
| <font color="#ffffff">**HTTP ステータス コード**</font> | **400**                           |
:::

:::ExpandableHeading
## リクエスト本文が無効です

シナリオ: 無効なリクエスト本文で サービス申請を作成しようとしています。

ヘッダー名:

**認証: セッションキー**

| <font color="#ffffff">コード</font>                | ISM\_4000                           |
| ----------------------------------------------- | ----------------------------------- |
| 説明                                              | 無効なリクエストペイロード                       |
| メッセージ                                           | \[<br />「ビジネス オブジェクトが無効です。」<br />], |
| <font color="#ffffff">**HTTP ステータス コード**</font> | **400**                             |
:::

:::ExpandableHeading
## 必須フィールドが不足しています

シナリオ: 必須フィールドが欠落している サービス申請を作成しようとしています。

ヘッダー名:

**認証: セッションキー**

| <font color="#ffffff">コード</font>                | ISM\_4000                           |
| ----------------------------------------------- | ----------------------------------- |
| 説明                                              | 無効なリクエストペイロード                       |
| メッセージ                                           | \[<br />「必須フィールドパラメータがありません」<br />] |
| <font color="#ffffff">**HTTP ステータス コード**</font> | **400**                             |
:::

:::ExpandableHeading
## 無効な応答

シナリオ: サービス申請を作成しようとしたときにアプリケーションが保存に失敗した場合。

ヘッダー名:

**認証: セッションキー**

| <font color="#ffffff">コード</font>                | ISM\_5000                                             |
| ----------------------------------------------- | ----------------------------------------------------- |
| 説明                                              | 内部サーバーエラー                                             |
| メッセージ                                           | \[<br />「サーバーに内部エラーが発生しました。 リクエストを再試行してください。"<br />], |
| <font color="#ffffff">**HTTP ステータス コード**</font> | **500**                                               |
:::
