content/documentlistTypes

Use the Document List Types resource to manage the types of document lists in your site's document hierarchy. The type denotes a content type for that list of folders, sub-folders, and documents such as `web_pages`.

JSON Example

DocumentListType Properties

Property Description
defaultDocuments

type: list of documentInstallation

Definition of any documents to create with a document list is created.

documentInstallation.documentTypeFQN

type: string

Fully qualified name of the document type.

documentInstallation.locale

type: string

Localized properties for the document installation package and data. This information details the installation of document content and files within the site and is localized based on the `localeCode`.

documentInstallation.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

documentInstallation.properties

type: Mozu.Core.Api.Contracts.Json

Collection of property attributes defined for the object. Properties are associated to all objects within Kibo eCommerce, including documents, products, and product types.

documentListTypeFQN

type: string

The fully qualified name for the document list type for content.

documentTypeFQNs

type: list of string

List of fully qualified names for the document type.

enableActiveDateRanges

type: bool

Determines if documentLists belonging to this documentListType have ActiveDateRanges turned on or off. Each documentList created from the documentListType will use this value, but it can be overridden in an individual documentList.

enablePublishing

type: bool

Indicates if the document list and document list type are enabled to publish. If true, publishing of draft documents in this document list/document list type is enabled for the site. If false, all document changes are immediately published in live mode.

installationPackage

type: string

The package of document lists and content documents to be installed.

metadata

type: Mozu.Core.Api.Contracts.Json

Metadata content for entities, used by document lists, document type lists, document type, views, entity lists, and list views.

name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

namespace

type: string

The namespace for the accessible APIs and source capabilities in the core of Kibo eCommerce APIs.

scopeType

type: string

The type of scope associated with the documentList. For example, if the documentList is pageTemplateContent, the scopeType is Site.

Valid values are: "Tenant", "MasterCatalog", and "Site".

supportsActiveDateRanges

type: bool

Determines if documentLists belonging to this documentListType will support drafting and ActiveDateRanges documents. This field defaults to false and cannot be updated. Each documentList created from the documentListType will use this value.

supportsPublishing

type: bool

Indicates if modified documents are published automatically or saved to publish at a later time. If true, changed documents in this list can be saved as drafts until they are published to the site. If false, all document changes are immediately published in live mode. System-supplied and read only.

usages

type: list of string

A string array that determines where the document or entity list displays. The options are entityManager, for displaying content in the Custom Schema page in Admin, and siteBuilder, for displaying content in the site tree in Site Builder (applies only to document lists). The following example demonstrates how to display content across both options:

"usages": ["siteBuilder", "entityManager"]

version

type: string

The current version number of the order, wish list, document list, or document type list.

views

type: list of view

The view in the site used by associated entities or document lists/list types.

view.fields

type: list of viewField

The list of fields to display for a view or an associated schema. For example, the address schema would display fields for postal addresses.

view.viewField.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

view.viewField.target

type: string

Targets represent the object, such as an item to apply discounts to(products or orders) or a view field for content. Targets are the dot notations that link to the source document property. For example, firstitem for the direct level or firstitem.seconditem.thirditem for a deeper property.

view.filter

type: string

Used to filter and refine queries, returning data that matches the filter query. If multiple filters are used, they are ANDed together in the query. Filters use expressions to locate content based on a field and operator, such as `cn `for contains.

view.includeInactiveMode

type: string

Specifies how to filter views based on the status of a document.

Note:  This property requires the following criteria before it takes effect:
  • The includeInactive parameter of the GetViewDocuments operation must be set to true. This parameter is always set to true whenever a view is requested through Admin. However, if you make a request for a view through the API (using the GetViewDocuments operation), you must set the parameter to true manually. If you set the includeInactive parameter to false or leave it blank instead, then only documents within the active date range (or documents without an active date range specified) return in the view.
  • The document list requested in the view must support active date ranges. If it does not have active date ranges enabled, then the includeInactiveMode property is ignored.

You can specify the following values for this property:

all or null—all documents return in the view.

active—only documents within the active date range (or documents without an active date range specified) return in the view.

scheduled—only documents with an active date range set in the future return in the view.

activeOrScheduled—only scheduled and active documents return in the view.

ended—only documents with an active date range set in the past return in the view.

view.isAdminDefault

type: bool

If true, specifies that the view is the default view for a documentList or documentListType when viewed in Admin. If no view is specified as default, then the first view in the documentList or documentListType is default. Only one view within a documentList or documentListType can have this value set to true.

view.isVisibleInStorefront

type: bool

The isVisibleInStorefront field indicates whether documents in the view can be accessed from the Kibo eCommerce storefront application. If true, the storefront application and storefront client application (javascript tier) can GET documents from the view.

view.metadata

type: Mozu.Core.Api.Contracts.Json

Metadata content for entities, used by document lists, document type lists, document type, views, entity lists, and list views.

view.name

type: string

The user supplied name that appears in Admin. You can use this field for identification purposes.

view.usages

type: list of string

A string array that determines where the document or entity list displays. The options are entityManager, for displaying content in the Custom Schema page in Admin, and siteBuilder, for displaying content in the site tree in Site Builder (applies only to document lists). The following example demonstrates how to display content across both options:

"usages": ["siteBuilder", "entityManager"]

Operations

Operation Name Request URI Description
CreateDocumentListType POST %3fresponseFields%3d%7bresponseFields%7d

Creates a new documentListType.

GetDocumentListType GET %7bdocumentListTypeFQN%7d%3fresponseFields%3d%7bresponseFields%7d

Gets a documentListType.

GetDocumentListTypes GET %7bdocumentListTypeFQN%7d%3fresponseFields%3d%7bresponseFields%7d

Gets all the available documentListTypes.

UpdateDocumentListType PUT %7bdocumentListTypeFQN%7d%3fresponseFields%3d%7bresponseFields%7d

Updates a DocumentListType