Создание CSV-файла для импорта статей

1. Создайте CSV-файл для импорта статей.
   

   Примечание В Salesforce Classic каждый тип статьи импортируется отдельно, поэтому для каждого типа статьи создается CSV-файл. В Lightning Knowledge можно импортировать статьи разных типов в одном CSV-файле и установить тип записи во время импорта.
   • CSV-файл может содержать только один файл и файл .properties.
   • CSV-файл и файл .properties должны находиться в корневом каталоге.
   • Процесс сжатия должен сохранять структуру папки и подпапки.
   • Имя архивного файла не может содержать специальных символов.
   • Размер архивного файла не должен превышать 20 Мб, а размер отдельных несжатых файлов в архивном файле не должен превышать 10 Мб.
   • CSV-файлы не могут содержать более 10 000 строк, включая заголовок. Таким образом, количество статей и переводов может составлять не более 9999.
   • Размер строк CSV-файла не должен превышать 400 000 символов.
   • Размер ячеек CSV-файла не должен превышать 32 Кб.
   • Каждая статья CSV-файла не может содержать более 49 переводов.
2. В первой строке укажите поля и метаданные статьи, например, заголовок, язык, категории данных и каналы.

   Введите один элемент в каждый столбец. Ниже перечислены поля и метаданные, которые могут использоваться для импорта содержимого.

   Поле или данные	Описание
   isMasterLanguage	Определяет статью как основную (1) или перевод (0). Однако, isMasterLanguage не может быть импортирован в CSV- файл для импорта статей без переводов. Перевод должен следовать за основной статьей, чтобы быть связан с основной статьей, предшествующей ему.
   Заголовок	Заголовок статьи или перевода. Обязательно для всех импортов.
   Тип записи	Обозначает тип записи статьи (например, «Вопросы и ответы»). Импорт статьи требует 15-значного формата кода, чувствительного к регистру.
   Стандартные и настраиваемые поля	Ссылайтесь на стандартные поля типа статьи посредством имен полей и ссылайтесь на настраиваемые поля посредством имен API. Если связанное поле типа статьи является обязательным, оставление ячейки строки пустой может привести к пропуску статей.
   Поле типа «Область обогащенного текста»	Используйте настраиваемые поля типа «Область обогащенного текста» для импорта файлов или изображений .html. См. поле типа статьи «Область обогащенного текста» посредством его API-имени.
   Поле файла	Используйте настраиваемые поля файла для импорта любого типа файлов (.doc,.pdf,.txt). Используйте имя API для ссылки на поле файла типа статьи.
   Группы категорий данных	Чтобы классифицировать импортированные статьи, используйте группы категорий. Рекомендуем использовать уникальное имя группы категорий с префиксом datacategorygroup.. Например, используйте datacategorygroup.Products для указания группы категорий «Продукты».
   Канал	Чтобы указать доступность импортированных статей, воспользуйтесь ключевым словом Channels.
   Язык	Укажите язык статей. Обязательно для импорта статей с переводами. По желанию, импорт статей без переводов. Если вы не добавите этот столбец, статьи автоматически будут принадлежать стандартному языку базы Knowledge и импортировать переводы вместе с основными статьями будет невозможно.

3. В последующих строках укажите импортируемые статьи.

   Используйте одну строку на статью и введите соответствующие сведения в каждое поле или столбец метаданных. Чтобы пропустить импорт данных, оставьте столбец пустым. Например, если некоторые поля отображаются только в определенных типах записей, введите значения только для соответствующих статей этих типов.

   

   Важно! Все имена файлов чувствительны к регистру и должны полностью соответствовать данным CSV-файла.

   Рассмотрение	Примечания
   Стандартные или настраиваемые поля	Введите данные статей для каждого поля, за исключением полей типа «Область обогащенного текста», где нужно ввести относительный путь к соответствующему файлу .html в архивном файле. Импортер статей не поддерживает подполя. При наличии полей в полях настройте структуру и содержимое перед импортом в Salesforce Knowledge.
   Поле типа «Область обогащенного текста»	Всегда вводите путь к файлу .html относительно расположения CSV-файла. Не вводите исходный текст. Если указанный путь отсутствует, связанная статья не импортируется. Обратите внимание на следующие сведения об импорте HTML и изображений. Рекомендуем создать одну папку для файлов .html (например, /data) и другую папку для изображений (например, /data/images). Чтобы импортировать изображения, добавьте их в файл .html посредством тега <img> и атрибута src. Убедитесь, что значение src является относительным путем из файла .html в папку изображений. Изображения должны содержать файлы .png, .gif или .jpeg. Размер каждого файла изображения не должен превышать 1 Мб. При наличии нескольких полей типа «Область обогащенного текста» рекомендуем создать отдельный файл .html для каждого поля. Максимальный размер содержимого HTML-файла не может превышать его поля. Если дата не соответствует формату даты, указанному в файле свойств, связанная статья не импортируется. Если HTML-файл ссылается на файл, который не разрешен, связанная статья не импортируется. Если HTML-файл ссылается на отсутствующее изображение, то связанная статья импортируется без изображения.
   Поле файла	В Lightning Knowledge настраиваемые поля файлов заменяются Salesforce Files. Введите путь относительно расположения файла. Если указанный путь не существует, связанная статья не импортируется. Обратите внимание на следующие сведения об импорте файлов. Рекомендуем создать папку для файлов (например, /files). Размер каждого файла не должен превышать 5 Мб.
   Группы категорий	Используйте уникальные имена категорий для классификации статей. Используйте символ плюса (+) для указания нескольких категорий. Например, Laptop+Desktop. Обратите внимание на следующие сведения о группах категорий данных. Если оставить строку ячейки пустой, статье будет задано значение «Нет категорий». Если вы укажете категорию и ее родительскую (например, Европа+Франция), процесс импорта пропускает дочернюю категорию Франция и сохраняет родительскую категорию Европа, поскольку применение родительской категории косвенно включает дочерние категории. При импорте статей с переводами и связанными категориями данных только основная статья сохраняет категории данных. Переводы статей не имеют связанной категории данных при импорте.
   Каналы	Укажите каналы статей с помощью ключевых слов. application для внутреннего приложения. Если вы не укажете канал, application будет по умолчанию. sites для общедоступной базы знаний. csp для клиента. prm для партнера. Используйте символ плюса (+) для указания нескольких каналов (например, application+sites+csp для предоставления доступа к статье во всех каналах). При импорте статей с переводами и связанными каналами только основная статья сохраняет каналы. Переводы статей не имеют связанных каналов при импорте.

Чтобы задать параметры импорта в файле свойств, воспользуйтесь именами ключей и соответствующими значениями.