Article Type__DataCategorySelection

A data category selection represents a data category that classifies an article. This object can be used to associate an article with data categories from a data category group or to query the category selections for an article.

The object name is variable and has a syntax of Article Type__DataCategorySelection, where Article Type is the Object Name for the article type associated with the article. For example, Offer__DataCategorySelection represents the association between the Offer article type and its data categories. Every article is associated with an article type.

Supported Calls

create(), delete(), describeSObjects(), query(), getDeleted(), retrieve()

Special Access Rules

Users can only access, create or delete data category selection visible to their role, permission set, or profile. If a user has partial visibility on an article's categorization, only the visible categories are returned.

Fields

Field Name Details
DataCategoryGroupName
Type
DataCategoryGroupReference
Properties
Create
Description
Unique name of the data category group which has categories associated with the article.
DataCategoryName
Type
DataCategoryGroupReference
Properties
Create
Description
Unique name of the data category associated with the article.
ParentId
Type
reference
Properties
Create, Filter
Description
ID of the article associated with the data category selection.

Usage

Every article in Salesforce Knowledge can be categorized. A data category selection represents a category that has been selected to classify an article. You can use the Article Type__DataCategorySelection object to query and manage article categorization in your organization. Client applications can create a categorization for an article with a Draft status. They can also delete and query article categorizations.

Note
When using Article Type__DataCategorySelection to classify an article, you can't select both a category (for example USA) and one of its descendants (California) or ascendant categories (North America). In this case, only the first category is selected.

Answer communities use QuestionDataCategorySelection to classify questions.

SOQL Sample

The following SOQL query returns the data category selections used to classify the article whose ID is ka0D000000005ApIAI.

SELECT Id,DataCategoryName, ParentId
FROM Offer__DataCategorySelection WHERE ParentId='ka0D000000005ApIAI'

This clause only returns category unique names. To retrieve category labels use the following clause:

SELECT Id,toLabel(DataCategoryName), ParentId
FROM Offer__DataCategorySelection WHERE ParentId='ka0D000000005ApIAI'
Tip
You can also use relationship queries to retrieve categorizations from an article type.
© Copyright 2000–2014 salesforce.com, inc. All rights reserved.
Various trademarks held by their respective owners.