Metadata API Developer Guide
jNewer Version Available
KnowledgeSettings
This type extends the Metadata metadata type and inherits its fullName field.
In the package manifest, all organization settings metadata types are accessed using the “Settings” name. See Settings for more details.
File Suffix and Directory Location
KnowledgeSettings values are stored in a single file named Knowledge.settings in the settings directory. The .settings files are different from other named components because there is only one settings file for each settings component.
Version
KnowledgeSettings is available in API version 27.0 and later.
Fields
| Field Name | Field Type | Description |
|---|---|---|
| answers | KnowledgeAnswerSettings | Represents the metadata used to manage settings for Salesforce Knowledge and Answers. |
| cases | KnowledgeCaseSettings | Represents the metadata used to manage settings for Salesforce Knowledge and Cases. |
| defaultLanguage | string | Required. The default language for Salesforce Knowledge. Use the abbreviation for the language, for example, en_US for United States English. |
| languages | KnowledgeLanguageSettings | A list of languages enabled for Salesforce Knowledge. |
| enableChatterQuestionKBDeflection | boolean | Indicates whether tracking for case deflection via Chatter is enabled (true) or not (false). |
| enableCreateEditOnArticlesTab | boolean | Indicates whether users can create and edit articles on the articles tab (true) or not (false). |
| enableExternalMediaContent | boolean | Indicates whether connecting to external media is enabled (true) or not (false). |
| enableKnowledge | boolean | Indicates whetherSalesforce Knowledge is enabled (true) or not (false). |
| showArticleSummariesCustomerPortal | boolean | Indicates whether article summaries appear in the Customer Portal (true) or not (false). |
| showArticleSummariesInternalApp | boolean | Indicates whether article summaries appear in the internal knowledge base (true) or not (false). |
| showArticleSummariesPartnerPortal | boolean | Indicates whether article summaries appear in the partner portal (true) or not (false). |
| showValidationStatusField | boolean | Indicates whether validation status appears on articles (true) or not (false). |
| suggestedArticles | KnowledgeSuggestedArticlesSettings | Represents the metadata used to manage settings for the case fields used to suggest articles for cases. Available in API version 37.0 and later. |
KnowledgeAnswerSettings
Represents the metadata used to manage settings for Salesforce Knowledge and Answers.
| Field Name | Field Type | Description |
|---|---|---|
| assignTo | string | Specifies the username an article is assigned to from Answers. |
| defaultArticleType | string | The default article type for articles created from Answers. Uses the API name of the article type. |
| enableArticleCreation | boolean | Indicates whether users can create articles from Answers (true) or not (false). |
KnowledgeCaseField
Represents the name of the case field used to suggest articles for the case. Available in API version 37.0 and later.
| Field Name | Field Type | Description |
|---|---|---|
| name | string | Specifies the name of the case field used to suggest articles for the case. |
KnowledgeCaseFieldsSettings
Represents a list of the case fields used to suggest articles for the case. Available in API version 37.0 and later.
| Field Name | Field Type | Description |
|---|---|---|
| field | KnowledgeCaseField[] | Specifies the names of the case fields used to suggest articles for the case. |
KnowledgeWorkOrderField
Represents the name of the work order field used to suggest articles for the work order. Available in API version 39.0 and later.
| Field Name | Field Type | Description |
|---|---|---|
| name | string | Specifies the name of the work order field used to suggest articles for the work order. |
KnowledgeWorkOrderFieldsSettings
Represents a list of the work order fields used to suggest articles for the work order. Available in API version 39.0 and later.
| Field Name | Field Type | Description |
|---|---|---|
| field | KnowledgeWorkOrderField[] | Specifies the names of the work order fields used to suggest articles for the work order. |
KnowledgeWorkOrderLineItemField
Represents the name of the work order line item field used to suggest articles for the work order line item. Available in API version 39.0 and later.
| Field Name | Field Type | Description |
|---|---|---|
| name | string | Specifies the name of the work order line item field used to suggest articles for the work order line item. |
KnowledgeWorkOrderLineItemFieldsSettings
Represents a list of the work order line item fields used to suggest articles for the work order line item. Available in API version 39.0 and later.
| Field Name | Field Type | Description |
|---|---|---|
| field | KnowledgeWorkOrderLineItemField[] | Specifies the names of the work order line item fields used to suggest articles for the work order line item. |
KnowledgeSuggestedArticlesSettings
Represents the metadata used to manage settings for the articles suggested for cases, work orders, and work order line items. The Work Order and Work Order Line Item objects must be enabled in the org to use the associated fields.
| Field Name | Field Type | Description |
|---|---|---|
| caseFields | KnowledgeCaseFieldsSettings | Represents a list of the case fields used to suggest articles for the case. |
| useSuggestedArticlesForCase | boolean | Indicates whether case content is used to suggest articles for cases (true) or not (false). |
| workOrderFields | KnowledgeWorkOrderFieldsSettings | Represents a list of the work order fields used to suggest articles for the work order. |
| workOrderLineItemFields | KnowledgeWorkOrderLineItemFieldsSettings | Represents a list of the work order line item fields used to suggest articles for the work order line item. |
KnowledgeCaseSettings
Represents the metadata used to manage settings for Salesforce Knowledge and Cases.
| Field Name | Field Type | Description |
|---|---|---|
| articlePDFCreationProfile | string | The profile used to create a PDF of an article from Cases. |
| articlePublicSharingSites | KnowledgeSitesSettings | Represents the metadata used to manage settings for Salesforce Knowledge and Sites. |
| articlePublicSharingCommunities | KnowledgeSitesSettings | Represents the metadata used to manage settings for Salesforce Knowledge and Communities. |
| articlePublicSharingSitesChatterAnswers | KnowledgeSitesSettings | Represents the metadata used to manage settings for Salesforce Knowledge and Sites with Chatter Answers. |
| assignTo | string | Specifies the username an article is assigned to from Cases. |
| customizationClass | string | Specifies the Apex class used for customization. |
| defaultContributionArticleType | string | The default article type for articles created from Cases. |
| editor | KnowledgeCaseEditor (enumeration of type string) | Indicates the rich text editor type. Valid values are:
|
| enableArticleCreation | boolean | Indicates whether users can create articles from Cases (true) or not (false). Controls whether other fields on KnowledgeCaseSettings can be set. |
| enableArticlePublicSharingSites | boolean | Indicates whether articles can be shared via a public site (URL) from Cases (true) or not (false). |
| useProfileForPDFCreation | boolean | Indicates whether a profile is used to create a PDF of an article from Cases (true) or not (false). |
KnowledgeSitesSettings
Represents the metadata used to manage settings for Salesforce Knowledge and Sites.
| Field Name | Field Type | Description |
|---|---|---|
| site | string[] | Specifies the site used for Salesforce Knowledge and Sites. |
KnowledgeLanguageSettings
A list of languages enabled for Salesforce Knowledge. KnowledgeLanguageSettings is available in API version 28.0 and later.
| Field Name | Field Type | Description |
|---|---|---|
| language | KnowledgeLanguage | Represents the metadata used to manage settings for the languages enabled for Salesforce Knowledge. |
KnowledgeLanguage
Represents the metadata used to manage settings for the languages enabled for Salesforce Knowledge. KnowledgeLanguage is available in API version 28.0 and later.
| Field Name | Field Type | Description |
|---|---|---|
| active | boolean | Indicates whether the language is enabled (true) or not (false). |
| defaultAssignee | string | The default assignee for articles in the language. |
| defaultAssigneeType | KnowledgeLanguageLookupValueType (enumeration of type string) | Indicates the default assignee type. Valid values are:
|
| defaultReviewer | string | The default reviewer for articles in the language. |
| defaultReviewerType | KnowledgeLanguageLookupValueType (enumeration of type string) | Indicates the default reviewer type. Valid values are:
|
| name | string | The code for the language name, for example: English is en. See “What languages does Salesforce support?” in the Salesforce online help for a list of supported languages and their codes. |