アイテムサービス
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore ItemServiceはSitecoreアイテムと直接やり取りするためのRESTful APIを提供します。
Sitecore.Services.ClientItemServiceとやり取りするために事前に定義されたルートを持つ船サーバー側の開発を手間なくしてくれます。
ItemServiceは以下の方法で利用できます:
- 直接ItemService RESTful APIに。
- ItemService JavaScript図書館と一緒に。
- StoredQueryDataSourceのデータソースを持つSPEAKアプリケーションから。この方法でItemServiceを使うと、完全に透過的です。
実装
Sitecore.Services.Infrastructure.Sitecore.Controllers.ItemServiceControllerクラスはItemServiceを実装します。クラスは他のクラスが継承できないように密封されています。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