Importing content
Import content into Pega Knowledge from an external source such as a legacy content
system or a translation services vendor by using a pre-defined CSV file template. You can
also update existing content using this file template. Note the following restrictions about the import process: To import or update content, download the CSV file template from the Knowledge portal,
populate the file by mapping the data columns in the file to your Pega Knowledge content
structure, and then import the file. This section contains the following topics: Download the CSV file from the Pega Knowledge portal and populate it with information
about the content that you want to import or update. The CSV file template contains columns that represent the data that you map to your
Pega Knowledge content data structure. Each row and column represents an article. If the
data columns do not match your existing data structure, you can update the template by
adding additional data columns. For more information, see Adding additional data
attributes to the CSV file later in this section. The following figure shows an example of the CSV file template: Pega Knowledge uses the Content ID column to import or update content, based on the
following rules: The following table lists and describes the data columns in the CSV file, and
indicates whether that data is required when updating or importing content in Pega
Knowledge. The content ID of the article in the Pega Knowledge portal. The ContentID should exist in the system, and the format should
include the KC- prefix. Example: KC-123. Y= if updating existing content N = if importing new content Enter the type of content, for example, URL, Authored, or any
other valid content type. If you leave this column empty, Authored
is the default. The default language used for the articles. English is the
default language. The category associated with the article. The tags or synonyms associated with the article. When importing or updating content, you can add multiple tags as
comma-separated values in the Tags column. Spaces are not
required after commas. Example: travel
tips,travel,foreign. The content of the article. Use this column to import the remaining content when you have
exceeded the 32,767 character limit (including spaces) and there
are additional articles to import. Perform the following steps to import the remaining articles: Y = if you have exceeded the character limit and you want to
import the remaining content. N = if you have not exceeded the character limit. N = If importing new
content. If the CSV file has data columns that do not match your existing data structure, you
can add data attributes to the CSV file that represent your existing data
structure. After populating the CSV file, perform the following steps to import the file. This
process imports the new content or updates the existing content in the Pega Knowledge
portal. Only successful imports are moved to the
Knowledge Content - Imported Workbasket. If
errors occur while importing the CSV file, error messages that describe the
failure are displayed on the resulting Import page. After importing content, you can view the results of the import process in the
Import content tab. This page shows successful and failed
imports, and includes the row numbers, generated IDs, and comments (error messages) of the
imported rows. The following example shows the result of the import process. You can open an article by clicking the ID number or navigating to the
Knowledge Content – Imported workbasket. The content
displayed in this workbasket is in the New-Draft stage,
which allows you to continue editing, approving, and publishing the content according to
the standard Pega Knowledge authoring flow. Note the following:Downloading the CSV file
Populating the CSV file
Data Column Description Required? ContentID ContentTitle The title of the article. Y ContentAbstract The abstract information for the article. Y ContentType Y Language N Category Invalid category
error.N Tags N ContentBody Y LinkToPrevious ReasonForEdit If you are updating existing content, enter the reason for the
update. Y = If updating existing content. Adding additional data attributes to the CSV file
Importing the CSV file
Viewing the import results
Previous topic Customizing the dashboard Next topic Exporting content