---
title: "アイテムサービス"
slug: "the-itemservice"
abstract: "Sitecore ItemServiceの実装と一般的な使用方法を紹介します。"
---
# アイテムサービス

Sitecore ItemServiceはSitecoreアイテムと直接やり取りするためのRESTful APIを提供します。

Sitecore.Services.ClientItemServiceとやり取りするために事前に定義されたルートを持つ船サーバー側の開発を手間なくしてくれます。

ItemServiceは以下の方法で利用できます:

-   直接[ItemService RESTful API](https://doc.sitecore.com/xp/ja/developers/103/sitecore-experience-manager/the-restful-api-for-the-itemservice.html "The RESTful API for the ItemService")に。
-   [ItemService JavaScript図書館](https://doc.sitecore.com/xp/ja/developers/103/sitecore-experience-manager/using-the-itemservice-from-javascript.html "Using the ItemService from JavaScript")と一緒に。
-   [StoredQueryDataSourceのデータソース](https://doc.sitecore.com/xp/en/developers/speak/80/speak/en/storedquerydatasource.html)を持つSPEAKアプリケーションから。この方法でItemServiceを使うと、完全に透過的です。

## 実装

Sitecore.Services.Infrastructure.Sitecore.Controllers.ItemServiceControllerクラスはItemServiceを実装します。クラスは他のクラスが継承できないように[密封されています](http://msdn.microsoft.com/en-us/library/88c54tsw.aspx)。Sitecoreウェブサイト上でItemServiceのインスタンスを1つだけ実行することを推奨します。

## ItemModelの返送値

Sitecore.Services.ClientItemServiceがアイテムを返す際にSitecoreをSitecore.Services.Core.Model.ItemModelのインスタンスにマッピングします。ItemModelインスタンスは、以下の追加キーを持つDictionary<string, object>でSitecoreアイテムの生のフィールド値を含みます。

-   ItemID
-   ItemName
-   ItemPath
-   ParentID
-   TemplateID
-   TemplateName
-   CloneSource
-   ItemLanguage
-   ItemVersion
-   DisplayName
-   HasChildren
-   ItemIcon
-   ItemMedialUrl
-   ItemUrl

## ItemServiceリクエストの例

以下の例はItemService RESTful APIの使い方を示しています:

動作

クエリ文字列

アイテムを入手

/sitecore/api/ssc/item/110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9

メタデータを含むアイテムを入手してください

/sitecore/api/ssc/item/110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9?includeMetadata=true

標準テンプレートフィールドを含むアイテムを入手してください

/sitecore/api/ssc/item/110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9?includeStandardTemplateFields=true

フィールドプロジェクション付きのアイテムを入手してください

/sitecore/api/ssc/item/110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9?fields=ItemID,ItemName,TemplateName

Search

/sitecore/api/ssc/item/search?term=Home

ページングとフィールド投影によるSearch

/sitecore/api/ssc/item/search?includeStandardTemplateFields=false&fields=ItemID%2CItemName&page=1&term=sitecore

メディアアイテムを入手

/sitecore/api/ssc/item/C19E9164-FF99-4A05-B8C0-E9C931DA111F

コンテンツパスを使ってアイテムを入手してください

/sitecore/api/ssc/item/?path=/sitecore/content/Home