# ServiceNow - サービスカタログコネクターシンクレット

ServiceNow - インシデント管理コネクタのThinkletを設定して、ワークフロー内で特定の操作を実行します。

## アクション: サービスカタログアイテムを取得 <a href="#action-get-service-catalog-item" id="action-get-service-catalog-item"></a>

**サービスカタログアイテムを取得** は、詳細なサービスカタログアイテムデータを取得します。 このアクションは、例えばサービスカタログアイテムの内部IDを取得するためにワークフローで使用され、サービスの注文に関連する他のアクションに必要です。 このThinkletは、[サービスカタログ - GET /sn\_sc/servicecatalog/items](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/integrate/inbound-rest/concept/c_ServiceCatalogAPI.html#title_servicecat-GET-items) APIエンドポイントに依存しています。

Thinklet設定の例:

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-2c394ac3fde426870abec66b29527595ce575972%2Fimage-20240614-113447.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

* **パラメーター:** このアクションで使用するパラメーターとしてデータを設定します。 パラメーターがどのようにマップされ、どのデータが必要かについての情報を得るには、ツールチップアイコンにマウスオーバーしてください。
  * **検索テキスト** - サービスカタログアイテムを検索するテキスト
* **出力:** コネクタThinkletの出力を表示します。
  * **サービスカタログアイテムID** (`ServiceCatalogItemID`)
  * **名称** (`Name`) - サービスカタログアイテム名
  * **短い説明** (`ShortDescription`) - サービスカタログアイテムの短い説明
  * **可用性** (`Availability`) - サービスの可用性
  * **タイプ** (`Type`)
  * **クラス名** (`ClassName`)

コネクタを再作成する際のAPI サービスThinkletの詳細:

<table><thead><tr><th width="272">フィールド</th><th>値</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td>api/sn_sc/servicecatalog/items?sysparm_limit=1&#x26;sysparm_text={{SerachText}}</td><td></td></tr><tr><td>メソッド</td><td>GET</td><td></td></tr><tr><td>ペイロード</td><td></td><td></td></tr><tr><td>出力</td><td><p>可用性 $.result[0].availability</p><p>名前 $.result[0].short_description</p><p>ショートディスクリプション $.result[0].short_description</p><p>クラス名 $.result[0].sys_class_name サービスカタログアイテムID $.result[0].sys_id</p><p>タイプ $.result[0].type</p></td><td></td></tr></tbody></table>

## アクション: サービスカタログアイテムをリクエスト <a href="#action-request-service-catalog-item" id="action-request-service-catalog-item"></a>

**サービスカタログアイテムをリクエスト** はカタログアイテムを注文し、サービスリクエストチケットの作成を促します。 このThinkletは、[POST /sn\_sc/servicecatalog/items/{sys\_id}/order\_now](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/integrate/inbound-rest/concept/c_ServiceCatalogAPI.html#title_servicecat-POST-items-order_now) APIエンドポイントに依存しています。

Thinklet設定の例:

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-cd45d0d8f7c1b4b8146b2b9bf5f0ab7579830e70%2Fimage-20240613-160938.png?alt=media" alt=""><figcaption></figcaption></figure>

\&#x20

* **パラメーター:** このアクションで使用するパラメーターとしてデータを設定します。 パラメーターがどのようにマップされ、どのデータが必要かについての情報を得るには、ツールチップアイコンにマウスオーバーしてください。
  * **サービスカタログアイテムID** (`ServiceCatalogItemID`) - サービスカタログアイテムID
  * **ユーザーIDのリクエスト** (`RequestedForUserID`) - リクエストされたユーザーID
  * **数量** (`OrderQuantity`) - 注文されたサービスの数量
* **出力:** コネクタThinkletの出力を表示します。
  * **リクエスト番号** (`RequestNumber`)
  * **リクエストID** (`RequestID`)

以下の表は、コネクタを再作成する際のAPI サービスコネクタの詳細を示しています:

<table><thead><tr><th width="272">フィールド</th><th>値</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td><code>api/sn_sc/servicecatalog/items/{{ServiceCatalogItemID}}/order_no</code></td><td></td></tr><tr><td>メソッド</td><td><code>POST</code></td><td></td></tr><tr><td>ペイロード</td><td><code>{"sysparm_requested_for":"{{RequestedForUserID}}","sysparm_quantity":"{{OrderQuantity}}"}</code></td><td></td></tr><tr><td>出力</td><td><p><code>RequestNumber $.result.number</code></p><p><code>RequestID $.result.sys_id</code></p></td><td></td></tr></tbody></table>

## アクション: サービスカタログリクエストの説明を更新 <a href="#action-update-service-catalog-request-descriptions" id="action-update-service-catalog-request-descriptions"></a>

**サービスカタログリクエストの説明を更新** は、サービスカタログリクエストチケットの説明と短い説明フィールドを更新します。 このThinkletは、[テーブルリクエストPATCH](https://docs.servicenow.com/bundle/washingtondc-api-reference/page/integrate/inbound-rest/concept/c_TableAPI.html#title_table-PATCH) APIエンドポイントに依存しています。

<figure><img src="https://3549141153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeLm8O7QKZDn6z806e7Sv%2Fuploads%2Fgit-blob-e176b9208161ee6d79eb6c476d4b949833764a08%2Fimage-20240618-112009.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

* **パラメーター:** このアクションで使用するパラメーターとしてデータを設定します。 パラメーターがどのようにマップされ、どのデータが必要かについての情報を得るには、ツールチップアイコンにマウスオーバーしてください。
  * **リクエストID** (`RequestID`) - リクエストID
  * **説明** (`Description`) - 説明
  * **短い説明** (`ShortDescription`) - 短い説明
* **出力:** コネクタThinkletの出力を表示します。
  * **リクエスト番号** (`RequestNumber`)
  * **リクエストID** (`RequestID`)

以下の表は、コネクタを再作成する際のAPI サービスコネクタの詳細を示しています:

<table><thead><tr><th width="272">フィールド</th><th>値</th><th data-hidden></th></tr></thead><tbody><tr><td>リソースパス</td><td>api/now/table/sc_request/{{RequestID}}</td><td></td></tr><tr><td>メソッド</td><td>PATCH</td><td></td></tr><tr><td>ペイロード</td><td>{"description":"{{Description}}","short_description":"{{ShortDescription}}"}</td><td></td></tr><tr><td>出力</td><td><p>リクエスト番号 $.result.number</p><p>リクエストID $.result.sys_id</p></td><td></td></tr></tbody></table>

[コネクタThinkletの設定](https://docs.nexthink.com/platform/ja/user-guide/workflows/creating-workflows/configuring-connector-thinklet) ドキュメントでコネクタThinkletについての詳細情報をご確認ください。