記事のインポート用の .csv ファイルの作成

1. 記事をインポートするための .csv ファイルを作成します。
   

   メモ Salesforce Classic の場合は、各記事タイプを個別にインポートするので、記事タイプごとに .csv ファイルを作成します。Lightning Knowledge の場合は、さまざまな記事タイプを 1 つの .csv ファイルでインポートし、インポート中にレコードタイプを設定できます。
   • .csv ファイルと .properties ファイルをそれぞれ 1 つのみ含めることができます。
   • .csv ファイルと .properties ファイルがルートディレクトリに配置されている必要があります。
   • 圧縮プロセスでフォルダーとサブフォルダーの構造を維持する必要があります。
   • .zip ファイル名に特殊文字は使用できません。
   • .zip ファイルは 20 MB、zip ファイル内の各非圧縮ファイルは 10 MB を超えることはできません。
   • .csv ファイルには、ヘッダー行を含め 10,000 行を超える行を含めることはできません。したがって、最大 9,999 個の記事と翻訳を含めることができます。
   • .csv ファイルの行が 400,000 文字を超えることはできません。
   • .csv ファイルのセルが 32 KB を超えることはできません。
   • .csv ファイルの各記事に 49 を超える翻訳を含めることはできません。
2. 1 行目には、記事の項目とメタデータ (タイトル、言語、データカテゴリ、チャネルなど) を指定します。

   各列に 1 つの項目を入力します。次の項目とメタデータを使用して内容をインポートできます。

   項目またはデータ	説明
   isMasterLanguage	記事をプライマリ (1) または翻訳 (0) として特定します。翻訳を含む記事をインポートする場合には必須項目です。ただし、翻訳を含まない記事をインポートする場合は、isMasterLanguage が .csv ファイルに含まれない可能性があります。翻訳はその前にあるプライマリ記事に関連付けられるように、プライマリ記事の後に記載する必要があります。
   タイトル	記事または翻訳のタイトル。すべてのインポートで必須です。
   レコードタイプ	記事のレコードタイプ (FAQ など) を示します。記事のインポートでは、大文字と小文字を区別する 15 文字の ID 形式を使用する必要があります。
   標準項目およびカスタム項目	記事タイプの標準項目を参照する場合は項目名を使用し、カスタム項目を参照する場合は API 名を使用します。関連する記事タイプ項目が必須の場合、行のセルを空のままにしておくと、記事がスキップされる場合があります。
   リッチテキストエリア項目	.html ファイルまたは画像をインポートするには、リッチテキストエリアカスタム項目を使用します。記事タイプのリッチテキストエリア項目を参照するには、API 名を使用します。
   ファイル項目	.doc、.pdf、.txt などのファイル形式をインポートするには、ファイルカスタム項目を使用します。記事タイプのファイル項目を参照するには、API 名を使用します。
   データカテゴリグループ	インポートした記事を分類するには、カテゴリグループを使用します。カテゴリグループを参照するには、プレフィックスとして datacategorygroup. が付けられた一意の名前を使用します。たとえば、カテゴリグループ Products を指定するには datacategorygroup.Products を使用します。
   チャネル	インポートした記事を使用できる場所を指定するには、キーワード Channels を使用します。
   言語	記事の言語を指定します。翻訳を含む記事のインポートでは必須です。翻訳を含まない記事のインポートでは省略可能です。この列を追加しない場合、記事は自動的に知識ベースのデフォルト言語に属します。また、プライマリ記事と一緒に翻訳をインポートすることはできません。

3. 以降の行に、インポートする記事を指定します。

   1 記事につき 1 行を使用し、各項目列またはメタデータ列に適切な情報を入力します。列を空白にすると、データのインポートをスキップできます。たとえば、一部の項目が特定のレコードタイプのみで表示される場合、それらのタイプの該当する記事のみに値を入力します。

   

   重要 すべてのファイル名で大文字と小文字が区別され、.csv ファイルの表記と正確に一致する必要があります。

   考慮事項	メモ
   標準項目またはカスタム項目	項目ごとに記事のデータを入力します。ただし、リッチテキストエリア項目を除きます。リッチテキストエリア項目には、.zip ファイル内の対応する .html ファイルへの相対パスを入力する必要があります。 記事のインポートは、サブ項目をサポートしません。項目内に項目がある場合は、Salesforce ナレッジにインポートする前に、構造とコンテンツを調整する必要があります。
   リッチテキストエリア項目	常に、.csv ファイルの場所を基準とする .html ファイルの相対パスを入力します。テキストをそのまま入力しないでください。指定したパスが存在しない場合、関連する記事はインポートされません。HTML および画像のインポートに関する次の情報に注意してください。 .html ファイル用のフォルダー (/data など) と画像用のフォルダー (data/images など) を別々に作成することをお勧めします。 画像をインポートするには、<img> タグと src 属性を使用して、画像を .html ファイルに含めます。src 値には、.html ファイルから画像フォルダーへの相対パスを指定します。 画像は、.png、.gif、.jpeg ファイルのいずれかである必要があります。 各画像ファイルは 1 MB を超えることはできません。 複数のリッチテキストエリア項目がある場合、各項目のコンテンツ用に個別の .html ファイルを作成します。 .html ファイルの内容は、その項目の最大サイズを超えることはできません。 日付がプロパティファイルに指定された日付形式に一致しない場合、関連する記事はインポートされません。 .html ファイルが参照できないファイルを参照する場合、関連する記事はインポートされません。 .html ファイルが存在しない画像を参照している場合でも、関連記事はその画像を含めずにインポートされます。
   ファイル項目	Lightning Knowledge では、カスタムファイル項目は Salesforce Files で置換されます。 ファイルの場所への相対パスを入力します。指定したパスが存在しない場合、関連する記事はインポートされません。ファイルのインポートについて、次の点に注意してください。 ファイルのフォルダーを作成することをお勧めします (例: /files)。 各画像ファイルは 5 MB を超えることはできません。
   カテゴリグループ	一意のカテゴリ名を使用して記事を分類します。複数のカテゴリを指定する場合は、プラス記号 (+) を使用します。たとえば、Laptop+Desktop です。データカテゴリグループについて、次の点に注意してください。 セル行を空のままにしておくと、記事はカテゴリなしとして設定されます。 親カテゴリを適用すると、そのカテゴリの子が暗黙的に含まれるため、カテゴリとその親 (例: Europe+France) を指定した場合、インポート処理では、子カテゴリの France がスキップされ、親カテゴリの Europe が保持されます。 翻訳および関連付けられたデータカテゴリを持つ記事をインポートする場合は、プライマリ記事のみがデータカテゴリを保持します。記事翻訳にはインポート時に関連付けられているデータカテゴリはありません。
   チャネル	次のキーワードを使用して、記事のチャネルを指定します。 内部アプリケーションには application を使用します。チャネルを指定しない場合、application がデフォルトとなります。 公開知識ベースには sites を使用します。 カスタマーには csp を使用します。 パートナーには prm を使用します。 複数のチャネルを指定するには、プラス記号 (+) を使用します。たとえば、application+sites+csp と指定すると、記事はすべてのチャネルで使用可能になります。 翻訳および関連付けられたチャネルを持つ記事をインポートする場合は、プライマリ記事のみがチャネルを保持します。記事翻訳にはインポート時に関連付けられているチャネルはありません。

キー名および対応する値を使用して、プロパティファイル内のインポートパラメーターを指定します。