クエリ

mutation {   createItem(     input: {       name: "Sitecore Authoring and Management API"       templateId: "{76036F5E-CBCE-46D1-AF0A-4143F9B557AA}"       parent: "{110D559F-DEA5-42EA-9C1C-8A5DF7E70EF9}"       language: "en"       fields:         { name: "title", value: "Welcome to Sitecore" }         { name: "text", value: "Welcome to Sitecore" }           }   ) {     item {       itemId       name       path       fields(ownFields: true, excludeStandardFields: true) {         nodes {           name           value         }       }     }   } }

結果

{   "data": {     "createItem": {       "item": {         "itemId": "30a8616da7c6411db307d4f2c9684e76",         "name": "Sitecore Authoring and Management API",         "path": "/sitecore/content/Home/Sitecore Authoring and Management API",         "fields": {           "nodes":             {               "name": "Text",               "value": "Welcome to Sitecore"             },             {               "name": "Title",               "value": "Welcome to Sitecore"             }                   }       }     }   } }

クエリ

mutation {   deleteItem( input: {        path: "/sitecore/content/Home/Sitecore Authoring and Management API"       permanently: true     }   ) {     successful   } }

結果

{   "data": {     "deleteItem": {       "successful": true     }   } }

クエリ

query { item( where: { database: "master", itemId: "{A58AAB49-FE07-4GT5-B03F-927C581E74D7}" }){ itemId name path fields(ownFields: true, excludeStandardFields: true) { nodes { name value } } } }

結果

{ "data": { "item": { "itemId": "a58aab49fe074gt5b03f927c581e74d7", "name": "Sitecore Authoring and Management API", "path": "/sitecore/content/Home/Sitecore Authoring and Management API", "fields": { "nodes": { "name": "Text", "value": "Welcome to Sitecore" }, { "name": "Title", "value": "Welcome to Sitecore" }

} } } }

クエリ

