MarkForPublishServicesGetAssetMarks Method

Ingeniux CMS Web Services API

Retrieves the Mark-for-publish information on given page(s)

Namespace:  IngeniuxCMService
Assembly:  IngeniuxCMService (in IngeniuxCMService.dll) Version: 10.3.70
Syntax

public XHRServiceResponseGeneric<ContentItemPublishMarkingList> GetAssetMarks(
	GetContentItemMarksInput data
)

Parameters

data
Type: GetContentItemMarksInput

The information on the assets(s) to request mark-for-publish information for

Examples

Sample JSON request
JavaScript
{
  "pageIds": [
    "a/160"
  ],
  "recursive": false
}

Return Value

Type: XHRServiceResponseGenericContentItemPublishMarkingList

Collection of Publishing Targets information, also indication on each target on whether or not the given pages are marked for the target, and which version of this asset was marked for the given target.

Also, the collection of information on all available previous versions of the assets and the mark-for-publish information on each version.

Examples

Sample JSON return
JavaScript
{
    "markByDefault": false,
    "pubTargets": [
      {
        "allowCurrentUser": true,
        "markedVersion": 3,
        "pubTargetId": "PublishingTargets/33",
        "pubTargetName": "Brand Central",
        "structuredUrlEnabled": true
      },
      {
        "allowCurrentUser": true,
        "markedVersion": 3,
        "pubTargetId": "PublishingTargets/65",
        "pubTargetName": "confidencecenter",
        "structuredUrlEnabled": true
      }
    ],
    "versions": [
      {
        "ID": null,
        "Name": "flexTable",
        "CheckoutVersion": false,
        "Comments": null,
        "CurrentVersion": true,
        "Date": "20180403T22:11:55",
        "IsFirstVersion": false,
        "MasterVersion": -1,
        "PubTargets": "{\"version\":3,\"targets\":[{\"id\":\"PublishingTargets/33\",\"name\":\"Brand Central\"},{\"id\":\"PublishingTargets/65\",\"name\":\"confidencecenter\"}]}",
        "User": "test [test]",
        "Version": 3
      },
      {
        "ID": null,
        "Name": "flexTable",
        "CheckoutVersion": false,
        "Comments": null,
        "CurrentVersion": false,
        "Date": "20180403T22:11:43",
        "IsFirstVersion": false,
        "MasterVersion": -1,
        "PubTargets": "{\"version\":2,\"targets\":[]}",
        "User": "test [test]",
        "Version": 2
      },
      {
        "ID": null,
        "Name": "flexTable",
        "CheckoutVersion": false,
        "Comments": null,
        "CurrentVersion": false,
        "Date": "20180403T22:11:20",
        "IsFirstVersion": true,
        "MasterVersion": -1,
        "PubTargets": "{\"version\":1,\"targets\":[]}",
        "User": "test [test]",
        "Version": 1
      }
    ]
}
Remarks

For each item in "pubTargets" collection: the "markedVersion" property indicating which version was marked for that target. If value is -1, then it is not marked for that target.

If multiple asset ids are provided, the return marking information will be the first asset in the selection. However, because it is on multiple asset, the "versions" collection will only list current version.

See Also

Reference