mutation {   createItemTemplate(     input: {       name: "NewTemplate"       parent: "{B29EE504-861C-492F-95A3-0D890B6FCA09}"       sections: {         # Create a new template section if the ID is empty, otherwise update the template section         name: "newSection"         fields:           # Create a new template field if the ID is empty, otherwise update the template field           { name: "Field 1", type: "Single-Line Text" }           { name: "Field 2", type: "Rich Text" }               }     }   ) {     itemTemplate {       name       ownFields {         nodes {           name           type         }       }     }   } }

結果

{   "data": {     "createItemTemplate": {       "itemTemplate": {         "name": "NewTemplate",         "ownFields": {           "nodes":             {               "name": "Field 1",               "type": "Single-Line Text"             },             {               "name": "Field 2",               "type": "Rich Text"             }                   }       }     }   } }

クエリ

mutation {   updateItemTemplate(     input: {       templateId: "{A597BE8E-3DD6-483F-B474-A18AF0560E89}"       name: "UpdatedTemplate"       sections:         {           # Create a new template section if the ID is empty, otherwise update the template section           templateSectionId: "{C8076CA2-FDDE-423C-A819-B6C7573B3FF2}"           name: "Updated Section 1"           fields:             {               # Create a new template field if the ID is empty, otherwise update the template field               fieldId: "{59B88198-5C5B-4E64-A051-3D5ADD003884}"               name: "Updated Field 1"             }             { name: "Create New Field", type: "Single-Line Text" }                   }         { name: "Create New Section 2" }           }   ) {     itemTemplate {       name       ownFields {         nodes {           name           type         }       }     }   } }

結果

{   "data": {     "updateItemTemplate": {       "itemTemplate": {         "name": "UpdatedTemplate",         "ownFields": {           "nodes":             {               "name": "Updated Field 1",               "type": "Single-Line Text"             },             {               "name": "Field 2",               "type": "Rich Text"             },             {               "name": "Create New Field",               "type": " Single-Line Text "             }                   }       }     }   } }

クエリ

mutation {   # The itemPath parameter should not include the Sitecore media library obsolete path   # The media item name should be included in the itemPath   uploadMedia(input: { itemPath: "Default Website/new media" }) {     presignedUploadUrl   } }

結果

{   "data": {     "uploadMedia": {       "presignedUploadUrl": "https://xmcloudcm.localhost/sitecore/api/v1/authoring/media/upload?token=dFh6hm\_yH2DrUppd2v7zAU4kvIHk7CgMsXgg2ieaeQzKCU7v7q\_W\_L9mBY7wGyPw0"     }   } }

!注XM Cloudは現在SitecoreAIですエンジニアリング資産が更新されている間、一部のコード例、画像、UIラベルは引き続きXM Cloudを使用する場合があります。

!注事前署名されたアップロードURLのクエリで「 指定されたキーはこのアルゴリズムの有効なサイズでない」というエラーが返された場合、GraphQL.UploadMediaOptions.EncryptionKey設定に値があるか確認してください。例えば:

もし合わなければ、設定しなければなりません。

レスポンスから事前署名済みのアップロードURLを取得したら、POSTリクエストを送ってメディアファイルをSitecoreにアップロードできます。

例えば、curlクライアントを使うと:

curl --request POST "https://<your_server>/sitecore/api/v1/authoring/media/upload?token=dFh6hm_yH2DrUppd2v7zAU4kvIHk7CgMsXgg2ieaeQzKCU7v7q_W_L9mBY7wGyPw0" --header "Authorization: Bearer <JWT_TOKEN>" --form =@<path_to_your_file>

リクエストへの応答は、メディアアイテムのID、名前、そして成功したメディアアップロード時のフルパスを含むJSON形式の応答です。

クエリ

query {   site(siteName: "website") {     name     domain    rootPath     startPath     browserTitle     cacheHtml     cacheMedia     enablePreview   } }

結果

{ "data": {    "site": {      "name": "website",      "domain": "extranet",     "rootPath": "/sitecore/content",      "startPath": "/home",      "browserTitle": "Website - Sitecore",      "cacheHtml": true,      "cacheMedia": true,      "enablePreview": true    } } }

クエリ

query {   search(     query: {       index: "sitecore_master_index"       searchStatement: {         criteria:           { criteriaType: SEARCH, field: "Title", value: "sample item" }           {             operator: MUST             field: "_path"             value: "110d559fdea542ea9c1c8a5df7e70ef9"           }               }     }   ) {     results {       innerItem {         path         field(name: "Title") {           value         }       }     }   } }

結果

{  "data": {     "search": {       "results":         {           "innerItem": {             "path": "/sitecore/content/Home/Sample Item1",             "field": {               "value": "Sample Item1"             }           }         },         {           "innerItem": {             "path": "/sitecore/content/Home/Sample Item2",             "field": {               "value": "Sample Item2"             }           }         }           }   } }

クエリ

query { search( query: { index: "sitecore_master_index" sort: { field: "__smallcreateddate", direction: DESCENDING } searchStatement: { criteria: { operator: MUST field: "_template" value: "76036f5ecbce46d1af0a4143f9b557aa" # Sample Item template ID }

} } ) { results { innerItem { name path field(name: "__Created") { value } } } } }

結果

{ "data": { "search": { "results": { "innerItem": { "name": "NewestItem", "path": "/sitecore/content/Home/NewestItem", "field": { "value": "20241114T120709Z" } } }, { "innerItem": { "name": "OldItem", "path": "/sitecore/content/Home/OldItem", "field": { "value": "20230512T110132Z" } } }

} } }

クエリ

query { search( query: { index: "sitecore_master_index" paging: { pageSize: 3, skip: 0, pageIndex: 0 } searchStatement: { criteria: { operator: MUST field: "_template" value: "76036f5ecbce46d1af0a4143f9b557aa" # Sample Item template ID }

} } ) { results { innerItem { name path } } } }

結果

{ "data": { "search": { "results": { "innerItem": { "name": "One", "path": "/sitecore/content/Home/One" } }, { "innerItem": { "name": "Two", "path": "/sitecore/content/Home/Two" } }, { "innerItem": { "name": "Three", "path": "/sitecore/content/Home/Three" } }

} } }

クエリ

query fieldValidation { item(where: { itemId: "{F704D058-D53C-490A-8803-37249B4F4031}" }) { field(name: "Title") { value validation { mode results { nodes { message result valid validator } } } } } }

結果

{ "data": { "item": { "field": { "value": "Page", "validation": { "mode": "FieldRegexValidation", "results": { "nodes": { "message": "Only numbers are allowed!", "result": "Error", "valid": false, "validator": "Field RegEx validator" }

} }

} } }, "extensions": {} }